CMFCToolBarComboBoxButton-Klasse

Eine Symbolleistenschaltfläche, die ein Kombinationsfeld-Steuerelement enthält ( CComboBox-Klasse).

Syntax

class CMFCToolBarComboBoxButton : public CMFCToolBarButton

Member

Öffentliche Konstruktoren

Name	Beschreibung
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton	Erstellt ein Objekt vom Typ CMFCToolBarComboBoxButton.

Öffentliche Methoden

Name	Beschreibung
CMFCToolBarComboBoxButton::AddItem	Fügt am Ende der Kombinationsfeldliste ein Element hinzu.
CMFCToolBarComboBoxButton::AddSortedItem	Fügt der Kombinationsfeldliste ein Element hinzu. Die Reihenfolge der Elemente in der Liste wird durch Compareangegeben.
CMFCToolBarComboBoxButton::Compare	Vergleicht zwei Elemente. Wird aufgerufen, um Elemente zu sortieren, die AddSortedItems der Kombinationsfeldliste hinzugefügt werden.
CMFCToolBarComboBoxButton::CreateEdit	Erstellt ein neues Bearbeitungssteuerelement für die Kombinationsfeldschaltfläche.
CMFCToolBarComboBoxButton::D eleteItem	Löscht ein Element aus der Kombinationsfeldliste.
CMFCToolBarComboBoxButton::FindItem	Gibt den Index des Elements zurück, das eine angegebene Zeichenfolge enthält.
CMFCToolBarComboBoxButton::GetByCmd	Gibt einen Zeiger auf die Kombinationsfeldschaltfläche mit einer angegebenen Befehls-ID zurück.
CMFCToolBarComboBoxButton::GetComboBox	Gibt einen Zeiger auf das Kombinationsfeld-Steuerelement zurück, das in die Kombinationsfeldschaltfläche eingebettet ist.
CMFCToolBarComboBoxButton::GetCount	Gibt die Anzahl der Elemente in der Kombinationsfeldliste zurück.
CMFCToolBarComboBoxButton::GetCountAll	Sucht die Kombinationsfeldschaltfläche mit einer angegebenen Befehls-ID. Gibt die Anzahl der Elemente in der Kombinationsfeldliste dieser Schaltfläche zurück.
CMFCToolBarComboBoxButton::GetCurSel	Gibt den Index des ausgewählten Elements in der Kombinationsfeldliste zurück.
CMFCToolBarComboBoxButton::GetCurSelAll	Sucht die Kombinationsfeldschaltfläche mit einer angegebenen Befehls-ID und gibt den Index des ausgewählten Elements in der Kombinationsfeldliste dieser Schaltfläche zurück.
CMFCToolBarComboBoxButton::GetEditCtrl	Gibt einen Zeiger auf das Bearbeitungssteuerelement zurück, das in die Kombinationsfeldschaltfläche eingebettet ist.
CMFCToolBarComboBoxButton::GetItem	Gibt die Zeichenfolge zurück, die einem angegebenen Index in der Kombinationsfeldliste zugeordnet ist.
CMFCToolBarComboBoxButton::GetItemAll	Sucht die Kombinationsfeldschaltfläche mit einer angegebenen Befehls-ID und gibt die Zeichenfolge zurück, die einem Index in der Kombinationsfeldliste dieser Schaltfläche zugeordnet ist.
CMFCToolBarComboBoxButton::GetItemData	Gibt den 32-Bit-Wert zurück, der einem angegebenen Index in der Kombinationsfeldliste zugeordnet ist.
CMFCToolBarComboBoxButton::GetItemDataAll	Sucht die Kombinationsfeldschaltfläche mit einer angegebenen Befehls-ID und gibt den 32-Bit-Wert zurück, der einem Index in der Kombinationsfeldliste dieser Schaltfläche zugeordnet ist.
CMFCToolBarComboBoxButton::GetItemDataPtrAll	Sucht die Kombinationsfeldschaltfläche mit einer angegebenen Befehls-ID. Ruft den 32-Bit-Wert ab, der einem Index in der Kombinationsfeldliste dieser Schaltfläche zugeordnet ist, und gibt den 32-Bit-Wert als Zeiger zurück.
CMFCToolBarComboBoxButton::GetText	Gibt den Text aus dem Bearbeitungssteuerelement des Kombinationsfelds zurück.
CMFCToolBarComboBoxButton::GetTextAll	Sucht die Kombinationsfeldschaltfläche mit einer angegebenen Befehls-ID und gibt den Text aus dem Bearbeitungssteuerelement dieser Schaltfläche zurück.
CMFCToolBarComboBoxButton::IsCenterVert	Bestimmt, ob Kombinationsfeldschaltflächen in der Anwendung zentriert oder am oberen Rand der Symbolleiste ausgerichtet sind.
CMFCToolBarComboBoxButton::IsFlatMode	Bestimmt, ob Kombinationsfeldschaltflächen in der Anwendung eine flache Darstellung aufweisen.
CMFCToolBarComboBoxButton::RemoveAllItems	Entfernt alle Elemente aus dem Listenfeld und das Bearbeitungssteuerelement des Kombinationsfelds.
CMFCToolBarComboBoxButton::SelectItem	Wählt ein Element im Kombinationsfeld entsprechend dem Index, dem 32-Bit-Wert oder der Zeichenfolge aus und benachrichtigt das Kombinationsfeld-Steuerelement über die Auswahl.
CMFCToolBarComboBoxButton::SelectItemAll	Sucht die Kombinationsfeldschaltfläche mit einer angegebenen Befehls-ID. Aufrufe SelectItem zum Auswählen eines Elements im Kombinationsfeld dieser Schaltfläche entsprechend dem Zeichenfolgen-, Index- oder 32-Bit-Wert.
CMFCToolBarComboBoxButton::SetCenterVert	Gibt an, ob Kombinationsfeldschaltflächen in der Anwendung vertikal zentriert oder am oberen Rand der Symbolleiste ausgerichtet sind.
CMFCToolBarComboBoxButton::SetDropDownHeight	Legt die Höhe des Dropdown-Listenfelds fest.
CMFCToolBarComboBoxButton::SetFlatMode	Gibt an, ob Kombinationsfeldschaltflächen in der Anwendung eine flache Darstellung aufweisen.

