CMFCEditBrowseCtrl-Klasse

Artikel
02/26/2013

Die CMFCEditBrowseCtrl-Klasse unterstützt das Steuerelement zum Bearbeiten und Durchsuchen, das ein bearbeitbare Textfelder ist, das optional Schaltfläche Durchsuchen enthält.Wenn der Benutzer auf die Schaltfläche zum Durchsuchen klicken, führt das Steuerelement eine benutzerdefinierte Aktion aus oder zeigt ein Standarddialogfeld an, das einen Dateibrowser oder einen Ordnerbrowser enthält.

class CMFCEditBrowseCtrl : public CEdit

Mitglieder

Öffentliche Konstruktoren

Name	Description
CMFCEditBrowseCtrl::CMFCEditBrowseCtrl	Standardkonstruktor.
CMFCEditBrowseCtrl::~CMFCEditBrowseCtrl	Destruktor.

Öffentliche Methoden

Name	Description
CMFCEditBrowseCtrl::EnableBrowseButton	Aktiviert oder deaktiviert () zeigt die Schaltfläche zum Durchsuchen.
CMFCEditBrowseCtrl::EnableFileBrowseButton	Aktiviert die Schaltfläche zum Durchsuchen und aktiviert das Steuerelement zum Bearbeiten und Navigieren in Dateidurchsuchen-modus ein.
CMFCEditBrowseCtrl::EnableFolderBrowseButton	Aktiviert die Schaltfläche zum Durchsuchen und aktiviert das Steuerelement zum Bearbeiten und Navigieren in Ordnerdurchsuchen-modus ein.
CMFCEditBrowseCtrl::GetMode	Gibt den aktuellen Durchsuchen-Modus zurück.
CMFCEditBrowseCtrl::OnAfterUpdate	Aufgerufen vom Framework nach dem Steuerelement zum Bearbeiten und Durchsuchen wird mit dem Ergebnis einer Aktion Durchsuchen aktualisiert.
CMFCEditBrowseCtrl::OnBrowse	Aufgerufen vom Framework nach dem Benutzer klickt auf die Schaltfläche zum Durchsuchen.
CMFCEditBrowseCtrl::OnChangeLayout	Aktualisiert das aktuelle Steuerelement zum Bearbeiten und Durchsuchen neu.
CMFCEditBrowseCtrl::OnDrawBrowseButton	Aufgerufen durch das Framework, um die Schaltfläche Durchsuchen zu zeichnen.
CMFCEditBrowseCtrl::OnIllegalFileName	Aufgerufen vom Framework, als ein ungültiger Dateiname in das Bearbeitungssteuerelement eingeführt wurde.
CMFCEditBrowseCtrl::PreTranslateMessage	Übersetzt Fenstermeldungen, bevor sie an den TranslateMessage und DispatchMessage Windows-Funktionen weitergeleitet werden.So Syntax und weitere Informationen finden Sie unter CWnd::PreTranslateMessage.
CMFCEditBrowseCtrl::SetBrowseButtonImage	Legt ein benutzerdefiniertes Bild für die Schaltfläche Durchsuchen fest.

Hinweise

Verwenden Sie ein Steuerelement zum Bearbeiten und Durchsuchen, um eine Datei oder einen Ordnernamen auszuwählen.Optional können Sie das Steuerelement, um eine benutzerdefinierte Aktion auszuführen, wie ein Dialogfeld anzuzeigen.Sie können die Schaltfläche Durchsuchen anzeigen oder nicht anzeigen, und Sie können eine benutzerdefinierte Bezeichnung oder ein Bild auf der Schaltfläche anwenden.

Der Durchsuchen-Modus des Steuerelements zum Bearbeiten und Durchsuchen bestimmt, ob es Schaltfläche Durchsuchen angezeigt und welche Aktion erfolgt, wenn auf die Schaltfläche geklickt wird.Weitere Informationen finden Sie in GetMode-Methode.

