CMFCRibbonComboBox-Klasse
Die CMFCRibbonComboBox Klasse implementiert ein Kombinationsfeld-Steuerelement, das Sie einer Menübandleiste, einem Menübandbereich oder einem Menüband-Popupmenü hinzufügen können.
Syntax
class CMFCRibbonComboBox : public CMFCRibbonEdit
Member
Konstruktoren
| Name | Beschreibung |
|---|---|
| CMFCRibbonComboBox::CMFCRibbonComboBox | Erstellt ein CMFCRibbonComboBox -Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CMFCRibbonComboBox::AddItem | Fügt ein eindeutiges Element an das Listenfeld an. |
| CMFCRibbonComboBox::D eleteItem | Löscht ein angegebenes Element aus dem Listenfeld. |
| CMFCRibbonComboBox::EnableDropDownListResize | Gibt an, ob das Listenfeld die Größe ändern kann, wenn es abbricht. |
| CMFCRibbonComboBox::FindItem | Gibt den Index des ersten Elements im Listenfeld zurück, das einer angegebenen Zeichenfolge entspricht. |
| CMFCRibbonComboBox::GetCount | Gibt die Anzahl der Elemente im Listenfeld zurück. |
| CMFCRibbonComboBox::GetCurSel | Ruft den Index des aktuell ausgewählten Elements im Listenfeld ab. |
| CMFCRibbonComboBox::GetDropDownHeight | Ruft die Höhe des Listenfelds ab, wenn das Listenfeld nach unten abgelegt wird. |
| CMFCRibbonComboBox::GetIntermediateSize | Gibt die Größe des Kombinationsfelds zurück, wie im Zwischenmodus angezeigt. |
| CMFCRibbonComboBox::GetItem | Gibt die Zeichenfolge zurück, die einem Element bei einem angegebenen Index im Listenfeld zugeordnet ist. |
| CMFCRibbonComboBox::GetItemData | Gibt die Daten zurück, die einem Element in einem angegebenen Index im Listenfeld zugeordnet sind. |
| CMFCRibbonComboBox::HasEditBox | Gibt an, ob das Steuerelement ein Bearbeitungsfeld enthält. |
| CMFCRibbonComboBox::IsResizeDropDownList | Gibt an, ob die Größe des Listenfelds geändert werden kann. |
| CMFCRibbonComboBox::OnSelectItem | Wird vom Framework aufgerufen, wenn der Benutzer ein Element im Listenfeld auswählt. |
| CMFCRibbonComboBox::RemoveAllItems | Löscht alle Elemente aus dem Listenfeld und löscht das Bearbeitungsfeld. |
| CMFCRibbonComboBox::SelectItem | Wählt ein Element im Listenfeld aus. |
| CMFCRibbonComboBox::SetDropDownHeight | Legt die Höhe des Listenfelds fest, wenn es nach unten abgelegt wird. |
Hinweise
Das Kombinationsfeld des Menübands besteht aus einem Listenfeld, das entweder mit einer statischen Bezeichnung oder einer Bezeichnung kombiniert wird, die vom Benutzer bearbeitet werden kann. Sie müssen angeben, welchen Typ Sie beim Erstellen des Menüband-Kombinationsfelds wünschen.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie Sie ein Objekt der CMFCRibbonComboBox Klasse erstellen, dem Kombinationsfeld ein Element hinzufügen, ein Element im Kombinationsfeld auswählen und einem Panel ein Kombinationsfeld hinzufügen.
// Create a simple combo box with two entries:
// The first parameter is the id of the combo box.
// The third parameter is the width of the combo box in pixels.
// The fourth parameter is the display label of the combo box.
// The fifth parameter is the index of the small image of the combo box.
CMFCRibbonComboBox *pComboSimple = new CMFCRibbonComboBox(-1, FALSE, -1, 0, -1);
// Add two items to the combo box and select the first item in the list:
pComboSimple->AddItem(_T("Hi!"));
pComboSimple->AddItem(_T("Hello!"));
pComboSimple->SelectItem(0);
// Add combo button to "Favorites" panel:
// CMFCRibbonPanel* pPanelFavorites
pPanelFavorites->Add(pComboSimple);
Vererbungshierarchie
Anforderungen
Header: afxribboncombobox.h
CMFCRibbonComboBox::AddItem
Fügt ein eindeutiges Element an das Listenfeld an.
virtual INT_PTR AddItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Parameter
lpszItem
[in] Die Zeichenfolge des hinzuzufügenden Elements.
dwData
[in] Die dem hinzuzufügenden Element zugeordneten Daten.
Rückgabewert
Der nullbasierte Index des angefügten Elements.
CMFCRibbonComboBox::CMFCRibbonComboBox
Erstellt ein CMFCRibbonComboBox-Objekt.
public:
CMFCRibbonComboBox(
UINT nID,
BOOL bHasEditBox=TRUE,
Int nWidth=-1,
LPCTSTR lpszLabel=NULL,
Int nImage=-1);
protected:
CMFCRibbonComboBox();
Parameter
Nid
[in] Die ID des Kombinationsfelds.
bHasEditBox
[in] TRUE, wenn Sie ein Bearbeitungsfeld innerhalb des Steuerelements verwenden möchten; Andernfalls FALSE.
nWidth
[in] Breite des Kombinationsfelds in Pixeln; oder -1 für die Standardbreite.
lpszLabel
[in] Die Anzeigebezeichnung des Kombinationsfelds.
nImage
[in] Der kleine Bildindex des Kombinationsfelds.
Hinweise
Die Standardbreite beträgt 108 Pixel.
CMFCRibbonComboBox::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] Die Zeichenfolge des zu löschenden Elements. Wenn mehrere Elemente mit derselben Zeichenfolge vorhanden sind, wird das erste Element gelöscht.
Rückgabewert
TRUE, wenn das angegebene Element gelöscht wurde; andernfalls FALSE.
Hinweise
CMFCRibbonComboBox::EnableDropDownListResize
Gibt an, ob das Listenfeld die Größe ändern kann, wenn es abbricht.
void EnableDropDownListResize(BOOL bEnable=FALSE);
Parameter
bEnable
[in] TRUE zum Aktivieren der Größenänderung; FALSE zum Deaktivieren der Größenänderung.
Hinweise
Wenn die Größenänderung aktiviert ist, ändert sich die Größe des Listenfelds an die angezeigten Elemente.
CMFCRibbonComboBox::FindItem
Gibt den Index des ersten Elements im Listenfeld zurück, das einer angegebenen Zeichenfolge entspricht.
int FindItem(LPCTSTR lpszText) const;
Parameter
lpszText
[in] Die Zeichenfolge eines Elements im Listenfeld.
Rückgabewert
Der nullbasierte Index des Elements; oder -1, wenn das Element nicht gefunden wird.
Hinweise
CMFCRibbonComboBox::GetCount
Gibt die Anzahl der Elemente im Listenfeld zurück.
INT_PTR GetCount() const;
Rückgabewert
Die Anzahl der Elemente im Listenfeld oder 0, wenn das Listenfeld keine Elemente enthält.
Hinweise
CMFCRibbonComboBox::GetCurSel
Ruft den Index des aktuell ausgewählten Elements im Listenfeld ab.
int GetCurSel() const;
Rückgabewert
Der nullbasierte Index des aktuell ausgewählten Elements im Listenfeld; oder -1, wenn kein Element ausgewählt ist.
CMFCRibbonComboBox::GetDropDownHeight
Ruft die Höhe des Listenfelds ab, wenn das Listenfeld nach unten abgelegt wird.
int GetDropDownHeight();
Rückgabewert
Die Höhe des Listenfelds in Pixel.
Hinweise
CMFCRibbonComboBox::GetIntermediateSize
Gibt die Größe des Kombinationsfelds zurück, wie im Zwischenmodus angezeigt.
virtual CSize GetIntermediateSize(CDC* pDC);
Parameter
pDC
[in] Zeigen Sie auf einen Gerätekontext für das Kombinationsfeld.
Rückgabewert
Die Größe des Kombinationsfelds.
Hinweise
Die zurückgegebene Größe basiert auf der Größe des Kombinationsfelds, wenn kleine Bilder angezeigt werden.
CMFCRibbonComboBox::GetItem
Gibt die Zeichenfolge zurück, die einem Element bei einem angegebenen Index im Listenfeld zugeordnet ist.
LPCTSTR GetItem(int iIndex) const;
Parameter
iIndex
[in] Der nullbasierte 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 Element im Kombinationsfeld ausgewählt ist.
Hinweise
CMFCRibbonComboBox::GetItemData
Gibt die Daten zurück, die einem Element in einem angegebenen Index im Listenfeld zugeordnet sind.
DWORD_PTR GetItemData(int iIndex) 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 oder der Indexparameter -1 ist und kein ausgewähltes Element im Listenfeld vorhanden ist.
CMFCRibbonComboBox::HasEditBox
Gibt an, ob das Steuerelement ein Bearbeitungsfeld enthält.
BOOL HasEditBox() const;
Rückgabewert
TRUE, wenn das Steuerelement ein Bearbeitungsfeld enthält; andernfalls FALSE.
Hinweise
CMFCRibbonComboBox::IsResizeDropDownList
Gibt an, ob die Größe des Listenfelds geändert werden kann.
BOOL IsResizeDropDownList() const;
Rückgabewert
TRUE, wenn die Größe des Listenfelds geändert werden kann; andernfalls FALSE. CMFCRibbonComboBox::EnableDropDownListResize
Hinweise
Sie können die Größe des Listenfelds mithilfe der CMFCRibbonComboBox::EnableDropDownListResize-Methode aktivieren.
CMFCRibbonComboBox::OnSelectItem
Wird vom Framework aufgerufen, wenn ein Benutzer ein Element im Listenfeld auswählt.
virtual void OnSelectItem(int nItem);
Parameter
nItem
[in] Der Index des ausgewählten Elements.
Hinweise
Überschreiben Sie diese Methode, wenn Sie eine Benutzereingabeauswahl verarbeiten möchten.
CMFCRibbonComboBox::RemoveAllItems
Löscht alle Elemente aus dem Listenfeld und löscht das Bearbeitungsfeld.
void RemoveAllItems();
Hinweise
CMFCRibbonComboBox::SelectItem
Wählt ein Element im Listenfeld aus.
BOOL SelectItem(int iIndex);
BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);
Parameter
iIndex
[in] Der nullbasierte Index eines Elements im Listenfeld.
dwData
[in] Die daten, die einem Element im Listenfeld zugeordnet sind.
lpszText
[in] Die Zeichenfolge eines Elements im Listenfeld.
Rückgabewert
TRUE, wenn die Methode erfolgreich war; andernfalls FALSE.
Hinweise
CMFCRibbonComboBox::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.
Siehe auch
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