Public Function ConvertToGdiPlusImage() As Image

Visual Basic (Usage)	Copy Code
Dim instance As RasterImage Dim value As Image   value = instance.ConvertToGdiPlusImage()

public Image ConvertToGdiPlusImage()

public: Image ConvertToGdiPlusImage(); 

public:
Image ConvertToGdiPlusImage(); 

Return Value

This result GDI+ image is a copy of this RasterImage object and do not share the same image data. You can use this method to pass a LEAD RasterImage object to other class library methods that expect a GDI+ Image object. Use the ChangeToGdiPlusImage method to obtain a GDI+ Image object that shares its data with this RasterImage object.

Use RasterImage.TestGdiPlusCompatible to determine if the image is compatible for conversion to a GDI+ image.

For a RasterImage to be compatible with a GDI+ image it needs the following:

• IsConventionalMemory to be true (Tiled, compressed and disk-based images are not supported)
• BitsPerPixel value of 1, 4, 8, 16, 24 or 32
• Order value of RasterByteOrder.Rgb or RasterByteOrder.Bgr
• Not a gray scale image.
• ViewPerspective value of RasterViewPerspective.TopLeft

For more information, refer to The RasterPaintEngine Property and 16bpp Grayscale Images. and Using The PaintEngine Property.

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Reference