Condividi tramite


Funzione GetEnhMetaFileBits (wingdi.h)

La funzione GetEnhMetaFileBits recupera il contenuto del metafile di formato avanzato specificato e li copia in un buffer.

Sintassi

UINT GetEnhMetaFileBits(
  [in]  HENHMETAFILE hEMF,
  [in]  UINT         nSize,
  [out] LPBYTE       lpData
);

Parametri

[in] hEMF

Handle per il metafile avanzato.

[in] nSize

Dimensioni, in byte, del buffer per ricevere i dati.

[out] lpData

Puntatore a un buffer che riceve i dati del metafile. Il buffer deve essere sufficientemente grande per contenere i dati. Se lpbBuffer è NULL, la funzione restituisce le dimensioni necessarie per contenere i dati.

Valore restituito

Se la funzione ha esito positivo e il puntatore del buffer è NULL, il valore restituito è la dimensione del metafile avanzato, in byte.

Se la funzione ha esito positivo e il puntatore del buffer è un puntatore valido, il valore restituito è il numero di byte copiati nel buffer.

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

Commenti

Dopo aver recuperato i bit di metafile avanzati, è possibile usare per creare un metafile basato sulla memoria chiamando la funzione SetEnhMetaFileBits .

La funzione GetEnhMetaFileBits non invalida l'handle di metafile avanzato. L'applicazione deve chiamare la funzione DeleteEnhMetaFile per eliminare l'handle quando non è più necessario.

Il contenuto del metafile recuperato da questa funzione è nel formato avanzato. Per recuperare il contenuto del metafile nel formato Di Windows, usare la funzione GetWinMetaFileBits .

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

Vedi anche

DeleteEnhMetaFile

GetWinMetaFileBits

Funzioni metafile

Panoramica dei metafile

SetEnhMetaFileBits