Funzione GetWinMetaFileBits (wingdi.h)
La funzione GetWinMetaFileBits converte i record in formato avanzato da un metafile in record in formato Windows e archivia i record convertiti nel buffer specificato.
Sintassi
UINT GetWinMetaFileBits(
[in] HENHMETAFILE hemf,
[in] UINT cbData16,
[out] LPBYTE pData16,
[in] INT iMapMode,
[in] HDC hdcRef
);
Parametri
[in] hemf
Handle per il metafile avanzato.
[in] cbData16
Dimensione, in byte, del buffer in cui devono essere copiati i record convertiti.
[out] pData16
Puntatore al buffer che riceve i record convertiti. Se lpbBuffer è NULL, GetWinMetaFileBits restituisce il numero di byte necessari per archiviare i record metafile convertiti.
[in] iMapMode
Modalità di mapping da utilizzare nel metafile convertito.
[in] hdcRef
Handle per il contesto del dispositivo di riferimento.
Valore restituito
Se la funzione ha esito positivo e il puntatore del buffer è NULL, il valore restituito è il numero di byte necessari per archiviare i record convertiti; se la funzione ha esito positivo e il puntatore al buffer è un puntatore valido, il valore restituito corrisponde alle dimensioni dei dati del metafile in byte.
Se la funzione ha esito negativo, il valore restituito è zero.
Commenti
Questa funzione converte un metafile avanzato in un metafile in formato Windows in modo che l'immagine possa essere visualizzata in un'applicazione che riconosce il formato precedente.
Il sistema usa il contesto del dispositivo di riferimento per determinare la risoluzione del metafile convertito.
La funzione GetWinMetaFileBits non invalida l'handle metafile avanzato. Un'applicazione deve chiamare la funzione DeleteEnhMetaFile per rilasciare l'handle quando non è più necessario.
Per creare un metafile in formato Windows scalabile, specificare MM_ANISOTROPIC come parametro fnMapMode .
L'angolo superiore sinistro dell'immagine del metafile viene sempre mappato all'origine del dispositivo di riferimento.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wingdi.h (include Windows.h) |
| Libreria | Gdi32.lib |
| DLL | Gdi32.dll |