CMFCToolBarEditBoxButton-Klasse

Eine Symbolleistenschaltfläche, die ein Bearbeitungssteuerelement enthält ( CEdit-Klasse).

Syntax

class CMFCToolBarEditBoxButton : public CMFCToolBarButton

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCToolBarEditBoxButton::CMFCToolBarEditBoxButton Erstellt ein CMFCToolBarEditBoxButton-Objekt.
CMFCToolBarEditBoxButton::~CMFCToolBarEditBoxButton Destruktor.

Öffentliche Methoden

Name Beschreibung
CMFCToolBarEditBoxButton::CanBeStretched Gibt an, ob ein Benutzer die Schaltfläche während der Anpassung strecken kann. (Außerkraftsetzungen CMFCToolBarButton::CanBeStretched.)
CMFCToolBarEditBoxButton::CopyFrom Kopiert die Eigenschaften einer anderen Symbolleistenschaltfläche auf die aktuelle Schaltfläche. (Außerkraftsetzungen CMFCToolBarButton::CopyFrom.)
CMFCToolBarEditBoxButton::CMFCToolBarEditBoxButton::CreateEdit Erstellt ein neues Bearbeitungssteuerelement in der Schaltfläche.
CMFCToolBarEditBoxButton::CreateObject Wird vom Framework verwendet, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CMFCToolBarEditBoxButton::GetByCmd Ruft das erste CMFCToolBarEditBoxButton Objekt in der Anwendung ab, das die angegebene Befehls-ID aufweist.
CMFCToolBarEditBoxButton::GetContentsAll Ruft den Text des ersten Bearbeitungsfeldsymbolleisten-Steuerelements ab, das über die angegebene Befehls-ID verfügt.
CMFCToolBarEditBoxButton::GetContextMenuID Ruft die Ressourcen-ID des Kontextmenüs ab, das der Schaltfläche zugeordnet ist.
CMFCToolBarEditBoxButton::GetEditBorder Ruft das umgebende Rechteck des Bearbeitungsbereichs der Bearbeitungsschaltfläche ab.
CMFCToolBarEditBoxButton::CMFCToolBarEditBoxButton::GetEditBox Gibt einen Zeiger auf das Bearbeitungssteuerelement zurück, das in die Schaltfläche eingebettet ist.
CMFCToolBarEditBoxButton::GetHwnd Ruft das Fensterhandle ab, das der Symbolleistenschaltfläche zugeordnet ist. (Außerkraftsetzungen CMFCToolBarButton::GetHwnd.)
CMFCToolBarEditBoxButton::GetInvalidateRect Ruft den Bereich des Clientbereichs der Schaltfläche ab, die neu gezeichnet werden muss. (Außerkraftsetzungen CMFCToolBarButton::GetInvalidateRect.)
CMFCToolBarEditBoxButton::GetThisClass Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass -Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCToolBarEditBoxButton::HaveHotBorder Bestimmt, ob ein Rahmen der Schaltfläche angezeigt wird, wenn ein Benutzer auf die Schaltfläche klickt. (Außerkraftsetzungen CMFCToolBarButton::HaveHotBorder.)
CMFCToolBarEditBoxButton::IsFlatMode Bestimmt, ob Schaltflächen für Bearbeitungsfelder eine flache Formatvorlage aufweisen.
CMFCToolBarEditBoxButton::NotifyCommand Gibt an, ob die Schaltfläche die WM_COMMAND Nachricht verarbeitet. (Außerkraftsetzungen CMFCToolBarButton::NotifyCommand.)
CMFCToolBarEditBoxButton::OnAddToCustomizePage Wird vom Framework aufgerufen, wenn die Schaltfläche einem Dialogfeld "Anpassen " hinzugefügt wird. (Außerkraftsetzungen CMFCToolBarButton::OnAddToCustomizePage.)
CMFCToolBarEditBoxButton::OnCalculateSize Wird vom Framework aufgerufen, um die Größe der Schaltfläche für den angegebenen Gerätekontext und Andockzustand zu berechnen. (Außerkraftsetzungen CMFCToolBarButton::OnCalculateSize.)
CMFCToolBarEditBoxButton::OnChangeParentWnd Wird vom Framework aufgerufen, wenn die Schaltfläche in eine neue Symbolleiste eingefügt wird. (Außerkraftsetzungen CMFCToolBarButton::OnChangeParentWnd.)
CMFCToolBarEditBoxButton::OnClick Wird vom Framework aufgerufen, wenn der Benutzer auf die Maustaste klickt. (Außerkraftsetzungen CMFCToolBarButton::OnClick.)
CMFCToolBarEditBoxButton::OnCtlColor Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste eine WM_CTLCOLOR Nachricht behandelt. (Außerkraftsetzungen CMFCToolBarButton::OnCtlColor.)
CMFCToolBarEditBoxButton::OnDraw Wird vom Framework aufgerufen, um die Schaltfläche mithilfe der angegebenen Stile und Optionen zu zeichnen. (Außerkraftsetzungen CMFCToolBarButton::OnDraw.)
CMFCToolBarEditBoxButton::OnDrawOnCustomizeList Wird vom Framework aufgerufen, um die Schaltfläche im Befehlsbereich des Dialogfelds Anpassen zu zeichnen. (Außerkraftsetzungen CMFCToolBarButton::OnDrawOnCustomizeList.)
CMFCToolBarEditBoxButton::OnGlobalFontsChanged Wird vom Framework aufgerufen, wenn sich die globale Schriftart geändert hat. (Außerkraftsetzungen CMFCToolBarButton::OnGlobalFontsChanged.)
CMFCToolBarEditBoxButton::OnMove Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste verschoben wird. (Außerkraftsetzungen CMFCToolBarButton::OnMove.)
CMFCToolBarEditBoxButton::OnShow Wird vom Framework aufgerufen, wenn die Schaltfläche sichtbar oder unsichtbar wird. (Außerkraftsetzungen CMFCToolBarButton::OnShow.)
CMFCToolBarEditBoxButton::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. (Außerkraftsetzungen CMFCToolBarButton::OnSize.)
CMFCToolBarEditBoxButton::OnUpdateToolTip Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste den QuickInfo-Text aktualisiert. (Außerkraftsetzungen CMFCToolBarButton::OnUpdateToolTip.)
CMFCToolBarEditBoxButton::Serialize Liest dieses Objekt aus einem Archiv oder schreibt es in ein Archiv. (Außerkraftsetzungen CMFCToolBarButton::Serialize.)
CMFCToolBarEditBoxButton::SetACCData Füllt das bereitgestellte CAccessibilityData Objekt mit Barrierefreiheitsdaten aus der Symbolleistenschaltfläche auf. (Außerkraftsetzungen CMFCToolBarButton::SetACCData.)
CMFCToolBarEditBoxButton::CMFCToolBarEditBoxButton::SetContents Legt den Text im Bearbeitungssteuerelement der Schaltfläche fest.
CMFCToolBarEditBoxButton::CMFCToolBarEditBoxButton::SetContentsAll Sucht nach der Bearbeitungssteuerelementschaltfläche mit einer angegebenen Befehls-ID und legt den Text im Bearbeitungssteuerelement dieser Schaltfläche fest.
CMFCToolBarEditBoxButton::SetContextMenuID Gibt die Ressourcen-ID des Kontextmenüs an, das der Schaltfläche zugeordnet ist.
CMFCToolBarEditBoxButton::SetFlatMode Gibt die flache Darstellung von Bearbeitungsfeldschaltflächen in der Anwendung an.
CMFCToolBarEditBoxButton::CMFCToolBarEditBoxButton::SetStyle Gibt die Formatvorlage der Schaltfläche an. (Außerkraftsetzungen CMFCToolBarButton::SetStyle.)

