Structure OLEUIINSERTOBJECTA (oledlg.h)
Contient les informations que la bibliothèque d’interface utilisateur OLE utilise pour initialiser la boîte de dialogue Insérer un objet et l’espace pour que la bibliothèque retourne des informations lorsque la boîte de dialogue est ignorée.
Syntaxe
typedef struct tagOLEUIINSERTOBJECTA {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCSTR lpszTemplate;
HRSRC hResource;
CLSID clsid;
LPSTR lpszFile;
UINT cchFile;
UINT cClsidExclude;
LPCLSID lpClsidExclude;
IID iid;
DWORD oleRender;
LPFORMATETC lpFormatEtc;
LPOLECLIENTSITE lpIOleClientSite;
LPSTORAGE lpIStorage;
LPVOID *ppvObj;
SCODE sc;
HGLOBAL hMetaPict;
} OLEUIINSERTOBJECTA, *POLEUIINSERTOBJECTA, *LPOLEUIINSERTOBJECTA;
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, 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 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 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. Renseigné sur la sortie.
lpszFile
Pointeur vers le nom du fichier à lier ou à intégrer. Renseigné 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 lors de la création de 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 lors de la création de 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 pointeur de sortie qui contient le pointeur d’interface de l’objet en cours d’insertion. 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, s’il n’a pas été placé dans le cache de l’objet.
Remarques
Notes
L’en-tête oledlg.h définit OLEUIINSERTOBJECT 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 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | oledlg.h |