Hinweise

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

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

2. Konstruieren Sie ein CMFCToolBarComboBoxButton-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. Ein Beispiel für eine Symbolleistenschaltfläche mit Kombinationsfeld finden Sie im Beispielprojekt VisualStudioDemo.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung verschiedener Methoden in der CMFCToolBarComboBoxButton -Klasse. Das Beispiel zeigt, wie Sie die Bearbeitungs- und Kombinationsfelder aktivieren, die vertikale Position von Kombinationsfeldschaltflächen in der Anwendung festlegen, die Höhe des Listenfelds festlegen, wenn es abgesetzt wird, die flache Darstellung von Kombinationsfeldschaltflächen in der Anwendung festlegen und den Text im Bearbeitungsfeld der Kombinationsfeldschaltfläche festlegen. Dieser Codeausschnitt ist Teil des Visual Studio Demo-Beispiels.

// CObList listButtons
// POSITION posCombo
CMFCToolBarComboBoxButton* pCombo = DYNAMIC_DOWNCAST(CMFCToolBarComboBoxButton, listButtons.GetNext(posCombo));

pCombo->EnableWindow(true);
pCombo->SetCenterVert();
pCombo->SetDropDownHeight(25);
pCombo->SetFlatMode();
pCombo->SetText(_T("this is a combo box"));

Vererbungshierarchie

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

Anforderungen

Header: afxtoolbarcomboboxbutton.h

CMFCToolBarComboBoxButton::AddItem

Fügt ein eindeutiges Element an das Listenfeld an.

virtual INT_PTR AddItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

Parameter

lpszItem
[in] Der Text des Elements, das dem Listenfeld hinzugefügt werden soll.

dwData
[in] Die dem Element zugeordneten Daten, die dem Listenfeld hinzugefügt werden sollen.

Rückgabewert

Der Index des letzten Elements im Listenfeld.

Hinweise

Verwenden Sie diese Methode nicht, wenn die Listenfeldformatvorlage sortiert wird.

Wenn sich der Elementtext bereits im Listenfeld befindet, werden die neuen Daten mit dem vorhandenen Element gespeichert. Bei der Suche nach dem Element wird die Groß-/Kleinschreibung beachtet.

CMFCToolBarComboBoxButton::AddSortedItem

Fügt dem Listenfeld ein Element in der Von der Compare-Methode definierten Reihenfolge hinzu.

virtual INT_PTR AddSortedItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

Parameter

lpszItem
[in] Der Text des Elements, das dem Listenfeld hinzugefügt werden soll.

dwData
[in] Die dem Element zugeordneten Daten, die dem Listenfeld hinzugefügt werden sollen.

Rückgabewert

Index des Elements, das dem Listenfeld hinzugefügt wurde.

Hinweise

Verwenden Sie diese Funktion, um dem Listenfeld Elemente in einer bestimmten Reihenfolge hinzuzufügen.

CMFCToolBarComboBoxButton::CanBeStretched

Gibt an, ob sich die Größe der Kombinationsfeldschaltfläche ändern kann.

virtual BOOL CanBeStretched() const;

Rückgabewert

Gibt WAHR zurück.

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

Erstellt ein CMFCToolBarComboBoxButton -Objekt.

CMFCToolBarComboBoxButton(
    UINT uiID,
    int iImage,
    DWORD dwStyle=CBS_DROPDOWNLIST,
    int iWidth=0);

Parameter

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

iImage
[in] Der Bildindex des Bilds, das der neuen Schaltfläche zugeordnet ist.

dwStyle
[in] Die Formatvorlage der neuen Schaltfläche.

iWidth
[in] Die Breite der neuen Schaltfläche in Pixel.

Hinweise

Die Standardbreite beträgt 150 Pixel.

Eine Liste der Symbolleistenschaltflächenarten finden Sie unter ToolBar-Steuerelementformatvorlagen

CMFCToolBarComboBoxButton::ClearData

Löscht benutzerdefinierte Daten.

virtual void ClearData();

Hinweise

Standardmäßig führt diese Methode nichts aus. Überschreiben Sie diese Methode in einer abgeleiteten Klasse, wenn Sie benutzerdefinierte Daten löschen möchten.

CMFCToolBarComboBoxButton::Compare

Vergleicht zwei Zeichenfolgen.

virtual int Compare(
    LPCTSTR lpszItem1,
    LPCTSTR lpszItem2);

Parameter

lpszItem1
[in] Die erste zu vergleichende Zeichenfolge.

lpszItem2
[in] Die zweite zu vergleichende Zeichenfolge.

Rückgabewert

Ein Wert, der die lexikographische Beziehung zwischen den Zeichenfolgen angibt. Die folgende Tabelle enthält die möglichen Werte:

Wert	Beschreibung
<0	Die erste Zeichenfolge ist kleiner als die zweite.
0	Die erste Zeichenfolge entspricht der zweiten.
>0	Die erste Zeichenfolge ist größer als die zweite.

Hinweise

Überschreiben Sie diese Methode, um zu ändern, wie Elemente im Listenfeld sortiert werden.

Beim Vergleich wird die Groß-/Kleinschreibung beachtet.

Diese Methode wird nur von der AddSortedItem-Methode aufgerufen.

CMFCToolBarComboBoxButton::CopyFrom

Kopiert den Zustand des angegebenen CMFCToolBarComboBoxButton Objekts an das aktuelle Objekt.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parameter

src
[in] Das Quellobjekt CMFCToolBarComboBoxButton .

CMFCToolBarComboBoxButton::CreateCombo

Erstellt ein neues Kombinationsfeld für die Kombinationsfeldschaltfläche.

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    const CRect& rect);

Parameter

pWndParent
[in] Ein Zeiger auf das übergeordnete Fenster der Schaltfläche.

rect
[in] Umgebendes Rechteck des Kombinationsfelds.

Rückgabewert

Ein Zeiger auf das neue Kombinationsfeld, wenn die Methode erfolgreich war; andernfalls NULL.

CMFCToolBarComboBoxButton::CreateEdit

Erstellt ein neues Bearbeitungsfeld für die Kombinationsfeldschaltfläche.

virtual CMFCToolBarComboBoxEdit* CreateEdit(
    CWnd* pWndParent,
    const CRect& rect,
    DWORD dwEditStyle);

Parameter

pWndParent
[in] Ein Zeiger auf das übergeordnete Fenster der Schaltfläche.

rect
[in] Umgebendes Rechteck des neuen Bearbeitungsfelds.

dwEditStyle
[in] Steuerelementformat des neuen Bearbeitungsfelds.

Rückgabewert

Ein Zeiger auf das neue Bearbeitungsfeld, wenn die Methode erfolgreich war; andernfalls NULL.

Hinweise

Das Framework ruft diese Methode auf, wenn ein neues Bearbeitungsfeld für eine Kombinationsfeldschaltfläche erstellt wird. Überschreiben Sie diese Methode, um zu ändern, wie CMFCToolBarComboBoxEdit erstellt wird.

CMFCToolBarComboBoxButton::D eleteItem

Löscht ein angegebenes Element aus dem Listenfeld.

BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);

Parameter

iIndex
[in] Der nullbasierte Index des zu löschenden Elements.

dwData
[in] Die dem Element zugeordneten Daten, die gelöscht werden sollen.

lpszText
[in] Der Text des zu löschenden Elements. Wenn mehrere Elemente mit demselben Text vorhanden sind, wird das erste Element gelöscht.

Rückgabewert

TRUE, wenn das Element gefunden und erfolgreich gelöscht wurde; andernfalls FALSE.

Hinweise

CMFCToolBarComboBoxButton::D uplicateData

Dupliziert benutzerdefinierte Daten.

virtual void DuplicateData();

Hinweise

Standardmäßig führt diese Methode nichts aus. Überschreiben Sie diese Methode in einer abgeleiteten Klasse, wenn Sie benutzerdefinierte Daten kopieren möchten.

CMFCToolBarComboBoxButton::EnableWindow

