Structure OLEUICHANGEICONW (oledlg.h)

Contient des informations que la bibliothèque d’interface utilisateur OLE utilise pour initialiser la boîte de dialogue Icône de modification , et elle contient de l’espace pour que la bibliothèque retourne des informations lorsque la boîte de dialogue est ignorée.

Syntaxe

typedef struct tagOLEUICHANGEICONW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  WCHAR         szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONW, *POLEUICHANGEICONW, *LPOLEUICHANGEICONW;

Membres

cbStruct

Taille de la structure, en octets. Ce champ doit être renseigné lors de l’entrée.

dwFlags

En entrée, spécifie les indicateurs d’initialisation et de création. À la sortie, il spécifie les choix de l’utilisateur. Il peut s’agir d’une combinaison des indicateurs suivants.

Valeur	Signification
CIF_SHOWHELP	La boîte de dialogue affiche un bouton Aide .
CIF_SELECTCURRENT	Lors de l’entrée, sélectionne la case d’option Actuel lors de l’initialisation. Lors de la sortie, spécifie que l’utilisateur a sélectionné Actuel.
CIF_SELECTDEFAULT	Lors de l’entrée, sélectionne la case d’option Par défaut lors de l’initialisation. À la sortie, spécifie que l’utilisateur a sélectionné Par défaut.
CIF_SELECTFROMFILE	Lors de l’entrée, sélectionne la case d’option À partir du fichier lors de l’initialisation. À la sortie, spécifie que l’utilisateur a sélectionné À partir du fichier.
CIF_USEICONEXE	Entrée uniquement. Extrait l’icône de l’exécutable spécifié dans le membre szIconExe , au lieu de la récupérer à partir de la classe . Cela est utile pour l’incorporation ou la liaison OLE à des fichiers non OLE.

hWndOwner

Fenêtre qui possède la boîte de dialogue. Ce membre ne doit pas avoir la valeur NULL.

lpszCaption

Pointeur vers une chaîne à utiliser comme titre de la boîte de dialogue. Si la valeur est NULL, la bibliothèque utilise l’icône Modifier.

lpfnHook

Pointeur vers une fonction de crochet qui traite les messages destinés à la boîte de dialogue. La fonction de hook doit retourner zéro pour transmettre un message qu’elle n’a pas traité à la procédure de boîte de dialogue dans la bibliothèque. La fonction hook doit retourner une valeur différente de zéro pour empêcher la procédure de boîte de dialogue de la bibliothèque de traiter un message qu’elle a déjà traité.

lCustData

Données définies par l’application que la bibliothèque transmet à la fonction de hook pointée par le membre lpfnHook . La bibliothèque transmet un pointeur vers la structure OLEUICHANGEICON dans le paramètre lParam du message WM_INITDIALOG ; ce pointeur peut être utilisé pour récupérer le membre lCustData .

hInstance

Instance qui contient un modèle de boîte de dialogue spécifié par le membre lpTemplateName .

lpszTemplate

Pointeur vers une chaîne terminée par null qui spécifie le nom du fichier de ressources pour le modèle de boîte de dialogue qui doit être remplacé par le modèle de boîte de dialogue Icône de modification de la bibliothèque.

hResource

Handle de modèle personnalisé.

hMetaPict

Image actuelle et finale. La source de l’icône est incorporée dans le métafichier lui-même.

clsid

Entrée uniquement. Classe à utiliser pour obtenir l’icône Par défaut .

szIconExe[MAX_PATH]

Entrée uniquement. Pointeur vers l’exécutable à partir duquel extraire l’icône par défaut. Ce membre est ignoré, sauf si CIF_USEICONEXE est inclus dans le membre dwFlags et qu’une tentative de récupération de l’icône de classe à partir du CLSID spécifié échoue.

cchIconExe

Entrée uniquement. Nombre de caractères dans szIconExe. Ce membre est ignoré, sauf si CIF_USEICONEXE est inclus dans le membre dwFlags .

Remarques

Notes

L’en-tête oledlg.h définit OLEUICHANGEICON comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
En-tête	oledlg.h