Graphics::EnumerateMetafile Method (Metafile^, Point, Graphics::EnumerateMetafileProc^)

 

Sends the records in the specified Metafile, one at a time, to a callback method for display at a specified point.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public:
void EnumerateMetafile(
	Metafile^ metafile,
	Point destPoint,
	Graphics::EnumerateMetafileProc^ callback
)

Parameters

metafile
Type: System.Drawing.Imaging::Metafile^

Metafile to enumerate.

destPoint
Type: System.Drawing::Point

Point structure that specifies the location of the upper-left corner of the drawn metafile.

callback
Type: System.Drawing::Graphics::EnumerateMetafileProc^

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

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.

The following code example creates a form that has a Metafile as one of its private members. The OnPaint method calls EnumerateMetafile, which calls the form's MetafileCallback method for each record in the metafile. The MetafileCallback method calls the PlayRecord method. Notice that the MetafileCallback method receives the record data as an IntPtr, but the PlayRecord method expects the record data to be a byte array. The call to Copy copies the record data to a byte array so that it can be passed to PlayRecord.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: