Funzione EnumEnhMetaFile (wingdi.h)

Articolo
03/08/2023

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

Sintassi

BOOL EnumEnhMetaFile(
  [in] HDC           hdc,
  [in] HENHMETAFILE  hmf,
  [in] ENHMFENUMPROC proc,
  [in] LPVOID        param,
  [in] const RECT    *lpRect
);

Parametri

[in] hdc

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

[in] hmf

Handle per un enhanced metafile.

[in] proc

Puntatore alla funzione di callback fornita dall'applicazione. Per altre informazioni, vedere la funzione EnhMetaFileProc .

[in] param

Puntatore ai dati facoltativi della funzione di callback.

[in] lpRect

Puntatore a una struttura RECT che specifica le coordinate, in unità logiche, degli angoli superiore sinistro e inferiore destro dell'immagine.

Valore restituito

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

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

Commenti

I punti lungo il bordo del rettangolo a cui punta il parametro lpRect sono inclusi nell'immagine. Se il parametro hdc è NULL, il sistema ignora lpRect.

Se la funzione di callback chiama la funzione PlayEnhMetaFileRecord , hdc deve identificare un contesto di dispositivo valido. Il sistema usa la modalità di trasformazione e mapping del contesto di dispositivo per trasformare l'immagine visualizzata dalla funzione PlayEnhMetaFileRecord .

È possibile usare la funzione EnumEnhMetaFile per incorporare un metafile avanzato all'interno di un altro.

Requisiti


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