Funzione GetEnhMetaFileDescriptionA (wingdi.h)

Articolo
11/20/2024

La funzione GetEnhMetaFileDescription recupera una descrizione di testo facoltativa da un metafile in formato avanzato e copia la stringa nel buffer specificato.

Sintassi

UINT GetEnhMetaFileDescriptionA(
  [in]  HENHMETAFILE hemf,
  [in]  UINT         cchBuffer,
  [out] LPSTR        lpDescription
);

Parametri

[in] hemf

Handle per il metafile avanzato.

[in] cchBuffer

Dimensioni, in caratteri, del buffer per ricevere i dati. Verranno copiati solo questi molti caratteri.

[out] lpDescription

Puntatore a un buffer che riceve la descrizione del testo facoltativa.

Valore restituito

Se la descrizione del testo facoltativa esiste e il puntatore al buffer è NULL, il valore restituito è la lunghezza della stringa di testo, espressa in caratteri.

Se la descrizione del testo facoltativa esiste e il puntatore del buffer è un puntatore valido, il valore restituito corrisponde al numero di caratteri copiati nel buffer.

Se la descrizione del testo facoltativa non esiste, il valore restituito è zero.

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

Osservazioni

La descrizione del testo facoltativa contiene due stringhe, la prima che identifica l'applicazione che ha creato il metafile avanzato e la seconda che identifica l'immagine contenuta nel metafile. Le stringhe sono separate da un carattere Null e terminate con due caratteri Null, ad esempio "XYZ Graphics Editor\0Bald Eagle\0\0" dove \0 rappresenta il carattere Null.

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.

Nota

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

CreateEnhMetaFile

funzioni metafile

Panoramica Metafiles

Condividi tramite