LEADTOOLS GDI/GDI+ (Leadtools.Drawing assembly)
LEAD Technologies, Inc

ChangeFromWmf(IntPtr,Int32,Int32,RasterColor) Method






Handle to the WMF to be changed.
Amount by which to scale the metafiles original width.
Amount by which to scale the metafiles original height.
The color to use to fill the image area before painting the metafile objects.
Changes a Windows Metafile (WMF) into a LEADTOOLS Leadtools.RasterImage object and, if successful, frees the Metafile.
Syntax
public static RasterImage ChangeFromWmf( 
   IntPtr hwmf,
   int width,
   int height,
   RasterColor backColor
)
'Declaration
 
Public Overloads Shared Function ChangeFromWmf( _
   ByVal hwmf As IntPtr, _
   ByVal width As Integer, _
   ByVal height As Integer, _
   ByVal backColor As RasterColor _
) As RasterImage
'Usage
 
Dim hwmf As IntPtr
Dim width As Integer
Dim height As Integer
Dim backColor As RasterColor
Dim value As RasterImage
 
value = RasterImageConverter.ChangeFromWmf(hwmf, width, height, backColor)
public static RasterImage ChangeFromWmf( 
   IntPtr hwmf,
   int width,
   int height,
   RasterColor backColor
)
 function Leadtools.Drawing.RasterImageConverter.ChangeFromWmf(IntPtr,Int32,Int32,RasterColor)( 
   hwmf ,
   width ,
   height ,
   backColor 
)
public:
static RasterImage^ ChangeFromWmf( 
   IntPtr hwmf,
   int width,
   int height,
   RasterColor backColor
) 

Parameters

hwmf
Handle to the WMF to be changed.
width
Amount by which to scale the metafiles original width.
height
Amount by which to scale the metafiles original height.
backColor
The color to use to fill the image area before painting the metafile objects.

Return Value

The newly created Leadtools.RasterImage object.
Remarks

Some metafiles do not have a background color, and hence, when the metafile is used to create a Leadtools.RasterImage object, the area not covered by the metafile objects will contain the default image background color (black). To create a raster image from a metafile like this with a specific background color, set the desired background color in the backColor parameter.

Some metafiles do not have a background color, and hence, when the metafile is used to create a Leadtools.RasterImage object, the area not covered by the metafile objects will contain the default image background color (black). To create a raster image from a metafile like this with a specific background color, use ChangeFromWmf(hemf, width, height, backColor).

If this method is successful, hwmf is freed.

The metafile can be loaded at the original dimension or scaled by using the width and height parameters.

If width == 0 and height == 0 - the metafile is loaded at the size present in the file.

If width == 0 and height > 0 - the metafile is stretched so that it has the height height (preserving the aspect ratio).

If width > 0 and height == 0 - the metafile is stretched so that it has the width width (preserving the aspect ratio).

If width > 0 and height > 0 - the metafile is stretched so that it has the width width and height height (the aspect ratio is ignored).

This method does not support signed images.

For more information refer to RasterImage and GDI/GDI+.

Example
For an example, refer to ChangeFromWmf(IntPtr, int, int).
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

RasterImageConverter Class
RasterImageConverter Members
Overload List
ChangeFromWmf(hemf, width, height)
ChangeFromEmf(IntPtr,Int32,Int32) Method
FromEmf
FromWmf
ChangeToEmf Method
ChangeToWmf Method
ToEmf
ToWmf

 

 


Products | Support | Contact Us | Copyright Notices

© 2006-2012 All Rights Reserved. LEAD Technologies, Inc.