Freigeben über

CMFCRibbonComboBox-Klasse

  • Artikel

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

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonEdit

CMFCRibbonComboBox

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

Hierarchiediagramm
Klassen
CMFCRibbonEdit-Klasse