|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| gdi32.lib
| Header File
| wingdi.h
| Unicode
| No
| Platform Notes
| Windows 95: int == 16 bits
|
|
|
PlayMetaFileRecord
The PlayMetaFileRecord function plays a Windows-format metafile record by executing the graphics
device interface (GDI) function contained within that record.
This function is provided for compatibility with 16-bit versions of Microsoft
Windows. Win32-based applications should use the PlayEnhMetaFileRecord function.
BOOL PlayMetaFileRecord(
HDC hdc,
| // handle to device context
| LPHANDLETABLE lpHandletable,
| // pointer to metafile handle table
| LPMETARECORD lpMetaRecord,
| // pointer to metafile record
| UINT nHandles
| // count of handles
| );
|
|
Parameters
hdc
Identifies a device context.
lpHandletable
Points to a table of handles identifying GDI objects used when playing the
metafile.
lpMetaRecord
Points to the Windows-format metafile record.
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
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 use the
enhanced format metafile functions.
To convert a Windows-format metafile into an enhanced-format metafile, use the SetWinMetaFileBits function.
An application typically uses PlayMetaFileRecord in conjunction with the EnumMetaFile function to process and play a Windows-format metafile one record at a time.
The lpHandletable and nHandles parameters must be identical to those passed to the EnumMetaFileProc callback procedure by EnumMetaFile.
If the PlayMetaFileRecord function does not recognize a record, it ignores the record and returns TRUE.
See Also
BeginPath, EnumMetaFile, PlayMetaFile, PolyBezier, SetWinMetaFileBits, SetWorldTransform
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|