Public Function ChangeToGdiPlusImage( _
   ByVal flags As ChangeToGdiPlusImageFlags _
) As Image

Visual Basic (Usage)	Copy Code
Dim instance As RasterImage Dim flags As ChangeToGdiPlusImageFlags Dim value As Image   value = instance.ChangeToGdiPlusImage(flags)

public Image ChangeToGdiPlusImage( 
   ChangeToGdiPlusImageFlags flags
)

public: Image ChangeToGdiPlusImage( 
   ChangeToGdiPlusImageFlags flags
) 

public:
Image ChangeToGdiPlusImage( 
   ChangeToGdiPlusImageFlags flags
) 

Parameters

flags

Options for the conversion.

Return Value

This result GDI+ image and this RasterImage object will 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 ConvertToGdiPlusImage method to obtain a GDI+ Image object that is a copy of this RasterImage object.

Calling this method may change the internal format of 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