Aktiviert oder deaktiviert die Bearbeitungs- und Kombinationsfelder.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parameter

bEnable
[in] TRUE, um die Bearbeitungs- und Kombinationsfelder zu aktivieren; FALSE zum Deaktivieren der Bearbeitungs- und Kombinationsfelder.

Hinweise

Wenn sie deaktiviert ist, können die Steuerelemente nicht aktiv werden und können keine Benutzereingaben akzeptieren.

CMFCToolBarComboBoxButton::ExportToMenuButton

Kopiert eine Zeichenfolge aus der Anwendungszeichenfolgentabelle mithilfe der Befehls-ID des Kombinationsfelds in das angegebene Menü.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parameter

menuButton
[out] Verweisen auf eine Menüschaltfläche.

Rückgabewert

Immer TRUE.

CMFCToolBarComboBoxButton::FindItem

Gibt den Index des ersten Elements im Listenfeld zurück, das eine angegebene Zeichenfolge enthält.

int FindItem(LPCTSTR lpszText) const;

Parameter

lpszText
[in] Der Text, nach dem im Listenfeld gesucht werden soll.

Rückgabewert

Der Index des Elements; oder CB_ERR, wenn das Element nicht gefunden wird.

Hinweise

CMFCToolBarComboBoxButton::GetByCmd

Ruft einen Zeiger auf die Kombinationsfeldschaltfläche mit einer angegebenen Befehls-ID ab.

static CMFCToolBarComboBoxButton* GetByCmd(
    UINT uiCmd,
    BOOL bIsFocus=FALSE);

Parameter

uiCmd
[in] Die Befehls-ID einer Kombinationsfeldschaltfläche.

bIsFocus
[in] TRUE, um nur fokussierte Schaltflächen zu durchsuchen; FALSE, um alle Schaltflächen zu durchsuchen.

Rückgabewert

Ein Zeiger auf eine Kombinationsfeldschaltfläche; oder NULL, wenn die Schaltfläche nicht gefunden wird.

Hinweise

CMFCToolBarComboBoxButton::GetComboBox

Gibt einen Zeiger auf das Kombinationsfeld in der Kombinationsfeldschaltfläche zurück.

CComboBox* GetComboBox() const;

Rückgabewert

Ein Zeiger auf das CComboBox Class-Objekt , wenn die Methode erfolgreich war; andernfalls NULL.

Hinweise

CMFCToolBarComboBoxButton::GetContextMenuID

Ruft die Ressourcen-ID des Kontextmenüs für die Kombinationsfeldschaltfläche ab.

UINT GetContextMenuID();

Rückgabewert

Die Ressourcen-ID des Kontextmenüs.

CMFCToolBarComboBoxButton::GetCount

Gibt die Anzahl der Elemente im Listenfeld zurück.

INT_PTR GetCount() const;

Rückgabewert

Die Anzahl der Elemente im Listenfeld.

Hinweise

CMFCToolBarComboBoxButton::GetCountAll

Ruft die Anzahl der Elemente im Listenfeld einer Kombinationsfeldschaltfläche mit einer angegebenen Befehls-ID ab.

static int GetCountAll(UINT uiCmd);

Parameter

uiCmd
[in] Die Befehls-ID einer Kombinationsfeldschaltfläche.

Rückgabewert

Die Anzahl der Elemente im Listenfeld; andernfalls CB_ERR, wenn die Kombinationsfeldschaltfläche nicht gefunden wird.

Hinweise

CMFCToolBarComboBoxButton::GetCurSel

Ruft den Index des aktuell ausgewählten Elements im Listenfeld ab.

int GetCurSel() const;

Rückgabewert

Der Index des aktuell ausgewählten Elements im Listenfeld; oder CB_ERR, wenn kein Element ausgewählt ist.

Hinweise

Der Listenfeldindex ist nullbasiert.

CMFCToolBarComboBoxButton::GetCurSelAll

Gibt den Index des aktuell ausgewählten Elements im Listenfeld einer Kombinationsfeldschaltfläche zurück, die über eine angegebene Befehls-ID verfügt.

static int GetCurSelAll(UINT uiCmd);

Parameter

uiCmd
[in] Die Befehls-ID einer Kombinationsfeldschaltfläche.

Rückgabewert

Der Index des aktuell ausgewählten Elements im Listenfeld; andernfalls CB_ERR, wenn kein Element ausgewählt ist oder eine Kombinationsfeldschaltfläche nicht gefunden wird.

Hinweise

Der Listenfeldindex ist nullbasiert.

CMFCToolBarComboBoxButton::GetEditCtrl

Gibt einen Zeiger auf das Bearbeitungsfeld in der Kombinationsfeldschaltfläche zurück.

virtual CEdit* GetEditCtrl();

Rückgabewert