Die CMFCEditBrowseCtrl-Klasse unterstützt die folgenden Modi.

custom mode
Eine benutzerdefinierte Aktion wird ausgeführt, wenn der Benutzer auf die Schaltfläche zum Durchsuchen klicken.Beispielsweise können Sie ein anwendungsspezifisches Dialogfeld anzeigen.
file mode
Ein Standarddatei-Auswahldialogfeld wird angezeigt, wenn der Benutzer auf die Schaltfläche zum Durchsuchen klicken.
folder mode
Ein Standardordner-Auswahldialogfeld wird angezeigt, wenn der Benutzer auf die Schaltfläche zum Durchsuchen klicken.

Gewusst-wie-Themen: Geben Sie ein Steuerelement zum Bearbeiten und Durchsuchen an

Führen Sie die folgenden Schritte aus, um ein Steuerelement zum Bearbeiten und Navigieren in der Anwendung zu enthalten:

Wenn Sie einen benutzerdefinierten Durchsuchen-Modus implementieren möchten, berechnen Sie die eigene Klasse von der Klasse CMFCEditBrowseCtrl und überschreiben Sie dann die CMFCEditBrowseCtrl::OnBrowse-Methode.In der überschriebenen Methode führen Sie eine benutzerdefinierte Aktion Navigieren aus und aktualisieren Sie das Steuerelement zum Bearbeiten und zum Durchsuchen mit dem Ergebnis.
Betten Sie entweder das CMFCEditBrowseCtrl abgeleitete Objekt oder das Steuerelement zum Bearbeiten und Durchsuchen-Objekt in das Objekt des übergeordneten Fensters ein.
Wenn Sie Klassen-Assistent verwenden, um ein Dialogfeld zu erstellen, fügen Sie ein Bearbeitungssteuerelement (CEdit) dem Dialogfeldformular hinzu.Außerdem fügen Sie eine Variable hinzu, um auf das Steuerelement in der Headerdatei zuzugreifen.In der Headerdatei ändern Sie den Typ der Variablen von CEdit zu CMFCEditBrowseCtrl.Das Steuerelement zum Bearbeiten und Durchsuchen wird automatisch erstellt.Wenn Sie nicht Klassen-Assistent verwenden, fügen Sie eine CMFCEditBrowseCtrl-Variable der Headerdatei hinzu und rufen Sie dann die Create-Methode auf.
Wenn Sie ein Steuerelement zum Bearbeiten und Durchsuchen einem Dialogfeld hinzufügen, verwenden Sie das Tool, um ClassWizard Datenaustausch zu installieren.
Rufen Sie die EnableFolderBrowseButton, EnableFileBrowseButton oder EnableBrowseButton-Methode auf, um den Durchsuchen-Modus festzulegen und die Schaltfläche zum Durchsuchen anzuzeigen.Rufen Sie die Methode auf GetMode, erhält der aktuelle Durchsuchen-Modus.
Um ein benutzerdefiniertes Bild für die Schaltfläche Durchsuchen bereitzustellen, rufen Sie die Methode auf SetBrowseButtonImage oder überschreiben Sie die Methode OnDrawBrowseButton.
Um die Schaltfläche Durchsuchen vom Steuerelement zum Bearbeiten und Wechseln zu entfernen, rufen Sie die EnableBrowseButton-Methode mit dem bEnable-Parameter auf, der zu FALSE festgelegt ist.

Vererbungshierarchie

Beispiel

Das folgende Beispiel zeigt, wie zwei Methoden in der Klasse CMFCEditBrowseCtrl verwendet: EnableFolderBrowseButton und EnableFileBrowseButton.Dieses Beispiel ist Teil Neue Kontrollprobe.

    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();

Anforderungen

Header: afxeditbrowsectrl.h

Siehe auch

Referenz

Hierarchien-Diagramm

Weitere Ressourcen

MFC-Klassen

Freigeben über