CMFCToolBarComboBoxButton – třída
Tlačítko panelu nástrojů obsahující ovládací prvek pole se seznamem ( CComboBox – třída).
Syntaxe
class CMFCToolBarComboBoxButton : public CMFCToolBarButton
Členové
Veřejné konstruktory
| Jméno | popis |
|---|---|
| CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton | Vytvoří .CMFCToolBarComboBoxButton |
Veřejné metody
| Jméno | popis |
|---|---|
| CMFCToolBarComboBoxButton::AddItem | Přidá položku na konec seznamu se seznamem. |
| CMFCToolBarComboBoxButton::AddSortedItem | Přidá položku do seznamu polí se seznamem. Pořadí položek v seznamu je určeno parametrem Compare. |
| CMFCToolBarComboBoxButton::Compare | Porovná dvě položky. Volá se k řazení položek, které AddSortedItems se přidají do seznamu polí se seznamem. |
| CMFCToolBarComboBoxButton::CreateEdit | Vytvoří nový ovládací prvek pro úpravy tlačítka pole se seznamem. |
| CMFCToolBarComboBoxButton::D eleteItem | Odstraní položku ze seznamu se seznamem. |
| CMFCToolBarComboBoxButton::FindItem | Vrátí index položky, která obsahuje zadaný řetězec. |
| CMFCToolBarComboBoxButton::GetByCmd | Vrátí ukazatel na tlačítko pole se seznamem se zadaným ID příkazu. |
| CMFCToolBarComboBoxButton::GetComboBox | Vrátí ukazatel na ovládací prvek pole se seznamem, který je vložen do tlačítka pole se seznamem. |
| CMFCToolBarComboBoxButton::GetCount | Vrátí počet položek v seznamu polí se seznamem. |
| CMFCToolBarComboBoxButton::GetCountAll | Najde tlačítko pole se seznamem, které má zadané ID příkazu. Vrátí počet položek v seznamu se seznamem tohoto tlačítka. |
| CMFCToolBarComboBoxButton::GetCurSel | Vrátí index vybrané položky v seznamu polí se seznamem. |
| CMFCToolBarComboBoxButton::GetCurSelAll | Vyhledá tlačítko pole se seznamem, které má zadané ID příkazu, a vrátí index vybrané položky v seznamu polí se seznamem tohoto tlačítka. |
| CMFCToolBarComboBoxButton::GetEditCtrl | Vrátí ukazatel na ovládací prvek pro úpravy, který je vložen do tlačítka pole se seznamem. |
| CMFCToolBarComboBoxButton::GetItem | Vrátí řetězec přidružený k zadanému indexu v seznamu polí se seznamem. |
| CMFCToolBarComboBoxButton::GetItemAll | Vyhledá tlačítko pole se seznamem, které má zadané ID příkazu, a vrátí řetězec přidružený k indexu v seznamu polí se seznamem tohoto tlačítka. |
| CMFCToolBarComboBoxButton::GetItemData | Vrátí 32bitovou hodnotu přidruženou k zadanému indexu v seznamu polí se seznamem. |
| CMFCToolBarComboBoxButton::GetItemDataAll | Vyhledá tlačítko pole se seznamem, které má zadané ID příkazu, a vrátí 32bitovou hodnotu přidruženou k indexu v seznamu polí se seznamem tohoto tlačítka. |
| CMFCToolBarComboBoxButton::GetItemDataPtrAll | Najde tlačítko pole se seznamem, které má zadané ID příkazu. Načte 32bitovou hodnotu přidruženou k indexu v seznamu polí se seznamem tohoto tlačítka a vrátí 32bitovou hodnotu jako ukazatel. |
| CMFCToolBarComboBoxButton::GetText | Vrátí text z ovládacího prvku pro úpravy pole se seznamem. |
| CMFCToolBarComboBoxButton::GetTextAll | Najde tlačítko pole se seznamem, které má zadané ID příkazu, a vrátí text z ovládacího prvku pro úpravy tohoto tlačítka. |
| CMFCToolBarComboBoxButton::IsCenterVert | Určuje, zda jsou tlačítka pole se seznamem v aplikaci zarovnaná na střed nebo zarovnaná s horní částí panelu nástrojů. |
| CMFCToolBarComboBoxButton::IsFlatMode | Určuje, zda tlačítka pole se seznamem v aplikaci mají plochý vzhled. |
| CMFCToolBarComboBoxButton::RemoveAllItems | Odebere všechny položky ze seznamu a ovládací prvek upravit pole se seznamem. |
| CMFCToolBarComboBoxButton::SelectItem | Vybere položku v poli se seznamem podle jeho indexu, 32bitové hodnoty nebo řetězce a upozorní ovládací prvek pole se seznamem na výběr. |
| CMFCToolBarComboBoxButton::SelectItemAll | Najde tlačítko pole se seznamem, které má zadané ID příkazu. Volání SelectItem pro výběr položky v poli se seznamem tohoto tlačítka podle jeho řetězce, indexu nebo 32bitové hodnoty. |
| CMFCToolBarComboBoxButton::SetCenterVert | Určuje, jestli jsou tlačítka polí se seznamem v aplikaci svisle zarovnaná na střed nebo zarovnaná s horní částí panelu nástrojů. |
| CMFCToolBarComboBoxButton::SetDropDownHeight | Nastaví výšku rozevíracího seznamu. |
| CMFCToolBarComboBoxButton::SetFlatMode | Určuje, jestli mají tlačítka pole se seznamem v aplikaci plochý vzhled. |
Poznámky
Chcete-li přidat tlačítko pole se seznamem na panel nástrojů, postupujte takto:
Zarezervujte si pro tlačítko zástupný identifikátor ID prostředku v nadřazeném prostředku panelu nástrojů.
Vytvoření objektu
CMFCToolBarComboBoxButtonV obslužné rutině zprávy, která zpracovává AFX_WM_RESETTOOLBAR zprávu, nahraďte fiktivní tlačítko novým polem se seznamem pomocí CMFCToolBar::ReplaceButton.
Další informace naleznete v tématu Návod: Umístění ovládacích prvků na panely nástrojů. Příklad tlačítka panelu nástrojů pole se seznamem najdete v příkladu projektu VisualStudioDemo.
Příklad
Následující příklad ukazuje, jak používat různé metody ve CMFCToolBarComboBoxButton třídě. Příklad ukazuje, jak povolit úpravy a pole se seznamem, nastavit svislou pozici tlačítek pole se seznamem v aplikaci, nastavit výšku pole seznamu při jeho vyřazení, nastavit vzhled plochého stylu tlačítek pole se seznamem v aplikaci a nastavit text v poli pro úpravy tlačítka pole se seznamem. Tento fragment kódu je součástí ukázky sady Visual Studio Demo.
// 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"));
Hierarchie dědičnosti
Požadavky
Hlavička: afxtoolbarcomboboxbutton.h
CMFCToolBarComboBoxButton::AddItem
Připojí jedinečnou položku do seznamu.
virtual INT_PTR AddItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Parametry
lpszItem
[v] Text položky, kterou chcete přidat do seznamu.
dwData
[v] Data přidružená k položce, která se mají přidat do seznamu.
Vrácená hodnota
Index poslední položky v seznamu.
Poznámky
Tuto metodu nepoužívejte při řazení stylu seznamu.
Pokud je text položky již v seznamu, nová data jsou uložena s existující položkou. Při hledání položky se rozlišují malá a velká písmena.
CMFCToolBarComboBoxButton::AddSortedItem
Přidá položku do seznamu v pořadí definovaném metodou Compare .
virtual INT_PTR AddSortedItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Parametry
lpszItem
[v] Text položky, kterou chcete přidat do seznamu.
dwData
[v] Data přidružená k položce, která se mají přidat do seznamu.
Vrácená hodnota
Index položky přidané do seznamu
Poznámky
Tato funkce slouží k přidání položek do seznamu v určitém pořadí.
CMFCToolBarComboBoxButton::CanBeStretched
Určuje, jestli se dá změnit velikost tlačítka pole se seznamem.
virtual BOOL CanBeStretched() const;
Vrácená hodnota
Vrátí hodnotu PRAVDA.
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton
Vytvoří CMFCToolBarComboBoxButton objektu.
CMFCToolBarComboBoxButton(
UINT uiID,
int iImage,
DWORD dwStyle=CBS_DROPDOWNLIST,
int iWidth=0);
Parametry
UIID
[v] ID příkazu nového tlačítka.
iImage
[v] Index image obrázku přidruženého k novému tlačítku.
dwStyle
[v] Styl nového tlačítka.
iWidth
[v] Šířka nového tlačítka v pixelech.
Poznámky
Výchozí šířka je 150 pixelů.
Seznam stylů tlačítek panelu nástrojů naleznete v části Styly ovládacího prvku ToolBar
CMFCToolBarComboBoxButton::ClearData
Odstraní uživatelem definovaná data.
virtual void ClearData();
Poznámky
Ve výchozím nastavení tato metoda nic nedělá. Tuto metodu přepište v odvozené třídě, pokud chcete odstranit všechna uživatelsky definovaná data.
CMFCToolBarComboBoxButton::Compare
Porovná dva řetězce.
virtual int Compare(
LPCTSTR lpszItem1,
LPCTSTR lpszItem2);
Parametry
lpszItem1
[v] První řetězec, který se má porovnat.
lpszItem2
[v] Druhý řetězec, který chcete porovnat.
Vrácená hodnota
Hodnota, která označuje lexikografický vztah rozlišující velká a malá písmena mezi řetězci. V následující tabulce jsou uvedené možné hodnoty:
| Hodnota | popis |
|---|---|
| <0 | První řetězec je menší než druhý. |
| 0 | První řetězec se rovná druhému. |
| >0 | První řetězec je větší než druhý. |
Poznámky
Přepište tuto metodu, chcete-li změnit způsob řazení položek v seznamu.
V porovnání se rozlišují malá a velká písmena.
Tato metoda je volána pouze z AddSortedItem metoda.
CMFCToolBarComboBoxButton::CopyFrom
Zkopíruje stav zadaného CMFCToolBarComboBoxButton objektu do aktuálního objektu.
virtual void CopyFrom(const CMFCToolBarButton& src);
Parametry
Src
[v] Zdrojový CMFCToolBarComboBoxButton objekt.
CMFCToolBarComboBoxButton::CreateCombo
Vytvoří nové pole se seznamem pro tlačítko pole se seznamem.
virtual CComboBox* CreateCombo(
CWnd* pWndParent,
const CRect& rect);
Parametry
pWndParent
[v] Ukazatel na nadřazené okno tlačítka.
Rect
[v] Ohraničující obdélník pole se seznamem
Vrácená hodnota
Ukazatel na nové pole se seznamem, pokud byla metoda úspěšná; v opačném případě null.
CMFCToolBarComboBoxButton::CreateEdit
Vytvoří nové textové pole pro tlačítko pole se seznamem.
virtual CMFCToolBarComboBoxEdit* CreateEdit(
CWnd* pWndParent,
const CRect& rect,
DWORD dwEditStyle);
Parametry
pWndParent
[v] Ukazatel na nadřazené okno tlačítka.
Rect
[v] Ohraničující obdélník nového textového pole
dwEditStyle
[v] Styl ovládacího prvku nového textového pole
Vrácená hodnota
Ukazatel na nové pole pro úpravy, pokud byla metoda úspěšná; v opačném případě null.
Poznámky
Architektura volá tuto metodu při vytvoření nového textového pole pro tlačítko pole se seznamem. Přepište tuto metodu, chcete-li změnit způsob vytvoření CMFCToolBarComboBoxEdit .
CMFCToolBarComboBoxButton::D eleteItem
Odstraní zadanou položku ze seznamu.
BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);
Parametry
iIndex
[v] Index položky, který se má odstranit, založený na nule.
dwData
[v] Data přidružená k položce, která se má odstranit.
lpszText
[v] Text položky, která se má odstranit. Pokud existuje více položek se stejným textem, první položka se odstraní.
Vrácená hodnota
TRUE, pokud byla položka nalezena a úspěšně odstraněna; jinak NEPRAVDA.
Poznámky
CMFCToolBarComboBoxButton::D uplicateData
Duplikuje uživatelem definovaná data.
virtual void DuplicateData();
Poznámky
Ve výchozím nastavení tato metoda nic nedělá. Tuto metodu přepište v odvozené třídě, pokud chcete zkopírovat všechna uživatelsky definovaná data.
CMFCToolBarComboBoxButton::EnableWindow
Povolí nebo zakáže úpravy a pole se seznamem.
virtual void EnableWindow(BOOL bEnable = TRUE);
Parametry
bEnable
[v] TRUE pro povolení úprav a polí se seznamem; NEPRAVDA, pokud chcete zakázat úpravy a pole se seznamem.
Poznámky
Pokud jsou zakázány, ovládací prvky se nemůžou aktivovat a nemůžou přijmout uživatelský vstup.
CMFCToolBarComboBoxButton::ExportToMenuButton
Zkopíruje řetězec z tabulky řetězců aplikace do zadané nabídky pomocí ID příkazu pole se seznamem.
virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;
Parametry
menuButton
[ven] Odkaz na tlačítko nabídky
Vrácená hodnota
Vždy PRAVDA.
CMFCToolBarComboBoxButton::FindItem
Vrátí index první položky v seznamu, který obsahuje zadaný řetězec.
int FindItem(LPCTSTR lpszText) const;
Parametry
lpszText
[v] Text, pro který chcete hledat v seznamu.
Vrácená hodnota
Index položky; nebo CB_ERR, pokud položka nebyla nalezena.
Poznámky
CMFCToolBarComboBoxButton::GetByCmd
Získá ukazatel na tlačítko pole se seznamem, které má zadané ID příkazu.
static CMFCToolBarComboBoxButton* GetByCmd(
UINT uiCmd,
BOOL bIsFocus=FALSE);
Parametry
uiCmd
[v] ID příkazu tlačítka pole se seznamem
bIsFocus
[v] PRAVDA pro vyhledávání pouze tlačítka s fokusem; NEPRAVDA pro vyhledávání všech tlačítek.
Vrácená hodnota
Ukazatel na tlačítko pole se seznamem; nebo NULL, pokud tlačítko není nalezeno.
Poznámky
CMFCToolBarComboBoxButton::GetComboBox
Vrátí ukazatel na pole se seznamem v tlačítku pole se seznamem.
CComboBox* GetComboBox() const;
Vrácená hodnota
Ukazatel na objekt CComboBox Class , pokud byla metoda úspěšná; jinak NULL.
Poznámky
CMFCToolBarComboBoxButton::GetContextMenuID
Získá ID prostředku místní nabídky pro tlačítko pole se seznamem.
UINT GetContextMenuID();
Vrácená hodnota
ID prostředku místní nabídky.
CMFCToolBarComboBoxButton::GetCount
Vrátí počet položek v seznamu.
INT_PTR GetCount() const;
Vrácená hodnota
Početpoložekch
Poznámky
CMFCToolBarComboBoxButton::GetCountAll
Získá počet položek v seznamu pole se seznamem tlačítko, které má zadané ID příkazu.
static int GetCountAll(UINT uiCmd);
Parametry
uiCmd
[v] ID příkazu tlačítka pole se seznamem
Vrácená hodnota
Počet položek v seznamu; v opačném případě CB_ERR, pokud není tlačítko pole se seznamem nalezeno.
Poznámky
CMFCToolBarComboBoxButton::GetCurSel
Získá index aktuálně vybrané položky v seznamu.
int GetCurSel() const;
Vrácená hodnota
Index aktuálně vybrané položky v seznamu; nebo CB_ERR, pokud není vybrána žádná položka.
Poznámky
Index seznamu je založený na nule.
CMFCToolBarComboBoxButton::GetCurSelAll
Vrátí index aktuálně vybrané položky v seznamu tlačítka pole se seznamem, které má zadané ID příkazu.
static int GetCurSelAll(UINT uiCmd);
Parametry
uiCmd
[v] ID příkazu tlačítka pole se seznamem
Vrácená hodnota
Index aktuálně vybrané položky v seznamu; v opačném případě CB_ERR, pokud není vybrána žádná položka nebo tlačítko pole se seznamem nebylo nalezeno.
Poznámky
Index seznamu je založený na nule.
CMFCToolBarComboBoxButton::GetEditCtrl
Vrátí ukazatel na textové pole v tlačítku pole se seznamem.
virtual CEdit* GetEditCtrl();
Vrácená hodnota
Ukazatel na textové pole, pokud byla metoda úspěšná; v opačném případě null.
Poznámky
CMFCToolBarComboBoxButton::GetHwnd
Vrátí úchyt okna pro pole se seznamem.
virtual HWND GetHwnd();
Vrácená hodnota
Popisovač okna nebo NULL, pokud pole se seznamem není přidruženo k objektu okna.
CMFCToolBarComboBoxButton::GetItem
Vrátí řetězec přidružený k položce v zadaném indexu v seznamu.
LPCTSTR GetItem(int iIndex=-1) const;
Parametry
iIndex
[v] Index položky založené na nule v seznamu
Vrácená hodnota
Ukazatel na řetězec přidružený k položce; v opačném případě hodnota NULL, pokud je parametr indexu neplatný nebo pokud je parametr indexu -1 a v poli se seznamem není vybraná položka.
Poznámky
Parametr indexu -1 vrátí řetězec aktuálně vybrané položky.
CMFCToolBarComboBoxButton::GetItemAll
Vrátí řetězec přidružený k položce v zadaném indexu v seznamu tlačítka pole se seznamem, který má zadané ID příkazu.
static LPCTSTR GetItemAll(
UINT uiCmd,
int iIndex=-1);
Parametry
uiCmd
[v] ID příkazu tlačítka pole se seznamem
iIndex
[v] Index položky v seznamu založený na nule.
Vrácená hodnota
Ukazatel na řetězec položky, pokud byla metoda úspěšná; V opačném případě hodnota NULL, pokud je index neplatný, tlačítko pole se seznamem nebylo nalezeno nebo pokud je index -1 a v poli se seznamem není vybraná položka.
Poznámky
Hodnota indexu -1 vrátí řetězec položky, která je aktuálně vybrána.
CMFCToolBarComboBoxButton::GetItemData
Vrátí data přidružená k položce v určitém indexu v seznamu.
DWORD_PTR GetItemData(int iIndex=-1) const;
Parametry
iIndex
[v] Index položky v seznamu založený na nule.
Vrácená hodnota
Data přidružená k položce; nebo 0, pokud položka neexistuje.
Poznámky
Parametr indexu -1 vrátí data přidružená k aktuálně vybrané položce.
CMFCToolBarComboBoxButton::GetItemDataAll
Vrátí data přidružená k položce v určitém indexu v seznamu tlačítka pole se seznamem, které má konkrétní ID příkazu.
static DWORD_PTR GetItemDataAll(
UINT uiCmd,
int iIndex=-1);
Parametry
uiCmd
[v] ID příkazu tlačítka pole se seznamem
iIndex
[v] Index položky v seznamu založený na nule.
Vrácená hodnota
Data přidružená k položce, pokud byla metoda úspěšná; v opačném případě platí hodnota 0, pokud zadaný index není platný, nebo CB_ERR, pokud se tlačítko pole se seznamem nenajde.
Poznámky
Parametr indexu -1 vrátí data přidružená k aktuálně vybrané položce.
CMFCToolBarComboBoxButton::GetItemDataPtrAll
Vrátí data přidružená k položce v určitém indexu v seznamu tlačítka pole se seznamem, které má konkrétní ID příkazu. Tato data se vrátí jako ukazatel.
static void* GetItemDataPtrAll(
UINT uiCmd,
int iIndex=-1);
Parametry
uiCmd
[v] ID příkazu tlačítka pole se seznamem.
iIndex
[v] Index položky v seznamu založený na nule.
Vrácená hodnota
Ukazatel přidružený k položce, pokud byla metoda úspěšná; jinak , -1 pokud dojde k chybě, nebo NULL pokud tlačítko pole se seznamem není nalezeno.
Poznámky
CMFCToolBarComboBoxButton::GetPrompt
Vrátí řetězec výzvy pro tlačítko pole se seznamem.
virtual CString GetPrompt() const;
Vrácená hodnota
Řetězec výzvy.
Poznámky
Tato metoda není aktuálně implementována.
CMFCToolBarComboBoxButton::GetText
Získá text v textovém poli.
LPCTSTR GetText() const;
Vrácená hodnota
Text v textovém poli.
Poznámky
CMFCToolBarComboBoxButton::GetTextAll
Získá text v textovém poli tlačítka pole se seznamem, který má zadané ID příkazu.
static LPCTSTR GetTextAll(UINT uiCmd);
Parametry
uiCmd
[v] ID příkazu konkrétního tlačítka pole se seznamem.
Vrácená hodnota
Text v textovém poli, pokud metoda byla úspěšná; v opačném případě null.
Poznámky
CMFCToolBarComboBoxButton::HasFocus
Určuje, jestli má pole se seznamem aktuálně fokus.
virtual BOOL HasFocus() const;
Vrácená hodnota
TRUE, pokud pole se seznamem aktuálně obsahuje fokus; jinak NEPRAVDA.
Poznámky
Tato metoda také vrátí hodnotu TRUE, pokud je fokus aktuálně v libovolném podřízeném okně pole se seznamem.
CMFCToolBarComboBoxButton::IsCenterVert
Vrátí svislou pozici tlačítek pole se seznamem v aplikaci.
static BOOL IsCenterVert();
Vrácená hodnota
TRUE, pokud jsou tlačítka na střed; FALSE, pokud jsou tlačítka zarovnaná v horní části.
Poznámky
CMFCToolBarComboBoxButton::IsFlatMode
Vrátí plochý styl vzhledu tlačítek pole se seznamem v aplikaci.
static BOOL IsFlatMode();
Vrácená hodnota
TRUE, pokud tlačítka mají plochý styl; jinak NEPRAVDA.
Poznámky
Výchozí plochý styl tlačítek pole se seznamem je NEPRAVDA.
CMFCToolBarComboBoxButton::IsOwnerOf
Určuje, jestli je zadaný popisovač přidružený k tlačítku pole se seznamem nebo k některé z podřízených položek.
virtual BOOL IsOwnerOf(HWND hwnd);
Parametry
Hwnd
[v] Úchyt okna.
Vrácená hodnota
TRUE, pokud je úchyt assocován tlačítkem pole se seznamem, nebo jedním z jeho podřízených; jinak NEPRAVDA.
CMFCToolBarComboBoxButton::IsRibbonButton
Určuje, zda je tlačítko pole se seznamem umístěné na panelu pásu karet.
BOOL IsRibbonButton() const;
Vrácená hodnota
Vždy NEPRAVDA.
Poznámky
Ve výchozím nastavení tato metoda vždy vrátí hodnotu FALSE, což znamená, že tlačítko pole se seznamem se nikdy nezobrazí na panelu pásu karet.
CMFCToolBarComboBoxButton::IsWindowVisible
Vrátí stav viditelnosti tlačítka pole se seznamem.
virtual BOOL IsWindowVisible();
Vrácená hodnota
Stav viditelnosti tlačítka pole se seznamem
CMFCToolBarComboBoxButton::NotifyCommand
Určuje, jestli tlačítko pole se seznamem zpracuje zprávu.
virtual BOOL NotifyCommand(int iNotifyCode);
Parametry
iNotifyCode
[v] Zpráva s oznámením, která je přidružená k příkazu.
Vrácená hodnota
Určuje, jestli tlačítko pole se seznamem zpracuje zprávu.
CMFCToolBarComboBoxButton::OnAddToCustomizePage
Volá se rozhraním při přidání tlačítka do dialogového okna Přizpůsobit .
virtual void OnAddToCustomizePage();
CMFCToolBarComboBoxButton::OnCalculateSize
Volané rozhraním pro výpočet velikosti tlačítka.
virtual SIZE OnCalculateSize(
CDC* pDC,
const CSize& sizeDefault,
BOOL bHorz);
Parametry
Pdc
[v] Kontext zařízení, který zobrazuje tlačítko pole se seznamem.
sizeDefault
[v] Výchozí velikost tlačítka pole se seznamem
bHorz
[v] Stav ukotvení nadřazeného panelu nástrojů TRUE, pokud je panel nástrojů ukotven vodorovně a NEPRAVDA při ukotvení panelu nástrojů svisle.
Vrácená hodnota
Struktura SIZE , která obsahuje rozměry tlačítka pole se seznamem v pixelech.
CMFCToolBarComboBoxButton::OnChangeParentWnd
Volá se rozhraním při vložení tlačítka pole se seznamem do nového panelu nástrojů.
virtual void OnChangeParentWnd(CWnd* pWndParent);
Parametry
pWndParent
[v] Ukazatel na nový nadřazený panel nástrojů
CMFCToolBarComboBoxButton::OnClick
Volá se rozhraním, když uživatel klikne na tlačítko pole se seznamem.
virtual BOOL OnClick(
CWnd* pWnd,
BOOL bDelay = TRUE);
Parametry
pWnd
[v] Ukazatel na nadřazené okno tlačítka pole se seznamem
bDelay
[v] Vyhrazeno pro použití v odvozené třídě.
Vrácená hodnota
TRUE, pokud metoda zpracovává událost; jinak NEPRAVDA.
CMFCToolBarComboBoxButton::OnCtlColor
Volá se rozhraním, když uživatel změní barvu nadřazeného panelu nástrojů tak, aby nastavil barvu tlačítka pole se seznamem.
virtual HBRUSH OnCtlColor(
CDC* pDC,
UINT nCtlColor);
Parametry
Pdc
[v] Kontext zařízení, který zobrazuje tlačítko pole se seznamem.
nCtlColor
[v] Nepoužité.
Vrácená hodnota
Úchyt štětce, který architektura používá k vykreslení pozadí tlačítka pole se seznamem.
Poznámky
Tato metoda také nastaví barvu textu pole se seznamem.
CMFCToolBarComboBoxButton::OnDraw
Volá se rozhraním pro kreslení tlačítka pole se seznamem pomocí zadaných stylů a možností.
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
[v] Kontext zařízení, který tlačítko zobrazí.
Rect
[v] Ohraničující obdélník tlačítka.
pImages
[v] Kolekce obrázků přidružených k tlačítku.
bHorz
[v] Stav ukotvení nadřazeného panelu nástrojů TRUE, pokud je panel nástrojů ukotven vodorovně a NEPRAVDA při ukotvení panelu nástrojů svisle.
bCustomizeMode
[v] Určuje, jestli je aplikace v režimu přizpůsobení.
bHighlight
[v] Určuje, jestli chcete nakreslit zvýrazněné tlačítko pole se seznamem.
bDrawBorder
[v] Určuje, jestli chcete nakreslit tlačítko pole se seznamem s ohraničením.
bGrayDisabledButtons
[v] TRUE pro kreslení vystínovaných zakázaných tlačítek; NEPRAVDA pro použití zakázané kolekce obrázků.
CMFCToolBarComboBoxButton::OnDrawOnCustomizeList
Volá se rozhraním pro kreslení tlačítka pole se seznamem v podokně Příkazy dialogového okna Přizpůsobit .
virtual int OnDrawOnCustomizeList(
CDC* pDC,
const CRect& rect,
BOOL bSelected);
Parametry
Pdc
[v] Kontext zařízení, který zobrazuje tlačítko pole se seznamem.
Rect
[v] Ohraničující obdélník tlačítka pole se seznamem.
bSelected
[v] TRUE, pokud je vybráno tlačítko pole se seznamem; jinak NEPRAVDA.
Vrácená hodnota
Šířka tlačítka pole se seznamem v pixelech.
CMFCToolBarComboBoxButton::OnGlobalFontsChanged
Volá se rozhraním pro nastavení písma pole se seznamem při změně písma aplikace.
virtual void OnGlobalFontsChanged();
CMFCToolBarComboBoxButton::Onmove
Volá se rozhraním, aby při přesunutí nadřazeného panelu nástrojů změnilo umístění tlačítka pole se seznamem.
virtual void OnMove();
CMFCToolBarComboBoxButton::OnShow
Volá se rozhraním, když je tlačítko pole se seznamem skryté nebo zobrazené.
virtual void OnShow(BOOL bShow);
Parametry
BShow
[v] Zda chcete skrýt nebo zobrazit tlačítko pole se seznamem.
CMFCToolBarComboBoxButton::Onsize
Volá se rozhraním pro změnu velikosti tlačítka pole se seznamem, když se změní velikost nadřazeného panelu nástrojů.
virtual void OnSize(int iSize);
Parametry
iSize
[v] Nová šířka tlačítka pole se seznamem.
CMFCToolBarComboBoxButton::OnUpdateToolTip
Volá se rozhraním, když uživatel změní popis tlačítka pole se seznamem.
virtual BOOL OnUpdateToolTip(
CWnd* pWndParent,
int iButtonIndex,
CToolTipCtrl& wndToolTip,
CString& str);
Parametry
pWndParent
[v] Ukazatel na nadřazené okno pro tlačítko pole se seznamem
iButtonIndex
[v] ID tlačítka pole se seznamem
wndToolTip
[v] Popis nástroje, který chcete přidružit k tlačítku pole se seznamem.
Str
[v] Text popisku nástroje.
Vrácená hodnota
TRUE, pokud metoda zpracovává událost; jinak NEPRAVDA.
CMFCToolBarComboBoxButton::RemoveAllItems
Odstraní všechny položky ze seznamu a polí pro úpravy.
void RemoveAllItems();
Poznámky
Odebere všechny položky ze seznamu a upraví ovládací prvek pole se seznamem.
CMFCToolBarComboBoxButton::SelectItem
Vybere položku v seznamu.
BOOL SelectItem(
int iIndex,
BOOL bNotify=TRUE);
BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);
Parametry
iIndex
[v] Index položky v seznamu založený na nule.
bNotify
[v] TRUE pro oznámení pole se seznamem tlačítko výběru; jinak NEPRAVDA.
dwData
[v] Data přidružená k položce v seznamu.
lpszText
[v] Text položky v seznamu
Vrácená hodnota
TRUE, pokud byla metoda úspěšná; jinak NEPRAVDA.
Poznámky
CMFCToolBarComboBoxButton::SelectItemAll
Vybere položku v seznamu tlačítka pole se seznamem, které má zadané ID příkazu.
static BOOL SelectItemAll(
UINT uiCmd,
int iIndex);
static BOOL SelectItemAll(
UINT uiCmd,
DWORD_PTR dwData);
static BOOL SelectItemAll(
UINT uiCmd,
LPCTSTR lpszText);
Parametry
uiCmd
[v] ID příkazu tlačítka pole se seznamem, které obsahuje seznam.
iIndex
[v] Index položky v seznamu založený na nule. Hodnota -1 odebere všechny aktuální výběry v seznamu a zruší zaškrtnutí políčka pro úpravy.
dwData
[v] Data položky v seznamu.
lpszText
[v] Text položky v seznamu
Vrácená hodnota
TRUE, pokud byla metoda úspěšná; jinak NEPRAVDA.
Poznámky
CMFCToolBarComboBoxButton::Serialize
Načte tento objekt z archivu nebo ho zapíše do archivu.
virtual void Serialize(CArchive& ar);
Parametry
ar
[in, out] Objekt CArchive , který se má serializovat.
Poznámky
Nastavení v objektu CArchive určuje, zda tato metoda čte nebo zapisuje do archivu.
CMFCToolBarComboBoxButton::SetACCData
Naplní zadaný CAccessibilityData objekt pomocí dat přístupnosti z tlačítka pole se seznamem.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Parametry
pParent
[v] Nadřazené okno tlačítka pole se seznamem
Dat
[ven] CAccessibilityData Objekt, který přijímá data přístupnosti z tlačítka pole se seznamem.
Vrácená hodnota
TRUE, pokud byla metoda úspěšná; jinak NEPRAVDA.
CMFCToolBarComboBoxButton::SetCenterVert
Nastaví svislou pozici tlačítek pole se seznamem v aplikaci.
static void SetCenterVert(BOOL bCenterVert=TRUE);
Parametry
bCenterVert
[v] HODNOTA TRUE pro zarovnání tlačítka pole se seznamem na panelu nástrojů; FALSE, pokud chcete zarovnat tlačítko pole se seznamem na začátek panelu nástrojů.
Poznámky
Ve výchozím nastavení jsou tlačítka pole se seznamem zarovnaná k horní části.
CMFCToolBarComboBoxButton::SetContextMenuID
Nastaví ID prostředku místní nabídky pro tlačítko pole se seznamem.
void SetContextMenuID(UINT uiResID);
Parametry
uiResID
[v] ID prostředku místní nabídky.
CMFCToolBarComboBoxButton::SetDropDownHeight
Nastaví výšku pole seznamu při vyřazení.
void SetDropDownHeight(int nHeight);
Parametry
nHeight
[v] Výška seznamu v pixelech.
Poznámky
Výchozí výška je 150 pixelů.
CMFCToolBarComboBoxButton::SetFlatMode
Nastaví vzhled plochého stylu tlačítek pole se seznamem v aplikaci.
static void SetFlatMode(BOOL bFlat=TRUE);
Parametry
bFlat
[v] PRAVDA pro plochý styl vzhledu; jinak NEPRAVDA.
Poznámky
Výchozí plochý styl tlačítek pole se seznamem je NEPRAVDA.
CMFCToolBarComboBoxButton::SetStyle
Nastaví zadaný styl tlačítka pole se seznamem a překreslí ovládací prvek, pokud není zakázaný.
virtual void SetStyle(UINT nStyle);
Parametry
nStyle
[v] Bitové kombinace (OR) stylů panelu nástrojů.
Poznámky
Seznam stylů tlačítek panelu nástrojů naleznete v části Styly ovládacího prvku ToolBar
CMFCToolBarComboBoxButton::SetText
Nastaví text v textovém poli tlačítka pole se seznamem.
void SetText(LPCTSTR lpszText);
Parametry
lpszText
[v] Ukazatel na řetězec, který obsahuje text pro textové pole.
Viz také
Graf hierarchie
Třídy
CMFCToolBarButton – třída
CComboBox – třída
CMFCToolBar::ReplaceButton
Návod: Umístění ovládacích prvků na panely nástrojů
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro