Structure OLEUICHANGEICONW (oledlg.h)

Contient des informations que la bibliothèque d’interface utilisateur OLE utilise pour initialiser l’icône de modification boîte de dialogue et qu’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 rempli lors de l’entrée.

dwFlags

Lors de l’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électionnez la case d’option Actuelle lors de l’initialisation. À la sortie, spécifie que l’utilisateur a sélectionné actuel .
CIF_SELECTDEFAULT	Lors de l’entrée, sélectionnez 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électionnez la case d’option à partir d’un fichier lors de l’initialisation. À la sortie, spécifie que l’utilisateur a sélectionné à partir dufichier .
CIF_USEICONEXE	Entrée uniquement. Extrait l’icône de l’exécutable spécifié dans le membre szIconExe, au lieu de le récupérer à partir de la classe. Cela est utile pour l’incorporation OLE ou la liaison à des fichiers non OLE.

hWndOwner

Fenêtre propriétaire de la boîte de dialogue. Ce membre ne doit pas être NULL.

lpszCaption

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

lpfnHook

Pointeur vers une fonction de raccordement qui traite les messages destinés à la boîte de dialogue. La fonction de raccordement doit retourner zéro pour transmettre un message qu’elle n’a pas réappuché à la procédure de boîte de dialogue dans la bibliothèque. La fonction de 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 à 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 du modèle de boîte de dialogue à remplacer par le modèle de boîte de dialogue Icône de modification de la bibliothèque modèle de boîte de dialogue.

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 de 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

Note

L’en-tête oledlg.h définit OLEUICHANGEICON comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10 Build 20348
serveur minimum pris en charge	Windows 10 Build 20348
d’en-tête	oledlg.h