Klasa CMFCToolBarComboBoxButton
Przycisk paska narzędzi, który zawiera kontrolkę pola kombi ( Klasa CComboBox).
Składnia
class CMFCToolBarComboBoxButton : public CMFCToolBarButton
Elementy członkowskie
Konstruktory publiczne
Nazwa/nazwisko | opis |
---|---|
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton | Tworzy element CMFCToolBarComboBoxButton . |
Metody publiczne
Nazwa/nazwisko | opis |
---|---|
CMFCToolBarComboBoxButton::AddItem | Dodaje element na końcu listy pól kombi. |
CMFCToolBarComboBoxButton::AddSortedItem | Dodaje element do listy pól kombi. Kolejność elementów na liście jest określona przez Compare element . |
CMFCToolBarComboBoxButton::Compare | Porównuje dwa elementy. Wywoływane w celu sortowania elementów dodawanych AddSortedItems do listy pól kombi. |
CMFCToolBarComboBoxButton::CreateEdit | Tworzy nową kontrolkę edycji dla przycisku pola kombi. |
CMFCToolBarComboBoxButton::D eleteItem | Usuwa element z listy pól kombi. |
CMFCToolBarComboBoxButton::FindItem | Zwraca indeks elementu, który zawiera określony ciąg. |
CMFCToolBarComboBoxButton::GetByCmd | Zwraca wskaźnik do przycisku pola kombi z określonym identyfikatorem polecenia. |
CMFCToolBarComboBoxButton::GetComboBox | Zwraca wskaźnik do kontrolki pola kombi osadzonej w przycisku pola kombi. |
CMFCToolBarComboBoxButton::GetCount | Zwraca liczbę elementów na liście pól kombi. |
CMFCToolBarComboBoxButton::GetCountAll | Znajduje przycisk pola kombi, który ma określony identyfikator polecenia. Zwraca liczbę elementów na liście pól kombi tego przycisku. |
CMFCToolBarComboBoxButton::GetCurSel | Zwraca indeks wybranego elementu na liście pól kombi. |
CMFCToolBarComboBoxButton::GetCurSelAll | Znajduje przycisk pola kombi z określonym identyfikatorem polecenia i zwraca indeks wybranego elementu na liście pól kombi tego przycisku. |
CMFCToolBarComboBoxButton::GetEditCtrl | Zwraca wskaźnik do kontrolki edycji osadzonej w przycisku pola kombi. |
CMFCToolBarComboBoxButton::GetItem | Zwraca ciąg skojarzony z określonym indeksem na liście pól kombi. |
CMFCToolBarComboBoxButton::GetItemAll | Znajduje przycisk pola kombi o określonym identyfikatorze polecenia i zwraca ciąg skojarzony z indeksem na liście pól kombi tego przycisku. |
CMFCToolBarComboBoxButton::GetItemData | Zwraca wartość 32-bitową skojarzona z określonym indeksem na liście pól kombi. |
CMFCToolBarComboBoxButton::GetItemDataAll | Znajduje przycisk pola kombi z określonym identyfikatorem polecenia i zwraca wartość 32-bitową skojarzona z indeksem na liście pól kombi tego przycisku. |
CMFCToolBarComboBoxButton::GetItemDataPtrAll | Znajduje przycisk pola kombi, który ma określony identyfikator polecenia. Pobiera wartość 32-bitową skojarzona z indeksem na liście pól kombi tego przycisku i zwraca wartość 32-bitową jako wskaźnik. |
CMFCToolBarComboBoxButton::GetText | Zwraca tekst z kontrolki edycji pola kombi. |
CMFCToolBarComboBoxButton::GetTextAll | Znajduje przycisk pola kombi z określonym identyfikatorem polecenia i zwraca tekst z kontrolki edycji tego przycisku. |
CMFCToolBarComboBoxButton::IsCenterVert | Określa, czy przyciski pola kombi w aplikacji są wyśrodkowane, czy wyrównane do górnej części paska narzędzi. |
CMFCToolBarComboBoxButton::IsFlatMode | Określa, czy przyciski pola kombi w aplikacji mają płaski wygląd. |
CMFCToolBarComboBoxButton::RemoveAllItems | Usuwa wszystkie elementy z pola listy i kontrolkę edycji pola kombi. |
CMFCToolBarComboBoxButton::SelectItem | Wybiera element w polu kombi zgodnie z jego indeksem, wartością 32-bitową lub ciągiem i powiadamia kontrolkę pola kombi o zaznaczeniu. |
CMFCToolBarComboBoxButton::SelectItemAll | Znajduje przycisk pola kombi, który ma określony identyfikator polecenia. Wywołuje metodę SelectItem wybierania elementu w polu kombi tego przycisku zgodnie z jego ciągiem, indeksem lub wartością 32-bitową. |
CMFCToolBarComboBoxButton::SetCenterVert | Określa, czy przyciski pola kombi w aplikacji są wyśrodkowane w pionie lub wyrównane do góry paska narzędzi. |
CMFCToolBarComboBoxButton::SetDropDownHeight | Ustawia wysokość pola listy rozwijanej. |
CMFCToolBarComboBoxButton::SetFlatMode | Określa, czy przyciski pola kombi w aplikacji mają płaski wygląd. |
Uwagi
Aby dodać przycisk pola kombi do paska narzędzi, wykonaj następujące kroki:
Zarezerwuj fikcyjny identyfikator zasobu dla przycisku w zasobie nadrzędnego paska narzędzi.
Konstruowanie
CMFCToolBarComboBoxButton
obiektu.W procedurze obsługi komunikatów, która przetwarza komunikat AFX_WM_RESETTOOLBAR, zastąp fikcyjny przycisk nowego pola kombi za pomocą CMFCToolBar::ReplaceButton.
Aby uzyskać więcej informacji, zobacz Przewodnik: umieszczanie kontrolek na paskach narzędzi. Przykładowy przycisk paska narzędzi pola kombi można znaleźć w przykładowym projekcie VisualStudioDemo.
Przykład
W poniższym przykładzie pokazano, jak używać różnych metod w CMFCToolBarComboBoxButton
klasie . W przykładzie pokazano, jak włączyć pola edycji i kombi, ustawić pionową pozycję przycisków pola kombi w aplikacji, ustawić wysokość pola listy po upuszczeniu, ustawić płaski wygląd pól kombi w aplikacji i ustawić tekst w polu edycji przycisku pola kombi. Ten fragment kodu jest częścią przykładu pokazowego programu Visual Studio.
// CObList listButtons
// POSITION posCombo
CMFCToolBarComboBoxButton* pCombo = DYNAMIC_DOWNCAST(CMFCToolBarComboBoxButton, listButtons.GetNext(posCombo));
pCombo->EnableWindow(true);
pCombo->SetCenterVert();
pCombo->SetDropDownHeight(25);
pCombo->SetFlatMode();
pCombo->SetText(_T("this is a combo box"));
Hierarchia dziedziczenia
Wymagania
Nagłówek: afxtoolbarcomboboxbutton.h
CMFCToolBarComboBoxButton::AddItem
Dołącza unikatowy element do pola listy.
virtual INT_PTR AddItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Parametry
lpszItem
[in] Tekst elementu, który ma zostać dodany do pola listy.
dwData
[in] Dane skojarzone z elementem, które mają zostać dodane do pola listy.
Wartość zwracana
Indeks ostatniego elementu w polu listy.
Uwagi
Nie używaj tej metody, gdy styl pola listy jest sortowany.
Jeśli tekst elementu znajduje się już w polu listy, nowe dane są przechowywane z istniejącym elementem. W wyszukiwaniu elementu jest uwzględniana wielkość liter.
CMFCToolBarComboBoxButton::AddSortedItem
Dodaje element do pola listy w kolejności zdefiniowanej przez metodę Compare .
virtual INT_PTR AddSortedItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Parametry
lpszItem
[in] Tekst elementu, który ma zostać dodany do pola listy.
dwData
[in] Dane skojarzone z elementem, które mają zostać dodane do pola listy.
Wartość zwracana
Indeks elementu, który został dodany do pola listy.
Uwagi
Ta funkcja służy do dodawania elementów do pola listy w określonej kolejności.
CMFCToolBarComboBoxButton::CanBeStretched
Wskazuje, czy rozmiar przycisku pola kombi może ulec zmianie.
virtual BOOL CanBeStretched() const;
Wartość zwracana
Zwraca wartość TRUE.
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton
Tworzy obiekt CMFCToolBarComboBoxButton.
CMFCToolBarComboBoxButton(
UINT uiID,
int iImage,
DWORD dwStyle=CBS_DROPDOWNLIST,
int iWidth=0);
Parametry
identyfikator uiID
[in] Identyfikator polecenia nowego przycisku.
iImage
[in] Indeks obrazu skojarzony z nowym przyciskiem.
dwStyle
[in] Styl nowego przycisku.
iWidth
[in] Szerokość przycisku w pikselach.
Uwagi
Domyślna szerokość to 150 pikseli.
Aby uzyskać listę stylów przycisków paska narzędzi, zobacz ToolBar Control Styles (Style kontrolek Paska narzędzi)
CMFCToolBarComboBoxButton::ClearData
Usuwa dane zdefiniowane przez użytkownika.
virtual void ClearData();
Uwagi
Domyślnie ta metoda nic nie robi. Zastąp tę metodę w klasie pochodnej, jeśli chcesz usunąć dowolne dane zdefiniowane przez użytkownika.
CMFCToolBarComboBoxButton::Compare
Porównuje dwa ciągi.
virtual int Compare(
LPCTSTR lpszItem1,
LPCTSTR lpszItem2);
Parametry
lpszItem1
[in] Pierwszy ciąg do porównania.
lpszItem2
[in] Drugi ciąg do porównania.
Wartość zwracana
Wartość wskazująca relację leksykograficzną uwzględniającą wielkość liter między ciągami. W poniższej tabeli wymieniono możliwe wartości:
Wartość | Opis |
---|---|
<0 | Pierwszy ciąg jest mniejszy niż drugi. |
0 | Pierwszy ciąg jest równy drugiemu. |
>0 | Pierwszy ciąg jest większy niż drugi. |
Uwagi
Zastąpij tę metodę, aby zmienić sposób sortowania elementów w polu listy.
Porównanie uwzględnia wielkość liter.
Ta metoda jest wywoływana tylko z metody AddSortedItem .
CMFCToolBarComboBoxButton::CopyFrom
Kopiuje stan określonego CMFCToolBarComboBoxButton
obiektu do bieżącego obiektu.
virtual void CopyFrom(const CMFCToolBarButton& src);
Parametry
Src
[in] Obiekt źródłowy CMFCToolBarComboBoxButton
.
CMFCToolBarComboBoxButton::CreateCombo
Tworzy nowe pole kombi dla przycisku pola kombi.
virtual CComboBox* CreateCombo(
CWnd* pWndParent,
const CRect& rect);
Parametry
pWndParent
[in] Wskaźnik do okna nadrzędnego przycisku.
Rect
[in] Ograniczenie prostokąta pola kombi.
Wartość zwracana
Wskaźnik do nowego pola kombi, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie wartość NULL.
CMFCToolBarComboBoxButton::CreateEdit
Tworzy nowe pole edycji dla przycisku pola kombi.
virtual CMFCToolBarComboBoxEdit* CreateEdit(
CWnd* pWndParent,
const CRect& rect,
DWORD dwEditStyle);
Parametry
pWndParent
[in] Wskaźnik do okna nadrzędnego przycisku.
Rect
[in] Ograniczenie prostokąta nowego pola edycji.
dwEditStyle
[in] Styl sterowania nowym polem edycji.
Wartość zwracana
Wskaźnik do nowego pola edycji, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie wartość NULL.
Uwagi
Struktura wywołuje tę metodę podczas tworzenia nowego pola edycji dla przycisku pola kombi. Zastąpij tę metodę, aby zmienić sposób tworzenia metody CMFCToolBarComboBoxEdit .
CMFCToolBarComboBoxButton::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] Tekst elementu do usunięcia. Jeśli istnieje wiele elementów z tym samym tekstem, pierwszy element zostanie usunięty.
Wartość zwracana
WARTOŚĆ TRUE, jeśli element został zlokalizowany i pomyślnie usunięty; w przeciwnym razie, FAŁSZ.
Uwagi
CMFCToolBarComboBoxButton::D uplicateData
Duplikuje dane zdefiniowane przez użytkownika.
virtual void DuplicateData();
Uwagi
Domyślnie ta metoda nic nie robi. Zastąp tę metodę w klasie pochodnej, jeśli chcesz skopiować dowolne dane zdefiniowane przez użytkownika.
CMFCToolBarComboBoxButton::EnableWindow
Włącza lub wyłącza pola edycji i kombi.
virtual void EnableWindow(BOOL bEnable = TRUE);
Parametry
bEnable
[in] Wartość TRUE w celu włączenia pól edycji i kombi; FAŁSZ, aby wyłączyć pola edycji i kombi.
Uwagi
Po wyłączeniu kontrolki nie mogą być aktywne i nie mogą akceptować danych wejściowych użytkownika.
CMFCToolBarComboBoxButton::ExportToMenuButton
Kopiuje ciąg z tabeli ciągów aplikacji do określonego menu przy użyciu identyfikatora polecenia przycisku pola kombi.
virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;
Parametry
menuButton
[out] Odwołanie do przycisku menu.
Wartość zwracana
Zawsze prawda.
CMFCToolBarComboBoxButton::FindItem
Zwraca indeks pierwszego elementu w polu listy zawierający określony ciąg.
int FindItem(LPCTSTR lpszText) const;
Parametry
lpszText
[in] Tekst, dla którego ma być wyszukiwane w polu listy.
Wartość zwracana
Indeks elementu; lub CB_ERR, jeśli element nie zostanie znaleziony.
Uwagi
CMFCToolBarComboBoxButton::GetByCmd
Pobiera wskaźnik do przycisku pola kombi, który ma określony identyfikator polecenia.
static CMFCToolBarComboBoxButton* GetByCmd(
UINT uiCmd,
BOOL bIsFocus=FALSE);
Parametry
uiCmd
[in] Identyfikator polecenia przycisku pola kombi.
bIsFocus
[in] Wartość TRUE do wyszukiwania tylko przycisków ukierunkowanych; FAŁSZ do wyszukiwania wszystkich przycisków.
Wartość zwracana
Wskaźnik do przycisku pola kombi; lub null, jeśli przycisk nie zostanie znaleziony.
Uwagi
CMFCToolBarComboBoxButton::GetComboBox
Zwraca wskaźnik do pola kombi w przycisku pola kombi.
CComboBox* GetComboBox() const;
Wartość zwracana
Wskaźnik do obiektu klasy CComboBox, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie wartość NULL.
Uwagi
CMFCToolBarComboBoxButton::GetContextMenuID
Pobiera identyfikator zasobu menu skrótów dla przycisku pola kombi.
UINT GetContextMenuID();
Wartość zwracana
Identyfikator zasobu menu skrótów.
CMFCToolBarComboBoxButton::GetCount
Zwraca liczbę elementów w polu listy.
INT_PTR GetCount() const;
Wartość zwracana
Liczba elementów w polu listy.
Uwagi
CMFCToolBarComboBoxButton::GetCountAll
Pobiera liczbę elementów w polu listy przycisku pola kombi, który ma określony identyfikator polecenia.
static int GetCountAll(UINT uiCmd);
Parametry
uiCmd
[in] Identyfikator polecenia przycisku pola kombi.
Wartość zwracana
Liczba elementów w polu listy; w przeciwnym razie CB_ERR, jeśli przycisk pola kombi nie zostanie znaleziony.
Uwagi
CMFCToolBarComboBoxButton::GetCurSel
Pobiera indeks aktualnie wybranego elementu w polu listy.
int GetCurSel() const;
Wartość zwracana
Indeks aktualnie wybranego elementu w polu listy; lub CB_ERR, jeśli nie wybrano żadnego elementu.
Uwagi
Indeks pola listy jest oparty na zera.
CMFCToolBarComboBoxButton::GetCurSelAll
Zwraca indeks aktualnie wybranego elementu w polu listy przycisku pola kombi, który ma określony identyfikator polecenia.
static int GetCurSelAll(UINT uiCmd);
Parametry
uiCmd
[in] Identyfikator polecenia przycisku pola kombi.
Wartość zwracana
Indeks aktualnie wybranego elementu w polu listy; w przeciwnym razie CB_ERR, jeśli nie wybrano żadnego elementu lub nie znaleziono przycisku pola kombi.
Uwagi
Indeks pola listy jest oparty na zera.
CMFCToolBarComboBoxButton::GetEditCtrl
Zwraca wskaźnik do pola edycji w przycisku pola kombi.
virtual CEdit* GetEditCtrl();
Wartość zwracana
Wskaźnik do pola edycji, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie wartość NULL.
Uwagi
CMFCToolBarComboBoxButton::GetHwnd
Zwraca uchwyt okna dla pola kombi.
virtual HWND GetHwnd();
Wartość zwracana
Uchwyt okna lub wartość NULL, jeśli pole kombi nie jest skojarzone z obiektem okna.
CMFCToolBarComboBoxButton::GetItem
Zwraca ciąg skojarzony z elementem w określonym indeksie w polu listy.
LPCTSTR GetItem(int iIndex=-1) const;
Parametry
iIndex
[in] Indeks na podstawie 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 to -1 i nie ma zaznaczonego elementu w polu kombi.
Uwagi
Parametr indeksu -1 zwraca ciąg aktualnie wybranego elementu.
CMFCToolBarComboBoxButton::GetItemAll
Zwraca ciąg skojarzony z elementem w określonym indeksie w polu listy przycisku pola kombi, który ma określony identyfikator polecenia.
static LPCTSTR GetItemAll(
UINT uiCmd,
int iIndex=-1);
Parametry
uiCmd
[in] Identyfikator polecenia przycisku pola kombi.
iIndex
[in] Indeks oparty na zera elementu w polu listy.
Wartość zwracana
Wskaźnik do ciągu elementu, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie wartość NULL, jeśli indeks jest nieprawidłowy, nie można odnaleźć przycisku pola kombi lub jeśli indeks ma wartość -1 i nie ma zaznaczonego elementu w polu kombi.
Uwagi
Wartość indeksu -1 zwraca ciąg aktualnie wybranego elementu.
CMFCToolBarComboBoxButton::GetItemData
Zwraca dane skojarzone z elementem w określonym indeksie w polu listy.
DWORD_PTR GetItemData(int iIndex=-1) 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.
Uwagi
Parametr indeksu -1 zwraca dane skojarzone z aktualnie wybranym elementem.
CMFCToolBarComboBoxButton::GetItemDataAll
Zwraca dane skojarzone z elementem w określonym indeksie w polu listy przycisku pola kombi, który ma określony identyfikator polecenia.
static DWORD_PTR GetItemDataAll(
UINT uiCmd,
int iIndex=-1);
Parametry
uiCmd
[in] Identyfikator polecenia przycisku pola kombi.
iIndex
[in] Indeks oparty na zera elementu w polu listy.
Wartość zwracana
Dane skojarzone z elementem, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie 0, jeśli określony indeks jest nieprawidłowy lub CB_ERR, jeśli przycisk pola kombi nie zostanie znaleziony.
Uwagi
Parametr indeksu -1 zwraca dane skojarzone z aktualnie wybranym elementem.
CMFCToolBarComboBoxButton::GetItemDataPtrAll
Zwraca dane skojarzone z elementem w określonym indeksie w polu listy przycisku pola kombi, który ma określony identyfikator polecenia. Te dane są zwracane jako wskaźnik.
static void* GetItemDataPtrAll(
UINT uiCmd,
int iIndex=-1);
Parametry
uiCmd
[in] Identyfikator polecenia przycisku pola kombi.
iIndex
[in] Indeks oparty na zera elementu w polu listy.
Wartość zwracana
Wskaźnik skojarzony z elementem, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie - 1, jeśli wystąpi błąd lub wartość NULL, jeśli przycisk pola kombi nie zostanie znaleziony.
Uwagi
CMFCToolBarComboBoxButton::GetPrompt
Zwraca ciąg monitu dla przycisku pola kombi.
virtual CString GetPrompt() const;
Wartość zwracana
Ciąg monitu.
Uwagi
Ta metoda nie jest obecnie implementowana.
CMFCToolBarComboBoxButton::GetText
Pobiera tekst w polu edycji.
LPCTSTR GetText() const;
Wartość zwracana
Tekst w polu edycji.
Uwagi
CMFCToolBarComboBoxButton::GetTextAll
Pobiera tekst w polu edycji przycisku pola kombi, który ma określony identyfikator polecenia.
static LPCTSTR GetTextAll(UINT uiCmd);
Parametry
uiCmd
[in] Identyfikator polecenia określonego przycisku pola kombi.
Wartość zwracana
Tekst w polu edycji, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie wartość NULL.
Uwagi
CMFCToolBarComboBoxButton::HasFocus
Wskazuje, czy pole kombi ma obecnie fokus.
virtual BOOL HasFocus() const;
Wartość zwracana
Wartość TRUE, jeśli pole kombi ma obecnie fokus; w przeciwnym razie, FAŁSZ.
Uwagi
Ta metoda zwraca również wartość TRUE, jeśli jakiekolwiek okno podrzędne pola kombi ma obecnie fokus.
CMFCToolBarComboBoxButton::IsCenterVert
Zwraca pozycję pionową przycisków pola kombi w aplikacji.
static BOOL IsCenterVert();
Wartość zwracana
WARTOŚĆ TRUE, jeśli przyciski są wyśrodkowane; FAŁSZ, jeśli przyciski są wyrównane u góry.
Uwagi
CMFCToolBarComboBoxButton::IsFlatMode
Zwraca płaski wygląd stylów przycisków pola kombi w aplikacji.
static BOOL IsFlatMode();
Wartość zwracana
WARTOŚĆ TRUE, jeśli przyciski mają płaski styl; w przeciwnym razie, FAŁSZ.
Uwagi
Domyślny prosty styl przycisków pola kombi to FALSE.
CMFCToolBarComboBoxButton::IsOwnerOf
Wskazuje, czy określony uchwyt jest skojarzony z przyciskiem pola kombi, czy jednym z jego elementów podrzędnych.
virtual BOOL IsOwnerOf(HWND hwnd);
Parametry
hwnd
[in] Uchwyt okna.
Wartość zwracana
Wartość TRUE, jeśli uchwyt jest asocated z przyciskiem pola kombi lub jednym z jego elementów podrzędnych; w przeciwnym razie, FAŁSZ.
CMFCToolBarComboBoxButton::IsRibbonButton
Wskazuje, czy przycisk pola kombi znajduje się na panelu wstążki.
BOOL IsRibbonButton() const;
Wartość zwracana
Zawsze FAŁSZ.
Uwagi
Domyślnie ta metoda zawsze zwraca wartość FALSE, co oznacza, że przycisk pola kombi nigdy nie jest wyświetlany na panelu wstążki.
CMFCToolBarComboBoxButton::IsWindowVisible
Zwraca stan widoczności przycisku pola kombi.
virtual BOOL IsWindowVisible();
Wartość zwracana
Stan widoczności przycisku pola kombi.
CMFCToolBarComboBoxButton::NotifyCommand
Wskazuje, czy przycisk pola kombi przetwarza komunikat.
virtual BOOL NotifyCommand(int iNotifyCode);
Parametry
iNotifyCode
[in] Komunikat powiadomienia skojarzony z poleceniem .
Wartość zwracana
Określa, czy przycisk pola kombi przetwarza komunikat.
CMFCToolBarComboBoxButton::OnAddToCustomizePage
Wywoływana przez platformę po dodaniu przycisku do okna dialogowego Dostosowywanie .
virtual void OnAddToCustomizePage();
CMFCToolBarComboBoxButton::OnCalculateSize
Wywoływana przez strukturę w celu obliczenia rozmiaru przycisku.
virtual SIZE OnCalculateSize(
CDC* pDC,
const CSize& sizeDefault,
BOOL bHorz);
Parametry
PDC
[in] Kontekst urządzenia, który wyświetla przycisk pola kombi.
sizeDefault
[in] Domyślny rozmiar przycisku pola kombi.
bHorz
[in] Stan docku nadrzędnego paska narzędzi. WARTOŚĆ TRUE, gdy pasek narzędzi jest zadokowany poziomo i FALSE, gdy pasek narzędzi jest zadokowany w pionie.
Wartość zwracana
Struktura SIZE
zawierająca wymiary przycisku pola kombi w pikselach.
CMFCToolBarComboBoxButton::OnChangeParentWnd
Wywoływana przez platformę po wstawieniu przycisku pola kombi do nowego paska narzędzi.
virtual void OnChangeParentWnd(CWnd* pWndParent);
Parametry
pWndParent
[in] Wskaźnik do nowego nadrzędnego paska narzędzi.
CMFCToolBarComboBoxButton::OnClick
Wywoływana przez platformę, gdy użytkownik kliknie przycisk pola kombi.
virtual BOOL OnClick(
CWnd* pWnd,
BOOL bDelay = TRUE);
Parametry
pWnd
[in] Wskaźnik do okna nadrzędnego przycisku pola kombi.
bDelay
[in] Zarezerwowane do użycia w klasie pochodnej.
Wartość zwracana
Wartość TRUE, jeśli metoda obsługuje zdarzenie; w przeciwnym razie, FAŁSZ.
CMFCToolBarComboBoxButton::OnCtlColor
Wywoływana przez platformę, gdy użytkownik zmienia kolor nadrzędnego paska narzędzi, aby ustawić kolor przycisku pola kombi.
virtual HBRUSH OnCtlColor(
CDC* pDC,
UINT nCtlColor);
Parametry
PDC
[in] Kontekst urządzenia, który wyświetla przycisk pola kombi.
nCtlColor
[in] Nieużywane.
Wartość zwracana
Uchwyt do pędzla używany przez platformę do malowania tła przycisku pola kombi.
Uwagi
Ta metoda ustawia również kolor tekstu przycisku pola kombi.
CMFCToolBarComboBoxButton::OnDraw
Wywoływana przez strukturę w celu narysowania przycisku pola kombi przy użyciu określonych stylów i opcji.
virtual void OnDraw(
CDC* pDC,
const CRect& rect,
CMFCToolBarImages* pImages,
BOOL bHorz = TRUE,
BOOL bCustomizeMode = FALSE,
BOOL bHighlight = FALSE,
BOOL bDrawBorder = TRUE,
BOOL bGrayDisabledButtons = TRUE);
Parametry
Pdc
[in] Kontekst urządzenia, w ramach którego jest wyświetlany przycisk.
Rect
[in] Prostokąt ograniczenia przycisku.
pImages
[in] Kolekcja obrazów skojarzonych z przyciskiem .
bHorz
[in] Stan docku nadrzędnego paska narzędzi. WARTOŚĆ TRUE, gdy pasek narzędzi jest zadokowany poziomo i FALSE, gdy pasek narzędzi jest zadokowany w pionie.
bCustomizeMode
[in] Czy aplikacja jest w trybie dostosowywania.
bHighlight
[in] Czy narysować wyróżniony przycisk pola kombi.
bDrawBorder
[in] Czy narysować przycisk pola kombi z obramowaniem.
bGrayDisabledButtons
[in] WARTOŚĆ TRUE do rysowania zacienionych przycisków wyłączonych; FAŁSZ do używania kolekcji wyłączonych obrazów.
CMFCToolBarComboBoxButton::OnDrawOnCustomizeList
Wywoływana przez strukturę, aby narysować przycisk pola kombi w okienku Polecenia okna dialogowego Dostosowywanie .
virtual int OnDrawOnCustomizeList(
CDC* pDC,
const CRect& rect,
BOOL bSelected);
Parametry
PDC
[in] Kontekst urządzenia, który wyświetla przycisk pola kombi.
Rect
[in] Prostokąt ograniczenia przycisku pola kombi.
bSelected
[in] WARTOŚĆ TRUE, jeśli zaznaczono przycisk pola kombi; w przeciwnym razie, FAŁSZ.
Wartość zwracana
Szerokość przycisku pola kombi w pikselach.
CMFCToolBarComboBoxButton::OnGlobalFontsChanged
Wywoływana przez strukturę w celu ustawienia czcionki przycisku pola kombi po zmianie czcionki aplikacji.
virtual void OnGlobalFontsChanged();
CMFCToolBarComboBoxButton::OnMove
Wywoływana przez strukturę w celu zmiany lokalizacji przycisku pola kombi po przesunięciu nadrzędnego paska narzędzi.
virtual void OnMove();
CMFCToolBarComboBoxButton::OnShow
Wywoływana przez platformę, gdy przycisk pola kombi jest ukryty lub wyświetlany.
virtual void OnShow(BOOL bShow);
Parametry
bShow
[in] Czy ukryć lub wyświetlić przycisk pola kombi.
CMFCToolBarComboBoxButton::OnSize
Wywoływana przez strukturę w celu zmiany rozmiaru przycisku pola kombi po zmianie rozmiaru nadrzędnego paska narzędzi.
virtual void OnSize(int iSize);
Parametry
Rozmiar i
[in] Nowa szerokość przycisku pola kombi.
CMFCToolBarComboBoxButton::OnUpdateToolTip
Wywoływana przez platformę, gdy użytkownik zmieni poradę narzędzia dla przycisku pola kombi.
virtual BOOL OnUpdateToolTip(
CWnd* pWndParent,
int iButtonIndex,
CToolTipCtrl& wndToolTip,
CString& str);
Parametry
pWndParent
[in] Wskaźnik do okna nadrzędnego dla przycisku pola kombi.
iButtonIndex
[in] Identyfikator przycisku pola kombi.
wndToolTip
[in] Porada narzędzia do skojarzenia z przyciskiem pola kombi.
Str
[in] Tekst porady narzędzia.
Wartość zwracana
Wartość TRUE, jeśli metoda obsługuje zdarzenie; w przeciwnym razie, FAŁSZ.
CMFCToolBarComboBoxButton::RemoveAllItems
Usuwa wszystkie elementy z listy i pól edycji.
void RemoveAllItems();
Uwagi
Usuwa wszystkie elementy z pola listy i edytuje kontrolkę pola kombi.
CMFCToolBarComboBoxButton::SelectItem
Wybiera element w polu listy.
BOOL SelectItem(
int iIndex,
BOOL bNotify=TRUE);
BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);
Parametry
iIndex
[in] Indeks oparty na zera elementu w polu listy.
bNotify
[in] WARTOŚĆ TRUE, aby powiadomić przycisk pola kombi zaznaczenia; w przeciwnym razie FAŁSZ.
dwData
[in] Dane skojarzone z elementem w polu listy.
lpszText
[in] Tekst elementu w polu listy.
Wartość zwracana
Wartość TRUE, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.
Uwagi
CMFCToolBarComboBoxButton::SelectItemAll
Wybiera element w polu listy przycisku pola kombi, który ma określony identyfikator polecenia.
static BOOL SelectItemAll(
UINT uiCmd,
int iIndex);
static BOOL SelectItemAll(
UINT uiCmd,
DWORD_PTR dwData);
static BOOL SelectItemAll(
UINT uiCmd,
LPCTSTR lpszText);
Parametry
uiCmd
[in] Identyfikator polecenia przycisku pola kombi zawierającego pole listy.
iIndex
[in] Indeks zerowy elementu w polu listy. Wartość -1 usuwa wszystkie bieżące zaznaczenie w polu listy i czyści pole edycji.
dwData
[in] Dane elementu w polu listy.
lpszText
[in] Tekst elementu w polu listy.
Wartość zwracana
Wartość TRUE, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.
Uwagi
CMFCToolBarComboBoxButton::Serialize
Odczytuje ten obiekt z archiwum lub zapisuje go w archiwum.
virtual void Serialize(CArchive& ar);
Parametry
Ar
[in, out] CArchive
Obiekt do serializacji.
Uwagi
Ustawienia w CArchive
obiekcie określają, czy ta metoda odczytuje lub zapisuje w archiwum.
CMFCToolBarComboBoxButton::SetACCData
Wypełnia określony CAccessibilityData
obiekt przy użyciu danych ułatwień dostępu z przycisku pola kombi.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Parametry
PParent
[in] Okno nadrzędne przycisku pola kombi.
data
[out] CAccessibilityData
Obiekt, który odbiera dane ułatwień dostępu z przycisku pola kombi.
Wartość zwracana
Wartość TRUE, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.
CMFCToolBarComboBoxButton::SetCenterVert
Ustawia położenie pionowe przycisków pola kombi w aplikacji.
static void SetCenterVert(BOOL bCenterVert=TRUE);
Parametry
bCenterVert
[in] Wartość TRUE, aby wyśrodkować przycisk pola kombi na pasku narzędzi; FAŁSZ, aby wyrównać przycisk pola kombi do góry paska narzędzi.
Uwagi
Domyślnie przyciski pola kombi są wyrównane do góry.
CMFCToolBarComboBoxButton::SetContextMenuID
Ustawia identyfikator zasobu menu skrótów dla przycisku pola kombi.
void SetContextMenuID(UINT uiResID);
Parametry
uiResID
[in] Identyfikator zasobu menu skrótów.
CMFCToolBarComboBoxButton::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.
CMFCToolBarComboBoxButton::SetFlatMode
Ustawia płaski wygląd przycisków pola kombi w aplikacji.
static void SetFlatMode(BOOL bFlat=TRUE);
Parametry
bFlat
[in] PRAWDA dla płaskiego wyglądu stylu; w przeciwnym razie FAŁSZ.
Uwagi
Domyślny prosty styl przycisków pola kombi to FALSE.
CMFCToolBarComboBoxButton::SetStyle
Ustawia określony styl przycisku pola kombi i ponownie rysuje kontrolkę, jeśli nie jest wyłączona.
virtual void SetStyle(UINT nStyle);
Parametry
nStyle
[in] Kombinacja bitowa (OR) stylów paska narzędzi.
Uwagi
Aby uzyskać listę stylów przycisków paska narzędzi, zobacz ToolBar Control Styles (Style kontrolek Paska narzędzi)
CMFCToolBarComboBoxButton::SetText
Ustawia tekst w polu edycji przycisku pola kombi.
void SetText(LPCTSTR lpszText);
Parametry
lpszText
[in] Wskaźnik do ciągu zawierającego tekst pola edycji.
Zobacz też
Wykres hierarchii
Klasy
Klasa CMFCToolBarButton
Klasa CComboBox
CMFCToolBar::ReplaceButton
Przewodnik: umieszczanie kontrolek na paskach narzędzi