![]() |
CNiImage | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
Class |
Declared in: NiImage.h |
Overview
CNiImage encapsulates the interface to an image object that is associated with a Measurement Studio ActiveX control such as a graph or a button. This allows you to manipulate and animate images to create complex visual effects.
Note that you must initialize a CNiImage object from an existing object. If you do not initialize a CNiImage object from an existing object, a CNiObjectNotInUsableState exception will be thrown when you attempt to manipulate the instance of the CNiImage.
Base Classes
Data Items
![]() |
long | AnimateColumns | Specifies the number of columns in a bitmap that is being used for animation. |
![]() |
Speeds | AnimateInterval | Specifies how often this image animates. |
![]() |
long | AnimateRows | Specifies the number of rows in a bitmap that is being used for animation. |
![]() |
Speeds | BlinkInterval | Specifies how often this image blinks. |
![]() |
CNiColor | Color | Specifies the color for the image. |
![]() |
CNiPicture | Picture | Specifies the image used in the CNiImage object. |
![]() |
bool | ReverseAnimation | Specifies the direction of animation. |
![]() |
bool | SaveLink | Specifies if the CNiImage object saves the image or a link to the image. |
![]() |
bool | Stretch | Specifies if the image is displayed in its normal size or stretched to fit within the control. |
![]() |
bool | Tile | Specifies if the image is tiled. |
![]() |
bool | Transparent | Specifies if the image has a transparent color. |
![]() |
CNiColor | TransparentColor | Specifies the color in the image that should be drawn as transparent. |
![]() |
CString | Url | Specifies the path to the image. |
![]() |
bool | Visible | Specifies if the image is visible. |
Constructors
![]() |
CNiImage() |
Default constructor. | |
![]() |
CNiImage( CWImage_CI* pCustom, CNiInterface::ThreadAccess option ) |
Constructor that attaches to the specified CWImage_CI pointer. | |
![]() |
CNiImage( const CNiImage& source ) |
Copy constructor. |
Destructors
Functions
![]() |
static const IID & | GetIid() |
Returns the globally unique identifier (GUID) of the ActiveX interface to which this class connects. |
![]() |
const CNiImage & | Assignment operator. | |
![]() |
void | Reload() |
Loads the image referenced by the current value of the URL property. |
Example
// Change the image displayed in the plot area of a 2D graph and // set it to blink quickly.
CNiGraph3D graph; CNiImage image = graph.Images("Plot Area"); image.URL = "c:\\windows\\circles.bmp"; image.BlinkInterval = CNiImage::SpeedVeryFast;