CMFCToolBarButton-Klasse
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_bWer leText | 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 Class Standard tained. 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
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.
Blockiert
[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_bWer leText
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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für