GdPicture.NET.14
GdPicture14 Namespace / GdPictureImaging Class / CreateGdPictureImageFromHICON Method / CreateGdPictureImageFromHICON(IntPtr) Method
A Windows handle to an icon, as an IntPtr value. This pointer must be initialized with the proper image data and it must be disposed of by the user as well.
Example





In This Topic
CreateGdPictureImageFromHICON(IntPtr) Method
In This Topic
Creates a new GdPicture image from an instantiated Windows handle to icon provided as an IntPtr value. The newly created image is identified by its unique non-zero image identifier. Please note that it is your responsibility to release the image resources once you have no use for them.
Syntax
'Declaration
 
Public Overloads Function CreateGdPictureImageFromHICON( _
   ByVal hicon As IntPtr _
) As Integer
public int CreateGdPictureImageFromHICON( 
   IntPtr hicon
)
public function CreateGdPictureImageFromHICON( 
    hicon: IntPtr
): Integer; 
public function CreateGdPictureImageFromHICON( 
   hicon : IntPtr
) : int;
public: int CreateGdPictureImageFromHICON( 
   IntPtr hicon
) 
public:
int CreateGdPictureImageFromHICON( 
   IntPtr hicon
) 

Parameters

hicon
A Windows handle to an icon, as an IntPtr value. This pointer must be initialized with the proper image data and it must be disposed of by the user as well.

Return Value

A unique image identifier of the GdPicture image representing the newly created image. The returned value is non-zero if the image is successfully created. Please first of all use the GetStat method to determine if this method has been successful.

Be aware that you need to release the image with the ReleaseGdPictureImage method after being used.

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

Please note, that created GdPicture image will use its own pixel allocation.

This method requires the Image Documents component to run.

Example
Creating a GdPicture image from an icon handle and saving to a PNG file.
using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    Icon icon = Icon.ExtractAssociatedIcon(System.Reflection.Assembly.GetEntryAssembly().Location);
 
    // Create the GdPicture image and save it as a PNG.
    int imageID = gdpictureImaging.CreateGdPictureImageFromHICON(icon.Handle);
    gdpictureImaging.SaveAsPNG(imageID, "image.png");
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}
See Also