|
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
|
|
|
PlayMetaFile
The PlayMetaFile function displays the picture stored in the given Windows-format metafile on
the specified device.
This function is provided for compatibility with 16-bit versions of Windows.
Win32-based applications should use the PlayEnhMetaFile function.
BOOL PlayMetaFile(
HDC hdc,
| // handle to the device context
| HMETAFILE hmf
| // handle to the metafile
| );
|
|
Parameters
hdc
Identifies a device context.
hmf
Identifies a Windows-format metafile.
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.
A Windows-format metafile can be played multiple times.
A Windows-format metafile can be embedded in a second Windows-format metafile
by calling the PlayMetaFile function and playing the source metafile into the device context for the
target metafile.
Any object created but not deleted in the Windows-format metafile is deleted
by this function.
To stop this function, an application can call the CancelDC function from another thread to terminate the operation. In this case, the
function returns FALSE.
See Also
BeginPath, CancelDC, 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
|