Funzione SetMetaFileBitsEx (wingdi.h)

Articolo
03/13/2024

La funzione SetMetaFileBitsEx crea un metafile in formato Windows basato sulla memoria dai dati forniti.

Nota Questa funzione viene fornita solo per la compatibilità con metafile in formato Windows. I metafile con formato avanzato offrono funzionalità superiori e sono consigliate per le nuove applicazioni. La funzione corrispondente per un metafile con formato avanzato è SetEnhMetaFileBits.

Sintassi

HMETAFILE SetMetaFileBitsEx(
  [in] UINT       cbBuffer,
  [in] const BYTE *lpData
);

Parametri

[in] cbBuffer

Specifica le dimensioni, in byte, del metafile in formato Windows.

[in] lpData

Puntatore a un buffer contenente il metafile in formato Windows. Si presuppone che i dati siano stati ottenuti usando la funzione GetMetaFileBitsEx .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per un metafile in formato Windows basato sulla memoria.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Per convertire un metafile in formato Windows in un metafile con formato avanzato, usare la funzione SetWinMetaFileBits .

Quando l'applicazione non ha più bisogno dell'handle metafile restituito da SetMetaFileBitsEx, deve eliminarlo chiamando la funzione DeleteMetaFile .

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