Hinweise

Führen Sie die folgenden Schritte aus, um einer Symbolleiste eine Bearbeitungsfeldschaltfläche hinzuzufügen:

  1. Reservieren Sie eine Platzhalterressourcen-ID für die Schaltfläche in der übergeordneten Symbolleistenressource.

  2. Konstruieren Sie ein CMFCToolBarEditBoxButton-Objekt.

  3. Ersetzen Sie im Nachrichtenhandler, der die AFX_WM_RESETTOOLBAR Nachricht verarbeitet, die Dummy-Schaltfläche durch die neue Kombinationsfeldschaltfläche mithilfe von CMFCToolBar::ReplaceButton.

Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Einfügen von Steuerelementen auf Symbolleisten.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung verschiedener Methoden in der CMFCToolBarEditBoxButton -Klasse. Das Beispiel zeigt, wie Sie angeben, dass ein Benutzer die Schaltfläche während der Anpassung strecken kann, angeben, dass ein Rahmen der Schaltfläche angezeigt wird, wenn ein Benutzer auf die Schaltfläche klickt, den Text im Textfeld-Steuerelement festlegen, die flache Darstellung von Bearbeitungsfeldschaltflächen in der Anwendung angeben und die Formatvorlage eines Symbolleisten-Bearbeitungsfeld-Steuerelements angeben.

