Teilen über

CMFCToolBarButton-Klasse

  • Artikel

Stellt Schaltflächenfunktionen für Symbolleisten bereit.

Syntax

class CMFCToolBarButton : public CObject

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCToolBarButton::CMFCToolBarButton Erstellt und initialisiert ein CMFCToolBarButton-Objekt.
CMFCToolBarButton::~CMFCToolBarButton Destruktor.

Öffentliche Methoden

Name Beschreibung
CMFCToolBarButton::CanBeDropped Gibt an, ob ein Benutzer eine Schaltfläche während der Anpassung auf einer Symbolleiste oder einem Menü 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 bereitgestellten CMFCToolBarButton Objekt.
CMFCToolBarButton::CopyFrom Kopiert die Eigenschaften einer anderen Symbolleistenschaltfläche auf die aktuelle Schaltfläche.
CMFCToolBarButton::CreateFromOleData Erstellt ein CMFCToolBarButton Objekt aus dem bereitgestellten COleDataObject Objekt.
CMFCToolBarButton::CreateObject Wird vom Framework verwendet, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CMFCToolBarButton::EnableWindow Aktiviert oder deaktiviert die Maus- und Tastatureingaben.
CMFCToolBarButton::ExportToMenuButton Kopiert Text von der Symbolleistenschaltfläche in ein Menü.
CMFCToolBarButton::GetClipboardFormat Ruft das globale Zwischenablageformat für die Anwendung ab.
CMFCToolBarButton::GetHwnd Ruft das Fensterhandle ab, das der Symbolleistenschaltfläche zugeordnet ist.
CMFCToolBarButton::GetImage Ruft den Bildindex der Schaltfläche ab.
CMFCToolBarButton::GetInvalidateRect Ruft den Bereich des Clientbereichs der Schaltfläche ab, die neu gezeichnet werden muss.
CMFCToolBarButton::GetParentWnd Ruft das übergeordnete Fenster der Schaltfläche ab.
CMFCToolBarButton::GetProtectedCommands Ruft die Liste der Befehle 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 auf der Schaltfläche eine Textbezeichnung angezeigt wird.
CMFCToolBarButton::IsDroppedDown Bestimmt, ob auf der Schaltfläche ein Untermenü angezeigt wird.
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 sich die Schaltfläche an der ersten Position in der Schaltflächengruppe befindet.
CMFCToolBarButton::IsHidden Bestimmt, ob die Schaltfläche ausgeblendet ist.
CMFCToolBarButton::IsHorizontal Bestimmt, ob sich die Schaltfläche auf einer horizontalen Symbolleiste befindet.
CMFCToolBarButton::IsLastInGroup Gibt an, ob sich die Schaltfläche an der letzten Position in der Schaltflächengruppe befindet.
CMFCToolBarButton::IsLocked Bestimmt, ob sich die Schaltfläche auf einer gesperrten (nicht anpassbaren) Symbolleiste befindet.
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 WM_COMMAND Nachricht verarbeitet.
CMFCToolBarButton::OnAddToCustomizePage Wird vom Framework aufgerufen, wenn die Schaltfläche einem Dialogfeld "Anpassen " hinzugefügt wird.
CMFCToolBarButton::OnBeforeDrag Gibt an, ob die Schaltfläche gezogen werden kann.
CMFCToolBarButton::OnBeforeDrop Gibt an, ob ein Benutzer die Schaltfläche auf der Zielsymbolleiste ablegen kann.
CMFCToolBarButton::OnCalculateSize Wird vom Framework aufgerufen, um die Größe der Schaltfläche für den angegebenen Gerätekontext und Andockzustand zu berechnen.
CMFCToolBarButton::OnCancelMode Vom Framework aufgerufen, um die WM_CANCELMODE Nachricht zu verarbeiten.
CMFCToolBarButton::OnChangeParentWnd Wird vom Framework aufgerufen, wenn die Schaltfläche in eine neue Symbolleiste eingefügt wird.
CMFCToolBarButton::OnClick Wird vom Framework aufgerufen, wenn der Benutzer auf die Maustaste klickt.
CMFCToolBarButton::OnClickUp Wird vom Framework aufgerufen, wenn der Benutzer die Maustaste loslässt.
CMFCToolBarButton::OnContextHelp Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste eine WM_HELPHITTEST Nachricht behandelt.
CMFCToolBarButton::OnCtlColor Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste eine WM_CTLCOLOR Nachricht behandelt.
CMFCToolBarButton::OnCustomizeMenu Ermöglicht es der Schaltfläche, das bereitgestellte Menü zu ändern, wenn die Anwendung ein Kontextmenü auf der übergeordneten Symbolleiste anzeigt.
CMFCToolBarButton::OnDblClk Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste eine WM_LBUTTONDBLCLK Nachricht behandelt.
CMFCToolBarButton::OnDraw Wird vom Framework aufgerufen, um die Schaltfläche mithilfe der angegebenen Stile und Optionen zu zeichnen.
CMFCToolBarButton::OnDrawOnCustomizeList Wird vom Framework aufgerufen, um die Schaltfläche im Befehlsbereich des Dialogfelds Anpassen zu zeichnen.
CMFCToolBarButton::OnGetCustomToolTipText Vom Framework aufgerufen, um den benutzerdefinierten QuickInfo-Text für die Schaltfläche abzurufen.
CMFCToolBarButton::OnGlobalFontsChanged Wird vom Framework aufgerufen, wenn sich die globale Schriftart geändert hat.
CMFCToolBarButton::OnMove Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste verschoben wird.
CMFCToolBarButton::OnShow Wird vom Framework aufgerufen, wenn die Schaltfläche sichtbar oder unsichtbar wird.
CMFCToolBarButton::OnSize Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste seine Größe oder Position ändert, und diese Änderung erfordert, dass die Schaltfläche die Größe ändert.
CMFCToolBarButton::OnToolHitTest Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste bestimmen muss, ob sich ein Punkt im umgebenden Rechteck der Schaltfläche befindet.
CMFCToolBarButton::OnUpdateToolTip Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste den QuickInfo-Text aktualisiert.
CMFCToolBarButton::P repareDrag Wird vom Framework aufgerufen, wenn die Schaltfläche eine Drag-and-Drop-Operation ausführt.
CMFCToolBarButton::Rect Ruft das umgebende Rechteck der Schaltfläche ab.
CMFCToolBarButton::ResetImageToDefault Legt den Standardwert auf das Bild fest, das der Schaltfläche zugeordnet ist.
CMFCToolBarButton::SaveBarState Speichert den Status der Symbolleistenschaltfläche.
CMFCToolBarButton::Serialize Liest dieses Objekt aus einem Archiv oder schreibt es in ein Archiv. (Überschreibt CObject::Serialize.)
CMFCToolBarButton::SetACCData Füllt das bereitgestellte CAccessibilityData Objekt mit Barrierefreiheitsdaten aus der Symbolleistenschaltfläche auf.
CMFCToolBarButton::SetClipboardFormatName Benennt das globale Zwischenablageformat um.
CMFCToolBarButton::SetImage Legt den Bildindex der Schaltfläche fest.
CMFCToolBarButton::SetProtectedCommands Legt die Liste der Befehle fest, die der Benutzer nicht anpassen kann.
CMFCToolBarButton::SetRadio Wird vom Framework aufgerufen, wenn eine Schaltfläche ihren aktivierten Zustand ändert.
CMFCToolBarButton::SetRect Legt das umgebende Rechteck der Schaltfläche fest.
CMFCToolBarButton::SetStyle Legt den Stil der Schaltfläche fest.
CMFCToolBarButton::SetVisible Gibt an, ob die Schaltfläche sichtbar ist.
CMFCToolBarButton::Show Blendet die Schaltfläche ein oder aus.

Datenelemente

