Funzione SetWinMetaFileBits (wingdi.h)

Articolo
03/13/2024

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