Funzione EnumMetaFile (wingdi.h)

Articolo
03/04/2024

La funzione EnumMetaFile enumera i record all'interno di un metafile in formato Windows recuperando ogni record e passandolo alla funzione di callback specificata. La funzione callback fornita dall'applicazione elabora ogni record in base alle esigenze. L'enumerazione continua fino a quando l'ultimo record viene elaborato o quando la funzione di callback restituisce zero.

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

Sintassi

BOOL EnumMetaFile(
  [in] HDC        hdc,
  [in] HMETAFILE  hmf,
  [in] MFENUMPROC proc,
  [in] LPARAM     param
);

Parametri

[in] hdc

Handle per un contesto di dispositivo. Questo handle viene passato alla funzione di callback.

[in] hmf

Gestire un metafile in formato Windows.

[in] proc

Puntatore a una funzione di callback fornita dall'applicazione. Per altre informazioni, vedere EnumMetaFileProc.

[in] param

Puntatore ai dati facoltativi.

Valore restituito

Se la funzione di callback enumera correttamente tutti i record nel metafile in formato Windows, il valore restituito è diverso da zero.

Se la funzione di callback non enumera correttamente tutti i record nel metafile in formato Windows, il valore restituito è zero.

Commenti

Per convertire un metafile in formato Windows in un metafile con formato avanzato, usare la funzione SetWinMetaFileBits .

È possibile usare la funzione EnumMetaFile per incorporare un metafile in formato Windows all'interno di un altro.

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