CMFCToolBarButton-Klasse

Artikel
02/26/2013

Stellt Schaltflächenfunktionalität auf Symbolleisten bereit.

class CMFCToolBarButton : public CObject

Mitglieder

Öffentliche Konstruktoren

Name	Description
CMFCToolBarButton::CMFCToolBarButton	erstellt und initialisiert ein CMFCToolBarButton-Objekt.
CMFCToolBarButton::~CMFCToolBarButton	Destruktor.

Öffentliche Methoden

Name	Description
CMFCToolBarButton::CanBeDropped	Gibt an, ob ein Benutzer eine Schaltfläche auf einer Symbolleiste oder einem Menü während der Anpassung positionieren kann.
CMFCToolBarButton::CanBeStored	Gibt an, ob die Schaltfläche gespeichert werden kann.
CMFCToolBarButton::CanBeStretched	Gibt an, ob ein Benutzer die Schaltfläche während der Anpassung strecken kann.
CMFCToolBarButton::CompareWith	Vergleicht diese Instanz mit dem angegebenen CMFCToolBarButton-Objekt.
CMFCToolBarButton::CopyFrom	Kopiert die Eigenschaften einer anderen Symbolleisten-Schaltfläche zur aktuellen Schaltfläche.
CMFCToolBarButton::CreateFromOleData	Erstellt ein Objekt CMFCToolBarButton im bereitgestellten COleDataObject-Objekt.
CMFCToolBarButton::CreateObject	Wird vom Framework, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CMFCToolBarButton::EnableWindow	Aktiviert oder deaktiviert Maus- und Tastatureingaben.
CMFCToolBarButton::ExportToMenuButton	Kopien Text aus der Symbolleisten-Schaltfläche zu einem Menü.
CMFCToolBarButton::GetClipboardFormat	Ruft das globale Zwischenablageformat für die Anwendung ab.
CMFCToolBarButton::GetHwnd	Ruft das Fensterhandle ab, das der Symbolleisten-Schaltfläche zugeordnet ist.
CMFCToolBarButton::GetImage	Ruft den Bildindex der Schaltfläche ab.
CMFCToolBarButton::GetInvalidateRect	Ruft den des Innenbereichs der Schaltfläche ab, die neu gezeichnet werden muss.
CMFCToolBarButton::GetParentWnd	Ruft das übergeordnete Fenster der Schaltfläche ab.
CMFCToolBarButton::GetProtectedCommands	Ruft die Liste von Befehlen ab, die der Benutzer nicht anpassen kann.
CMFCToolBarButton::GetTextSize	Ruft die Größe des Schaltflächentexts ab.
CMFCToolBarButton::HasFocus	Bestimmt, ob die Schaltfläche den aktuellen Eingabefokus hat.
CMFCToolBarButton::HaveHotBorder	Bestimmt, ob ein Rahmen der Schaltfläche angezeigt wird, wenn ein Benutzer die Schaltfläche auswählt.
CMFCToolBarButton::IsDrawImage	Bestimmt, ob ein Bild auf der Schaltfläche angezeigt wird.
CMFCToolBarButton::IsDrawText	Bestimmt, ob eine Beschriftung auf der Schaltfläche angezeigt wird.
CMFCToolBarButton::IsDroppedDown	Bestimmt, ob die Schaltfläche ein Untermenü anzeigt.
CMFCToolBarButton::IsEditable	Bestimmt, ob die Schaltfläche angepasst werden kann.
CMFCToolBarButton::IsExtraSize	Bestimmt, ob die Schaltfläche mit einem erweiterten Rahmen angezeigt werden kann.
CMFCToolBarButton::IsFirstInGroup	Bestimmt, ob die Schaltfläche an der ersten Position in einer Schaltflächengruppe ist.
CMFCToolBarButton::IsHidden	Bestimmt, ob die Schaltfläche ausgeblendet wird.
CMFCToolBarButton::IsHorizontal	Bestimmt, ob die Schaltfläche auf einer horizontalen Symbolleiste ist.
CMFCToolBarButton::IsLastInGroup	Gibt an, ob die Schaltfläche in der letzten Position in einer Schaltflächengruppe ist.
CMFCToolBarButton::IsLocked	Bestimmt, ob die Schaltfläche auf einer gesperrten (nicht-vomBenutzer anpassbare Symbolleiste) ist.
CMFCToolBarButton::IsOwnerOf	Bestimmt, ob die Schaltfläche der Besitzer des bereitgestellten Fensterhandles ist.
CMFCToolBarButton::IsVisible	Bestimmt, ob die Symbolleistenschaltfläche sichtbar ist.
CMFCToolBarButton::IsWindowVisible	Bestimmt, ob das zugrunde liegende Fensterhandle der Schaltfläche sichtbar ist.
CMFCToolBarButton::NotifyCommand	Gibt an, ob die Schaltfläche die Da WM_COMMAND Meldung verarbeitet.
CMFCToolBarButton::OnAddToCustomizePage	Aufgerufen vom Framework, wenn die Schaltfläche zu einem Dialogfeld Anpassen hinzugefügt wird.
CMFCToolBarButton::OnBeforeDrag	Gibt an, ob die Schaltfläche gezogen werden können.
CMFCToolBarButton::OnBeforeDrop	Gibt an, ob ein Benutzer die Schaltfläche auf die Zielsymbolleiste ablegen kann.
CMFCToolBarButton::OnCalculateSize	Aufgerufen vom Framework, um die Größe der Schaltfläche für den angegebenen Gerätekontext und den angedockten Zustand zu berechnen.
CMFCToolBarButton::OnCancelMode	Aufgerufen vom Framework, um die WM_CANCELMODE Meldung zu bearbeiten.
CMFCToolBarButton::OnChangeParentWnd	Aufgerufen vom Framework, wenn die Schaltfläche in eine neue Symbolleiste eingefügt wird.
CMFCToolBarButton::OnClick	Aufgerufen vom Framework, wenn der Benutzer auf die Maustaste klickt.
CMFCToolBarButton::OnClickUp	Aufgerufen vom Framework, wenn der Benutzer die Maustaste loslässt.
CMFCToolBarButton::OnContextHelp	Aufgerufen vom Framework, wenn die Elemente eine Symbolleiste WM_HELPHITTEST Meldung verarbeitet.
CMFCToolBarButton::OnCtlColor	Aufgerufen vom Framework, wenn die Elemente eine Symbolleiste WM_CTLCOLOR Meldung verarbeitet.
CMFCToolBarButton::OnCustomizeMenu	Ermöglicht der Schaltfläche, um das bereitgestellte Menü zu ändern, wenn die Anwendung ein Kontextmenü auf der übergeordneten Symbolleiste angezeigt wird.
CMFCToolBarButton::OnDblClk	Aufgerufen vom Framework, wenn die Elemente eine Symbolleiste WM_LBUTTONDBLCLK Meldung verarbeitet.
CMFCToolBarButton::OnDraw	Aufgerufen durch das Framework, um die Schaltfläche mithilfe der angegebenen Formate und der Optionen zu zeichnen.
CMFCToolBarButton::OnDrawOnCustomizeList	Aufgerufen durch das Framework, um die Schaltfläche im Bereich Befehle des Dialogfelds Anpassen zu zeichnen.
CMFCToolBarButton::OnGetCustomToolTipText	Aufgerufen vom Framework, um den benutzerdefinierten QuickInfo-Text für die Schaltfläche abzurufen.
CMFCToolBarButton::OnGlobalFontsChanged	Aufgerufen vom Framework, wenn die globale Schriftart geändert hat.
CMFCToolBarButton::OnMove	Aufgerufen vom Framework, wenn die Elemente Symbolleiste bewegt.
CMFCToolBarButton::OnShow	Aufgerufen vom Framework, wenn die Schaltfläche sichtbar oder nicht sichtbar ist.
CMFCToolBarButton::OnSize	Aufgerufen vom Framework, wenn die Elemente Symbolleiste ändert, erfordert die Größe oder Position und diese Änderung die Schaltfläche, ihre Größe ändern.
CMFCToolBarButton::OnToolHitTest	Aufgerufen vom Framework, wenn die Elemente Symbolleiste bestimmen muss, ob ein Punkt im umgebenden Rechteck der Schaltfläche ist.
CMFCToolBarButton::OnUpdateToolTip	Aufgerufen vom Framework, wenn die Elemente Symbolleiste den QuickInfo-Text aktualisiert.
CMFCToolBarButton::PrepareDrag	Aufgerufen vom Framework, wenn die Schaltfläche im Begriff ist, einen Drag & Drop-Vorgang auszuführen.
CMFCToolBarButton::Rect	Ruft das umschließende Rechteck der Schaltfläche ab.
CMFCToolBarButton::ResetImageToDefault	Legt den Standardwert das Bild fest, das der Schaltfläche zugeordnet ist.
CMFCToolBarButton::SaveBarState	Rettet den Zustand der Symbolleisten-Schaltfläche.
CMFCToolBarButton::Serialize	Liest dieses Objekt einem Archiv oder schreibt es einem Archiv.(Überschreibungen CObject::Serialize.)
CMFCToolBarButton::SetACCData	Füllt das bereitgestellte CAccessibilityData-Objekt mit Barrierefreiheitsdaten von der Symbolleisten-Schaltfläche auf.
CMFCToolBarButton::SetClipboardFormatName	Benennt das globale Zwischenablageformat.
CMFCToolBarButton::SetImage	Legt den Bildindex der Schaltfläche fest.
CMFCToolBarButton::SetProtectedCommands	Legt die Liste von Befehlen fest, die der Benutzer nicht anpassen kann.
CMFCToolBarButton::SetRadio	Aufgerufen vom Framework, wenn eine Schaltfläche den aktivierten Zustand ändert.
CMFCToolBarButton::SetRect	Legt das umschließende Rechteck der Schaltfläche fest.
CMFCToolBarButton::SetStyle	Legt das Format der Schaltfläche fest.
CMFCToolBarButton::SetVisible	Gibt an, ob die Schaltfläche sichtbar ist.
CMFCToolBarButton::Show	Zeigt die Schaltfläche oder aus.

