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

Configuration requise

Voir aussi

OleUIInsertObject