CMFCToolBarEditBoxButton *boxButton = new CMFCToolBarEditBoxButton();
boxButton->CanBeStretched();
boxButton->HaveHotBorder();
boxButton->SetContents(_T("edit box button"));
boxButton->SetFlatMode(true);
boxButton->SetStyle(TBBS_PRESSED);

Vererbungshierarchie

CObject

CMFCToolBarButton

CMFCToolBarEditBoxButton

Anforderungen

Header: afxtoolbareditboxbutton.h

CMFCToolBarEditBoxButton::CanBeStretched

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

virtual BOOL CanBeStretched() const;

Rückgabewert

Diese Methode gibt TRUE zurück.

Hinweise

Standardmäßig lässt das Framework dem Benutzer nicht zu, eine Symbolleistenschaltfläche während der Anpassung zu strecken. Diese Methode erweitert die Basisklassenimplementierung ( CMFCToolBarButton::CanBeStretched), indem der Benutzer während der Anpassung eine Symbolleistenschaltfläche des Bearbeitungsfelds dehnen kann.

CMFCToolBarEditBoxButton::CMFCToolBarEditBoxButton

Erstellt ein CMFCToolBarEditBoxButton -Objekt.

CMFCToolBarEditBoxButton(
    UINT uiID,
    int iImage,
    DWORD dwStyle=ES_AUTOHSCROLL,
    int iWidth=0);

Parameter

uiID
[in] Gibt die Steuerelement-ID an.

iImage
[in] Gibt den nullbasierten Index eines Symbolleistenbilds an. Das Bild befindet sich im CMFCToolBarImages-Klassenobjekt, das die CMFCToolBar-Klasse Standard tains aufweist.

dwStyle
[in] Gibt das Bearbeitungssteuerelementformat an.

iWidth
[in] Gibt die Breite des Bearbeitungssteuerelements in Pixel an.

Hinweise

Der Standardkonstruktor legt den Bearbeitungssteuerelementstil auf die folgende Kombination fest:

WS_CHILD | WS_VISIBLE | ES_AUTOHSCROLL

Die Standardbreite des Steuerelements beträgt 150 Pixel.

CMFCToolBarEditBoxButton::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. src muss vom Typ CMFCToolBarEditBoxButtonsein.

CMFCToolBarEditBoxButton::CreateEdit

Erstellt ein neues Bearbeitungssteuerelement in der Schaltfläche.

virtual CEdit* CreateEdit(
    CWnd* pWndParent,
    const CRect& rect);

Parameter

pWndParent
[in] Gibt das übergeordnete Fenster des Bearbeitungssteuerelements an. Er darf nicht NULL sein.

Rect
[in] Gibt die Größe und Position des Bearbeitungssteuerelements an.

Rückgabewert

Ein Zeiger auf das neu erstellte Bearbeitungssteuerelement; Dies ist NULL, wenn die Erstellung und Anlage des Steuerelements fehlschlagen.

Hinweise

Sie erstellen ein CMFCToolBarEditBoxButton Objekt in zwei Schritten. Rufen Sie zuerst den Konstruktor auf, und rufen Sie CreateEditdann auf, wodurch das Windows-Bearbeitungssteuerelement erstellt und an das CMFCToolBarEditBoxButton Objekt angefügt wird.

CMFCToolBarEditBoxButton::GetByCmd

Ruft das erste CMFCToolBarEditBoxButton Objekt in der Anwendung ab, das die angegebene Befehls-ID aufweist.

static CMFCToolBarEditBoxButton* __stdcall GetByCmd(UINT uiCmd);

Parameter

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

Rückgabewert

Das erste CMFCToolBarEditBoxButton Objekt in der Anwendung mit der angegebenen Befehls-ID oder NULL, wenn kein solches Objekt vorhanden ist.

Hinweise

Diese freigegebene Hilfsmethode wird von Methoden wie CMFCToolBarEditBoxButton::SetContentsAll und CMFCToolBarEditBoxButton::GetContentsAll verwendet, um den Text des ersten Bearbeitungsfeldsymbolleisten-Steuerelements festzulegen oder abzurufen, das die angegebene Befehls-ID aufweist.

