CMFCRibbonComboBox-klasse

De CMFCRibbonComboBox klasse implementeert een besturingselement voor keuzelijsten met invoervak dat u kunt toevoegen aan een lintbalk, een lintpaneel of een pop-upmenu op het lint.

Syntaxis

class CMFCRibbonComboBox : public CMFCRibbonEdit

Leden

Constructeurs

Openbare methoden

Opmerkingen

De keuzelijst met invoervak op het lint bestaat uit een keuzelijst in combinatie met een statisch label of label dat door de gebruiker kan worden bewerkt. U moet opgeven welk type u wilt wanneer u de keuzelijst met invoervak voor het lint maakt.

Example

In het volgende voorbeeld ziet u hoe u een object van de CMFCRibbonComboBox klasse maakt, een item toevoegt aan de keuzelijst met invoervak, een item in de keuzelijst met invoervak selecteert en een keuzelijst met invoervak toevoegt aan een deelvenster.

// 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);

Overnamehiërarchie

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonEdit

CMFCRibbonComboBox

Requirements

Koptekst: afxribboncombobox.h

CMFCRibbonComboBox::AddItem

Voegt een uniek item toe aan de keuzelijst.

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

Parameterwaarden

lpszItem
[in] De tekenreeks van het item dat moet worden toegevoegd.

dwData
[in] De gegevens die aan het item zijn gekoppeld om toe te voegen.

Retourwaarde

De op nul gebaseerde index van het toegevoegde item.

CMFCRibbonComboBox::CMFCRibbonComboBox

Maakt een CMFCRibbonComboBox object.

public:
CMFCRibbonComboBox(
    UINT nID,
    BOOL bHasEditBox=TRUE,
    int nWidth=-1,
    LPCTSTR lpszLabel=NULL,
    int nImage=-1);

protected:
CMFCRibbonComboBox();

Parameterwaarden

nID
[in] De id van de keuzelijst met invoervak.

bHasEditBox
[in] WAAR als u een invoervak in het besturingselement wilt hebben; ANDERS ONWAAR.

nWidth
[in] Breedte van de keuzelijst met invoervak in pixels; of -1 voor de standaardbreedte.

lpszLabel
[in] Het weergavelabel van de keuzelijst met invoervak.

nImage
[in] De kleine afbeeldingsindex van de keuzelijst met invoervak.

Opmerkingen

De standaardbreedte is 108 pixels.

CMFCRibbonComboBox::D eleteItem

Hiermee verwijdert u een opgegeven item uit de keuzelijst.

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

BOOL DeleteItem(LPCTSTR lpszText);

Parameterwaarden

iIndex
[in] De op nul gebaseerde index van het item dat moet worden verwijderd.

dwData
[in] De gegevens die zijn gekoppeld aan het item dat moet worden verwijderd.

lpszText
[in] De tekenreeks van het item dat moet worden verwijderd. Als er meerdere items met dezelfde tekenreeks zijn, wordt het eerste item verwijderd.

Retourwaarde

WAAR als het opgegeven item is verwijderd; anders, ONWAAR.

Opmerkingen

CMFCRibbonComboBox::EnableDropDownListResize

Hiermee geeft u op of de keuzelijst de grootte kan wijzigen wanneer deze wordt neergeschreven.

void EnableDropDownListResize(BOOL bEnable=FALSE);

Parameterwaarden

bEnable
[in] TRUE om het formaat in te schakelen; FALSE om het formaat uit te schakelen.

Opmerkingen

Wanneer het formaat wordt ingeschakeld, wordt de grootte van de keuzelijst aangepast aan de items die worden weergegeven.

CMFCRibbonComboBox::FindItem

Retourneert de index van het eerste item in de keuzelijst die overeenkomt met een opgegeven tekenreeks.

int FindItem(LPCTSTR lpszText) const;

Parameterwaarden

lpszText
[in] De tekenreeks van een item in de keuzelijst.

Retourwaarde

De op nul gebaseerde index van het item; of -1 als het item niet is gevonden.

Opmerkingen

CMFCRibbonComboBox::GetCount

Retourneert het aantal items in de keuzelijst.

INT_PTR GetCount() const;

Retourwaarde

Het aantal items in de keuzelijst of 0 als de keuzelijst geen items bevat.

Opmerkingen

CMFCRibbonComboBox::GetCurSel

Hiermee haalt u de index op van het geselecteerde item in de keuzelijst.

int GetCurSel() const;

Retourwaarde

