|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| gdi32.lib
| Header File
| wingdi.h
| Unicode
| No
| Platform Notes
| None
|
|
|
SetWinMetaFileBits
The SetWinMetaFileBits function converts a metafile from the older Windows format to the new
enhanced format and stores the new metafile in memory.
HENHMETAFILE SetWinMetaFileBits(
UINT cbBuffer,
| // size of buffer
| CONST BYTE *lpbBuffer,
| // address of buffered metafile data
| HDC hdcRef,
| // handle of reference device context
| CONST METAFILEPICT *lpmfp
| // suggested size of metafile picture
| );
|
|
Parameters
cbBuffer
Specifies the size, in bytes, of the buffer that contains the Windows-format
metafile.
lpbBuffer
Points to a buffer that contains the Windows-format metafile data. (It is
assumed that the data was obtained by using the GetMetaFileBitsEx or GetWinMetaFileBits function.)
hdcRef
Identifies a reference device context.
lpmfp
Points to a METAFILEPICT structure that contains the suggested size of the metafile picture and the
mapping mode that was used when the picture was created.
Return Values
If the function succeeds, the return value is a handle of a memory-based
enhanced metafile.
If the function fails, the return value is NULL. To get extended error
information, call GetLastError.
Remarks
Windows uses the reference device context's resolution data and the data in
the METAFILEPICT structure to scale a picture. If the hdcRef parameter is NULL, Windows uses resolution data for the current output
device. If the lpmfp parameter is NULL, Windows uses the MM_ANISOTROPIC mapping mode to scale the
picture so that it fits the entire device surface. The hMF field in the METAFILEPICT structure is not used.
When the application no longer needs the enhanced metafile handle, it should
delete it by calling the DeleteEnhMetaFile function.
The handle returned by this function can be used with other enhanced-metafile
functions.
If the reference device context is not identical to the device in which the
metafile was originally created, some GDI functions that use device units may not
draw the picture correctly.
See Also
DeleteEnhMetaFile, GetWinMetaFileBits, GetMetaFileBitsEx, METAFILEPICT, PlayEnhMetaFile
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
|
