PlayEnhMetaFileRecord
The PlayEnhMetaFileRecord
function plays an enhanced-metafile record by executing the graphics device
interface (GDI) functions identified by the record.
BOOL PlayEnhMetaFileRecord(
|
HDC hdc, |
// handle to device
context |
|
LPHANDLETABLE lpHandletable, |
// pointer to
metafile handle table |
|
CONST ENHMETARECORD *lpEnhMetaRecord, |
// pointer to
metafile record |
|
UINT nHandles |
// count of handles
|
|
); |
|
Parameters
hdc
Identifies
the device context passed to the EnumEnhMetaFile function.
lpHandletable
Points to a
table of handles identifying GDI objects used when playing the metafile. The
first entry in this table contains the enhanced-metafile handle.
lpEnhMetaRecord
Points to the
enhanced-metafile record to be played.
nHandles
Specifies the
number of handles in the handle table.
Return Values
If the
function succeeds, the return value is nonzero.
If the function
fails, the return value is zero.
Remarks
This is an
enhanced-metafile function.
An
application typically uses PlayEnhMetaFileRecord in conjunction with the
EnumEnhMetaFile
function to process and play an enhanced-format metafile one record at a time.
The hdc,
lpHandletable, and nHandles parameters must be exactly those
passed to the EnhMetaFileProc callback procedure by the EnumEnhMetaFile
function.
If PlayEnhMetaFileRecord
does not recognize a record, it ignores the record and returns TRUE.
Windows
95: PlayEnhMetaFileRecord is
subject to the limitations of the Windows 95 GDI. For example, Windows 95
supports only 16-bit signed coordinates. For records that contain 32-bit
values, Windows 95 fails to play the record if the values are not in the range
-32,768 to 32,767.
See Also