Structure OLEUICONVERTA (oledlg.h)
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 tagOLEUICONVERTA {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCSTR lpszTemplate;
HRSRC hResource;
CLSID clsid;
CLSID clsidConvertDefault;
CLSID clsidActivateDefault;
CLSID clsidNew;
DWORD dvAspect;
WORD wFormat;
BOOL fIsLinkedObject;
HGLOBAL hMetaPict;
LPSTR lpszUserType;
BOOL fObjectsIconChanged;
LPSTR lpszDefLabel;
UINT cClsidExclude;
LPCLSID lpClsidExclude;
} OLEUICONVERTA, *POLEUICONVERTA, *LPOLEUICONVERTA;
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.
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 |