Name Beschreibung
CMFCToolBarButton::m_bImage Gibt an, ob ein Bild auf der Schaltfläche angezeigt wird.
CMFCToolBarButton::m_bText Gibt an, ob auf der Schaltfläche eine Textbezeichnung angezeigt wird.
CMFCToolBarButton::m_bTextBelow Gibt an, ob die Textbezeichnung unter dem Bild auf der Schaltfläche angezeigt wird.
CMFCToolBarButton::m_bUserButton Gibt an, ob die Schaltfläche über ein benutzerdefiniertes Bild verfügt.
CMFCToolBarButton::m_bWholeText Gibt an, ob die Schaltfläche die vollständige Beschriftung anzeigt, auch wenn sie nicht in das umgebende Rechteck passt.
CMFCToolBarButton::m_bWrap Gibt an, ob die Schaltfläche neben einem Trennzeichen in der nächsten Zeile platziert wird.
CMFCToolBarButton::m_bWrapText Gibt an, ob mehrzeilige Textbeschriftungen aktiviert sind.
CMFCToolBarButton::m_nID Die Befehls-ID der Schaltfläche.
CMFCToolBarButton::m_nStyle Die Formatvorlage der Schaltfläche.
CMFCToolBarButton::m_strText Die Textbezeichnung der Schaltfläche.

Hinweise

Ein CMFCToolbarButton Objekt ist ein Steuerelement, das sich auf einer Symbolleiste befindet. Sein Verhalten ähnelt der einer normalen Schaltfläche. Sie können diesem Objekt ein Bild und eine Beschriftung zuweisen. Eine Symbolleistenschaltfläche kann auch über eine Befehls-ID verfügen. Wenn der Benutzer auf die Symbolleistenschaltfläche klickt, führt das Framework den Befehl aus, den diese ID angibt.

In der Regel können Symbolleistenschaltflächen angepasst werden: Der Benutzer kann Schaltflächen von einer Symbolleiste auf eine andere ziehen und Textbeschriftungen und -bilder kopieren, einfügen, löschen und bearbeiten. Um zu verhindern, dass der Benutzer die Symbolleiste anpassen kann, können Sie die Symbolleiste auf eine von zwei Arten sperren. Legen Sie entweder das bLocked Flag auf TRUE fest, wenn Sie CMFCToolBar::LoadToolBar aufrufen, oder fügen Sie die Befehls-ID einer einzelnen Schaltfläche zur globalen Liste der geschützten Befehle mithilfe der CMFCToolBarButton::SetProtectedCommands-Methode hinzu.

CMFCToolBarButton Objekte zeigen Bilder aus den globalen Sammlungen von Symbolleistenbildern in der Anwendung an. Diese Auflistungen werden von der übergeordneten Symbolleiste CMFCToolBar-Klasse verwaltet. Weitere Informationen finden Sie unter CMFCToolBarImages Class.

Wenn der Benutzer auf eine Symbolleistenschaltfläche klickt, verarbeitet die übergeordnete Symbolleiste die Mausnachricht und kommuniziert die entsprechenden Aktionen an die Schaltfläche. Wenn die Schaltfläche über eine gültige Befehls-ID verfügt, sendet die übergeordnete Symbolleiste die WM_COMMAND Nachricht an den übergeordneten Frame.

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

Beispiel

Im folgenden Beispiel wird das Konfigurieren eines CMFCToolBarButton Objekts mithilfe verschiedener Methoden in der CMFCToolBarButton Klasse veranschaulicht. Das Beispiel veranschaulicht, wie Sie die Maus- und Tastatureingabe aktivieren, den Bildindex der Schaltfläche festlegen, das Begrenzungsrechteck der Schaltfläche festlegen und die Schaltfläche sichtbar machen. Dieser Codeausschnitt ist Teil des Tab-Steuerelement-Beispiels.

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

Vererbungshierarchie

CObject

CMFCToolBarButton

Anforderungen

Kopfzeile: afxtoolbarbutton.h

CMFCToolBarButton::CanBeDropped

Gibt an, ob ein Benutzer eine Schaltfläche während der Anpassung auf einer Symbolleiste oder einem Menü positionieren kann.

virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);

Parameter

pToolbar
[in] Nicht verwendet.

Rückgabewert

Diese Methode gibt TRUE zurück.

Hinweise

Standardmäßig kann eine Symbolleistenschaltfläche auf jeder anpassbaren Symbolleiste (d. h. nicht gesperrt) abgelegt werden.

Die Standardimplementierung dieser Methode gibt TRUE zurück. Überschreiben Sie diese Methode, und geben Sie FALSE zurück, wenn Sie verhindern möchten, dass der Benutzer die Schaltfläche neu positioniert.

CMFCToolBarButton::CanBeStored

Bestimmt, ob die Schaltfläche gespeichert werden kann.

virtual BOOL CanBeStored() const;

Rückgabewert

Diese Methode gibt TRUE zurück.

Hinweise

Das Framework verwendet diese Methode, um zu bestimmen, ob die Schaltfläche an einem Drag-and-Drop-Vorgang teilnehmen kann.

Die Standardimplementierung gibt TRUE zurück. Überschreiben Sie diese Methode, wenn die Schaltfläche nicht als Teil eines Drag-and-Drop-Vorgangs gespeichert werden kann. Weitere Informationen zu Drag-and-Drop-Vorgängen finden Sie unter OLE-Ziehen und -Ablegen.

CMFCToolBarButton::CanBeStretched

Gibt an, ob ein Benutzer die Schaltfläche während der Anpassung strecken kann.

virtual BOOL CanBeStretched() const;

Rückgabewert

Diese Methode gibt FALSE zurück.

Hinweise

Diese Methode wird vom Framework verwendet, um zu bestimmen, ob die Schaltfläche im Anpassungsmodus gestreckt werden kann.

Die Standardimplementierung dieser Methode gibt FALSE zurück. Überschreiben Sie diese Methode, um WAHR für ein Steuerelement mit variabler Breite wie einem Kombinationsfeld oder Schieberegler zurückzugeben.

Weitere Informationen zum Anpassungsmodus finden Sie unter CMFCToolBar::SetCustomizeMode.

CMFCToolBarButton::CMFCToolBarButton

Erstellt und initialisiert ein CMFCToolBarButton-Objekt.

CMFCToolBarButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE,
    BOOL bLocked=FALSE);

Parameter

uiID
[in] Die Befehls-ID der Schaltfläche.

iImage
[in] Der Bildindex der Schaltfläche in der Sammlung von Bildern.

lpszText
[in] Die Textbezeichnung der Schaltfläche. Kann den Wert NULL haben.

bUserButton
[in] Ein boolescher Wert, der bestimmt, ob die Schaltfläche benutzerdefiniert ist. Wenn dieser Parameter WAHR ist, wird die Schaltfläche benutzerdefinierter. Andernfalls wird das Schaltflächenbild aus einer Ressource geladen.

gesperrt
[in] Ein boolescher Wert, der bestimmt, ob die Schaltfläche angepasst werden kann. Wenn dieser Parameter WAHR ist, kann die Schaltfläche nicht angepasst werden. Andernfalls kann die Schaltfläche angepasst werden.

CMFCToolBarButton::CompareWith

Vergleicht diese Instanz mit dem bereitgestellten CMFCToolBarButton Objekt.

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parameter

sonstige
[in] Verweisen Sie auf das Objekt, das mit dieser Instanz verglichen werden soll.

Rückgabewert

Nonzero, wenn das angegebene Objekt dem Wert dieser Instanz entspricht; andernfalls 0.

Hinweise

Die Standardimplementierung bestimmt, ob die Befehls-ID des bereitgestellten Objekts der Befehls-ID dieser Instanz entspricht. Überschreiben Sie diese Methode, wenn Sie zusätzliche Verarbeitung durchführen müssen, um zu bestimmen, ob zwei CMFCToolBarButton Objekte gleich sind.

CMFCToolBarButton::CopyFrom

Kopiert die Eigenschaften einer anderen Symbolleistenschaltfläche auf die aktuelle Schaltfläche.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parameter

src
[in] Ein Verweis auf die Quellschaltfläche, aus der kopiert werden soll.

Hinweise

Rufen Sie diese Methode auf, um eine weitere Symbolleistenschaltfläche auf diese Symbolleistenschaltfläche zu kopieren.

CMFCToolBarButton::CreateFromOleData

Erstellt ein CMFCToolBarButton Objekt aus dem bereitgestellten COleDataObject Objekt.

static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);

Parameter

pDataObject
[in] Das OLE-Quelldatenobjekt.

Rückgabewert

Das erstellte CMFCToolBarButton-Objekt.

Hinweise

Diese Methode wird vom Framework verwendet, um Datenübertragungen in verschiedenen Formaten durchzuführen. Die Methode verwendet z CMFCOutlookBarPane::OnDragOver . B. diese Methode, um Drag-and-Drop-Vorgänge auszuführen.

CMFCToolBarButton::EnableWindow

Aktiviert oder deaktiviert die Maus- und Tastatureingaben.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parameter

bEnable
[in] Legen Sie diesen Parameter auf TRUE fest, um die Eingabe zu aktivieren, oder auf FALSE, um die Eingabe zu deaktivieren.

Hinweise

Diese Methode ruft die Funktion auf, um Eingaben EnableWindow zu aktivieren oder zu deaktivieren. Weitere Informationen finden Sie unter EnableWindow im Windows SDK.

CMFCToolBarButton::ExportToMenuButton

Kopiert Text von der Symbolleistenschaltfläche in ein Menü.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parameter

menuButton
[in] Ein Verweis auf die Zielmenüschaltfläche.

Rückgabewert

Diese Methode gibt TRUE zurück.

Hinweise

Das Framework ruft diese Methode auf, um den Text von einer Symbolleistenschaltfläche in eine Menüschaltfläche zu kopieren. Die Standardimplementierung kopiert die Textbezeichnung der Schaltfläche. Wenn die Beschriftung leer ist, kopiert diese Methode den QuickInfo-Text der Schaltfläche.

Die Standardimplementierung dieser Methode gibt TRUE zurück. Überschreiben Sie diese Methode, wenn Sie zusätzliche Aktionen ausführen möchten, wenn das Framework ein Objekt konvertiert, das von CMFCToolbarButton in eine Menüschaltfläche abgeleitet wird.

CMFCToolBarButton::GetClipboardFormat

Ruft das globale Zwischenablageformat für die Anwendung ab.

static CLIPFORMAT __stdcall GetClipboardFormat();

Rückgabewert

Der globale CLIPFORMAT-Wert für die Anwendung.

Hinweise

Das Framework ruft diese Methode auf, um das Zwischenablageformat für OLE-Datenübertragungsvorgänge abzurufen. Beispielsweise verwendet die CMFCToolBarButton::CreateFromOleData-Methode diese Methode, um Daten aus einem OLE-Quelldatenobjekt zu kopieren.

Diese Methode legt den globalen CLIPFORMAT-Wert beim ersten Aufruf dieser Methode fest. Alle nachfolgenden Aufrufe dieser Methode geben diesen Wert zurück.

Rufen Sie die CMFCToolBarButton::SetClipboardFormatName-Methode auf, um Drag-and-Drop-Vorgänge zwischen Anwendungen zuzulassen.

Weitere Informationen zu Zwischenablage in MFC finden Sie unter "Zwischenablage".

CMFCToolBarButton::GetHwnd

Ruft das Fensterhandle ab, das der Symbolleistenschaltfläche zugeordnet ist.

virtual HWND GetHwnd();

Rückgabewert

Das Fensterhandle, das der Symbolleistenschaltfläche oder NULL zugeordnet ist, wenn die Symbolleistenschaltfläche kein Fensterziehpunkt zugeordnet ist.

Hinweise

Die Standardimplementierung dieser Methode gibt NULL zurück. Überschreiben Sie diese Methode, um das Fensterhandle Ihres bestimmten Steuerelements zurückzugeben.

CMFCToolBarButton::GetImage

Ruft den Bildindex der Schaltfläche ab.

int GetImage() const;

Rückgabewert

Der Index des Bilds, das dieser Schaltfläche zugeordnet ist.

Hinweise

Wenn die Schaltfläche über ein benutzerdefiniertes Bild verfügt (d. a. wenn bUserButton im Konstruktor WAHR war), gibt der zurückgegebene Index ein Bild in der Auflistung von benutzerdefinierten Bildern an (siehe CMFCToolBar::GetUserImages). Andernfalls gibt der Index ein Bild in der Auflistung von Bildern an, die aus einer Ressourcendatei geladen werden (siehe CMFCToolBar::GetImages). Weitere Informationen zu Ressourcendateien finden Sie unter "Arbeiten mit Ressourcendateien".

CMFCToolBarButton::GetInvalidateRect

Ruft den Bereich des Clientbereichs der Schaltfläche ab, die neu gezeichnet werden muss.

virtual const CRect GetInvalidateRect() const;

Rückgabewert

Ein CRect Objekt, das den Bereich angibt, der neu gezeichnet werden muss.

Hinweise

Die Standardimplementierung dieser Methode gibt den gesamten Clientbereich zurück. Überschreiben Sie diese Methode, wenn ein anderer Bereich neu gezeichnet werden soll.

CMFCToolBarButton::GetParentWnd

Ruft das übergeordnete Fenster der Schaltfläche ab.

CWnd* GetParentWnd() const;

Rückgabewert

Das übergeordnete Fenster der Schaltfläche.

CMFCToolBarButton::GetProtectedCommands

Ruft die Liste der Befehle ab, die der Benutzer nicht anpassen kann.

static const CList<UINT,UINT>& GetProtectedCommands();

Rückgabewert

Die Liste der geschützten Befehle.

Hinweise

Im Anpassungsmodus deaktiviert das Framework Symbolleistenschaltflächenbefehle, die geschützt sind. Der Benutzer kann keine Drag-and-Drop- und Bearbeitungsvorgänge auf deaktivierten Symbolleistenschaltflächen ausführen.

Verwenden Sie die CMFCToolBarButton::SetProtectedCommands-Methode , um die Liste der geschützten Befehle zu definieren.

CMFCToolBarButton::GetTextSize

Ruft die Größe des Schaltflächentexts ab.

SIZE GetTextSize() const;

Rückgabewert

Ein SIZE-Objekt, das die Größe des Schaltflächentexts in Pixel enthält.

CMFCToolBarButton::HasFocus

Bestimmt, ob die Schaltfläche den aktuellen Eingabefokus hat.

virtual BOOL HasFocus() const;

Rückgabewert

Nonzero, wenn die Schaltfläche den Eingabefokus hat; andernfalls 0.

Hinweise

Die Standardimplementierung dieser Methode gibt nonzero zurück, wenn die Schaltfläche den Eingabefokus hat oder ein untergeordnetes oder untergeordnetes Fenster des Fensters ist, das den Eingabefokus besitzt. Sie können diese Funktion außer Kraft setzen, um dieses Verhalten anzupassen.

CMFCToolBarButton::HaveHotBorder

Bestimmt, ob ein Rahmen der Schaltfläche angezeigt wird, wenn ein Benutzer die Schaltfläche auswählt.

virtual BOOL HaveHotBorder() const;

Rückgabewert

Diese Methode gibt TRUE zurück.

Hinweise

Das Framework ruft diese Methode auf, um zu bestimmen, ob die Symbolleistenschaltfläche ihren Rahmen anzeigen soll, wenn ein Benutzer ihn auswählt.

Die Standardimplementierung gibt TRUE zurück. Sie können diese Methode außer Kraft setzen, um dieses Verhalten anzupassen.

CMFCToolBarButton::IsDrawImage

Bestimmt, ob ein Bild auf der Schaltfläche angezeigt wird.

BOOL IsDrawImage() const;

Rückgabewert

Nonzero, wenn ein Bild auf der Schaltfläche angezeigt wird; andernfalls 0.

Hinweise

Diese Methode gibt FALSE zurück, wenn die Symbolleistenschaltfläche kein zugeordnetes Bild aufweist ( CMFCToolBarButton::GetImage returns -1) oder wenn CMFCToolBarButton::m_bImage auf FALSE festgelegt ist.

CMFCToolBarButton::IsDrawText

Bestimmt, ob auf der Schaltfläche eine Textbezeichnung angezeigt wird.

BOOL IsDrawText() const;

Rückgabewert

Nonzero, wenn eine Textbezeichnung angezeigt wird; andernfalls 0.

Hinweise

Diese Methode gibt FALSE zurück, wenn die Symbolleistenschaltfläche keine zugehörige Textbeschriftung aufweist ( CMFCToolBarButton::m_strText ist leer) oder CMFCToolBarButton::m_bText auf FALSE festgelegt ist.

CMFCToolBarButton::IsDroppedDown

Bestimmt, ob auf der Schaltfläche ein Untermenü angezeigt wird.

virtual BOOL IsDroppedDown() const;

Rückgabewert

Diese Methode gibt FALSE zurück.

Hinweise

Die Standardimplementierung dieser Methode gibt FALSE zurück. Überschreiben Sie diese Methode, um TRUE zurückzugeben, wenn das Steuerelement ein Untermenü anzeigt.

CMFCToolBarButton::IsEditable

Bestimmt, ob die Schaltfläche angepasst werden kann.

virtual BOOL IsEditable() const;

Rückgabewert

Nonzero, wenn eine Schaltfläche vom Benutzer angepasst werden kann; andernfalls 0.

Hinweise

Das Framework ruft diese Methode auf, um zu bestimmen, ob der Benutzer die Symbolleistenschaltfläche mithilfe von Drag-and-Drop- oder Bearbeitungsvorgängen anpassen kann.

Die Standardimplementierung gibt FALSE zurück, wenn die Befehls-ID der Schaltfläche ein Standardbefehl ist (Sie können dies durch Aufrufen der IsStandardCommand Funktion ermitteln) oder wenn sich die Befehls-ID in der Liste der geschützten Befehle befindet. Weitere Informationen zu geschützten Befehlen finden Sie unter CMFCToolBarButton::GetProtectedCommands und CMFCToolBarButton::SetProtectedCommands.

Überschreiben Sie diese Methode, um das Verhalten anzupassen.

CMFCToolBarButton::IsExtraSize

Bestimmt, ob die Schaltfläche mit einem erweiterten Rahmen angezeigt werden kann.

virtual BOOL IsExtraSize() const;

Rückgabewert

Nonzero, wenn die Symbolleistenschaltfläche mit einem erweiterten Rahmen angezeigt werden kann; andernfalls 0.

Hinweise

Mehrere Skins verwenden zusätzliche Größe für die Rahmen von Symbolleistenschaltflächen (z. B. abgerundete Schaltflächen).

Wenn der Benutzer diese Schaltfläche von einer Symbolleiste in eine andere verschiebt, ruft das Framework die CMFCToolBarButton::OnChangeParentWnd-Methode auf. Die CMFCToolBarButton::OnChangeParentWnd-Methode legt die zusätzliche Größenkennzeichnung auf die der neuen übergeordneten Symbolleiste fest (weitere Informationen finden Sie unter CMFCToolBar::IsButtonExtraSizeAvailable).

CMFCToolBarButton::IsFirstInGroup

Bestimmt, ob sich die Schaltfläche an der ersten Position in der Schaltflächengruppe befindet.

virtual BOOL IsFirstInGroup() const;

Rückgabewert

TRUE, wenn die Schaltfläche die erste Schaltfläche in der Schaltflächengruppe ist; andernfalls FALSE.

Hinweise

Diese Methode definiert eine Schaltflächengruppe als benachbarte Gruppe von Schaltflächen, die in derselben Zeile positioniert sind und durch Trennzeichen oder den Rahmen der Symbolleiste begrenzt sind. Diese Methode gibt FALSE zurück, wenn sich die Symbolleistenschaltfläche auf die Schaltfläche "Anpassen " bezieht. Weitere Informationen zur Schaltfläche "Anpassen " finden Sie unter CMFCToolBar::GetCustomizeButton.

Rufen Sie die CMFCToolBarButton::IsLastInGroup-Methode auf, um zu bestimmen, ob sich die Schaltfläche an der letzten Position in der Schaltflächengruppe befindet.

CMFCToolBarButton::IsHidden

Bestimmt, ob die Schaltfläche ausgeblendet ist.

BOOL IsHidden() const;

Rückgabewert

Nonzero, wenn die Schaltfläche ausgeblendet ist (unsichtbar); andernfalls 0.

Hinweise

Das Framework ruft diese Methode auf, wenn die übergeordnete Symbolleiste gestreckt wird, um zu bestimmen, ob die Symbolleistenschaltfläche sichtbar ist.

Wenn Sie festlegen, dass die Schaltfläche mithilfe der CMFCToolBarButton::SetVisible-Methode unsichtbar ist, verwenden Sie CMFCToolBarButton::IsVisible , um zu bestimmen, ob die Symbolleistenschaltfläche sichtbar ist.

Standardmäßig sind alle Symbolleistenschaltflächen sichtbar. Verwenden Sie die CMFCToolBarButton::Show-Methode , um Symbolleistenschaltflächen auszublenden oder anzuzeigen.

CMFCToolBarButton::IsHorizontal

Bestimmt, ob sich die Schaltfläche auf einer horizontalen Symbolleiste befindet.

BOOL IsHorizontal() const;

Rückgabewert

Nonzero, wenn sich eine Symbolleistenschaltfläche auf einer horizontalen Symbolleiste befindet; andernfalls 0.

Hinweise

Das Framework ruft diese Methode auf, um das Layout von Symbolleistenschaltflächen zu bestimmen.

Diese Methode gibt das m_bHorz Datenelement zurück. Der Standardwert des m_bHorz Datenelements ist TRUE. Er wird bei jedem Aufruf der CMFCToolBarButton::OnDraw-Methode zurückgesetzt.

CMFCToolBarButton::IsLastInGroup

Gibt an, ob sich die Schaltfläche an der letzten Position in der Schaltflächengruppe befindet.

virtual BOOL IsLastInGroup() const;

Rückgabewert

TRUE, wenn die Schaltfläche die letzte Schaltfläche in der Schaltflächengruppe ist; andernfalls FALSE.

Hinweise

Diese Methode definiert eine Schaltflächengruppe als benachbarte Gruppe von Schaltflächen, die in derselben Zeile positioniert sind und durch Trennzeichen oder den Rahmen der Symbolleiste gebunden sind. Diese Methode gibt FALSE zurück, wenn die Symbolleistenschaltfläche keine übergeordnete Symbolleiste hat oder die Symbolleistenschaltfläche auf die Schaltfläche "Anpassen " verweist. Weitere Informationen zur Schaltfläche "Anpassen " finden Sie unter CMFCToolBar::GetCustomizeButton.

Rufen Sie die CMFCToolBarButton::IsFirstInGroup-Methode auf, um zu bestimmen, ob sich die Schaltfläche an der ersten Position in der Schaltflächengruppe befindet.

CMFCToolBarButton::IsLocked

Bestimmt, ob sich die Schaltfläche auf einer gesperrten (nicht anpassbaren) Symbolleiste befindet.

BOOL IsLocked() const;

Rückgabewert

Nonzero, wenn sich die Schaltfläche auf einer gesperrten Symbolleiste befindet; andernfalls 0.

Hinweise

Das Framework ruft diese Methode auf, um zu bestimmen, ob der Benutzer die Symbolleistenschaltfläche mithilfe von Drag-and-Drop- oder Bearbeitungsvorgängen anpassen kann. Legen Sie das gesperrte Attribut auf der übergeordneten Symbolleiste mithilfe der CMFCToolBar::LoadToolBar-Methode fest. Das Framework übergibt den Wert dieses Attributs an den Konstruktor jeder Symbolleistenschaltfläche ( CMFCToolbarButton), die es in die übergeordnete Symbolleiste einfügt.

CMFCToolBarButton::IsOwnerOf

Bestimmt, ob die Schaltfläche der Besitzer des bereitgestellten Fensterhandles ist.

virtual BOOL IsOwnerOf(HWND hwnd);

Parameter

hwnd
[in] Ein Fensterziehpunkt.

Rückgabewert

Nonzero, wenn die Schaltfläche der Besitzer des bereitgestellten Fensterhandle ist; andernfalls 0.

Hinweise

Diese Methode gibt nonzero zurück, wenn hwnd entweder auf den direkten Fensterziehpunkt verweist oder ein untergeordnetes Element des Fensterhandles ist, das der Schaltfläche zugeordnet ist. Diese Methode gibt 0 zurück, wenn hwnd NULL ist.

CMFCToolBarButton::IsVisible

Bestimmt, ob die Symbolleistenschaltfläche sichtbar ist.

BOOL IsVisible() const;