Ein Zeiger auf das Bearbeitungsfeld, wenn die Methode erfolgreich war; andernfalls NULL.

Hinweise

CMFCToolBarComboBoxButton::GetHwnd

Gibt den Fensterziehpunkt für das Kombinationsfeld zurück.

virtual HWND GetHwnd();

Rückgabewert

Das Fensterziehpunkt oder NULL, wenn das Kombinationsfeld keinem Fensterobjekt zugeordnet ist.

CMFCToolBarComboBoxButton::GetItem

Gibt die Zeichenfolge zurück, die einem Element bei einem angegebenen Index im Listenfeld zugeordnet ist.

LPCTSTR GetItem(int iIndex=-1) const;

Parameter

iIndex
[in] Nullbasierter Index eines Elements im Listenfeld.

Rückgabewert

Ein Zeiger auf die Zeichenfolge, die dem Element zugeordnet ist; andernfalls NULL, wenn der Indexparameter ungültig ist oder der Indexparameter -1 ist und kein ausgewähltes Element im Kombinationsfeld vorhanden ist.

Hinweise

Ein Indexparameter von -1 gibt die Zeichenfolge des aktuell ausgewählten Elements zurück.

CMFCToolBarComboBoxButton::GetItemAll

Gibt die Zeichenfolge zurück, die einem Element in einem angegebenen Index im Listenfeld einer Kombinationsfeldschaltfläche zugeordnet ist, die über eine angegebene Befehls-ID verfügt.

static LPCTSTR GetItemAll(
    UINT uiCmd,
    int iIndex=-1);

Parameter

uiCmd
[in] Die Befehls-ID einer Kombinationsfeldschaltfläche.

iIndex
[in] Der nullbasierte Index eines Elements im Listenfeld.

Rückgabewert

Ein Zeiger auf die Zeichenfolge des Elements, wenn die Methode erfolgreich war; andernfalls NULL, wenn der Index ungültig ist, wird keine Kombinationsfeldschaltfläche gefunden, oder wenn Index -1 ist und kein ausgewähltes Element im Kombinationsfeld vorhanden ist.

Hinweise

Ein Indexwert von -1 gibt die Zeichenfolge des aktuell ausgewählten Elements zurück.

CMFCToolBarComboBoxButton::GetItemData

Gibt die Daten zurück, die einem Element in einem bestimmten Index im Listenfeld zugeordnet sind.

DWORD_PTR GetItemData(int iIndex=-1) const;

Parameter

iIndex
[in] Der nullbasierte Index eines Elements im Listenfeld.

Rückgabewert

Die mit dem Element verknüpften Daten; oder 0, wenn das Element nicht vorhanden ist.

Hinweise

Ein Indexparameter von -1 gibt die daten zurück, die dem aktuell ausgewählten Element zugeordnet sind.

CMFCToolBarComboBoxButton::GetItemDataAll

Gibt die Daten zurück, die einem Element in einem bestimmten Index im Listenfeld einer Kombinationsfeldschaltfläche zugeordnet sind, die eine bestimmte Befehls-ID enthält.

static DWORD_PTR GetItemDataAll(
    UINT uiCmd,
    int iIndex=-1);

Parameter

uiCmd
[in] Die Befehls-ID einer Kombinationsfeldschaltfläche.

iIndex
[in] Der nullbasierte Index eines Elements im Listenfeld.

Rückgabewert

Die dem Element zugeordneten Daten, wenn die Methode erfolgreich war; andernfalls 0, wenn der angegebene Index ungültig ist, oder CB_ERR, wenn die Kombinationsfeldschaltfläche nicht gefunden wird.

Hinweise

Ein Indexparameter von -1 gibt die daten zurück, die dem aktuell ausgewählten Element zugeordnet sind.

CMFCToolBarComboBoxButton::GetItemDataPtrAll

Gibt die Daten zurück, die einem Element in einem bestimmten Index im Listenfeld einer Kombinationsfeldschaltfläche zugeordnet sind, die eine bestimmte Befehls-ID enthält. Diese Daten werden als Zeiger zurückgegeben.

static void* GetItemDataPtrAll(
    UINT uiCmd,
    int iIndex=-1);

Parameter

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

iIndex
[in] Der nullbasierte Index eines Elements im Listenfeld.

Rückgabewert

Ein Zeiger, der dem Element zugeordnet ist, wenn die Methode erfolgreich war; andernfalls -1, wenn ein Fehler auftritt, oder NULL, wenn die Kombinationsfeldschaltfläche nicht gefunden wird.

Hinweise

CMFCToolBarComboBoxButton::GetPrompt

Gibt die Eingabeaufforderungszeichenfolge für die Kombinationsfeldschaltfläche zurück.

virtual CString GetPrompt() const;

Rückgabewert

Die Eingabeaufforderungszeichenfolge.