De op nul gebaseerde index van het momenteel geselecteerde item in de keuzelijst; of -1 als er geen item is geselecteerd.

CMFCRibbonComboBox::GetDropDownHeight

Hiermee wordt de hoogte van de keuzelijst opgehaald wanneer de keuzelijst wordt neergezet.

int GetDropDownHeight();

Retourwaarde

De hoogte, in pixels, van de keuzelijst.

Opmerkingen

CMFCRibbonComboBox::GetIntermediateSize

Retourneert de grootte van de keuzelijst met invoervak zoals weergegeven in de tussenliggende modus.

virtual CSize GetIntermediateSize(CDC* pDC);

Parameterwaarden

Pdc
[in] Aanwijzer naar een apparaatcontext voor de keuzelijst met invoervak.

Retourwaarde

De grootte van de keuzelijst met invoervak.

Opmerkingen

De geretourneerde grootte is gebaseerd op de grootte van de keuzelijst met invoervak wanneer er kleine afbeeldingen worden weergegeven.

CMFCRibbonComboBox::GetItem

Retourneert de tekenreeks die is gekoppeld aan een item in een opgegeven index in de keuzelijst.

LPCTSTR GetItem(int iIndex) const;

Parameterwaarden

iIndex
[in] De op nul gebaseerde index van een item in de keuzelijst.

Retourwaarde

Een aanwijzer naar de tekenreeks die aan het item is gekoppeld; anders null als de indexparameter ongeldig is of als de indexparameter is -1 en er geen item is geselecteerd in de keuzelijst met invoervak.

Opmerkingen

CMFCRibbonComboBox::GetItemData

Retourneert de gegevens die zijn gekoppeld aan een item in een opgegeven index in de keuzelijst.

DWORD_PTR GetItemData(int iIndex) const;

Parameterwaarden

iIndex
[in] De op nul gebaseerde index van een item in de keuzelijst.

Retourwaarde

De gegevens die aan het item zijn gekoppeld; of 0 als het item niet bestaat of als de indexparameter is -1 en er geen geselecteerd item in de keuzelijst staat.

CMFCRibbonComboBox::HasEditBox

Geeft aan of het besturingselement een invoervak bevat.

BOOL HasEditBox() const;

Retourwaarde

WAAR als het besturingselement een invoervak bevat; anders, ONWAAR.

Opmerkingen

CMFCRibbonComboBox::IsResizeDropDownList

Geeft aan of het formaat van de keuzelijst al dan niet kan worden gewijzigd.

BOOL IsResizeDropDownList() const;

Retourwaarde

WAAR als het formaat van de keuzelijst kan worden gewijzigd; anders ONWAAR. CMFCRibbonComboBox::EnableDropDownListResize

Opmerkingen

U kunt het formaat van de keuzelijst inschakelen met behulp van de methode CMFCRibbonComboBox::EnableDropDownListResize .

CMFCRibbonComboBox::OnSelectItem

Aangeroepen door het framework wanneer een gebruiker een item in de keuzelijst selecteert.

virtual void OnSelectItem(int nItem);

Parameterwaarden

nItem
[in] De index van het geselecteerde item.

Opmerkingen

Overschrijf deze methode als u een selectie van gebruikersinvoer wilt verwerken.

CMFCRibbonComboBox::RemoveAllItems

Hiermee verwijdert u alle items uit de keuzelijst en schakelt u het invoervak uit.

void RemoveAllItems();

Opmerkingen

CMFCRibbonComboBox::SelectItem

Hiermee selecteert u een item in de keuzelijst.

BOOL SelectItem(int iIndex);
BOOL SelectItem(DWORD_PTR dwData);

BOOL SelectItem(LPCTSTR lpszText);

Parameterwaarden

iIndex
[in] De op nul gebaseerde index van een item in de keuzelijst.

dwData
[in] De gegevens die zijn gekoppeld aan een item in de keuzelijst.

lpszText
[in] De tekenreeks van een item in de keuzelijst.

Retourwaarde

WAAR als de methode is geslaagd; anders ONWAAR.

Opmerkingen

CMFCRibbonComboBox::SetDropDownHeight

Hiermee stelt u de hoogte van de keuzelijst in wanneer deze wordt neergezet.

void SetDropDownHeight(int nHeight);

Parameterwaarden

nHeight
[in] De hoogte, in pixels, van de keuzelijst.

Opmerkingen

De standaardhoogte is 150 pixels.

Zie ook

Hiërarchiegrafiek
Klassen
CMFCRibbonEdit-klasse