Datenmember

Name	Description
CMFCToolBarButton::m_bImage	Gibt an, ob ein Bild auf der Schaltfläche angezeigt wird.
CMFCToolBarButton::m_bText	Gibt an, ob eine Beschriftung auf der Schaltfläche angezeigt wird.
CMFCToolBarButton::m_bTextBelow	Gibt an, ob die Beschriftung unter das Bild auf der Schaltfläche angezeigt wird.
CMFCToolBarButton::m_bUserButton	Gibt an, ob die Schaltfläche ein benutzerdefiniertes Bild.
CMFCToolBarButton::m_bWholeText	Gibt an, ob die Schaltfläche seine Ganztextbezeichnung angezeigt, auch wenn sie nicht in das umschließende Rechteck passt.
CMFCToolBarButton::m_bWrap	Gibt an, ob die Schaltfläche neben einem Trennzeichen in die nächste Zeile gesetzt wird.
CMFCToolBarButton::m_bWrapText	Gibt an, ob Mehrkanalbeschriftungen aktiviert werden.
CMFCToolBarButton::m_nID	Die Befehls-ID der Schaltfläche.
CMFCToolBarButton::m_nStyle	Das Format der Schaltfläche.
CMFCToolBarButton::m_strText	Die Beschriftung der Schaltfläche.

Hinweise

Ein Objekt CMFCToolbarButton ist ein Steuerelement, das auf einer Symbolleiste auf.Das Verhalten ähnelt dem einer normalen Schaltfläche.Sie können ein Bild und eine Beschriftung auf dieses Objekt zuweisen.Eine Symbolleisten-Schaltfläche kann eine Befehl ID verfügenWenn der Benutzer auf die Schaltfläche klickt, führt das Framework den Befehl aus, den diese ID angibt.

In der Regel können Symbolleisten-Schaltflächen angepasst werden: kann der Benutzer Schaltflächen von einer Symbolleiste zu anderen ziehen und Kopieren, Einfügen, Löschen und Bearbeitungsbeschriftungen und Bilder.Um den Benutzer beim Anpassen der Symbolleiste zu verhindern, können Sie die Symbolleiste auf zwei Arten sperren.Alle bLocked ist das Flag auf TRUE, wenn Sie CMFCToolBar::LoadToolBar aufrufen fest, oder fügt die Befehls-ID einer einzelnen Schaltfläche der globalen Liste von geschützten Befehlen hinzu, indem die CMFCToolBarButton::SetProtectedCommands-Methode bei.

CMFCToolBarButton wendet Bilder aus den globalen Auflistungen von Symbolleistenimages in der Anwendung ein.Diese Auflistungen werden von die Elemente Symbolleiste, CMFCToolBar-Klasse beibehalten.Weitere Informationen finden Sie unter CMFCToolBarImages-Klasse.

Wenn der Benutzer auf eine Schaltfläche klickt, verarbeitet die Elemente Symbolleiste die Mausmeldung und teilt die entsprechende Aktion zur Schaltfläche mit.Wenn die Schaltfläche eine gültige Befehls-ID hat, sendet die Elemente Symbolleiste die WM_COMMAND Nachricht an den übergeordneten Frames.

Die CMFCToolBarButton-Klasse ist die Basisklasse für andere Symbolleistenschaltflächenklassen, wie CMFCToolBarMenuButton-Klasse, CMFCToolBarEditBoxButton-Klasse und CMFCToolBarComboBoxButton-Klasse.

Beispiel

Das folgende Beispiel zeigt, wie ein Objekt CMFCToolBarButton konfiguriert, indem verschiedene Methoden in der CMFCToolBarButton-Klasse angewendet wird.Das Beispiel veranschaulicht, wie die Maus und die Tastatureingabe aktiviert, den Bildindex der Schaltfläche festlegen, das umschließende Rechteck der Schaltfläche festlegen, und die Schaltfläche sichtbar.Dieser Codeausschnitt ist Teil Tab-Steuerelement-Beispiel.

    CMFCToolBarButton* pOffice2007 = NULL;
    int nIndex = -1;
    
    for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
    {
        // CMFCToolBar  m_wndToolBarTheme
        nIndex = m_wndToolBarTheme.CommandToIndex (uiCmd);

        CMFCToolBarButton* pButton = m_wndToolBarTheme.GetButton (nIndex);
    
        if (pButton != NULL)
        {
            pOffice2007 = pButton;
            break;
        }
    }


...


    pOffice2007->EnableWindow();
    pOffice2007->SetImage(1);
    pOffice2007->SetRect( CRect(1,1,1,1));
    pOffice2007->SetVisible();
    pOffice2007->Show(true);