Structure OLEUIINSERTOBJECTA (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 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 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.

Valeur	Signification
IOF_SHOWHELP	La boîte de dialogue affiche un bouton Aide.
IOF_SELECTCREATENEW	La case d’option Créer une sera initialement cochée. Cela ne peut pas être utilisé avec IOF_SELECTCREATEFROMFILE.
IOF_SELECTCREATEFROMFILE	La case d’option Créer à partir d’un fichier sera initialement cochée. Cela ne peut pas être utilisé avec IOF_SELECTCREATENEW.
IOF_CHECKLINK	La case à cocher Lier sera initialement cochée.
IOF_CHECKDISPLAYASICON	La case à cocher Afficher en tant qu’icône sera initialement cochée, l’icône active s’affiche et le bouton Modifier l’icône sera activé.
IOF_CREATENEWOBJECT	Un nouvel objet doit être créé lorsque l’utilisateur sélectionne OK pour ignorer la boîte de dialogue et la case d’option Créer un nouveau a été sélectionnée.
IOF_CREATEFILEOBJECT	Un nouvel objet doit être créé à partir du fichier spécifié lorsque l’utilisateur sélectionne OK pour ignorer la boîte de dialogue et que la case d’option Créer à partir d’un fichier a été sélectionnée.
IOF_CREATELINKOBJECT	Un nouvel objet lié doit être créé lorsque l’utilisateur sélectionne OK pour ignorer la boîte de dialogue et l’utilisateur a coché la case Lien.
IOF_DISABLELINK	La case à cocher Lier est désactivée lors de l’initialisation.
IOF_VERIFYSERVERSEXIST	La boîte de dialogue doit valider les classes qu’elle ajoute à la zone de liste en veillant à ce que le serveur spécifié dans la base de données d’inscription existe. Il s’agit d’un facteur de performance significatif.
IOF_DISABLEDISPLAYASICON	La case à cocher Afficher en tant qu’icône est désactivée lors de l’initialisation.
IOF_HIDECHANGEICON	Le bouton Modifier l’icône est masqué dans la boîte de dialogue Insérer un objet.
IOF_SHOWINSERTCONTROL	Affiche la case d’option Insérer un contrôle.
IOF_SELECTCREATECONTROL	Affiche la case d’option Créer un contrôle.

hWndOwner

Fenêtre propriétaire de la boîte de dialogue. Ce membre ne doit pas être NULL.

lpszCaption

Pointeur vers une chaîne à utiliser comme titre de la boîte de dialogue. Si NULL, la bibliothèque utilise Insérer un objet.

lpfnHook

Pointeur vers une fonction de raccordement qui traite les messages destinés à la boîte de dialogue. La fonction de raccordement doit retourner zéro pour transmettre un message qu’elle n’a pas réappuché à la procédure de boîte de dialogue dans la bibliothèque. La fonction de 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 à 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 du modèle de boîte de dialogue à remplacer par le modèle de boîte de dialogue Insérer un objet modèle de boîte de dialogue.

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 incorporé. Renseigné sur la sortie.

cchFile

Taille de la mémoire tampon lpszFile ; ne dépasse pas MAX_PATH.

cClsidExclude

Nombre de CLSID inclus dans la liste lpClsidExclude. Renseigné sur 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 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 emblématique, s’il n’a pas été placé dans le cache de l’objet.

Remarques

Note

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	oledlg.h

Voir aussi

OleUIInsertObject