Partager via

COleChangeSourceDialog, classe

  • Article

Utilisé pour la boîte de dialogue OLE Changer de source.

Syntaxe

class COleChangeSourceDialog : public COleDialog

Membres

Constructeurs publics

Nom Description
COleChangeSourceDialog ::COleChangeSourceDialog Construit un objet COleChangeSourceDialog.

Méthodes publiques

Nom Description
COleChangeSourceDialog ::D oModal Affiche la boîte de dialogue Source de modification OLE.
COleChangeSourceDialog ::GetDisplayName Obtient le nom complet de l’affichage source.
COleChangeSourceDialog ::GetFileName Obtient le nom de fichier du nom source.
COleChangeSourceDialog ::GetFromPrefix Obtient le préfixe de la source précédente.
COleChangeSourceDialog ::GetItemName Obtient le nom de l’élément à partir du nom de la source.
COleChangeSourceDialog ::GetToPrefix Obtient le préfixe de la nouvelle source
COleChangeSourceDialog ::IsValidSource Indique si la source est valide.

Membres de données publics

Nom Description
COleChangeSourceDialog ::m_cs Structure qui contrôle le comportement de la boîte de dialogue.

Notes

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

Pour plus d’informations, consultez la structure OLEUICHANGESOURCE 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

COleChangeSourceDialog

Spécifications

En-tête : afxodlgs.h

COleChangeSourceDialog ::COleChangeSourceDialog

Cette fonction construit un COleChangeSourceDialog objet.

explicit COleChangeSourceDialog(
    COleClientItem* pItem,
    CWnd* pParentWnd = NULL);

Paramètres

pItem
Pointeur vers l’objet COleClientItem lié dont la source doit être mise à jour.

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 la structure OLEUICHANGESOURCE et la fonction OleUIChangeSource dans le Kit de développement logiciel (SDK) Windows.

COleChangeSourceDialog ::D oModal

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

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 OleUIChangeSource 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_cs , 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 des fonctions membres pour récupérer les paramètres ou les informations entrés par l’utilisateur dans la boîte de dialogue. La liste suivante nomme les fonctions de requête classiques :

COleChangeSourceDialog ::GetDisplayName

Appelez cette fonction pour récupérer le nom complet de l’élément client lié.

CString GetDisplayName();

Valeur de retour

Nom complet de l’affichage source (moniker) du COleClientItem spécifié dans le constructeur.

COleChangeSourceDialog ::GetFileName

Appelez cette fonction pour récupérer la partie moniker de fichier du nom complet de l’élément client lié.

CString GetFileName();

Valeur de retour

Partie moniker de fichier du nom d’affichage source du COleClientItem spécifié dans le constructeur.

Notes

Le moniker de fichier avec le moniker d’élément donne le nom complet.

COleChangeSourceDialog ::GetFromPrefix

Appelez cette fonction pour obtenir la chaîne de préfixe précédente pour la source.

CString GetFromPrefix();

Valeur de retour

Chaîne de préfixe précédente de la source.

Notes

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

Cette valeur provient directement du lpszFrom membre de la structure OLEUICHANGESOURCE .

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

COleChangeSourceDialog ::GetItemName

Appelez cette fonction pour récupérer la partie moniker d’élément du nom complet de l’élément client lié.

CString GetItemName();

Valeur de retour

Partie moniker d’élément du nom d’affichage source du COleClientItem spécifié dans le constructeur.

Notes

Le moniker de fichier avec le moniker d’élément donne le nom complet.

COleChangeSourceDialog ::GetToPrefix

Appelez cette fonction pour obtenir la nouvelle chaîne de préfixe pour la source.

CString GetToPrefix();

Valeur de retour

Nouvelle chaîne de préfixe de la source.

Notes

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

Cette valeur provient directement du lpszTo membre de la structure OLEUICHANGESOURCE .

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

COleChangeSourceDialog ::m_cs

Ce membre de données est une structure de type OLEUICHANGESOURCE.

OLEUICHANGESOURCE m_cs;

Notes

OLEUICHANGESOURCE est utilisé pour contrôler le comportement de la boîte de dialogue Source de modification OLE. Les membres de cette structure peuvent être modifiés directement.

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

COleChangeSourceDialog ::IsValidSource

Appelez cette fonction pour déterminer si la nouvelle source est valide.

BOOL IsValidSource();

Valeur de retour

Différent de zéro si la nouvelle source est valide, sinon 0.

Notes

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

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

Voir aussi

COleDialog, classe
Graphique hiérarchique
COleDialog, classe