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
Członkowie
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
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ż
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla