Funzione SetWinMetaFileBits (wingdi.h)
La funzione SetWinMetaFileBits converte un metafile dal formato Windows precedente al nuovo formato avanzato e archivia il nuovo metafile in memoria.
Sintassi
HENHMETAFILE SetWinMetaFileBits(
[in] UINT nSize,
[in] const BYTE *lpMeta16Data,
[in] HDC hdcRef,
[in] const METAFILEPICT *lpMFP
);
Parametri
[in] nSize
Dimensioni, in byte, del buffer che contiene il metafile in formato Windows.
[in] lpMeta16Data
Puntatore a un buffer contenente i dati metafile in formato Windows. Si presuppone che i dati siano stati ottenuti usando la funzione GetMetaFileBitsEx o GetWinMetaFileBits .
[in] hdcRef
Handle in un contesto di dispositivo di riferimento.
[in] lpMFP
Puntatore a una struttura METAFILEPICT contenente le dimensioni suggerite dell'immagine metafile e la modalità di mapping usata quando è stata creata l'immagine.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle per un metafile avanzato basato sulla memoria.
Se la funzione ha esito negativo, il valore restituito è NULL.
Commenti
Windows usa i dati di risoluzione del contesto del dispositivo di riferimento e i dati nella struttura METAFILEPICT per ridimensionare un'immagine. Se il parametro hdcRef è NULL, il sistema usa i dati di risoluzione per il dispositivo di output corrente. Se il parametro lpmfp è NULL, il sistema usa la modalità di mapping MM_ANISOTROPIC per ridimensionare l'immagine in modo che si adatta all'intera superficie del dispositivo. Il membro hMF della struttura METAFILEPICT non viene usato.
Quando l'applicazione non ha più bisogno dell'handle metafile avanzato, deve eliminarla chiamando la funzione DeleteEnhMetaFile .
L'handle restituito da questa funzione può essere usato con altre funzioni metafile avanzate.
Se il contesto del dispositivo di riferimento non è identico al dispositivo in cui è stato originariamente creato il metafile, alcune funzioni GDI che usano unità dispositivo potrebbero non disegnare correttamente l'immagine.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |