SftPictureObject.Image Property	Softel vdm, Inc.

Defines the image object using a GDI+ image.

Syntax       

	Get
		VB.NET	GDIPlusImage = object.Image  As Integer
		VB	GDIPlusImage = object.Image  As LONG_PTR
		C#.NET	int GDIPlusImage = object.Image;
		VC++	LONG_PTR GDIPlusImage = object->Image; LONG_PTR GDIPlusImage = object->GetImage();
		C	HRESULT object->get_Image(LONG_PTR* GDIPlusImage);
		Delphi	GDIPlusImage := object.Image  : Pointer;
	Put
		VB.NET	object.Image = GDIPlusImage  As Integer
		VB	object.Image = GDIPlusImage  As LONG_PTR
		C#.NET	int object.Image = GDIPlusImage;
		VC++	LONG_PTR object->Image = GDIPlusImage; void object->PutImage(LONG_PTR GDIPlusImage);
		C	HRESULT object->put_Image(LONG_PTR GDIPlusImage);
		Delphi	object.Image := GDIPlusImage  : Pointer;

object

A SftPictureObject object.

GDIPlusImage

Defines the image object using a GDI+ image.

Comments

The Image property defines the image object using a GDI+ image. The image remains owned by the application and must remain valid as long as it is used by the control. Once it is no longer needed, it must be deleted by the application. Most languages, except C++, automatically delete the object when it is no longer needed so no action is usually necessary.

The Image property offers support for PNG, TIFF, JPEG, GIF, Exif, EMF+, EMF (GDI+ images) with full support for alpha-blended (translucent and semi-transparent) images.

Typically, .NET applications use the NETImageObject property to define an image, C and C++ applications use BitmapHandle or Image, VB6 and other COM applications use the Picture property.

SetImage can also to define the image object using a GDI image, but is also assign ownership of the GDI+ image to the control, so it automatically deletes the object when it is no longer needed. This is typically only used by C++ applications that have direct access to GDI+ classes.