Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

Graphics.EnumerateMetafile Method (Metafile, RectangleF, RectangleF, GraphicsUnit, Graphics.EnumerateMetafileProc, IntPtr, ImageAttributes)

Sends the records of a selected rectangle from a Metafile, one at a time, to a callback method for display in a specified rectangle using specified image attributes.

Namespace:  System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)
'Declaration
Public Sub EnumerateMetafile ( _
	metafile As Metafile, _
	destRect As RectangleF, _
	srcRect As RectangleF, _
	unit As GraphicsUnit, _
	callback As Graphics.EnumerateMetafileProc, _
	callbackData As IntPtr, _
	imageAttr As ImageAttributes _
)

Parameters

metafile
Type: System.Drawing.Imaging.Metafile

Metafile to enumerate.

destRect
Type: System.Drawing.RectangleF

RectangleF structure that specifies the location and size of the drawn metafile.

srcRect
Type: System.Drawing.RectangleF

RectangleF structure that specifies the portion of the metafile, relative to its upper-left corner, to draw.

unit
Type: System.Drawing.GraphicsUnit

Member of the GraphicsUnit enumeration that specifies the unit of measure used to determine the portion of the metafile that the rectangle specified by the srcRect parameter contains.

callback
Type: System.Drawing.Graphics.EnumerateMetafileProc

Graphics.EnumerateMetafileProc delegate that specifies the method to which the metafile records are sent.

callbackData
Type: System.IntPtr

Internal pointer that is required, but ignored. You can pass Zero for this parameter.

imageAttr
Type: System.Drawing.Imaging.ImageAttributes

ImageAttributes that specifies image attribute information for the drawn image.

This method enumerates the records contained in the specified metafile. Each record is individually sent to a callback method specified by the callback parameter. Typically, the callback method calls the PlayRecord method to "play back", or draw, the record.

If the callback method calls PlayRecord, it must do so by calling the PlayRecord method of the specific Metafile that is being enumerated.

Any drawing that takes place outside of the rectangle specified by the srcRect parameter is ignored.

The image attributes specified by the imageAttr parameter replace those specified when the metafile was written.

.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.