Klasa CMFCRibbonComboBox

Klasa CMFCRibbonComboBox implementuje kontrolkę pola kombi, którą można dodać do paska wstążki, panelu wstążki lub menu podręcznego wstążki.

Składnia

class CMFCRibbonComboBox : public CMFCRibbonEdit

Elementy członkowskie

Konstruktory

Nazwa/nazwisko	opis
CMFCRibbonComboBox::CMFCRibbonComboBox	Tworzy obiekt CMFCRibbonComboBox.

Metody publiczne

Nazwa/nazwisko	opis
CMFCRibbonComboBox::AddItem	Dołącza unikatowy element do pola listy.
CMFCRibbonComboBox::D eleteItem	Usuwa określony element z pola listy.
CMFCRibbonComboBox::EnableDropDownListResize	Określa, czy pole listy może zmienić rozmiar po jej wyświetleniu.
CMFCRibbonComboBox::FindItem	Zwraca indeks pierwszego elementu w polu listy, który pasuje do określonego ciągu.
CMFCRibbonComboBox::GetCount	Zwraca liczbę elementów w polu listy.
CMFCRibbonComboBox::GetCurSel	Pobiera indeks aktualnie wybranego elementu w polu listy.
CMFCRibbonComboBox::GetDropDownHeight	Pobiera wysokość pola listy, gdy pole listy zostanie usunięte.
CMFCRibbonComboBox::GetIntermediateSize	Zwraca rozmiar pola kombi, jak pokazano w trybie pośrednim.
CMFCRibbonComboBox::GetItem	Zwraca ciąg skojarzony z elementem w określonym indeksie w polu listy.
CMFCRibbonComboBox::GetItemData	Zwraca dane skojarzone z elementem w określonym indeksie w polu listy.
CMFCRibbonComboBox::HasEditBox	Wskazuje, czy kontrolka zawiera pole edycji.
CMFCRibbonComboBox::IsResizeDropDownList	Wskazuje, czy można zmienić rozmiar pola listy.
CMFCRibbonComboBox::OnSelectItem	Wywoływana przez platformę, gdy użytkownik wybierze element w polu listy.
CMFCRibbonComboBox::RemoveAllItems	Usuwa wszystkie elementy z pola listy i czyści pole edycji.
CMFCRibbonComboBox::SelectItem	Wybiera element w polu listy.
CMFCRibbonComboBox::SetDropDownHeight	Ustawia wysokość pola listy, gdy zostanie ona upuszczony.

Uwagi

Pole kombi wstążki składa się z pola listy połączonego z etykietą statyczną lub etykietą, którą można edytować przez użytkownika. Musisz określić typ, który ma zostać utworzony podczas tworzenia pola kombi wstążki.

Przykład

W poniższym przykładzie pokazano, jak skonstruować obiekt CMFCRibbonComboBox klasy, dodać element do pola kombi, wybrać element w polu kombi i dodać pole kombi do panelu.

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

Hierarchia dziedziczenia

Obiekt CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonEdit

CMFCRibbonComboBox

Wymagania

Nagłówek: afxribboncombobox.h

CMFCRibbonComboBox::AddItem

Dołącza unikatowy element do pola listy.

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

Parametry

lpszItem
[in] Ciąg elementu do dodania.

dwData
[in] Dane skojarzone z elementem do dodania.

Wartość zwracana

Indeks zerowy dołączonego elementu.

CMFCRibbonComboBox::CMFCRibbonComboBox

CMFCRibbonComboBox Tworzy obiekt.

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

protected:
CMFCRibbonComboBox();

Parametry

Nid
[in] Identyfikator pola kombi.

bHasEditBox
[in] WARTOŚĆ TRUE, jeśli chcesz edytować pole w kontrolce; FAŁSZ w przeciwnym razie.

nWidth
[in] Szerokość pola kombi w pikselach; lub -1 dla szerokości domyślnej.

lpszLabel
[in] Etykieta wyświetlana pola kombi.

nImage
[in] Mały indeks obrazu pola kombi.

Uwagi

Domyślna szerokość to 108 pikseli.

CMFCRibbonComboBox::D eleteItem

Usuwa określony element z pola listy.

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

BOOL DeleteItem(LPCTSTR lpszText);

Parametry

iIndex
[in] Indeks zerowy elementu do usunięcia.

dwData
[in] Dane skojarzone z elementem do usunięcia.

lpszText
[in] Ciąg elementu do usunięcia. Jeśli istnieje wiele elementów z tym samym ciągiem, pierwszy element zostanie usunięty.

Wartość zwracana

WARTOŚĆ TRUE, jeśli określony element został usunięty; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCRibbonComboBox::EnableDropDownListResize

Określa, czy pole listy może zmienić rozmiar po jej wyświetleniu.

void EnableDropDownListResize(BOOL bEnable=FALSE);

Parametry