Rückgabewert

Nonzero, wenn die Symbolleistenschaltfläche sichtbar ist; andernfalls 0.

Hinweise

Sie können die Symbolleistenschaltfläche mithilfe der CMFCToolBarButton::SetVisible-Methode ein- oder ausblenden. Rufen Sie die CPane::AdjustSizeImmediate-Methode auf der übergeordneten Symbolleiste auf, nachdem Sie CMFCToolBarButton::SetVisible aufgerufen haben, um das Layout einer übergeordneten Symbolleiste neu zu berechnen.

CMFCToolBarButton::IsWindowVisible

Bestimmt, ob das zugrunde liegende Fensterhandle der Schaltfläche sichtbar ist.

virtual BOOL IsWindowVisible();

Rückgabewert

Nonzero, wenn das zugrunde liegende Fensterhandle der Schaltfläche sichtbar ist; andernfalls 0.

Hinweise

Diese Methode gibt nonzero zurück, wenn das Formatvorlagen-Attribut des zugrunde liegenden Fensterhandle die WS_VISIBLE Formatvorlage enthält. Diese Methode gibt FALSE zurück, wenn das zugrunde liegende Fensterhandle der Schaltfläche NULL ist.

CMFCToolBarButton::m_bImage

Gibt an, ob ein Bild auf der Schaltfläche angezeigt wird.

BOOL m_bImage;

Hinweise

Wenn dieses Datenelement auf TRUE festgelegt ist, zeigt das Framework das Bild an, das der Symbolleistenschaltfläche zugeordnet ist. andernfalls zeigt das Framework das Bild nicht an. Dieses Element wirkt sich auf den Rückgabewert der CMFCToolBarButton::m_bImage-Methode aus.

CMFCToolBarButton::m_bText

Gibt an, ob auf der Schaltfläche eine Textbezeichnung angezeigt wird.

BOOL m_bText;

Hinweise

Wenn dieses Datenelement auf TRUE festgelegt ist, zeigt das Framework die Textbeschriftung der Symbolleistenschaltfläche an. andernfalls zeigt das Framework die Beschriftung nicht an. Dieses Element wirkt sich auf den Rückgabewert der CMFCToolBarButton::m_bText-Methode aus.

CMFCToolBarButton::m_bTextBelow

Gibt an, ob die Textbezeichnung unter dem Bild auf der Schaltfläche angezeigt wird.

BOOL m_bTextBelow;

Hinweise

Wenn diese Membervariable auf TRUE festgelegt ist, zeigt das Framework den Text der Schaltfläche unterhalb des Bilds an. Der Standardwert dieses Elements ist FALSE.

CMFCToolBarButton::m_bUserButton

Gibt an, ob die Schaltfläche über ein benutzerdefiniertes Bild verfügt.

BOOL m_bUserButton;

Hinweise

Dieses Datenelement wird auf TRUE festgelegt, wenn der Schaltfläche ein benutzerdefiniertes Bild zugeordnet ist.

CMFCToolBarButton::m_bWholeText

Gibt an, ob die Schaltfläche die vollständige Beschriftung anzeigt, auch wenn sie nicht in das umgebende Rechteck passt.

BOOL m_bWholeText;

Hinweise

Wenn dieses Datenelement auf TRUE festgelegt ist, zeigt das Framework die Volltextbeschriftung an, indem die Schaltfläche vergrößert wird. Andernfalls schneidet das Framework ab und fügt eine Auslassungspunkte ( ...) an die Textbeschriftung an.

CMFCToolBarButton::m_bWrap

Gibt an, ob die Schaltfläche neben einem Trennzeichen in der nächsten Zeile platziert wird.

BOOL m_bWrap;

Hinweise

Das Framework legt dieses Datenelement auf TRUE fest, wenn die Symbolleistenschaltfläche nicht in die aktuelle Zeile passt oder wenn Sie ein Layout angeben (z. B. eine bestimmte Anzahl von Symbolleistenschaltflächen pro Zeile).

Das Framework platziert diese Schaltfläche in der nächsten Zeile, wenn dieses Datenelement auf TRUE festgelegt ist und die Symbolleiste horizontal angedockt oder unverankert ist.

Der Standardwert dieses Datenelements ist FALSE.

CMFCToolBarButton::m_bWrapText

Gibt an, ob mehrzeilige Textbeschriftungen aktiviert sind.

AFX_IMPORT_DATA static BOOL m_bWrapText;

Hinweise

Wenn diese statische Membervariable WAHR ist, ermöglicht das Framework allen Symbolleisten das Anzeigen von mehrzeiligen Textbeschriftungen auf Symbolleistenschaltflächen.

Der Standardwert dieses Datenelements ist FALSE.

CMFCToolBarButton::m_nID

Die Befehls-ID der Schaltfläche.

UINT m_nID;

Hinweise

Eine Befehls-ID von -1 gibt an, dass die Schaltfläche ein Trennzeichen ist. Alle Schaltflächentrennzeichen weisen die TBBS_SEPARATOR Format auf. Weitere Informationen zu Schaltflächenformatvorlagen finden Sie unter CMFCToolBarButton::m_nStyle .

CMFCToolBarButton::m_nStyle

Die Formatvorlage der Schaltfläche.

UINT m_nStyle;

Hinweise

Siehe Symbolleisten-Steuerelementformatvorlagen für die Liste der verfügbaren Symbolleistenschaltflächenformate.

CMFCToolBarButton::m_strText

Die Textbezeichnung der Schaltfläche.

CString m_strText;

Hinweise

Dieses Datenelement enthält die Textbezeichnung der Schaltfläche. Die Beschriftung kann leer sein.

CMFCToolBarButton::NotifyCommand

Gibt an, ob die Schaltfläche die WM_COMMAND Nachricht verarbeitet.

virtual BOOL NotifyCommand(int iNotifyCode);

Parameter

iNotifyCode
[in] Die Benachrichtigung, die dem Befehl zugeordnet ist.

Rückgabewert

Diese Methode gibt FALSE zurück.

Hinweise

Das Framework ruft diese Methode auf, wenn es darum geht, eine WM_COMMAND Nachricht an das übergeordnete Fenster zu senden.

Standardmäßig gibt diese Methode FALSE zurück. Überschreiben Sie diese Methode, um WAHR zurückzugeben, wenn Sie die WM_COMMAND Nachricht oder FALSE verarbeiten möchten, um anzugeben, dass die übergeordnete Symbolleiste die Nachricht behandeln soll.

CMFCToolBarButton::OnAddToCustomizePage

Wird vom Framework aufgerufen, wenn die Schaltfläche einem Dialogfeld "Anpassen " hinzugefügt wird.

virtual void OnAddToCustomizePage();

Hinweise

Die Standardimplementierung dieser Methode führt nichts aus. Überschreiben Sie diese Methode, wenn Sie eine Aktion ausführen möchten, wenn die Schaltfläche einem Dialogfeld "Anpassen " hinzugefügt wird.

CMFCToolBarButton::OnBeforeDrag

Gibt an, ob die Schaltfläche gezogen werden kann.

virtual BOOL OnBeforeDrag() const;

Rückgabewert

TRUE, wenn die Schaltfläche gezogen werden kann; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, bevor der Benutzer mit dem Ziehen der Schaltfläche beginnt.

Die Standardimplementierung dieser Methode gibt TRUE zurück. Überschreiben Sie diese Methode, um FALSE zurückzugeben, um das Ziehen der Schaltfläche zu deaktivieren.

CMFCToolBarButton::OnBeforeDrop

Gibt an, ob ein Benutzer die Schaltfläche auf der Zielsymbolleiste ablegen kann.

virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);

Parameter

pTarget
[in] Das Ziel des Drag-and-Drop-Vorgangs.

Rückgabewert

TRUE, wenn die Schaltfläche auf der bereitgestellten Zielsymbolleiste abgelegt werden kann; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, bevor die Schaltfläche auf einer Symbolleiste abgelegt wird.

Die Standardimplementierung dieser Methode gibt TRUE zurück. Überschreiben Sie diese Methode, um FALSE zurückzugeben, um den Ablagevorgang für das angegebene Ziel zu deaktivieren.

CMFCToolBarButton::OnCalculateSize

Wird vom Framework aufgerufen, um die Größe der Schaltfläche für den angegebenen Gerätekontext und Andockzustand zu berechnen.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parameter

pDC
[in] Der Gerätekontext, der die Schaltfläche anzeigt.

sizeDefault
[in] Die Standardgröße der Schaltfläche.

bHorz
[in] Der Dockstatus der übergeordneten Symbolleiste. Dieser Parameter ist TRUE, wenn die Symbolleiste horizontal angedockt oder unverankert ist, oder FALSE, wenn die Symbolleiste vertikal angedockt wird.

Rückgabewert

Eine SIZE Struktur, die die Abmessungen der Schaltfläche in Pixel enthält.

Hinweise

Das Framework ruft diese Methode auf, um die Größe der Symbolleistenschaltfläche für den angegebenen Gerätekontext und den Dockzustand zu bestimmen.

Die Standardimplementierung berücksichtigt die Text- und Bildgrößen (wenn sie angezeigt werden), die Text- und Bildpositionen (den Text unten oder rechts neben dem Bild) und den Dockstatus der Symbolleiste.

Überschreiben Sie diese Methode, wenn Sie die Größe einer nicht standardmäßigen Schaltfläche angeben möchten (z. B. eine Bearbeitungsfeldschaltfläche).

CMFCToolBarButton::OnCancelMode

Vom Framework aufgerufen, um die WM_CANCELMODE Nachricht zu verarbeiten.

virtual void OnCancelMode();

Hinweise

Die Standardimplementierung dieser Methode führt nichts aus. Überschreiben Sie diese Methode, wenn Sie die WM_CANCELMODE Nachricht behandeln möchten.

CMFCToolBarButton::OnChangeParentWnd

Wird vom Framework aufgerufen, wenn die Schaltfläche in eine neue Symbolleiste eingefügt wird.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parameter

pWndParent
[in] Das neue übergeordnete Fenster.

Hinweise

Die Schaltfläche wird beispielsweise in eine Symbolleiste eingefügt, wenn der Benutzer sie von einer Symbolleiste auf eine andere Symbolleiste zieht.

Die Standardimplementierung dieser Methode führt nichts aus.

CMFCToolBarButton::OnClick

Wird vom Framework aufgerufen, wenn der Benutzer auf die Maustaste klickt.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay=TRUE);

Parameter

pWnd
[in] Das übergeordnete Fenster der Symbolleistenschaltfläche.

bDelay
[in] TRUE, wenn die Nachricht mit verzögerungsverzögert behandelt werden soll.

Rückgabewert

Diese Methode gibt FALSE zurück.

Hinweise

Das Framework ruft diese Methode auf, wenn der Benutzer auf die Symbolleistenschaltfläche klickt.

Die Standardimplementierung führt nichts aus und gibt FALSE zurück. Überschreiben Sie diese Methode, um einen Wert ungleich Null zurückzugeben, wenn die Schaltfläche die Klicknachricht verarbeitet.

CMFCToolBarButton::OnClickUp

Wird vom Framework aufgerufen, wenn der Benutzer die Maustaste loslässt.

virtual BOOL OnClickUp();

Rückgabewert

Diese Methode gibt FALSE zurück.

Hinweise

Das Framework ruft diese Methode auf, wenn der Benutzer die Symbolleistenschaltfläche loslässt.

Die Standardimplementierung führt nichts aus und gibt FALSE zurück. Überschreiben Sie diese Methode, um einen Wert ungleich Null zurückzugeben, wenn die Schaltfläche die Klicknachricht verarbeitet.

CMFCToolBarButton::OnContextHelp

Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste eine WM_HELPHITTEST Nachricht behandelt.

virtual BOOL OnContextHelp(CWnd* pWnd);

Parameter

pWnd
[in] Das übergeordnete Fenster der Symbolleistenschaltfläche.

Rückgabewert

Diese Methode gibt FALSE zurück.

Hinweise

Die Standardimplementierung dieser Methode führt nichts aus und gibt FALSE zurück. Überschreiben Sie diese Methode, um einen Wert ungleich Null zurückzugeben, wenn die Schaltfläche die Hilfenachricht verarbeitet.

Weitere Informationen zur WM_HELPHITTEST Nachricht finden Sie unter TN028: Unterstützung für kontextbezogene Hilfe.

CMFCToolBarButton::OnCtlColor

Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste eine WM_CTLCOLOR Nachricht behandelt.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parameter

pDC
[in] Der Gerätekontext, der die Schaltfläche anzeigt.

nCtlColor
[in] Die spezifische Farbbenachrichtigung.

Rückgabewert

Ein Handle für das Pinselobjekt, das vom Framework zum Zeichnen des Hintergrunds der Schaltfläche verwendet wird.

Hinweise

Das Framework ruft diese Methode auf, wenn die übergeordnete Symbolleiste die WM_CTLCOLOR Nachricht für eine Symbolleistenschaltfläche verarbeitet, die ein Windows-Steuerelement enthält. Das Framework ruft diese Methode nicht auf, wenn die Symbolleistenschaltfläche fensterlos ist.

Das Framework ruft diese Methode auf, wenn sich das Symbolleistenframework im Anpassungsmodus befindet und die Symbolleistenschaltfläche entsperrt ist. Weitere Informationen zum Anpassungsmodus finden Sie unter CMFCToolBar::SetCustomizeMode. Weitere Informationen zum Sperren von Symbolleistenschaltflächen finden Sie unter CMFCToolBarButton::IsLocked.

Die Standardimplementierung führt nichts aus und gibt NULL zurück.

CMFCToolBarButton::OnCustomizeMenu

Ermöglicht es der Schaltfläche, das bereitgestellte Menü zu ändern, wenn die Anwendung ein Kontextmenü auf der übergeordneten Symbolleiste anzeigt.

virtual BOOL OnCustomizeMenu(CMenu* pMenu);

Parameter

pMenu
[in] Das anzupassende Menü.

Rückgabewert

Diese Methode gibt FALSE zurück.

Hinweise

Die Standardimplementierung führt nichts aus und gibt FALSE zurück. Überschreiben Sie diese Methode, und geben Sie einen Wert ungleich Null zurück, wenn Sie den Inhalt des bereitgestellten Menüs ändern möchten.

CMFCToolBarButton::OnDblClk

Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste eine WM_LBUTTONDBLCLK Nachricht behandelt.

virtual void OnDblClk(CWnd* pWnd);

Parameter

pWnd
[in] – Das übergeordnete Fenster der Schaltfläche.

Hinweise

Diese Methode wird von der Methode aufgerufen, wenn die CMFCToolBar::OnLButtonDblClk übergeordnete Symbolleiste eine WM_LBUTTONDBLCLK Nachricht verarbeitet.

Die Standardimplementierung dieser Methode führt nichts aus.

CMFCToolBarButton::OnDraw

Wird vom Framework aufgerufen, um die Schaltfläche mithilfe der angegebenen Stile und Optionen zu zeichnen.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz=TRUE,
    BOOL bCustomizeMode=FALSE,
    BOOL bHighlight=FALSE,
    BOOL bDrawBorder=TRUE,
    BOOL bGrayDisabledButtons=TRUE);

Parameter

pDC
[in] Der Gerätekontext, der die Schaltfläche anzeigt.

rect
[in] Das umgebende Rechteck der Schaltfläche.

pImages
[in] Die Sammlung von Symbolleistenbildern, die der Schaltfläche zugeordnet sind.

bHorz
[in] Der Dockstatus der übergeordneten Symbolleiste. Dieser Parameter ist TRUE, wenn die Schaltfläche horizontal angedockt wird und FALSE, wenn die Schaltfläche vertikal angedockt wird.

bCustomizeMode
[in] Gibt an, ob sich die Symbolleiste im Anpassungsmodus befindet. Dieser Parameter ist TRUE, wenn sich die Symbolleiste im Anpassungsmodus und FALSE befindet, wenn sich die Symbolleiste nicht im Anpassungsmodus befindet.

bHighlight
[in] Gibt an, ob die Schaltfläche hervorgehoben ist. Dieser Parameter ist TRUE, wenn die Schaltfläche hervorgehoben ist und FALSE, wenn die Schaltfläche nicht hervorgehoben ist.

