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:
Reservieren Sie eine Platzhalterressourcen-ID für die Schaltfläche in der übergeordneten Symbolleistenressource.
Konstruieren Sie ein
CMFCToolBarComboBoxButton-Objekt.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
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
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
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