Funzione CopyMetaFileA (wingdi.h)

Articolo
11/20/2024

La funzione CopyMetaFile copia il contenuto di un metafile in formato Windows nel file specificato.

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 è CopyEnhMetaFile.

Sintassi

HMETAFILE CopyMetaFileA(
  [in] HMETAFILE unnamedParam1,
  [in] LPCSTR    unnamedParam2
);

Parametri

[in] unnamedParam1

Handle per il metafile in formato Windows di origine.

[in] unnamedParam2

Puntatore al nome del file di destinazione. Se questo parametro è NULL, il metafile di origine viene copiato in memoria.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per la copia del 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 questa funzione 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.

Quando l'applicazione non necessita più dell'handle metafile in formato Windows, deve eliminare l'handle chiamando la funzione DeleteMetaFile.

Nota

L'intestazione wingdi.h definisce CopyMetaFile 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

Vedere anche

DeleteMetaFile

funzioni metafile

Panoramica Metafiles

Condividi tramite