OleMetafilePictFromIconAndLabel, fonction (ole2.h)

Crée un métafichier dans lequel l’icône et l’étiquette spécifiées sont dessinées.

Syntaxe

HGLOBAL OleMetafilePictFromIconAndLabel(
  [in] HICON    hIcon,
  [in] LPOLESTR lpszLabel,
  [in] LPOLESTR lpszSourceFile,
  [in] UINT     iIconIndex
);

Paramètres

[in] hIcon

Gérez l’icône qui doit être dessinée dans le métafichier. Ce paramètre peut être NULL. Si hIcon a la valeur NULL, cette fonction retourne NULL sans créer de métafichier.

[in] lpszLabel

Étiquette d’icône. Ce paramètre peut être NULL. Si lpszLabel a la valeur NULL, le métafichier résultant n’inclut pas d’étiquette.

[in] lpszSourceFile

Chemin d’accès et nom de fichier du fichier d’icône. Cette chaîne peut être obtenue via l’interface utilisateur ou à partir de la base de données d’inscription. Ce paramètre peut être NULL.

[in] iIconIndex

Emplacement de l’icône dans le fichier nommé par lpszSourceFile, exprimé sous forme de décalage en octets par rapport au début du fichier.

Valeur retournée

Handle global vers une structure METAFILEPICT contenant l’icône et l’étiquette. Le métafichier utilise le mode de mappage MM_ANISOTROPIC.

Si une erreur se produit, le handle retourné est NULL. Dans ce cas, l’appelant peut appeler GetLastError pour obtenir des informations supplémentaires.

Remarques

Cette fonction est appelée par OleGetIconOfFile et OleGetIconOfClass.

Si lpszSourceFile n’a pas la valeur NULL et iIconIndex n’a pas la valeur 0, le nom du fichier source transmis dans lpszSourceFile et l’index transmis par iIconIndex sont ajoutés au métafichier créé en tant qu’enregistrement de commentaire.

Configuration requise

Voir aussi

OleGetIconOfClass

OleGetIconOfFile