Třída CToolBar

Článek
03/04/2013

Ovládací panely, které jste řádek rastrové obrázky tlačítek a volitelné oddělovače.

class CToolBar : public CControlBar

Členy

Veřejné konstruktory

Název	Description
CToolBar::CToolBar	Konstrukce CToolBar objektu.

Veřejné metody

Název	Description
CToolBar::CommandToIndex	Vrátí index tlačítka s ID daného příkazu.
CToolBar::Create	Vytvoří v panelu nástrojů systému Windows a připojí jej k CToolBar objektu.
CToolBar::CreateEx	Vytvoří CToolBar s další styly pro vložený objekt CToolBarCtrl objektu.
CToolBar::GetButtonInfo	Načte ID, styl a číslo obrázku tlačítka.
CToolBar::GetButtonStyle	Použije styl tlačítka.
CToolBar::GetButtonText	Načte text, který bude zobrazen na tlačítku.
CToolBar::GetItemID	Vrátí ID příkazu tlačítka nebo oddělovač v daném indexu.
CToolBar::GetItemRect	Načte obdélník zobrazení položky v daném indexu.
CToolBar::GetToolBarCtrl	Umožňuje přímý přístup k podkladové společné kontroly.
CToolBar::LoadBitmap	Načte bitmapy obsahující tlačítka bitmapové obrazy.
CToolBar::LoadToolBar	Načte nástrojů prostředků vytvořených pomocí editoru zdrojů.
CToolBar::SetBitmap	Nastaví rastrových obrázků.
CToolBar::SetButtonInfo	Nastaví ID, styl a číslo obrázku tlačítka.
CToolBar::SetButtons	Nastaví tlačítko styly a rejstřík obrázky tlačítek do bitmapy.
CToolBar::SetButtonStyle	Nastaví styl tlačítka.
CToolBar::SetButtonText	Nastaví text, který bude zobrazen na tlačítku.
CToolBar::SetHeight	Nastaví výšku panelu nástrojů.
CToolBar::SetSizes	Nastaví velikost tlačítek a jejich bitmapy.

Poznámky

Tlačítka mohou sloužit jako kapot, zaškrtnutí políčka tlačítka nebo přepínače.CToolBarobjekty jsou obvykle vložený členy rámeček okna objekty odvozené od třídy CFrameWnd nebo CMDIFrameWnd.

CToolBar::GetToolBarCtrl, členské funkce nové MFC 4.0 umožňuje využít podporu Windows společného ovládacího prvku pro úpravy nástrojů a další funkce.CToolBarfunkce členů poskytují většinu funkcí Windows běžné ovládací prvky; avšak při volání GetToolBarCtrl , panely nástrojů můžete poskytnout i další vlastnosti panelů Windows 95/98.Při volání GetToolBarCtrl , vrátí odkaz na CToolBarCtrl objektu.Viz CToolBarCtrl Další informace o navrhování běžné ovládací prvky systému Windows pomocí panelů nástrojů.Další obecné informace o běžných ovládacích prvků Běžné ovládací prvky v .

Visual C++ nabízí dva způsoby vytvoření panelu nástrojů.Vytvoření prostředku nástrojů editoru zdrojů, postupujte takto:

Vytvořte prostředek nástrojů.
Konstrukce CToolBar objektu.
Volání vytvořit (nebo CreateEx) funkce nástrojů systému Windows vytvořit a připojit ji k CToolBar objektu.
Volání LoadToolBar načíst zdroj nástrojů.

Jinak postupujte takto:

Konstrukce CToolBar objektu.
Volání vytvořit (nebo CreateEx) funkce nástrojů systému Windows vytvořit a připojit ji k CToolBar objektu.
Volání LoadBitmap načíst bitmapy obsahující obrázky tlačítek panelu nástrojů.
Volání SetButtons nastavit styl tlačítka a přidružit každé tlačítko obraz v rastru.

Obrázky tlačítek na panelu nástrojů jsou převzaty z jednoho rastrového obrázku, které musí obsahovat jeden obraz pro každé tlačítko.Všechny obrázky musí mít stejnou velikost; Výchozí hodnota je 16 pixelů a 15 pixelů.Obrázky musí být vedle sebe v rastru.

SetButtons Funkce má ukazatel na pole s ID ovládacího prvku a celé číslo, které určuje počet prvků pole.Funkce nastaví ID každého tlačítka na hodnotu odpovídající prvek pole a přiřadí každé tlačítko index obrázku, který určuje polohu na tlačítko obraz v rastru.Pokud prvek pole má hodnotu ID_SEPARATOR, je přiřazen žádný index obrázku.

Pořadí obrázků v rastru je obvykle pořadí, ve kterém budou vykresleny na obrazovce, ale můžete použít SetButtonInfo funkci změnit vztah mezi pořadí obrázků a pořadí kreslení.

Všechna tlačítka na panelu nástrojů jsou stejné velikosti.Výchozí hodnota je 24 x 22 pixelů v souladu s Windows rozhraní pokyny pro návrh softwaru.Dodatečný prostor mezi rozměry obrazu a tlačítko se používá k ohraničení kolem obrazu.

Každé tlačítko má jeden obraz.Různé státy tlačítek a styly (zakázáno, zakázáno dolů a neurčitý stisknuté nahoru, dolů) jsou generovány z tohoto jednoho obrazu.Ačkoli rastrové obrázky mohou být jakékoli barvy, můžete dosáhnout nejlepších výsledků s obrazy v černá a odstíny šedé.

Upozornění
CToolBarpodporuje rastry s maximálně 16 barev.Při načítání obrázku do panelu nástrojů editoru Visual Studio automaticky převede obraz na bitmapu, 16 barev, v případě potřeby a zobrazí upozornění, pokud byl převeden na obrázek.Použít obraz s více než 16 barev (pomocí externího editoru upravit obraz), může aplikace neočekávanému chování.

Tlačítka panelu nástrojů napodobujících kapot ve výchozím nastavení.Tlačítka panelu nástrojů lze však také napodobit zaškrtávací políčko tlačítka nebo přepínače.Zaškrtávací políčko tlačítka mají tři stavy: označené, vymazané a neurčitý.Přepínací tlačítka mají pouze dva stavy: zaškrtnuto a zaškrtnutí zrušeno.

Volání bez přejdete pole nastavit jednotlivá tlačítka nebo oddělovač stylu, GetButtonStyle k načtení stylu a potom volat SetButtonStyle namísto SetButtons .SetButtonStyleje užitečná, pokud chcete změnit styl tlačítka za běhu.

Text na tlačítku přiřadit, volání GetButtonText načíst text na tlačítku zobrazit, a potom volat SetButtonText nastavit text.

Pokud chcete vytvořit tlačítko, zaškrtávací políčko, přiřaďte jej styl TBBS_CHECKBOX nebo CCmdUI objektu SetCheck členské funkce v ON_UPDATE_COMMAND_UI popisovač.Volání SetCheck pushbutton se změní na tlačítko zaškrtávací políčko.Předat SetCheck argument 0 Nekontrolovaná, 1 pro zaškrtnuté nebo 2 pro neurčité.

Vytvořit přepínací tlačítko, zavolejte CCmdUI objektu SetRadio členské funkce z ON_UPDATE_COMMAND_UI popisovač.Předat SetRadio argument 0 Nekontrolovaná nebo nenulová pro kontrolu.Zajištění rádio skupiny vzájemně se vylučujících chování musí mít ON_UPDATE_COMMAND_UI obslužné rutiny pro všechna tlačítka ve skupině.

Další informace o použití CToolBar , naleznete v článku Implementace MFC nástrojů a 31 technická Poznámka: Ovládací panely.