Partager via


CMFCEditBrowseCtrl, classe

La classe d' CMFCEditBrowseCtrl prend en charge la modification parcourir le contrôle, qui est une zone de texte modifiable qui contient également un bouton Parcourir. Lorsque l'utilisateur clique sur le bouton Parcourir, le contrôle exécute une action personnalisée ou affiche une boîte de dialogue standard qui contient un explorateur de fichiers ou une recherche des dossiers.

class CMFCEditBrowseCtrl : public CEdit

Membres

Constructeurs publics

Nom

Description

CMFCEditBrowseCtrl::CMFCEditBrowseCtrl

Constructeur par défaut.

CMFCEditBrowseCtrl::~CMFCEditBrowseCtrl

Destructor.

Méthodes publiques

Nom

Description

CMFCEditBrowseCtrl::EnableBrowseButton

Active ou désactive (les) masque le bouton Parcourir.

CMFCEditBrowseCtrl::EnableFileBrowseButton

Active le bouton Parcourir et met la modification parcourir le contrôle en mode de navigation de fichier .

CMFCEditBrowseCtrl::EnableFolderBrowseButton

Active le bouton Parcourir et met la modification parcourir le contrôle en mode de navigation de dossier .

CMFCEditBrowseCtrl::GetMode

Retourne le mode de navigation actuel.

CMFCEditBrowseCtrl::OnAfterUpdate

Appelé par l'infrastructure après la modification recherchez le contrôle est mis à jour avec le résultat d'une action rechercher.

CMFCEditBrowseCtrl::OnBrowse

Appelé par l'infrastructure après l'utilisateur clique sur le bouton Parcourir.

CMFCEditBrowseCtrl::OnChangeLayout

Redessine la modification actuelle parcourir le contrôle.

CMFCEditBrowseCtrl::OnDrawBrowseButton

Appelé par l'infrastructure pour dessiner le bouton Parcourir.

CMFCEditBrowseCtrl::OnIllegalFileName

Appelé par l'infrastructure lorsqu'un nom de fichier non conforme a été écrit dans le contrôle d'édition.

CMFCEditBrowseCtrl::PreTranslateMessage

Traduit des messages de fenêtre pour qu'ils soient distribués aux fonctions Windows de TranslateMessage et de DispatchMessage . Pour la syntaxe et plus d'informations, consultez CWnd::PreTranslateMessage.

CMFCEditBrowseCtrl::SetBrowseButtonImage

Définit une icône personnalisée pour le bouton Parcourir.

Notes

Utilisez une modification parcourir le contrôle pour sélectionner un nom de fichier ou dossier. Éventuellement, utilisez le contrôle pour effectuer une action personnalisée comme d'afficher une boîte de dialogue. Vous pouvez afficher ou ne pas afficher le bouton Parcourir, et vous pouvez appliquer une étiquette personnalisé ou une image sur le bouton.

Le mode de navigation de manipulation parcourir le contrôle détermine s'il affiche un bouton Parcourir et l'action qui se produit lorsque l'utilisateur clique sur le bouton. Pour plus d'informations, consultez la méthode de GetMode .

La classe d' CMFCEditBrowseCtrl prend en charge les modes suivants.

  • custom mode
    Une action personnalisée est exécutée lorsque l'utilisateur clique sur le bouton Parcourir. Par exemple, vous pouvez afficher une boîte de dialogue spécifique à l'application.

  • file mode
    Une boîte de dialogue standard de sélection de fichier s'affiche lorsque l'utilisateur clique sur le bouton Parcourir.

  • folder mode
    Une boîte de dialogue standard de sélection de dossier s'affiche lorsque l'utilisateur clique sur le bouton Parcourir.

" Comment " : Spécifiez une modification parcourir le contrôle

Exécutez les étapes suivantes pour incorporer une modification parcourir le contrôle dans votre application :

  1. Si vous souhaitez implémenter un mode de navigation personnalisé, dérivez votre propre classe de la classe d' CMFCEditBrowseCtrl puis remplacez la méthode d' CMFCEditBrowseCtrl::OnBrowse . Dans la méthode substituée, exécutez une action Parcourir personnalisé et mettre à jour la modification parcourir le contrôle avec le résultat.

  2. Incluez ou l'objet d' CMFCEditBrowseCtrl ou la modification dérivée parcourent l'objet contrôle dans l'objet window parent.

  3. Si vous utilisez Assistant Classe pour créer une boîte de dialogue, ajoutez un contrôle d'édition (CEdit) au formulaire de boîte de dialogue. En outre, ajoutez une variable pour accéder au contrôle dans votre fichier d'en-tête. Dans le fichier d'en-tête, remplacez le type de la variable d' CEdit par CMFCEditBrowseCtrl. La modification parcourir le contrôle sera créée automatiquement. Si vous n'utilisez pas Assistant Classe, ajoutez une variable d' CMFCEditBrowseCtrl à votre fichier d'en-tête puis appelez sa méthode d' Create .

  4. Si vous ajoutez une modification recherchez le contrôle à une boîte de dialogue, utilisez l'outil ClassWizard pour installer l'échange de données.

  5. Appelez la méthode d' EnableFolderBrowseButton, d' EnableFileBrowseButton, ou d' EnableBrowseButton pour définir le mode de navigation et afficher le bouton Parcourir. Appelez la méthode de GetMode pour obtenir le mode de navigation actuel.

  6. Pour fournir une icône personnalisée pour le bouton Parcourir, appelez la méthode de SetBrowseButtonImage ou remplacez la méthode d' OnDrawBrowseButton .

  7. Pour supprimer le bouton Parcourir de la modification recherchez le contrôle, appelez la méthode d' EnableBrowseButton avec le jeu de paramètres d' bEnable à FALSE.

Hiérarchie d'héritage

CObject

   CCmdTarget

      CWnd

         CEdit

            CMFCEditBrowseCtrl

Exemple

L'exemple suivant montre comment utiliser deux méthodes dans la classe d' CMFCEditBrowseCtrl : EnableFolderBrowseButton et EnableFileBrowseButton. Cet exemple fait partie de Nouvel exemples de contrôles.

  CMFCEditBrowseCtrl m_wndFolderEdit;
    CMFCEditBrowseCtrl m_wndFileEdit;


...


    // enable the browse button and put the control in file browse mode
    m_wndFolderEdit.EnableFolderBrowseButton();
    // enable the browse button and put the control in the folder browse mode
    m_wndFileEdit.EnableFileBrowseButton();

Configuration requise

en-tête : afxeditbrowsectrl.h

Voir aussi

Référence

Graphique de la hiérarchie

Autres ressources

classes MFC