CMFCToolBarEditBoxButton::GetContentsAll

Ruft den Text des ersten Bearbeitungsfeldsymbolleisten-Steuerelements ab, das über die angegebene Befehls-ID verfügt.

static CString __stdcall GetContentsAll(UINT uiCmd);

Parameter

uiCmd
[in] Die Befehls-ID der Schaltfläche, aus der Inhalte abgerufen werden sollen.

Rückgabewert

Ein CString Objekt, das den Text des ersten Bearbeitungsfeldsymbolleisten-Steuerelements mit der angegebenen Befehls-ID enthält.

Hinweise

Diese Methode gibt die leere Zeichenfolge zurück, wenn keine CMFCToolBarEditBoxButton Objekte die angegebene Befehls-ID aufweisen.

CMFCToolBarEditBoxButton::GetContextMenuID

Ruft die Ressourcen-ID des Kontextmenüs ab, das der Schaltfläche zugeordnet ist.

UINT GetContextMenuID();

Rückgabewert

Die Ressourcen-ID des Kontextmenüs, das der Schaltfläche zugeordnet ist, oder 0, wenn die Schaltfläche kein zugeordnetes Kontextmenü aufweist.

Hinweise

Das Framework verwendet die Ressourcen-ID, um das Kontextmenü zu erstellen, wenn der Benutzer mit der rechten Maustaste auf die Schaltfläche klickt.

CMFCToolBarEditBoxButton::GetEditBorder

Ruft das umgebende Rechteck des Bearbeitungsbereichs der Bearbeitungsschaltfläche ab.

virtual void GetEditBorder(CRect& rectBorder);

Parameter

rectBorder
[out] Ein Verweis auf das CRect Objekt, das das umgebende Rechteck empfängt.

Hinweise

Diese Methode ruft das umgebende Rechteck des Bearbeitungssteuerelements in Clientkoordinaten ab. Es erweitert die Größe des Rechtecks in jeder Richtung um ein Pixel.

Die CMFCVisualManager::OnDrawEditBorder-Methode ruft diese Methode auf, wenn sie den Rahmen um ein CMFCToolBarEditBoxButton Objekt zeichnet.

CMFCToolBarEditBoxButton::GetEditBox

Gibt einen Zeiger auf das CEdit-Klassensteuerelement zurück, das in die Schaltfläche eingebettet ist.

CEdit* GetEditBox() const;

Rückgabewert

Ein Zeiger auf das CEdit-Klassensteuerelement , das die Schaltfläche enthält. Es ist NULL, wenn das CEdit Steuerelement noch nicht erstellt wurde.

Hinweise

Sie erstellen das CEdit Steuerelement durch Aufrufen von CMFCToolBarEditBoxButton::CreateEdit.

CMFCToolBarEditBoxButton::GetHwnd

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

virtual HWND GetHwnd();

Rückgabewert

Das Fensterhandle, das der Schaltfläche zugeordnet ist.

Hinweise

Diese Methode setzt die CMFCToolBarButton::GetHwnd-Methode außer Kraft, indem das Fensterhandle des Bearbeitungssteuerelementteils der Schaltfläche "Bearbeitungsfeld" zurückgegeben wird.

CMFCToolBarEditBoxButton::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

Diese Methode erweitert die Basisklassenimplementierung CMFCToolBarButton::GetInvalidateRect, indem sie den Bereich der Textbezeichnung in den Bereich einbezieht.

CMFCToolBarEditBoxButton::HaveHotBorder

Bestimmt, ob ein Rahmen der Schaltfläche angezeigt wird, wenn ein Benutzer auf die Schaltfläche klickt.

virtual BOOL HaveHotBorder() const;

Rückgabewert

Nonzero, wenn eine Schaltfläche den Rahmen anzeigt, wenn sie ausgewählt ist; andernfalls 0.

Hinweise

Diese Methode erweitert die Basisklassenimplementierung CMFCToolBarButton::HaveHotBorder, indem ein Wert ungleich Null zurückgegeben wird, wenn das Steuerelement sichtbar ist.

CMFCToolBarEditBoxButton::IsFlatMode

Bestimmt, ob Schaltflächen für Bearbeitungsfelder eine flache Formatvorlage aufweisen.

static BOOL __stdcall IsFlatMode();

Rückgabewert

Nonzero, wenn die Schaltflächen eine flache Formatvorlage aufweisen; andernfalls 0.

Hinweise

Standardmäßig weisen Bearbeitungsfeldschaltflächen eine flache Formatvorlage auf. Verwenden Sie die CMFCToolBarEditBoxButton::SetFlatMode-Methode , um die Darstellung des flachen Stils für Ihre Anwendung zu ändern.

CMFCToolBarEditBoxButton::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

TRUE, wenn die Schaltfläche die WM_COMMAND Nachricht verarbeitet, oder FALSE, um anzugeben, dass die Nachricht von der übergeordneten Symbolleiste behandelt werden muss.

Hinweise

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

Diese Methode erweitert die Basisklassenimplementierung ( CMFCToolBarButton::NotifyCommand), indem die EN_UPDATE Benachrichtigung verarbeitet wird. Für jedes Bearbeitungsfeld mit derselben Befehls-ID wie dieses Objekt wird dessen Beschriftung auf die Textbeschriftung dieses Objekts festgelegt.

CMFCToolBarEditBoxButton::OnAddToCustomizePage

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

virtual void OnAddToCustomizePage();

Hinweise

Diese Methode erweitert die Implementierung der Basisklasse ( CMFCToolBarButton::OnAddToCustomizePage) durch Kopieren der Eigenschaften aus dem Bearbeitungsfeld-Steuerelement in jede Symbolleiste mit derselben Befehls-ID wie dieses Objekt. Diese Methode führt nichts aus, wenn keine Symbolleiste über ein Bearbeitungsfeld-Steuerelement verfügt, das dieselbe Befehls-ID wie dieses Objekt aufweist.

Weitere Informationen zum Dialogfeld "Anpassen " finden Sie unter CMFCToolBarsCustomizeDialog-Klasse.

CMFCToolBarEditBoxButton::OnChangeParentWnd

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

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parameter

pWndParent
[in] Ein Zeiger auf das neue übergeordnete Fenster.

Hinweise

Diese Methode setzt die Implementierung der Basisklasse außer Kraft ( CMFCToolBarButton::OnChangeParentWnd), indem das interne CEdit Objekt neu erstellt wird.

CMFCToolBarEditBoxButton::OnClick

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

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

Parameter

pWnd
[in] Nicht verwendet.

bDelay
[in] Nicht verwendet.

Rückgabewert

Nonzero, wenn die Schaltfläche die Klicknachricht verarbeitet; andernfalls 0.

Hinweise

Diese Methode überschreibt die Implementierung der Basisklasse ( CMFCToolBarButton::OnClick), indem ein Wert ungleich Null zurückgegeben wird, wenn das interne CEdit Objekt sichtbar ist.

CMFCToolBarEditBoxButton::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] Nicht verwendet.

Rückgabewert

Ein Handle zum globalen Fensterpinsel.

Hinweise

Diese Methode setzt die Implementierung der Basisklasse ( CMFCToolBarButton::OnCtlColor) außer Kraft, indem die Text- und Hintergrundfarben des bereitgestellten Gerätekontexts auf den globalen Text bzw. die Hintergrundfarben festgelegt werden.

Weitere Informationen zu globalen Optionen, die für Ihre Anwendung verfügbar sind, finden Sie unter AFX_GLOBAL_DATA Struktur.

CMFCToolBarEditBoxButton::OnGlobalFontsChanged

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

virtual void OnGlobalFontsChanged();

Hinweise

Diese Methode erweitert die Implementierung der Basisklasse ( CMFCToolBarButton::OnGlobalFontsChanged) durch Ändern der Schriftart des Steuerelements auf die der globalen Schriftart.

Weitere Informationen zu globalen Optionen, die für Ihre Anwendung verfügbar sind, finden Sie unter AFX_GLOBAL_DATA Struktur.

CMFCToolBarEditBoxButton::OnMove

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

virtual void OnMove();

Hinweise

Diese Methode setzt die Standardklassenimplementierung ( CMFCToolBarButton::OnMove) außer Kraft, indem die Position des internen CEdit Objekts aktualisiert wird.

CMFCToolBarEditBoxButton::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

Diese Methode erweitert die Basisklassenimplementierung ( CMFCToolBarButton::OnShow), indem die Schaltfläche angezeigt wird, wenn bShow TRUE ist. Andernfalls blendet diese Methode die Schaltfläche aus.

