Structure OLEUICONVERTW (oledlg.h)

Article
03/01/2024

Contient des informations que la bibliothèque d’interface utilisateur OLE utilise pour initialiser la boîte de dialogue Convertir et de l’espace pour que la bibliothèque retourne des informations lorsque la boîte de dialogue est ignorée.

Syntaxe

typedef struct tagOLEUICONVERTW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPWSTR        lpszUserType;
  BOOL          fObjectsIconChanged;
  LPWSTR        lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTW, *POLEUICONVERTW, *LPOLEUICONVERTW;

Membres

cbStruct

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

dwFlags

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

Valeur	Signification
CF_SHOWHELPBUTTON	La boîte de dialogue affiche un bouton Aide . Cet indicateur est défini sur l’entrée.
CF_SETCONVERTDEFAULT	La classe dont le CLSID est spécifié par clsidConvertDefault sera utilisée comme sélection par défaut. Cette sélection apparaît dans la zone de liste de classe lorsque la case d’option Convertir en est sélectionnée. Cet indicateur est défini sur l’entrée.
CF_SETACTIVATEDEFAULT	La classe dont le CLSID est spécifié par clsidActivateDefault sera utilisée comme sélection par défaut. Cette sélection apparaît dans la zone de liste de classe lorsque la case d’option Activer en tant que est sélectionnée. Cet indicateur est défini sur l’entrée.
CF_SELECTCONVERTTO	Lors de l’entrée, cet indicateur spécifie que Convertir en sera initialement sélectionné (comportement par défaut). Cet indicateur est défini sur la sortie si Convertir en a été sélectionné lorsque l’utilisateur a ignoré la boîte de dialogue.
CF_SELECTACTIVATEAS	Lors de l’entrée, cet indicateur spécifie que l’option Activer sous sera initialement sélectionnée. Cet indicateur est défini sur la sortie si l’option Activer en tant que a été sélectionnée lorsque l’utilisateur a ignoré la boîte de dialogue.
CF_DISABLEDISPLAYASICON	Le bouton Afficher en tant qu’icône sera désactivé lors de l’initialisation.
CF_DISABLEACTIVATEAS	La case d’option Activer en tant que est désactivée lors de l’initialisation.
CF_HIDECHANGEICON	Le bouton Modifier l’icône est masqué dans la boîte de dialogue Convertir .
CF_CONVERTONLY	La case d’option Activer en tant que est désactivée dans la boîte de dialogue Convertir .

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 Convert.

lpfnHook

Pointeur vers une fonction de raccordement qui traite les messages destinés à la boîte de dialogue. La fonction hook doit retourner zéro pour transmettre un message qu’elle n’a pas retransmise à 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 hook pointée par le membre lpfnHook . La bibliothèque transmet un pointeur à la structure OLEUICONVERT 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 lpszTemplate . Ce membre est ignoré si le membre lpszTemplate est NULL ou non valide.

lpszTemplate

Pointeur vers une chaîne terminée par un caractère 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 Convertir de la bibliothèque.

hResource

Handle de ressource pour une boîte de dialogue personnalisée. Si ce membre a la valeur NULL, la bibliothèque utilise le modèle de boîte de dialogue Convertir standard ou, s’il est valide, le modèle nommé par le membre lpszTemplate .

clsid

CLSID de l’objet à convertir ou à activer. Ce membre est défini sur l’entrée.

clsidConvertDefault

CLSID à utiliser comme classe par défaut lorsque Convertir en est sélectionné. Ce membre est ignoré si le membre dwFlags n’inclut pas CF_SETCONVERTDEFAULT. Ce membre est défini sur l’entrée.

clsidActivateDefault

CLSID à utiliser comme classe par défaut lorsque l’option Activer sous est sélectionnée. Ce membre est ignoré si le membre dwFlags n’inclut pas CF_SETACTIVATEDEFAULT. Ce membre est défini sur l’entrée.

clsidNew

CLSID de la classe sélectionnée. Ce membre est défini sur la sortie.

dvAspect

Aspect de l’objet. Ce doit être DVASPECT_CONTENT ou DVASPECT_ICON. Si dvAspect est DVASPECT_ICON lors de l’entrée, la case Icône Afficher sous est cochée et l’icône de l’objet s’affiche. Ce membre est défini sur l’entrée et la sortie. Pour plus d’informations, consultez DVASPECT.

wFormat

Format de données de l’objet à convertir ou à activer.

fIsLinkedObject

TRUE si l’objet est lié. Ce membre est défini sur l’entrée.

hMetaPict

METAFILEPICT contenant l’aspect iconique. Ce membre est défini sur l’entrée et la sortie.

lpszUserType

Pointeur vers le nom de type d’utilisateur de l’objet à convertir ou à activer. Si cette valeur est NULL, la boîte de dialogue récupère le nom du type d’utilisateur dans le Registre. Cette chaîne est libérée à la sortie.

fObjectsIconChanged

TRUE si l’icône de l’objet a changé. (autrement dit, si OleUIChangeIcon a été appelé et n’a pas été annulé.). Ce membre est défini sur la sortie.

lpszDefLabel

Pointeur vers l’étiquette par défaut à utiliser pour l’icône. Si la valeur est NULL, le nom de type d’utilisateur court est utilisé. Si l’objet est un lien, l’appelant doit transmettre le nom complet de la source du lien. Il est libéré lors de la sortie.

cClsidExclude

Nombre de CLSID dans lpClsidExclude.

lpClsidExclude

Pointeur vers la liste des CLSID à exclure de la liste.

Remarques

Notes

L’en-tête oledlg.h définit OLEUICONVERT en tant qu’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. La combinaison 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 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	oledlg.h

Voir aussi

OleUIChangeIcon

OleUIConvert

Share via