COleInsertDialog, classe

Utilisée pour la boîte de dialogue OLE Insérer un objet.

Syntaxe

class COleInsertDialog : public COleDialog

Membres

Constructeurs publics

Méthodes publiques

Membres de données publics

Notes

Créez un objet de classe COleInsertDialog lorsque vous souhaitez appeler cette boîte de dialogue. Une fois qu’un COleInsertDialog objet a été construit, vous pouvez utiliser la structure m_io pour initialiser les valeurs ou les états des contrôles dans la boîte de dialogue. La m_io structure est de type OLEUIINSERTOBJECT. Pour plus d’informations sur l’utilisation de cette classe de dialogue, consultez la fonction membre DoModal .

Pour plus d’informations, consultez la structure OLEUIINSERTOBJECT dans le Kit de développement logiciel (SDK) Windows.

Pour plus d’informations sur les boîtes de dialogue spécifiques à OLE, consultez l’article Boîtes de dialogue dans OLE.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleInsertDialog

Spécifications

En-tête : afxodlgs.h

COleInsertDialog ::COleInsertDialog

Cette fonction construit uniquement un COleInsertDialog objet.

COleInsertDialog (
    DWORD dwFlags = IOF_SELECTCREATENEW,
    CWnd* pParentWnd = NULL);

Paramètres

dwFlags
Indicateur de création qui contient un nombre quelconque des valeurs suivantes à combiner à l’aide de l’opérateur OR au niveau du bit :

• IOF_SHOWHELP Spécifie que le bouton d’aide s’affiche lorsque la boîte de dialogue est appelée.

• IOF_SELECTCREATENEW Spécifie que la case d’option Créer une option est sélectionnée initialement lorsque la boîte de dialogue est appelée. Il s’agit de la valeur par défaut et ne peut pas être utilisée avec IOF_SELECTCREATEFROMFILE.

• IOF_SELECTCREATEFROMFILE Spécifie que la case d’option Créer à partir d’un fichier sera sélectionnée initialement lorsque la boîte de dialogue est appelée. Impossible d’utiliser avec IOF_SELECTCREATENEW.

• IOF_CHECKLINK Spécifie que la case à cocher Lien est cochée initialement lorsque la boîte de dialogue est appelée.

• IOF_DISABLELINK Spécifie que la case à cocher Lien est désactivée lorsque la boîte de dialogue est appelée.

• IOF_CHECKDISPLAYASICON Spécifie que la case à cocher Afficher en tant qu’icône est cochée initialement, l’icône active s’affiche et le bouton Modifier l’icône est activé lorsque la boîte de dialogue est appelée.

• IOF_VERIFYSERVERSEXIST Spécifie que la boîte de dialogue doit valider les classes qu’elle ajoute à la zone de liste en veillant à ce que les serveurs spécifiés dans la base de données d’inscription existent avant l’affichage de la boîte de dialogue. La définition de cet indicateur peut affecter considérablement les performances.

pParentWnd
Pointe vers l’objet de fenêtre parent ou propriétaire (de type CWnd) auquel appartient l’objet de boîte de dialogue. S’il s’agit de NULL, la fenêtre parente de l’objet de boîte de dialogue est définie sur la fenêtre principale de l’application.

Notes

Pour afficher la boîte de dialogue, appelez la fonction DoModal .

COleInsertDialog ::CreateItem

Appelez cette fonction pour créer un objet de type COleClientItem uniquement si DoModal retourne IDOK.

BOOL CreateItem(COleClientItem* pItem);

Paramètres

pItem
Pointe vers l’élément à créer.

Valeur de retour

Différent de zéro si l’élément a été créé ; sinon 0.

Notes

Vous devez allouer l’objet COleClientItem avant de pouvoir appeler cette fonction.

COleInsertDialog ::D oModal

Appelez cette fonction pour afficher la boîte de dialogue Objet d’insertion OLE.

virtual INT_PTR
    DoModal();

INT_PTR
    DoModal(DWORD  dwFlags);

Paramètres

dwFlags
Une des valeurs suivantes :

COleInsertDialog::DocObjectsOnly insère uniquement DocObjects.

COleInsertDialog::ControlsOnly insère uniquement des contrôles ActiveX.

Zéro insère ni DocObject ni un contrôle ActiveX. Cette valeur entraîne la même implémentation que le premier prototype répertorié ci-dessus.

Valeur de retour

État d’achèvement de la boîte de dialogue. Une des valeurs suivantes :

• IDOK si la boîte de dialogue s’affiche correctement.