bDrawBorder
[in] Gibt an, ob die Schaltfläche ihren Rahmen anzeigen soll. Dieser Parameter ist TRUE, wenn die Schaltfläche ihren Rahmen und FALSE anzeigen soll, wenn die Schaltfläche den Rahmen nicht anzeigen soll.

bGrayDisabledButtons
[in] Gibt an, ob deaktivierte Schaltflächen schattieren oder die sammlung deaktivierter Bilder verwendet werden soll. Dieser Parameter ist TRUE, wenn deaktivierte Schaltflächen schattiert werden sollen, und FALSE, wenn diese Methode die deaktivierte Bildersammlung verwenden soll.

Hinweise

Überschreiben Sie diese Methode, um die Zeichnung von Symbolleistenschaltflächen anzupassen.

CMFCToolBarButton::OnDrawOnCustomizeList

Wird vom Framework aufgerufen, um die Schaltfläche im Befehlsbereich des Dialogfelds Anpassen zu zeichnen.

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parameter

pDC
[in] Der Gerätekontext, der die Schaltfläche anzeigt.

rect
[in] Das umgebende Rechteck der Schaltfläche.

bSelected
[in] Gibt an, ob die Schaltfläche ausgewählt ist. Wenn dieser Parameter TRUE ist, wird die Schaltfläche ausgewählt. Wenn dieser Parameter FALSCH ist, ist die Schaltfläche nicht ausgewählt.

Rückgabewert

Die Breite der Schaltfläche im angegebenen Gerätekontext in Pixeln.

Hinweise

Diese Methode wird vom Dialogfeld zum Anpassen ( Befehlsregisterkarte ) aufgerufen, wenn sich die Schaltfläche im Listenfeld "Besitzer zeichnen" selbst anzeigt.

Die Standardimplementierung dieser Methode zeigt das Bild und die Textbezeichnung der Schaltfläche an, wenn sie verfügbar sind. Wenn die Beschriftung der Schaltfläche nicht verfügbar ist, zeigt die Methode den QuickInfo-Text an.

Überschreiben Sie diese Methode, um eine benutzerdefinierte Zeichnung auszuführen.

CMFCToolBarButton::OnGetCustomToolTipText

Vom Framework aufgerufen, um den benutzerdefinierten QuickInfo-Text für die Schaltfläche abzurufen.

virtual BOOL OnGetCustomToolTipText(CString& strToolTip);

Parameter

strToolTip
[out] Ein CString Objekt, das den benutzerdefinierten QuickInfo-Text empfängt.

Rückgabewert

Diese Methode gibt FALSE zurück.

Hinweise

Das Framework ruft diese Methode auf, wenn die QuickInfo für die Symbolleistenschaltfläche angezeigt wird. Wenn diese Methode FALSE zurückgibt, verwendet das Framework eine Standard-QuickInfo.

Die Standardimplementierung führt nichts aus und gibt FALSE zurück. Überschreiben Sie diese Methode, und geben Sie einen Wert ungleich Null zurück, um benutzerdefinierten QuickInfo-Text für die Symbolleistenschaltfläche bereitzustellen.

CMFCToolBarButton::OnGlobalFontsChanged

Wird vom Framework aufgerufen, wenn sich die globale Schriftart geändert hat.

virtual void OnGlobalFontsChanged();

Hinweise

Die Standardimplementierung dieser Methode führt nichts aus. Überschreiben Sie diese Methode, um die Schriftart zu aktualisieren, die zum Anzeigen des Schaltflächentexts verwendet wird.

CMFCToolBarButton::OnMove

Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste verschoben wird.

virtual void OnMove();

Hinweise

Die Standardimplementierung dieser Methode führt nichts aus. Überschreiben Sie diese Methode, um die Schaltfläche neu zu positionieren, wenn die übergeordnete Symbolleiste verschoben wird.

CMFCToolBarButton::OnShow

Wird vom Framework aufgerufen, wenn die Schaltfläche sichtbar oder unsichtbar wird.

virtual void OnShow(BOOL bShow);

Parameter

bShow
[in] Gibt an, ob die Schaltfläche sichtbar ist. Wenn dieser Parameter TRUE ist, ist die Schaltfläche sichtbar. Andernfalls ist die Schaltfläche nicht sichtbar.

Hinweise

Die Standardimplementierung dieser Methode führt nichts aus. Überschreiben Sie diese Methode, um die Sichtbarkeit der Schaltfläche zu aktualisieren.

CMFCToolBarButton::OnSize

Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste seine Größe oder Position ändert und diese Änderung bewirkt, dass die Schaltfläche die Größe ändert.

virtual void OnSize(int iSize);

Parameter

iSize
[in] Die neue Breite der Schaltfläche.

Hinweise

Die Standardimplementierung dieser Methode führt nichts aus. Überschreiben Sie diese Methode, um die Größe der Schaltfläche zu ändern, wenn sich die Größe oder Position der übergeordneten Symbolleiste ändert.

CMFCToolBarButton::OnToolHitTest

Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste bestimmen muss, ob sich ein Punkt im umgebenden Rechteck der Schaltfläche befindet.

virtual BOOL OnToolHitTest(
    const CWnd* pWnd,
    TOOLINFO* pTI);

Parameter

pWnd
[in] Das übergeordnete Fenster der Schaltfläche. Kann den Wert NULL haben.

Pti
[in] Eine TOOLINFO Struktur, die Informationen zu einem Tool in einem QuickInfo-Steuerelement enthält.

Rückgabewert

Das Ergebnis, OnMenuButtonToolHitTest wenn die Schaltfläche einen Zeiger auf das übergeordnete Framefenster abrufen kann; andernfalls FALSE.

Hinweise

Diese Methode ruft eine der folgenden Methoden auf, wenn das übergeordnete Fenster in ein gültiges Frameobjekt konvertiert werden kann:

CMFCToolBarButton::OnUpdateToolTip

Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste den QuickInfo-Text aktualisiert.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parameter

pWndParent
[in] Das übergeordnete Fenster.

iButtonIndex
[in] Der nullbasierte Index der Schaltfläche in der übergeordneten Schaltflächensammlung.

wndToolTip
[in] Das Steuerelement, das den QuickInfo-Text anzeigt.

str
[out] Ein CString Objekt, das den aktualisierten QuickInfo-Text empfängt.

Rückgabewert

Diese Methode gibt FALSE zurück.

Hinweise

Die Standardimplementierung dieser Methode führt nichts aus und gibt FALSE zurück. Überschreiben Sie diese Methode, um einen Wert ungleich Null zurückzugeben, wenn Sie eine QuickInfo-Textzeichenfolge angeben.

CMFCToolBarButton::P repareDrag

Wird vom Framework aufgerufen, wenn die Schaltfläche eine Drag-and-Drop-Operation ausführt.

virtual BOOL PrepareDrag(COleDataSource& srcItem);

Parameter

srcItem
[in] Ein COleDataSource Objekt, das Zustandsinformationen zum Drag-and-Drop-Vorgang speichert.

Rückgabewert

TRUE, wenn der Vorgang erfolgreich ist; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, um die Symbolleistenschaltfläche vorzubereiten, um den Zustand im bereitgestellten COleDataSource Objekt zu speichern. Diese Methode speichert ihren Zustand, indem sie sich selbst in eine freigegebene Datei serialisieren und diese Datei dann an die COleDataSource::CacheGlobalData-Methode übergeben. Weitere Informationen zur Serialisierung der Symbolleistenschaltfläche finden Sie unter CMFCToolBarButton::Serialize.

Diese Methode führt nichts aus und gibt TRUE zurück, wenn die Schaltfläche nicht gespeichert werden kann (die CMFCToolBarButton::CanBeStored-Methode gibt FALSE zurück). Er gibt FALSE zurück, wenn während der Objekt serialisierung eine Ausnahme auftritt.

Weitere Informationen zu OLE-Drag-and-Drop-Vorgängen finden Sie unter OLE-Ziehen und -Ablegen.

CMFCToolBarButton::Rect

Ruft das umgebende Rechteck der Schaltfläche ab.

const CRect& Rect() const;

Rückgabewert

Ein CRect Objekt, das das umgebende Rechteck einer Schaltfläche enthält.

