EnumMetaFileProc
The EnumMetaFileProc
function is an application-defined callback function that processes
Windows-format metafile records. This function is called by the EnumMetaFile function.
This function
is provided for compatibility with earlier versions of Microsoft Windows. Win32-based
applications should use the EnhMetaFileProc and EnumEnhMetaFile functions.
int CALLBACK EnumMetaFileProc(
|
HDC hDC, |
// handle to device
context |
|
HANDLETABLE FAR *lpHTable, |
// pointer to
metafile handle table |
|
METARECORD FAR *lpMFR, |
// pointer to
metafile record |
|
int nObj, |
// count of objects
|
|
LPARAM lpClientData |
// pointer to
optional data |
|
); |
|
Parameters
hDC
Identifies
the device context passed to EnumMetaFile.
lpHTable
Points to a
table of handles associated with the graphics objects (pens, brushes, and so
on) in the metafile.
lpMFR
Points to one
of the records in the metafile. This record should not be modified. (If
modification is necessary, it should be performed on a copy of the record.)
nObj
Specifies the
number of objects with associated handles in the handle table.
lpClientData
Points to any
application-supplied data.
Return Values
This function
must return a nonzero value to continue enumeration; to stop enumeration, it
must return zero.
Remarks
An
application must register the callback function by passing its address to the EnumMetaFile
function.
EnumMetaFileProc is a placeholder for the application-supplied
function name.
See Also