Exemplarische Vorgehensweise: Steuerelemente in eine Symbolleiste einfügen

Artikel
06/10/2015

In diesem Thema wird das Hinzufügen einer Symbolleistenschaltfläche beschrieben, die ein Windows-Steuerelement für eine Symbolleiste enthält. In MFC muss eine Symbolleistenschaltfläche eine von CMFCToolBarButton-Klasse abgeleitete Klasse sein, beispielsweise CMFCToolBarComboBoxButton-Klasse, CMFCToolBarEditBoxButton-Klasse, CMFCDropDownToolbarButton-Klasse oder CMFCToolBarMenuButton-Klasse.

Hinzufügen von Steuerelementen zu Symbolleisten

Führen Sie zum Hinzufügen eines Steuerelements zu einer Symbolleiste die folgenden Schritte aus:

Reservieren Sie eine Platzhalterressourcen-ID für die Schaltfläche in der übergeordneten Symbolleistenressource. Weitere Informationen über die Erstellung von Schaltflächen mithilfe des Symbolleisten-Editors in Visual Studio finden Sie im Thema Symbolleisten-Editor.
Reservieren Sie ein Symbolleistenbild (Schaltflächensymbol) für die Schaltfläche in allen Bitmaps der übergeordneten Symbolleiste.
Führen Sie im Meldungshandler, der die Meldung AFX_WM_RESETTOOLBAR verarbeitet, folgende Schritte aus:
1. Erstellen Sie das Schaltflächensteuerelement mithilfe einer von CMFCToolbarButton abgeleiteten Klasse.
2. Ersetzen Sie die Platzhalterschaltfläche mithilfe von CMFCToolBar::ReplaceButton durch das neue Steuerelement. Sie können das Schaltflächenobjekt auf dem Stapel erstellen, da ReplaceButton das Schaltflächenobjekt kopiert und die Kopie beibehält.

Hinweis

Wenn Sie die Anpassung in Ihrer Anwendung aktiviert haben, müssen Sie die Symbolleiste möglicherweise mit der Schaltfläche Zurücksetzen auf der Registerkarte Symbolleisten des Dialogfelds Anpassen zurücksetzen, um das aktualisierte Steuerelement nach dem erneuten Kompilieren in der Anwendung anzuzeigen.Der Zustand der Symbolleiste wird in der Windows-Registrierung gespeichert, und die Registrierungsinformationen werden geladen und angewendet, nachdem die ReplaceButton-Methode während des Anwendungsstarts ausgeführt wurde.

Symbolleisten-Steuerelemente und Anpassung

Die Registerkarte Befehle des Dialogfelds Anpassen enthält eine Liste von Befehlen, die in der Anwendung verfügbar sind. Standardmäßig verarbeitet das Dialogfeld Anpassen die Anwendungsmenüs und erstellt eine Liste der Standard-Symbolleistenschaltflächen in jeder Menükategorie. Zur Beibehaltung der erweiterten Funktionalität, die die Symbolleisten-Steuerelemente bieten, müssen Sie die Standard-Symbolleistenschaltfläche durch das benutzerdefinierte Steuerelement im Dialogfeld Anpassen ersetzen.

Wenn Sie die Anpassung aktivieren, erstellen Sie das Dialogfeld Anpassen im Anpassungshandler OnViewCustomize mithilfe der CMFCToolBarsCustomizeDialog-Klasse-Klasse. Bevor Sie das Dialogfeld Anpassen durch Aufrufen von CMFCToolBarsCustomizeDialog::Create anzeigen, rufen Sie CMFCToolBarsCustomizeDialog::ReplaceButton auf, um die Standardschaltfläche durch das neue Steuerelement zu ersetzen.

Beispiel: Erstellen eines Suchkombinationsfelds

In diesem Abschnitt wird die Erstellung eines Find-Kombinationsfeld-Steuerelements beschrieben, das in einer Symbolleiste angezeigt wird und kürzlich verwendete Suchzeichenfolgen enthält. Der Benutzer kann eine Zeichenfolge im Steuerelement eingeben und die EINGABETASTE drücken, um ein Dokument zu suchen, oder er kann die ESC-TASTE drücken, um zum Hauptframe zurückzukehren. In diesem Beispiel wird davon ausgegangen, dass das Dokument in einer von CEditView-Klasse abgeleiteten Ansicht angezeigt wird.

Erstellen des Suchen-Steuerelements

Erstellen Sie zuerst das Find-Kombinationsfeld-Steuerelement:

Fügen Sie den Anwendungsressourcen die Schaltfläche und die zugehörigen Befehle hinzu:
1. Fügen Sie in den Anwendungsressourcen eine neue Schaltfläche mit einer ID_EDIT_FIND-Befehls-ID zu einer Symbolleiste in Ihrer Anwendung und zu allen der Symbolleiste zugeordneten Bitmaps hinzu.
2. Erstellen Sie ein neues Menüelement mit der Befehls-ID ID_EDIT_FIND.
3. Fügen Sie der Zeichenfolgentabelle eine neue Zeichenfolge "Text suchen\nSuchen" hinzu, und weisen Sie ihr eine ID_EDIT_FIND_COMBO-Befehls-ID zu. Diese ID wird als Befehls-ID der Find-Kombinationsfelds-Schaltfläche verwendet.
  
  Hinweis
  
  Da ID_EDIT_FIND ein Standardbefehl ist, der von CEditView verarbeitet wird, ist es nicht erforderlich, einen speziellen Handler für diesen Befehl zu implementieren. Sie müssen jedoch einen Handler für den neuen Befehl ID_EDIT_FIND_COMBO implementieren.