Hinweise

Diese Methode ist derzeit nicht implementiert.

CMFCToolBarComboBoxButton::GetText

Ruft den Text im Bearbeitungsfeld ab.

LPCTSTR GetText() const;

Rückgabewert

Der Text im Bearbeitungsfeld.

Hinweise

CMFCToolBarComboBoxButton::GetTextAll

Ruft den Text im Bearbeitungsfeld einer Kombinationsfeldschaltfläche ab, die über eine angegebene Befehls-ID verfügt.

static LPCTSTR GetTextAll(UINT uiCmd);

Parameter

uiCmd
[in] Die Befehls-ID einer bestimmten Kombinationsfeldschaltfläche.

Rückgabewert

Der Text im Bearbeitungsfeld, wenn die Methode erfolgreich war; andernfalls NULL.

Hinweise

CMFCToolBarComboBoxButton::HasFocus

Gibt an, ob das Kombinationsfeld derzeit den Fokus hat.

virtual BOOL HasFocus() const;

Rückgabewert

TRUE, wenn das Kombinationsfeld derzeit den Fokus hat; andernfalls FALSE.

Hinweise

Diese Methode gibt auch TRUE zurück, wenn ein untergeordnetes Fenster des Kombinationsfelds derzeit den Fokus hat.

CMFCToolBarComboBoxButton::IsCenterVert

Gibt die vertikale Position der Kombinationsfeldschaltflächen in der Anwendung zurück.

static BOOL IsCenterVert();

Rückgabewert

TRUE, wenn die Schaltflächen zentriert sind; FALSE, wenn die Schaltflächen oben ausgerichtet sind.

Hinweise

CMFCToolBarComboBoxButton::IsFlatMode

Gibt die flache Darstellung von Kombinationsfeldschaltflächen in der Anwendung zurück.

static BOOL IsFlatMode();

Rückgabewert

TRUE, wenn die Schaltflächen eine flache Formatvorlage aufweisen; andernfalls FALSE.

Hinweise

Die Standardformatvorlage für Kombinationsfeldschaltflächen ist FALSE.

CMFCToolBarComboBoxButton::IsOwnerOf

Gibt an, ob der angegebene Handle der Kombinationsfeldschaltfläche oder einem seiner untergeordneten Elemente zugeordnet ist.

virtual BOOL IsOwnerOf(HWND hwnd);

Parameter

hwnd
[in] Ein Fensterziehpunkt.

Rückgabewert

TRUE, wenn der Ziehpunkt mit der Kombinationsfeldschaltfläche oder einem seiner untergeordneten Elemente zugeordnet ist; andernfalls FALSE.

CMFCToolBarComboBoxButton::IsRibbonButton

Gibt an, ob sich die Kombinationsfeldschaltfläche in einem Menübandbereich befindet.

BOOL IsRibbonButton() const;

Rückgabewert

Immer FALSE

Hinweise

Standardmäßig gibt diese Methode immer FALSE zurück, was bedeutet, dass die Kombinationsfeldschaltfläche nie in einem Menübandbereich angezeigt wird.

CMFCToolBarComboBoxButton::IsWindowVisible

Gibt den Sichtbarkeitsstatus der Kombinationsfeldschaltfläche zurück.

virtual BOOL IsWindowVisible();

Rückgabewert

Der Sichtbarkeitszustand der Kombinationsfeldschaltfläche.

CMFCToolBarComboBoxButton::NotifyCommand

Gibt an, ob die Kombinationsfeldschaltfläche die Nachricht verarbeitet.

virtual BOOL NotifyCommand(int iNotifyCode);

Parameter

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

Rückgabewert

Gibt an, ob die Kombinationsfeldschaltfläche die Nachricht verarbeitet.

CMFCToolBarComboBoxButton::OnAddToCustomizePage

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

virtual void OnAddToCustomizePage();

CMFCToolBarComboBoxButton::OnCalculateSize

Wird vom Framework aufgerufen, um die Größe der Schaltfläche zu berechnen.

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

Parameter

pDC
[in] Der Gerätekontext, in dem die Kombinationsfeldschaltfläche angezeigt wird.

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

bHorz
[in] Der Dockstatus der übergeordneten Symbolleiste. TRUE, wenn die Symbolleiste horizontal und FALSCH angedockt wird, wenn die Symbolleiste vertikal angedockt wird.

Rückgabewert

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

CMFCToolBarComboBoxButton::OnChangeParentWnd

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

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parameter

pWndParent
[in] Zeigen Sie auf die neue übergeordnete Symbolleiste.

CMFCToolBarComboBoxButton::OnClick

Wird vom Framework aufgerufen, wenn der Benutzer auf die Kombinationsfeldschaltfläche klickt.

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

Parameter

