Structure OLEUIINSERTOBJECTW (oledlg.h)
Contient des informations que la bibliothèque d’interface utilisateur OLE utilise pour initialiser la boîte de dialogue Insérer un objet et un espace pour que la bibliothèque retourne des informations lorsque la boîte de dialogue est ignorée.
Syntaxe
typedef struct tagOLEUIINSERTOBJECTW {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCWSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCWSTR lpszTemplate;
HRSRC hResource;
CLSID clsid;
LPWSTR lpszFile;
UINT cchFile;
UINT cClsidExclude;
LPCLSID lpClsidExclude;
IID iid;
DWORD oleRender;
LPFORMATETC lpFormatEtc;
LPOLECLIENTSITE lpIOleClientSite;
LPSTORAGE lpIStorage;
LPVOID *ppvObj;
SCODE sc;
HGLOBAL hMetaPict;
} OLEUIINSERTOBJECTW, *POLEUIINSERTOBJECTW, *LPOLEUIINSERTOBJECTW;
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, 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 Insert Object.
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 OLEUIINSERTOBJECT 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 Insérer un objet de la bibliothèque.
hResource
Handle de modèle personnalisé.
clsid
CLSID pour la classe de l’objet à insérer. Rempli sur la sortie.
lpszFile
Pointeur vers le nom du fichier à lier ou à intégrer. Rempli sur la sortie.
cchFile
Taille de la mémoire tampon lpszFile ; ne dépassera pas MAX_PATH.
cClsidExclude
Nombre de CLSID inclus dans la liste lpClsidExclude . Rempli lors de l’entrée.
lpClsidExclude
Pointeur vers une liste de CLSID à exclure de la liste.
iid
Identificateur de l’interface demandée. Si OleUIInsertObject crée l’objet, il retourne un pointeur vers cette interface. Ce paramètre est ignoré si OleUIInsertObject ne crée pas l’objet .
oleRender
Option de rendu. Si OleUIInsertObject crée l’objet, il sélectionne l’option de rendu lorsqu’il crée l’objet. Ce paramètre est ignoré si OleUIInsertObject ne crée pas l’objet .
lpFormatEtc
Format souhaité. Si OleUIInsertObject crée l’objet, il sélectionne le format lorsqu’il crée l’objet. Ce paramètre est ignoré si OleUIInsertObject ne crée pas l’objet .
lpIOleClientSite
Pointeur vers le site client à utiliser pour l’objet . Ce paramètre est ignoré si OleUIInsertObject ne crée pas l’objet .
lpIStorage
Pointeur vers le stockage à utiliser pour l’objet . Ce paramètre est ignoré si OleUIInsertObject ne crée pas l’objet .
ppvObj
Adresse de la variable de pointeur de sortie qui contient le pointeur d’interface pour l’objet inséré. Ce paramètre est ignoré si OleUIInsertObject ne crée pas l’objet .
sc
Résultat des appels de création. Ce paramètre est ignoré si OleUIInsertObject ne crée pas l’objet .
hMetaPict
Structure MetafilePict contenant l’aspect iconique, si elle n’a pas été placée dans le cache de l’objet.
Remarques
Notes
L’en-tête oledlg.h définit OLEUIINSERTOBJECT 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. 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 |