bEnable
[in] WARTOŚĆ TRUE, aby włączyć zmianę rozmiaru; FAŁSZ, aby wyłączyć zmianę rozmiaru.

Uwagi

Po włączeniu zmiany rozmiaru pole listy zmieni rozmiar tak, aby pasowało do wyświetlanych elementów.

CMFCRibbonComboBox::FindItem

Zwraca indeks pierwszego elementu w polu listy, który pasuje do określonego ciągu.

int FindItem(LPCTSTR lpszText) const;

Parametry

lpszText
[in] Ciąg elementu w polu listy.

Wartość zwracana

Indeks zerowy elementu; lub -1, jeśli nie znaleziono elementu.

Uwagi

CMFCRibbonComboBox::GetCount

Zwraca liczbę elementów w polu listy.

INT_PTR GetCount() const;

Wartość zwracana

Liczba elementów w polu listy lub 0, jeśli pole listy nie zawiera żadnych elementów.

Uwagi

CMFCRibbonComboBox::GetCurSel

Pobiera indeks aktualnie wybranego elementu w polu listy.

int GetCurSel() const;

Wartość zwracana

Indeks zerowy aktualnie wybranego elementu w polu listy; lub -1, jeśli nie wybrano żadnego elementu.

CMFCRibbonComboBox::GetDropDownHeight

Pobiera wysokość pola listy, gdy pole listy zostanie usunięte.

int GetDropDownHeight();

Wartość zwracana

Wysokość pola listy w pikselach.

Uwagi

CMFCRibbonComboBox::GetIntermediateSize

Zwraca rozmiar pola kombi, jak pokazano w trybie pośrednim.

virtual CSize GetIntermediateSize(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla pola kombi.

Wartość zwracana

Rozmiar pola kombi.

Uwagi

Zwrócony rozmiar jest oparty na rozmiarze pola kombi, gdy wyświetla małe obrazy.

CMFCRibbonComboBox::GetItem

Zwraca ciąg skojarzony z elementem w określonym indeksie w polu listy.

LPCTSTR GetItem(int iIndex) const;

Parametry

iIndex
[in] Indeks oparty na zera elementu w polu listy.

Wartość zwracana

Wskaźnik do ciągu skojarzonego z elementem; w przeciwnym razie wartość NULL, jeśli parametr indeksu jest nieprawidłowy lub jeśli parametr indeksu ma wartość -1 i w polu kombi nie wybrano żadnego elementu.

Uwagi

CMFCRibbonComboBox::GetItemData

Zwraca dane skojarzone z elementem w określonym indeksie w polu listy.

DWORD_PTR GetItemData(int iIndex) const;

Parametry

iIndex
[in] Indeks oparty na zera elementu w polu listy.

Wartość zwracana

Dane skojarzone z elementem; lub 0, jeśli element nie istnieje lub jeśli parametr indeksu wynosi -1 i nie ma zaznaczonego elementu w polu listy.

CMFCRibbonComboBox::HasEditBox

Wskazuje, czy kontrolka zawiera pole edycji.

BOOL HasEditBox() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli kontrolka zawiera pole edycji; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCRibbonComboBox::IsResizeDropDownList

Wskazuje, czy można zmienić rozmiar pola listy.

BOOL IsResizeDropDownList() const;

Wartość zwracana

Wartość TRUE, jeśli można zmienić rozmiar pola listy; w przeciwnym razie FAŁSZ. CMFCRibbonComboBox::EnableDropDownListResize

Uwagi

Można włączyć zmianę rozmiaru pola listy przy użyciu metody CMFCRibbonComboBox::EnableDropDownListResize .

CMFCRibbonComboBox::OnSelectItem

Wywoływana przez platformę, gdy użytkownik wybierze element w polu listy.

virtual void OnSelectItem(int nItem);

Parametry

nItem
[in] Indeks wybranego elementu.

Uwagi

Zastąpi tę metodę, jeśli chcesz przetworzyć wybór danych wejściowych użytkownika.

CMFCRibbonComboBox::RemoveAllItems

Usuwa wszystkie elementy z pola listy i czyści pole edycji.

void RemoveAllItems();

Uwagi

CMFCRibbonComboBox::SelectItem

Wybiera element w polu listy.

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

BOOL SelectItem(LPCTSTR lpszText);

Parametry

iIndex
[in] Indeks oparty na zera elementu w polu listy.

dwData
[in] Dane skojarzone z elementem w polu listy.

lpszText
[in] Ciąg elementu w polu listy.

Wartość zwracana

Wartość TRUE, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

CMFCRibbonComboBox::SetDropDownHeight

Ustawia wysokość pola listy, gdy zostanie ona upuszczony.

void SetDropDownHeight(int nHeight);

Parametry

nHeight
[in] Wysokość pola listy w pikselach.

Uwagi

Domyślna wysokość to 150 pikseli.

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCRibbonEdit