GetEnhMetaFileHeader, fonction (wingdi.h)

  • Article

La fonction GetEnhMetaFileHeader récupère l’enregistrement contenant l’en-tête du métafichier au format amélioré spécifié.

Syntaxe

UINT GetEnhMetaFileHeader(
  [in]  HENHMETAFILE    hemf,
  [in]  UINT            nSize,
  [out] LPENHMETAHEADER lpEnhMetaHeader
);

Paramètres

[in] hemf

Handle du métafichier amélioré pour lequel l’en-tête doit être récupéré.

[in] nSize

Taille, en octets, de la mémoire tampon à recevoir les données. Seuls ces octets seront copiés.

[out] lpEnhMetaHeader

Pointeur vers une structure ENHMETAHEADER qui reçoit l’enregistrement d’en-tête. Si ce paramètre a la valeur NULL, la fonction retourne la taille de l’enregistrement d’en-tête.

Valeur retournée

Si la fonction réussit et que le pointeur de structure a la valeur NULL, la valeur renvoyée correspond à la taille de l’enregistrement qui contient l’en-tête ; si le pointeur de structure est un pointeur valide, la valeur renvoyée est le nombre d’octets copiés. Sinon, c’est zéro.

Remarques

Un en-tête enhanced-metafile contient des informations telles que la taille du métafichier, en octets ; dimensions de l’image stockée dans le métafichier ; le nombre d’enregistrements stockés dans le métafichier ; décalage par rapport à la description de texte facultative ; la taille de la palette facultative et la résolution de l’appareil sur lequel l’image a été créée.

L’enregistrement qui contient l’en-tête enhanced-metafile est toujours le premier enregistrement du métafichier.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

ENHMETAHEADER

Fonctions de métafichier

Vue d’ensemble des métafichiers

PlayEnhMetaFile