IASLabel::get_Image

This method retrieves a handle to the control image and image mask, allowing a bitmap to be drawn on the label control.

Syntax

HRESULT get_Image( OLE_HANDLE *phImage OLE_HANDLE *phImageMask );

Parameters

phImage

[out] Pointer to the handle to a bitmap resource, cast to an OLE_HANDLE type.

phImageMask

[out] Pointer to the handle to the image mask that defines the transparent parts of the image.

Return Values

NOERROR indicates success. E_INVALIDARG indicates that the argument is invalid.

Remarks

This method allows a bitmap to be drawn on the label control. The image mask is an optional monochrome bitmap that defines the transparent areas in the bitmap to be displayed.

Because of Automation, bitmapped image pointers are passed as OLE_HANDLE types. You can cast a handle to and from a bitmap.