EnhMetaFileProc

Overview

Group

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
user-defined
Header File
wingdi.h
Unicode
No
Platform Notes
ENHMFENUMPROC

The EnhMetaFileProc function is an application-defined callback function that processes enhanced-format metafile records. This function is called by the EnumEnhMetaFile function.

int CALLBACK EnhMetaFileProc(

HDC hDC,	// handle to device context
HANDLETABLE FAR *lpHTable,	// pointer to metafile handle table
ENHMETARECORD FAR *lpEMFR,	// pointer to metafile record
int nObj,	// count of objects
LPARAM lpData	// pointer to optional data
);

Parameters
hDC

Identifies the device context passed to EnumEnhMetaFile.

lpHTable

Points to a table of handles associated with the graphics objects (pens, brushes, and so on) in the metafile. The first entry contains the enhanced-metafile handle.

lpEMFR

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.

lpData

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 EnumEnhMetaFile function.

EnhMetaFileProc is a placeholder for the application-supplied function name.