Erstellen Sie die neue Klasse, CFindComboBox, abgeleitet von CComboBox-Klasse.
Überschreiben Sie in der Klasse CFindComboBox die virtuelle Methode PreTranslateMessage. Diese Methode ermöglicht dem Kombinationsfeld, die Meldung WM_KEYDOWN zu verarbeiten. Wenn der Benutzer die ESC-TASTE (VK_ESCAPE) drückt, kehren Sie zum Hauptrahmenfenster zurück. Wenn der Benutzer die EINGABETASTE (VK_ENTER) drückt, geben Sie im Hauptrahmenfenster eine WM_COMMAND-Meldung aus, die die Befehls-ID ID_EDIT_FIND_COMBO enthält.
Erstellen Sie eine Klasse für die Find-Kombinationsfeldschaltfläche, abgeleitet von CMFCToolBarComboBoxButton-Klasse. In diesem Beispiel hat sie den Namen CFindComboButton.
Der Konstruktor von CMFCToolbarComboBoxButton akzeptiert drei Parameter: die Befehls-ID der Schaltfläche, den Index des Schaltflächensymbols und das Format des Kombinationsfelds. Legen Sie diese Parameter wie folgt fest:
1. Übergeben Sie ID_EDIT_FIND_COMBO als Befehls-ID.
2. Verwenden Sie CCommandManager::GetCmdImage mit ID_EDIT_FIND, um den Bildindex abzurufen.
3. Eine Liste der verfügbaren Kombinationsfeldformate finden Sie unter Kombinationsfeldstile.
Überschreiben Sie in der CFindComboButton-Klasse die CMFCToolbarComboBoxButton::CreateCombo-Methode. Hier sollten Sie das CFindComboButton-Objekt erstellen und einen Zeiger darauf zurückgeben.
Verwenden Sie das Makro IMPLEMENT_SERIAL, um die Kombinationsschaltfläche persistent zu erstellen. Der Arbeitsbereichs-Manager lädt und speichert den Zustand der Schaltfläche automatisch in der Windows-Registrierung.
Implementieren Sie den ID_EDIT_FIND_COMBO-Handler in der Dokumentenansicht. Verwenden Sie CMFCToolBar::GetCommandButtons mit ID_EDIT_FIND_COMBO, um alle Find-Kombinationsfeldschaltflächen abzurufen. Aufgrund der Anpassung können mehrere Kopien einer Schaltfläche mit derselben Befehls-ID vorhanden sein.
Verwenden Sie im ID_EDIT_FIND-Meldungshandler OnFind die Klasse CMFCToolBar::IsLastCommandFromButton, um festzustellen, ob der Suchbefehl von der Find-Kombinationsfeldschaltfläche gesendet wurde. Wenn dies der Fall ist, suchen Sie den Text, und fügen Sie dem Kombinationsfeld die Suchzeichenfolge hinzu.

Hinzufügen des Suchen-Steuerelements zur Hauptsymbolleiste

Führen Sie zum Hinzufügen der Kombinationsfeldschaltfläche zur Symbolleiste die folgenden Schritte aus:

Implementieren Sie den AFX_WM_RESETTOOLBAR-Meldungshandler OnToolbarReset im Hauptrahmenfenster.

Hinweis

Das Framework sendet diese Meldung an das Hauptrahmenfenster, wenn während des Anwendungsstarts eine Symbolleiste initialisiert wird oder wenn eine Symbolleiste während der Anpassung zurückgesetzt wird.In beiden Fall müssen Sie die Standard-Symbolleistenschaltfläche durch die benutzerdefinierte Find Kombinationsfeldschaltfläche ersetzen.
Überprüfen Sie im AFX_WM_RESETTOOLBAR-Handler die Symbolleisten-ID, d. h. den WPARAM-Wert der AFX_WM_RESETTOOLBAR-Meldung. Wenn die Symbolleisten-ID der der Symbolleiste entspricht, die die Find-Kombinationsfeldschaltfläche enthält, rufen Sie CMFCToolBar::ReplaceButton auf, um die Find-Schaltfläche (d. h. die Schaltfläche mit der Befehls-ID ID_EDIT_FIND) durch ein CFindComboButton-Objekt zu ersetzen.

Hinweis

Sie können ein CFindComboBox-Objekt auf dem Stapel erstellen, da ReplaceButton das Schaltflächenobjekt kopiert und die Kopie beibehält.

Hinzufügen des Suchen-Steuerelements zum Dialogfeld "Anpassen"

Rufen Sie im Anpassungshandler OnViewCustomize die Klasse CMFCToolBarsCustomizeDialog::ReplaceButton auf, um die Find-Schaltfläche (d. h. die Schaltfläche mit der Befehls-ID ID_EDIT_FIND) durch ein CFindComboButton-Objekt zu ersetzen.