COleConvertDialog, classe

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

Syntaxe

class COleConvertDialog : public COleDialog

Membres

Constructeurs publics

Méthodes publiques

Membres de données publics

Notes

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

COleConvertDialog

Spécifications

En-tête : afxodlgs.h

COleConvertDialog ::COleConvertDialog

Construit uniquement un COleConvertDialog objet.

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

Paramètres

pItem
Pointe vers l’élément à convertir ou à activer.

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

• CF_SELECTCONVERTTO Spécifie que la case d’option Convertir en case d’option sera sélectionnée initialement lorsque la boîte de dialogue est appelée. Il s’agit de la valeur par défaut.

• CF_SELECTACTIVATEAS Spécifie que la case d’option Activer en tant que sera sélectionnée initialement lorsque la boîte de dialogue est appelée.

• CF_SETCONVERTDEFAULT Spécifie que la classe dont le CLSID est spécifié par le clsidConvertDefault membre de la m_cv structure sera utilisée comme sélection par défaut dans la zone de liste de classes lorsque la case d’option Convertir en case d’option est sélectionnée.

• CF_SETACTIVATEDEFAULT Spécifie que la classe dont le CLSID est spécifié par le clsidActivateDefault membre de la m_cv structure sera utilisée comme sélection par défaut dans la zone de liste de classes lorsque la case d’option Activer en tant que case d’option est sélectionnée.

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

pClassID
Pointe vers le CLSID de l’élément à convertir ou à activer. Si la valeur EST NULL, l’ID CLSID associé à pItem est utilisé.

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

Pour plus d’informations, consultez clé CLSID et la structure OLEUICONVERT .

COleConvertDialog ::D oConvert

Appelez cette fonction, après avoir retourné correctement à partir de DoModal, soit pour convertir ou activer un objet de type COleClientItem.

BOOL DoConvert(COleClientItem* pItem);

Paramètres

pItem
Pointe vers l’élément à convertir ou à activer. Ne peut pas avoir la valeur NULL.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

Notes

L’élément est converti ou activé en fonction des informations sélectionnées par l’utilisateur dans la boîte de dialogue Convertir.

COleConvertDialog ::D oModal

Appelez cette fonction pour afficher la boîte de dialogue OLE Convert.

virtual INT_PTR DoModal();

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 OleUIConvert 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_cv , vous devez le faire avant d’appeler DoModal, mais après la construction de l’objet de dialogue.

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

COleConvertDialog ::GetClassID

Appelez cette fonction pour obtenir le CLSID associé à l’élément sélectionné par l’utilisateur dans la boîte de dialogue Convertir.

REFCLSID GetClassID() const;

Valeur de retour

CLSID associé à l’élément sélectionné dans la boîte de dialogue Convertir.

Notes

Appelez cette fonction uniquement après que DoModal retourne IDOK.

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

COleConvertDialog ::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 après que DoModal retourne IDOK.

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

COleConvertDialog ::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 iconique 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.

COleConvertDialog ::GetSelectionType

Appelez cette fonction pour déterminer le type de conversion sélectionné dans la boîte de dialogue Convertir.

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

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Voici quelques descriptions de ces valeurs :

• COleConvertDialog::noConversion Retourné si la boîte de dialogue a été annulée ou si l’utilisateur n’a sélectionné aucune conversion. Si COleConvertDialog::DoModal l’IDOK est retourné, il est possible que l’utilisateur a sélectionné une icône différente de celle précédemment sélectionnée.

• COleConvertDialog::convertItem Retourné si la case d’option Convertir en case d’option a été cochée, l’utilisateur a sélectionné un autre élément à convertir et DoModal retourné IDOK.

• COleConvertDialog::activateAs Retourné si la case d’option Activer en tant que case d’option a été cochée, l’utilisateur a sélectionné un autre élément à activer et DoModal retourné IDOK.

COleConvertDialog ::m_cv

Structure de type OLEUICONVERT utilisée pour contrôler le comportement de la boîte de dialogue Convertir.

OLEUICONVERT m_cv;

Notes

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

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

Voir aussi

COleDialog, classe
Graphique hiérarchique
COleDialog, classe