| BOOL EnumMetaFile(hdc, hmf, lpMetaFunc, lParam) | |||||
| HDC hdc; | /* handle of device context | */ | |||
| HMETAFILE hmf; | /* handle of windows-format metafile | */ | |||
| MFENUMPROC lpMetaFunc; | /* address of callback function | */ | |||
| LPARAM lParam; | /* address of callback function data | */ | |||
The EnumMetaFile function enumerates the records that are stored in a windows-format metafile that is identified by hloc. This function passes each record to the callback function at which lpMetaFunc points. This application-supplied callback function can process each record as required. The enumeration continues until the last record is processed.
hdc
Identifies a device context.
hmf
Identifies a windows-format metafile.
lpMetaFunc
Points to an application-supplied callback function. For more information about the callback function, see the description of the EnumMetaFileProc callback function.
lParam
Points to callback-function data.
The return value is TRUE if the callback function enumerates all the records in the windows-format metafile. Otherwise, it is FALSE.
This function is provided for compatibility purposes only. A windows-format metafile does not support the new curve, path, and transformation functions such as PolyBezier, BeginPath, and SetWorldTransform. Applications that use these new functions and use metafiles to store pictures created by these functions should call the enhanced-format metafile-functions instead.
An application can convert a windows-format metafile into a enhanced-format metafile by calling the SetWinMetaFileBits function.
The EnumMetaFile function can be used to embed one windows-format metafile within another.
PlayMetaFile, PlayMetaFileRecord, SetWinMetaFileBits