Hdib Property

Visual Basic
C#
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Property Hdib As IntPtr

'Usage
 
Dim instance As TemplateImage
Dim value As IntPtr
 
instance.Hdib = value
 
value = instance.Hdib

public IntPtr Hdib {get; set;}

public: __property IntPtr get_Hdib();
public: __property void set_Hdib( 
   IntPtr value
);

public:
property IntPtr Hdib {
   IntPtr get();
   void set (    IntPtr value);
}

This property provides a way for you to read and write the template image. This property accepts and returns WIN32 HDIB handles. Similar properties of this object accept and return the same image in other forms.

Important Information for Memory Management

If you set the template image using this property, this object will create a copy of your image and not keep a reference to your image.
If you get the template image using this property, this object will return a copy of the underlying image it holds and not keep a reference to the image that it returns. When you are finished with an image that this property returns, you must call the WIN32 GlobalFree() function to release it.

Template images must always be 1 bit-per-pixel. Gray or color images are not acceptable.

Changing this property will cause the HasChanged property to change to true.

Valid values: Any HDIB that contains a 1 bit-per-pixel image.

Default value: 0

Reference

TemplateImage Class
TemplateImage Members
CompressedData Property
Image Property
Hbitmap Property