CMFCToolBarEditBoxButton::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 in Pixel.

Hinweise

Diese Methode setzt die Standardklassenimplementierung CMFCToolBarButton::OnSize außer Kraft, indem die Größe und Position des internen CEdit Objekts aktualisiert wird.

CMFCToolBarEditBoxButton::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] Nicht verwendet.

iButtonIndex
[in] Nicht verwendet.

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

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

Rückgabewert

Nonzero, wenn die Methode den QuickInfo-Text aktualisiert; andernfalls 0.

Hinweise

Diese Methode erweitert die Implementierung der Basisklasse ( CMFCToolBarButton::OnUpdateToolTip), indem der QuickInfo-Text angezeigt wird, der dem Bearbeitungsteil der Schaltfläche zugeordnet ist. Wenn das interne CEdit Objekt NULL ist oder das Fensterhandle des CEdit Objekts kein vorhandenes Fenster identifiziert, führt diese Methode nichts aus und gibt FALSE zurück.

CMFCToolBarEditBoxButton::SetContents

Legt den Text im Textfeld-Steuerelement fest.

virtual void SetContents(const CString& sContents);

Parameter

sContents
[in] Gibt den festzulegenden neuen Text an.

CMFCToolBarEditBoxButton::SetContentsAll

Sucht ein CMFCToolBarEditBoxButton -Objekt mit einer angegebenen Befehls-ID und legt den angegebenen Text innerhalb des Textfelds fest.

static BOOL SetContentsAll(
    UINT uiCmd,
    const CString& strContents);

Parameter

uiCmd
[in] Gibt die Befehls-ID des Steuerelements an, für das der Text geändert wird.

strContents
[in] Gibt den festzulegenden neuen Text an.

Rückgabewert

Nonzero, wenn der Text festgelegt wurde; 0, wenn das CMFCToolBarEditBoxButton Steuerelement mit der angegebenen Befehls-ID nicht vorhanden ist.

CMFCToolBarEditBoxButton::SetContextMenuID

Gibt die Ressourcen-ID des Kontextmenüs an, das der Schaltfläche zugeordnet ist.

void SetContextMenuID(UINT uiResID);

Parameter

uiCmd
[in] Die Ressourcen-ID des Kontextmenüs.

Hinweise

Das Framework verwendet die Ressourcen-ID, um das Kontextmenü zu erstellen, wenn der Benutzer mit der rechten Maustaste auf die Symbolleistenschaltfläche klickt.

CMFCToolBarEditBoxButton::SetFlatMode

Gibt die flache Darstellung von Bearbeitungsfeldschaltflächen in der Anwendung an.

static void __stdcall SetFlatMode(BOOL bFlat = TRUE);

Parameter

bFlat
[in] Die flache Formatvorlage für Bearbeitungsfeldschaltflächen. Wenn dieser Parameter TRUE ist, ist die Darstellung der flachen Formatvorlage aktiviert. andernfalls ist die Darstellung des flachen Stils deaktiviert.

Hinweise

Die standardformatvorlage für Bearbeitungsfeldschaltflächen ist TRUE. Verwenden Sie die CMFCToolBarEditBoxButton::IsFlatMode-Methode , um die Darstellung des flachen Stils für Ihre Anwendung abzurufen.

CMFCToolBarEditBoxButton::SetStyle

Gibt die Formatvorlage eines Symbolleisten-Bearbeitungsfeld-Steuerelements an.

virtual void SetStyle(UINT nStyle);

Parameter

nStyle
[in] Eine neue Formatvorlage, die festgelegt werden soll.

Hinweise

Diese Methode legt CMFCToolBarButton::m_nStyle auf nStyle Es deaktiviert auch das Textfeld, wenn sich die Anwendung im Customize-Modus befindet, und aktiviert sie, wenn die Anwendung sich nicht im Customize-Modus befindet (siehe CMFCToolBar::SetCustomizeMode und CMFCToolBar::IsCustomizeMode). Eine Liste der gültigen Formatvorlagen finden Sie unter ToolBar-Steuerelementstile .

Siehe auch

Hierarchiediagramm
Klassen
CMFCToolBarButton-Klasse
CEdit-Klasse
CMFCToolBar::ReplaceButton
Exemplarische Vorgehensweise: Steuerelemente in eine Symbolleiste einfügen