GetDibFromGdPictureImage Method (GdPictureImaging)

In This Topic

Exports a specified GdPicture image to a DIB object, known as Device Independent Bitmap (DIB), as an IntPtr value. Please note that it is your responsibility to release the returned DIB object once you have no use for it.

Syntax

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

'Declaration
 
Public Function GetDibFromGdPictureImage( _
   ByVal ImageID As Integer _
) As IntPtr

public IntPtr GetDibFromGdPictureImage( 
   int ImageID
)

public function GetDibFromGdPictureImage( 
    ImageID: Integer
): IntPtr;

public function GetDibFromGdPictureImage( 
   ImageID : int
) : IntPtr;

public: IntPtr GetDibFromGdPictureImage( 
   int ImageID
)

public:
IntPtr GetDibFromGdPictureImage( 
   int ImageID
)

Parameters

ImageID: A unique image identifier of the GdPicture image representing the image to export.

Return Value

A pointer to a newly created DIB object, known as Device Independent Bitmap (DIB), as an IntPtr value, containing the specified GdPictureImage data. The GdPictureImaging.GetStat method can be subsequently used to determine if this method has been successful.

Remarks

It is recommend to use the GdPictureImaging.GetStat method to identify the specific reason for the method's failure, if any.

Be aware that you need to release the resulting DIB object with the GdPictureImaging.ReleaseDib method after being used.

This method requires the Image Documents component to run.

Reference

GdPictureImaging Class
GdPictureImaging Members
CreateGdPictureImageFromDIB(Int32) Method
SaveAsBMP(Int32,String) Method
GetStat Method
ReleaseDib(Int32) Method
ReleaseGdPictureImage Method