pWnd
[in] Zeigen Sie auf das übergeordnete Fenster der Kombinationsfeldschaltfläche.

bDelay
[in] Reserviert für die Verwendung in einer abgeleiteten Klasse.

Rückgabewert

TRUE, wenn die Methode das Ereignis behandelt; andernfalls FALSE.

CMFCToolBarComboBoxButton::OnCtlColor

Wird vom Framework aufgerufen, wenn der Benutzer die farbe der übergeordneten Symbolleiste ändert, um die Farbe der Kombinationsfeldschaltfläche festzulegen.

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

Parameter

pDC
[in] Der Gerätekontext, in dem die Kombinationsfeldschaltfläche angezeigt wird.

nCtlColor
[in] Nicht verwendet.

Rückgabewert

Behandeln Sie den Pinsel, den das Framework zum Zeichnen des Hintergrunds der Kombinationsfeldschaltfläche verwendet.

Hinweise

Mit dieser Methode wird auch die Textfarbe des Kombinationsfelds festgelegt.

CMFCToolBarComboBoxButton::OnDraw

Wird vom Framework aufgerufen, um die Kombinationsfeldschaltflä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 Bildern, die der Schaltfläche zugeordnet sind.

bHorz
[in] Der Dockstatus der übergeordneten Symbolleiste. TRUE, wenn die Symbolleiste horizontal und FALSCH angedockt wird, wenn die Symbolleiste vertikal angedockt wird.

bCustomizeMode
[in] Gibt an, ob sich die Anwendung im Anpassungsmodus befindet.

bHighlight
[in] Gibt an, ob die Kombinationsfeldschaltfläche hervorgehoben wird.

bDrawBorder
[in] Gibt an, ob die Kombinationsfeldschaltfläche mit einem Rahmen gezeichnet werden soll.

bGrayDisabledButtons
[in] TRUE, um schattierte deaktivierte Schaltflächen zu zeichnen; FALSE, um die deaktivierte Bildersammlung zu verwenden.

CMFCToolBarComboBoxButton::OnDrawOnCustomizeList

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

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

Parameter

pDC
[in] Der Gerätekontext, in dem die Kombinationsfeldschaltfläche angezeigt wird.

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

bSelected
[in] TRUE, wenn die Kombinationsfeldschaltfläche ausgewählt ist; andernfalls FALSE.

Rückgabewert

Die Breite der Kombinationsfeldschaltfläche in Pixel.

CMFCToolBarComboBoxButton::OnGlobalFontsChanged

Wird vom Framework aufgerufen, um die Schriftart der Kombinationsfeldschaltfläche festzulegen, wenn sich die Schriftart der Anwendung ändert.

virtual void OnGlobalFontsChanged();

CMFCToolBarComboBoxButton::OnMove

Wird vom Framework aufgerufen, um die Position der Kombinationsfeldschaltfläche zu ändern, wenn die übergeordnete Symbolleiste verschoben wird.

virtual void OnMove();

CMFCToolBarComboBoxButton::OnShow

Wird vom Framework aufgerufen, wenn die Kombinationsfeldschaltfläche ausgeblendet oder angezeigt wird.

virtual void OnShow(BOOL bShow);

Parameter

bShow
[in] Gibt an, ob die Kombinationsfeldschaltfläche ausgeblendet oder angezeigt werden soll.

CMFCToolBarComboBoxButton::OnSize

Wird vom Framework aufgerufen, um die Größe der Kombinationsfeldschaltfläche zu ändern, wenn die größe der übergeordneten Symbolleiste geändert wird.

virtual void OnSize(int iSize);

Parameter

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

CMFCToolBarComboBoxButton::OnUpdateToolTip

Wird vom Framework aufgerufen, wenn der Benutzer die QuickInfo für die Kombinationsfeldschaltfläche ändert.

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

Parameter

pWndParent
[in] Zeigen Sie auf das übergeordnete Fenster für die Kombinationsfeldschaltfläche.

iButtonIndex
[in] ID der Kombinationsfeldschaltfläche.

wndToolTip
[in] Die QuickInfo, die der Kombinationsfeldschaltfläche zugeordnet werden soll.

str
[in] Der QuickInfo-Text.

Rückgabewert

TRUE, wenn die Methode das Ereignis behandelt; andernfalls FALSE.

CMFCToolBarComboBoxButton::RemoveAllItems

Löscht alle Elemente aus den Listen- und Bearbeitungsfeldern.

void RemoveAllItems();

Hinweise

Entfernt alle Elemente aus dem Listenfeld und das Bearbeitungssteuerelement eines Kombinationsfelds.

CMFCToolBarComboBoxButton::SelectItem

Wählt ein Element im Listenfeld aus.

BOOL SelectItem(
    int iIndex,
    BOOL bNotify=TRUE);

BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);

Parameter