CMFCToolBarButton::ResetImageToDefault

Legt den Standardwert auf das Bild fest, das der Schaltfläche zugeordnet ist.

virtual void ResetImageToDefault();

Hinweise

Diese Methode ruft das Standardbild mithilfe der CMFCToolBar::GetDefaultImage-Methode von der übergeordneten Symbolleiste ab. Wenn die Schaltfläche kein Standardbild zugeordnet ist, legt diese Methode die Beschriftung der Schaltfläche entsprechend ihrer Zeichenfolgenressource mithilfe der CStringT::LoadString-Methode fest. Weitere Informationen zu Zeichenfolgenressourcen finden Sie unter Arbeiten mit Ressourcendateien.

Diese Methode führt nichts aus, wenn die Schaltfläche über ein benutzerdefiniertes Bild verfügt.

CMFCToolBarButton::SaveBarState

Speichert den Status der Symbolleistenschaltfläche.

virtual void SaveBarState();

Hinweise

Das Framework ruft diese Methode auf, wenn ein CMFCToolBarButton Objekt als Ergebnis eines Drag-and-Drop-Vorgangs erstellt wird.

Die Standardimplementierung dieser Methode führt nichts aus. Überschreiben Sie diese Methode, um den Status der Symbolleistenschaltfläche in einer externen Datenquelle zu speichern.

CMFCToolBarButton::Serialize

Liest dieses Objekt aus einem Archiv oder schreibt es in ein Archiv.

virtual void Serialize(CArchive& ar);

Parameter

Ar
[in] Das CArchive Objekt, von dem bzw. von dem aus serialisiert werden soll.

Hinweise

Diese Methode unterstützt Datenübertragungsprozesse wie Zwischenablage- oder Drag-and-Drop-Vorgänge. Sie liest oder schreibt Eigenschaften der Schaltfläche, z. B. ID, Textbezeichnung und Bild-ID von oder in das bereitgestellte CArchive Objekt.

Beispiele für die Serialisierung finden Sie unter Serialisierung: Serialisieren eines Objekts.

CMFCToolBarButton::SetACCData

Füllt das bereitgestellte CAccessibilityData Objekt mit Barrierefreiheitsdaten aus der Symbolleistenschaltfläche auf.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parameter

pParent
[in] Das übergeordnete Fenster der Symbolleistenschaltfläche.

data
[in] Ein CAccessibilityData Objekt, das mit den Barrierefreiheitsdaten der Symbolleistenschaltfläche aufgefüllt wird.

Rückgabewert

Diese Methode gibt TRUE zurück.

Hinweise

Überschreiben Sie diese Methode, um FALSE zurückzugeben, wenn ihre Symbolleistenschaltfläche keine Barrierefreiheitsdaten bereitstellt.

CMFCToolBarButton::SetClipboardFormatName

Benennt das globale Zwischenablageformat um.

static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);

Parameter

lpszName
[in] Der neue Name des globalen Zwischenablageformats. Lässt keine NULL-Werte zu.

Hinweise

Mit dieser Methode können Drag-and-Drop-Vorgänge zwischen mehreren Anwendungen ausgeführt werden. Jede Anwendung muss denselben Namen des Zwischenablageformats angeben.

Sie müssen diese Methode aufrufen, bevor das Framework CMFCToolBarButton::GetClipboardFormat aufruft.

CMFCToolBarButton::SetImage

Legt den Bildindex der Schaltfläche fest.

virtual void SetImage(int iImage);

Parameter

iImage
[in] Der Index des Bilds in der Sammlung von Symbolleistenbildern.

Hinweise

Wenn es sich bei der Symbolleistenschaltfläche um ein Trennzeichen handelt, verweist iImage auf die neue Breite der Trennzeichenschaltfläche.

Wenn iImage kleiner als 0 ist, deaktiviert diese Methode die Zeichnung des Bilds und aktiviert das Zeichnen der Textbezeichnung der Schaltfläche.

CMFCToolBarButton::SetProtectedCommands

Legt die Liste der Befehle fest, die der Benutzer nicht anpassen kann.

static void SetProtectedCommands(const CList<UINT,UINT>& lstCmds);

Parameter

lstCmds
[in] Die Liste der geschützten Befehle.

Hinweise

Im Anpassungsmodus deaktiviert das Framework Symbolleistenschaltflächenbefehle, die geschützt sind. Der Benutzer kann keine Drag-and-Drop- und Bearbeitungsvorgänge auf deaktivierten Symbolleistenschaltflächen ausführen.

Verwenden Sie die CMFCToolBarButton::GetProtectedCommands-Methode , um die Liste der geschützten Befehle abzurufen.

CMFCToolBarButton::SetRadio

Wird vom Framework aufgerufen, wenn eine Schaltfläche ihren aktivierten Zustand ändert.

virtual void SetRadio();

Hinweise

Die Standardimplementierung dieser Methode führt nichts aus. Überschreiben Sie diese Methode, um eine benutzerdefinierte Aktion auszuführen, wenn die Schaltfläche ihren aktivierten Zustand ändert.

CMFCToolBarButton::SetRect

Legt das umgebende Rechteck der Schaltfläche fest.

void SetRect(const CRect rect);

Parameter

rect
[in] Das neue umgebende Rechteck der Schaltfläche.

Hinweise

Diese Methode ruft die CMFCToolBarButton::OnMove-Methode auf, nachdem das neue umgebende Rechteck festgelegt wurde.

CMFCToolBarButton::SetStyle

Legt den Stil der Schaltfläche fest.

virtual void SetStyle(UINT nStyle);

Parameter

nStyle
[in] Die neue Formatvorlage der Schaltfläche.

Hinweise

Die Standardimplementierung legt das CMFCToolBarButton::m_nStyle-Datenelement auf nStyle fest. Überschreiben Sie diese Methode, wenn Sie eine zusätzliche Verarbeitung durchführen möchten, um die Änderung der Formatvorlage zu verarbeiten. Eine Liste der gültigen Formatvorlagen finden Sie unter ToolBar-Steuerelementstile .

CMFCToolBarButton::SetVisible

Gibt an, ob die Schaltfläche sichtbar ist.

void SetVisible(BOOL bShow=TRUE);

Parameter

bShow
[in] Ein boolescher Wert, der angibt, ob die Schaltfläche ein- oder ausgeblendet werden soll. Wenn dieser Parameter WAHR ist, wird die Schaltfläche angezeigt. Wenn der Parameter FALSE ist, wird die Schaltfläche ausgeblendet.

Hinweise

Verwenden Sie diese Funktion, um eine bestimmte Symbolleistenschaltfläche auszublenden oder anzuzeigen. Rufen Sie die CPane::AdjustSizeImmediate-Methode auf, nachdem Sie diese Methode aufgerufen haben.

CMFCToolBarButton::Show

Blendet die Schaltfläche ein oder aus.

void Show(BOOL bShow);

Parameter

bShow
[in] Ein boolescher Wert, der angibt, ob die Schaltfläche ein- oder ausgeblendet werden soll. Wenn dieser Parameter WAHR ist, wird die Schaltfläche angezeigt. Wenn der Parameter FALSE ist, wird die Schaltfläche ausgeblendet.

Hinweise

Das Framework ruft diese Methode auf, um die Sichtbarkeit von Symbolleistenschaltflächen zu aktualisieren, wenn die Größe der übergeordneten Symbolleiste geändert wird. Das Framework ruft diese Methode auf, wobei bShow auf FALSE festgelegt ist, wenn die Schaltfläche nicht mehr in die Grenzen der Symbolleiste passt. Das Framework ruft diese Methode mit bShow auf TRUE auf, wenn nach dem Ändern der Größe der Schaltfläche wieder in die Grenzen der Symbolleiste passt.

Verwenden Sie die CMFCToolBarButton::SetVisible-Methode , um die allgemeine Sichtbarkeit der Schaltfläche festzulegen.

Diese Methode ruft die CMFCToolBarButton::OnShow-Methode auf, nachdem sie den Sichtbarkeitsstatus der Schaltfläche aktualisiert hat.

Siehe auch

Hierarchiediagramm
Klassen
CMFCToolBar-Klasse
CMFCToolBarImages-Klasse