• IDCANCEL si l’utilisateur a annulé la boîte de dialogue.

• IDABORT si une erreur s’est produite. Si IDABORT est retourné, appelez la fonction membre COleDialog ::GetLastError pour obtenir plus d’informations sur le type d’erreur qui s’est produite. Pour obtenir la liste des erreurs possibles, consultez la fonction OleUIInsertObject dans le Kit de développement logiciel (SDK) Windows.

Notes

Si vous souhaitez initialiser les différents contrôles de boîte de dialogue en définissant les membres de la structure m_io , vous devez le faire avant d’appeler DoModal, mais après la construction de l’objet de dialogue.

Si DoModal cette propriété renvoie IDOK, vous pouvez appeler d’autres fonctions membres pour récupérer les paramètres ou l’entrée d’informations dans la boîte de dialogue par l’utilisateur.

COleInsertDialog ::GetClassID

Appelez cette fonction pour obtenir le CLSID associé à l’élément sélectionné uniquement si DoModal retourne IDOK et que le type de sélection est COleInsertDialog::createNewItem.

REFCLSID GetClassID() const;

Valeur de retour

Retourne le CLSID associé à l’élément sélectionné.

Notes

Pour plus d’informations, consultez clé CLSID dans le Kit de développement logiciel (SDK) Windows.

COleInsertDialog ::GetDrawAspect

Appelez cette fonction pour déterminer si l’utilisateur a choisi d’afficher l’élément sélectionné en tant qu’icône.

DVASPECT GetDrawAspect() const;

Valeur de retour

Méthode nécessaire pour restituer l’objet.

• DVASPECT_CONTENT Retourné si la case à cocher Afficher en tant qu’icône n’a pas été cochée.

• DVASPECT_ICON Retourné si la case à cocher Afficher en tant qu’icône a été cochée.

Notes

Appelez cette fonction uniquement si DoModal retourne IDOK.

Pour plus d’informations sur l’aspect du dessin, consultez la structure des données FORMATETC dans le Kit de développement logiciel (SDK) Windows.

COleInsertDialog ::GetIconicMetafile

Appelez cette fonction pour obtenir un handle au métafichier qui contient l’aspect emblématique de l’élément sélectionné.

HGLOBAL GetIconicMetafile() const;

Valeur de retour

Handle du métafichier contenant l’aspect emblématique de l’élément sélectionné, si la case à cocher Afficher en tant qu’icône a été cochée lorsque la boîte de dialogue a été ignorée en choisissant OK ; sinon NULL.

COleInsertDialog ::GetPathName

Appelez cette fonction pour obtenir le chemin complet du fichier sélectionné uniquement si DoModal retourne IDOK et que le type de sélection n’est pas COleInsertDialog::createNewItem.

CString GetPathName() const;

Valeur de retour

Chemin complet du fichier sélectionné dans la boîte de dialogue. Si le type de sélection est createNewItem, cette fonction retourne un mode CString de mise en production sans signification ou provoque une assertion en mode débogage.

COleInsertDialog ::GetSelectionType

Appelez cette fonction pour obtenir le type de sélection choisi lorsque la boîte de dialogue Insérer un objet a été ignorée en choisissant OK.

UINT GetSelectionType() const;

Valeur de retour

Type de sélection effectué.

Notes

Les valeurs de type de retour sont spécifiées par le Selection type d’énumération déclaré dans la COleInsertDialog classe.

enum Selection {
    createNewItem,
    insertFromFile,
    linkToFile
    };

Voici quelques descriptions de ces valeurs :

• COleInsertDialog::createNewItem La case d’option Créer une option a été sélectionnée.

• COleInsertDialog::insertFromFile La case d’option Créer à partir d’un fichier a été cochée et la case à cocher Lien n’a pas été cochée.

• COleInsertDialog::linkToFile La case d’option Créer à partir d’un fichier a été cochée et la case à cocher Lien a été cochée.

COleInsertDialog ::m_io

Structure de type OLEUIINSERTOBJECT utilisée pour contrôler le comportement de la boîte de dialogue Insérer un objet.

OLEUIINSERTOBJECT m_io;

Notes

Les membres de cette structure peuvent être modifiés directement ou via des fonctions membres.

Pour plus d’informations, consultez la structure OLEUIINSERTOBJECT dans le Kit de développement logiciel (SDK) Windows.

Voir aussi

Exemple OCLIENT MFC
COleDialog, classe
Graphique hiérarchique
COleDialog, classe