iIndex
[in] Der nullbasierte Index eines Elements im Listenfeld.

bNotify
[in] TRUE, um die Kombinationsfeldschaltfläche der Auswahl zu benachrichtigen; andernfalls FALSE.

dwData
[in] Die daten, die einem Element im Listenfeld zugeordnet sind.

lpszText
[in] Der Text eines Elements im Listenfeld.

Rückgabewert

TRUE, wenn die Methode erfolgreich war; andernfalls FALSE.

Hinweise

CMFCToolBarComboBoxButton::SelectItemAll

Wählt ein Element im Listenfeld einer Kombinationsfeldschaltfläche mit einer angegebenen Befehls-ID aus.

static BOOL SelectItemAll(
    UINT uiCmd,
    int iIndex);

static BOOL SelectItemAll(
    UINT uiCmd,
    DWORD_PTR dwData);

static BOOL SelectItemAll(
    UINT uiCmd,
    LPCTSTR lpszText);

Parameter

uiCmd
[in] Die Befehls-ID der Kombinationsfeldschaltfläche, die das Listenfeld enthält.

iIndex
[in] Der nullbasierte Index des Elements im Listenfeld. Ein Wert von -1 entfernt eine beliebige aktuelle Auswahl im Listenfeld und löscht das Bearbeitungsfeld.

dwData
[in] Die Daten eines Elements im Listenfeld.

lpszText
[in] Der Text eines Elements im Listenfeld.

Rückgabewert

TRUE, wenn die Methode erfolgreich war; andernfalls FALSE.

Hinweise

CMFCToolBarComboBoxButton::Serialize

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

virtual void Serialize(CArchive& ar);

Parameter

Ar
[in, out] Das CArchive zu serialisierende Objekt.

Hinweise

Die Einstellungen im CArchive Objekt bestimmen, ob diese Methode das Archiv liest oder in das Archiv schreibt.

CMFCToolBarComboBoxButton::SetACCData

Füllt das angegebene CAccessibilityData Objekt mithilfe von Barrierefreiheitsdaten aus der Kombinationsfeldschaltfläche auf.

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

Parameter

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

data
[out] Ein CAccessibilityData Objekt, das die Barrierefreiheitsdaten aus der Kombinationsfeldschaltfläche empfängt.

Rückgabewert

TRUE, wenn die Methode erfolgreich war; andernfalls FALSE.

CMFCToolBarComboBoxButton::SetCenterVert

Legt die vertikale Position von Kombinationsfeldschaltflächen in der Anwendung fest.

static void SetCenterVert(BOOL bCenterVert=TRUE);

Parameter

bCenterVert
[in] TRUE, um die Kombinationsfeldschaltfläche in der Symbolleiste zu zentrieren; FALSE, um die Kombinationsfeldschaltfläche am oberen Rand der Symbolleiste auszurichten.

Hinweise

Standardmäßig werden Kombinationsfeldschaltflächen oben ausgerichtet.

CMFCToolBarComboBoxButton::SetContextMenuID

Legt die Ressourcen-ID des Kontextmenüs für die Kombinationsfeldschaltfläche fest.

void SetContextMenuID(UINT uiResID);

Parameter

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

CMFCToolBarComboBoxButton::SetDropDownHeight

Legt die Höhe des Listenfelds fest, wenn es nach unten abgelegt wird.

void SetDropDownHeight(int nHeight);

Parameter

nHeight
[in] Die Höhe des Listenfelds in Pixel.

Hinweise

Die Standardhöhe beträgt 150 Pixel.

CMFCToolBarComboBoxButton::SetFlatMode

Legt die flache Darstellung von Kombinationsfeldschaltflächen in der Anwendung fest.

static void SetFlatMode(BOOL bFlat=TRUE);

Parameter

bFlat
[in] TRUE für ein flaches Erscheinungsbild; andernfalls FALSE.

Hinweise

Die Standardformatvorlage für Kombinationsfeldschaltflächen ist FALSE.

CMFCToolBarComboBoxButton::SetStyle

Legt die angegebene Formatvorlage für die Kombinationsfeldschaltfläche fest und zeichnet das Steuerelement neu, wenn es nicht deaktiviert ist.

virtual void SetStyle(UINT nStyle);

Parameter

nStyle
[in] Eine bitweise Kombination (OR) von Symbolleistenformatvorlagen.

Hinweise

Eine Liste der Symbolleistenschaltflächenarten finden Sie unter ToolBar-Steuerelementformatvorlagen

CMFCToolBarComboBoxButton::SetText

Legt den Text im Bearbeitungsfeld der Kombinationsfeldschaltfläche fest.

void SetText(LPCTSTR lpszText);

Parameter

lpszText
[in] Zeigen Sie auf eine Zeichenfolge, die den Text für das Bearbeitungsfeld enthält.

Siehe auch

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