Funzione CreateMetaFileA (wingdi.h)

Articolo
08/27/2023

La funzione CreateMetaFile crea un contesto di dispositivo per un metafile in formato Windows.

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

Sintassi

HDC CreateMetaFileA(
  [in] LPCSTR pszFile
);

Parametri

[in] pszFile

Puntatore al nome file per il metafile in formato Windows da creare. Se questo parametro è NULL, il metafile in formato Windows è basato sulla memoria e il relativo contenuto viene perso quando viene eliminato tramite la funzione DeleteMetaFile .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il contesto di dispositivo per il metafile in formato Windows.

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

Commenti

Dove gli argomenti di testo devono usare caratteri Unicode, usare la funzione CreateMetaFile come funzione a caratteri wide. Dove gli argomenti di testo devono usare caratteri del set di caratteri di Windows, usare questa funzione come funzione ANSI.

CreateMetaFile è una funzione metafile in formato Windows. Questa funzione supporta solo applicazioni basate su Windows a 16 bit, elencate in Metafile in formato Windows. Non registra o riproduce funzioni GDI come PolyBezier, che non fanno parte di Windows a 16 bit.

Il contesto di dispositivo creato da questa funzione può essere usato per registrare le funzioni di output GDI in un metafile in formato Windows. Non può essere usata con funzioni di query GDI, ad esempio GetTextColor. Quando il contesto di dispositivo viene usato con una funzione di output GDI, il valore restituito di tale funzione diventa TRUE se la funzione viene registrata e FALSE in caso contrario. Quando un oggetto viene selezionato utilizzando la funzione SelectObject , viene registrata solo una copia dell'oggetto. L'oggetto appartiene ancora all'applicazione.

Per creare un metafile in formato Windows scalabile, registrare l'output grafico nella modalità di mapping MM_ANISOTROPIC. Il file non può contenere funzioni che modificano l'origine e gli extent del riquadro di visualizzazione, né possono contenere funzioni dipendenti dal dispositivo, ad esempio la funzione SelectClipRgn . Dopo la creazione, il metafile di Windows può essere ridimensionato e sottoposto a rendering in qualsiasi formato di dispositivo di output definendo l'origine e gli extent del riquadro di visualizzazione dell'immagine prima di riprodurre l'immagine.

Nota

L'intestazione wingdi.h definisce CreateMetaFile come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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