Funzione CreateMetaFileA (wingdi.h)

Articolo
11/20/2024

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

Nota Questa funzione viene fornita solo per compatibilità con i metafile in formato Windows. I metafile con 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 del 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.

Osservazioni

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 Windows-Format Metafile. Non registra o riproduce funzioni GDI, ad esempio 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 usato 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é può contenere funzioni dipendenti dal dispositivo, ad esempio la funzione SelectClipRgn. Una volta creato, il metafile di Windows può essere ridimensionato e sottoposto a rendering in qualsiasi formato di dispositivo di output definendo l'origine del riquadro di visualizzazione e gli extent 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wingdi.h (include Windows.h)
libreria	Gdi32.lib
dll	Gdi32.dll