CMFCToolBar
Třída
Třída CMFCToolBar
se podobá CToolBar
třídě, ale poskytuje další podporu pro funkce uživatelského rozhraní. Patří mezi ně ploché panely nástrojů, panely nástrojů s horkými obrázky, velké ikony, tlačítka pageru, zamknuté panely nástrojů, ovládací prvky rebaru, text pod obrázky, obrázky pozadí a panely nástrojů s kartami. Třída CMFCToolBar
obsahuje také integrovanou podporu pro přizpůsobení panelů nástrojů a nabídek uživatelům, přetažení mezi panely nástrojů a nabídkami, tlačítky pole se seznamem, tlačítka pro úpravy polí, výběr barev a tlačítka pro vkládání.
Další podrobnosti najdete ve zdrojovém kódu umístěném v instalaci sady Visual Studio, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc
například .
Syntaxe
class CMFCToolBar : public CMFCBaseToolBar
Členové
Veřejné konstruktory
Název | Popis |
---|---|
CMFCToolBar::CMFCToolBar |
Výchozí konstruktor. |
CMFCToolBar::~CMFCToolBar |
Destruktor. |
Veřejné metody
Název | Popis |
---|---|
CMFCToolBar::AddBasicCommand |
Přidá příkaz nabídky do seznamu příkazů, které se vždy zobrazí, když uživatel otevře nabídku. |
CMFCToolBar::AddCommandUsage |
Zvýší o jeden čítač přidružený k danému příkazu. |
CMFCToolBar::AddToolBarForImageCollection |
Přidá obrázky z prostředků uživatelského rozhraní do kolekce obrázků v aplikaci. |
CMFCToolBar::AdjustLayout |
Přepočítá velikost a umístění panelu nástrojů. (Přepsání CBasePane::AdjustLayout ). |
CMFCToolBar::AdjustSize |
Přepočítá velikost panelu nástrojů. |
CMFCToolBar::AllowChangeTextLabels |
Určuje, jestli se popisky textu dají zobrazit pod obrázky na tlačítkách panelu nástrojů. |
CMFCToolBar::AreTextLabels |
Určuje, jestli se na tlačítkách panelu nástrojů aktuálně zobrazují popisky textu v obrázcích. |
CMFCToolBar::AutoGrayInactiveImages |
Povolí nebo zakáže automatické generování neaktivních obrázků tlačítek. |
CMFCToolBar::ButtonToIndex |
Vrátí index zadaného CMFCToolBarButton objektu třídy na tomto panelu nástrojů. |
CMFCToolBar::CalcFixedLayout |
Vypočítá vodorovnou velikost panelu nástrojů. (Přepsání CBasePane::CalcFixedLayout .) |
CMFCToolBar::CalcSize |
Volal ho architektura jako součást procesu výpočtu rozložení. (Přepsání CPane::CalcSize .) |
CMFCToolBar::CanHandleSiblings |
Určuje, zda je panel nástrojů a jeho stejné umístění ve stejném podokně. |
CMFCToolBar::CleanUpImages |
Uvolní systémové prostředky přidělené obrázkům na panelu nástrojů. |
CMFCToolBar::CleanUpLockedImages |
Uvolní systémové prostředky přidělené pro uzamčené obrázky panelu nástrojů. |
CMFCToolBar::CanBeClosed |
Určuje, jestli uživatel může panel nástrojů zavřít. (Přepsání CBasePane::CanBeClosed .) |
CMFCToolBar::CanBeRestored |
Určuje, zda systém může obnovit panel nástrojů do původního stavu po přizpůsobení. |
CMFCToolBar::CanFocus |
Určuje, jestli může podokno přijímat fokus. (Přepsání CBasePane::CanFocus .) |
CMFCToolBar::CanHandleSiblings |
Určuje, zda je panel nástrojů a jeho stejné umístění ve stejném podokně. |
CMFCToolBar::CommandToIndex |
Vrátí index tlačítka na panelu nástrojů se zadaným ID příkazu. |
CMFCToolBar::Create |
CMFCToolBar Vytvoří objekt. |
CMFCToolBar::CreateEx |
Vytvoří CMFCToolBar objekt, který používá další možnosti stylu, například velké ikony. |
CMFCToolBar::Deactivate |
Deaktivuje panel nástrojů. |
CMFCToolBar::EnableCustomizeButton |
Povolí nebo zakáže tlačítko Přidat nebo odebrat tlačítka , které se zobrazí na konci panelu nástrojů. |
CMFCToolBar::EnableDocking |
Umožňuje ukotvit podokno na hlavní rámec. (Přepsání CBasePane::EnableDocking .) |
CMFCToolBar::EnableLargeIcons |
Povolí nebo zakáže velké ikony na tlačítkách panelu nástrojů. |
CMFCToolBar::EnableQuickCustomization |
Povolí nebo zakáže rychlé přizpůsobení panelů nástrojů, aby uživatel mohl stisknout klávesu Alt a přetáhnout tlačítko na nové místo. |
CMFCToolBar::EnableReflections |
Povolí nebo zakáže odraz příkazů. |
CMFCToolBar::EnableTextLabels |
Povolí nebo zakáže popisky textu v obrázcích tlačítek panelu nástrojů. |
CMFCToolBar::FromHandlePermanent |
Načte ukazatel na CMFCToolBar objekt, který obsahuje daný popisovač okna. |
CMFCToolBar::GetAllButtons |
Vrátí seznam tlačítek jen pro čtení na panelu nástrojů. |
CMFCToolBar::GetAllToolbars |
Vrátí seznam všech panelů nástrojů v aplikaci jen pro čtení. |
CMFCToolBar::GetBasicCommands |
Vrátí seznam základních příkazů definovaných v aplikaci jen pro čtení. |
CMFCToolBar::GetButton |
Vrátí ukazatel na CMFCToolBarButton objekt, který má zadaný index tlačítka panelu nástrojů. |
CMFCToolBar::GetButtonInfo |
Vrátí ID příkazu, styl a index obrázku tlačítka v zadaném indexu. |
CMFCToolBar::GetButtonSize |
Vrátí rozměry každého tlačítka na panelu nástrojů. |
CMFCToolBar::GetButtonStyle |
Vrátí aktuální styl tlačítka panelu nástrojů umístěného v zadaném indexu. |
CMFCToolBar::GetButtonText |
Vrátí textový popisek tlačítka se zadaným indexem. |
CMFCToolBar::GetColdImages |
Vrátí ukazatel na kolekci obrázků tlačítek studeného panelu nástrojů v aplikaci. |
CMFCToolBar::GetColumnWidth |
Vrátí šířku tlačítek panelu nástrojů. |
CMFCToolBar::GetCommandButtons |
Vrátí seznam tlačítek, které mají zadané ID příkazu ze všech panelů nástrojů v aplikaci. |
CMFCToolBar::GetCount |
Vrátí počet tlačítek a oddělovačů na panelu nástrojů. |
CMFCToolBar::GetCustomizeButton |
Načte ukazatel na CMFCCustomizeButton objekt přidružený k panelu nástrojů. |
CMFCToolBar::GetDefaultImage |
Vrátí index výchozího obrázku pro tlačítko panelu nástrojů se zadaným ID příkazu. |
CMFCToolBar::GetDisabledImages |
Vrátí ukazatel na kolekci obrázků, které se používají pro zakázaná tlačítka panelu nástrojů v aplikaci. |
CMFCToolBar::GetDisabledMenuImages |
Vrátí ukazatel na kolekci obrázků, které se používají pro zakázaná tlačítka nabídek v aplikaci. |
CMFCToolBar::GetDroppedDownMenu |
Načte ukazatel na objekt tlačítka nabídky, který aktuálně zobrazuje jeho dílčí nabídku. |
CMFCToolBar::GetGrayDisabledButtons |
Určuje, jestli jsou obrázky zakázaných tlačítek neaktivní verze běžných obrázků tlačítek nebo pořízené z kolekce zakázaných obrázků tlačítek. |
CMFCToolBar::GetHighlightedButton |
Vrátí ukazatel na tlačítko panelu nástrojů, které je aktuálně zvýrazněné. |
CMFCToolBar::GetHotBorder |
Určuje, zda jsou tlačítka panelu nástrojů sledována. |
CMFCToolBar::GetHotTextColor |
Vrátí barvu textu zvýrazněných tlačítek panelu nástrojů. |
CMFCToolBar::GetHwndLastFocus |
Vrátí popisovač do okna, které mělo fokus vstupu těsně před panelem nástrojů. |
CMFCToolBar::GetIgnoreSetText |
Určuje, jestli se budou ignorovat volání pro nastavení popisků tlačítek. |
CMFCToolBar::GetImageSize |
Vrátí aktuální velikost obrázků tlačítek panelu nástrojů. |
CMFCToolBar::GetImages |
Vrátí ukazatel na kolekci výchozích obrázků tlačítek v aplikaci. |
CMFCToolBar::GetImagesOffset |
Vrátí posun indexu použitý k vyhledání obrázků tlačítek panelu nástrojů pro tento panel nástrojů v globálním seznamu obrázků tlačítek panelu nástrojů. |
CMFCToolBar::GetInvalidateItemRect |
Načte oblast klientské oblasti, která musí být překreslena pro tlačítko v daném indexu. |
CMFCToolBar::GetItemID |
Vrátí ID příkazu tlačítka panelu nástrojů v zadaném indexu. |
CMFCToolBar::GetItemRect |
Vrátí ohraničující obdélník tlačítka v zadaném indexu. |
CMFCToolBar::GetLargeColdImages |
Vrátí ukazatel na kolekci velkých obrázků tlačítek studeného panelu nástrojů v aplikaci. |
CMFCToolBar::GetLargeDisabledImages |
Vrátí ukazatel na kolekci velkých zakázaných obrázků tlačítek panelu nástrojů v aplikaci. |
CMFCToolBar::GetLargeImages |
Vrátí ukazatel na kolekci velkých obrázků tlačítek panelu nástrojů v aplikaci. |
CMFCToolBar::GetLockedColdImages |
Vrátí ukazatel na kolekci uzamčených studených obrázků na panelu nástrojů. |
CMFCToolBar::GetLockedDisabledImages |
Vrátí ukazatel na kolekci uzamčených zakázaných obrázků na panelu nástrojů. |
CMFCToolBar::GetLockedImages |
Vrátí ukazatel na kolekci obrázků uzamčených tlačítek na panelu nástrojů. |
CMFCToolBar::GetLockedImageSize |
Vrátí výchozí velikost uzamčených obrázků panelu nástrojů. |
CMFCToolBar::GetLockedMenuImages |
Vrátí ukazatel na kolekci obrázků nabídek uzamčených panelů nástrojů na panelu nástrojů. |
CMFCToolBar::GetMenuButtonSize |
Vrátí velikost tlačítek nabídky v aplikaci. |
CMFCToolBar::GetMenuImageSize |
Vrátí velikost obrázků tlačítek nabídky v aplikaci. |
CMFCToolBar::GetMenuImages |
Vrátí ukazatel na kolekci obrázků tlačítek nabídky v aplikaci. |
CMFCToolBar::GetOrigButtons |
Načte kolekci nespravovaných tlačítek panelu nástrojů. |
CMFCToolBar::GetOrigResetButtons |
Načte kolekci neupravovaných tlačítek pro resetování panelu nástrojů. |
CMFCToolBar::GetResourceID |
Načte ID prostředku panelu nástrojů. |
CMFCToolBar::GetRouteCommandsViaFrame |
Určuje, který objekt, nadřazený rámec nebo vlastník, odešle příkazy na panel nástrojů. |
CMFCToolBar::GetRowHeight |
Vrátí výšku tlačítek panelu nástrojů. |
CMFCToolBar::GetShowTooltips |
Určuje, jestli jsou u tlačítek panelu nástrojů zobrazeny popisky nástrojů. |
CMFCToolBar::GetSiblingToolBar |
Načte na stejné straně panelu nástrojů. |
CMFCToolBar::GetUserImages |
Vrátí ukazatel na kolekci obrázků tlačítek panelu nástrojů definovaných uživatelem v aplikaci. |
CMFCToolBar::HitTest |
Vrátí index tlačítka panelu nástrojů umístěného na zadané pozici. |
CMFCToolBar::InsertButton |
Vloží tlačítko na panel nástrojů. |
CMFCToolBar::InsertSeparator |
Vloží oddělovač na panel nástrojů. |
CMFCToolBar::InvalidateButton |
Zneplatní klientskou oblast tlačítka panelu nástrojů, která existuje v zadaném indexu. |
CMFCToolBar::IsAddRemoveQuickCustomize |
Určuje, zda uživatel může přidat nebo odebrat tlačítka panelu nástrojů pomocí možnosti Přizpůsobit nabídku. |
CMFCToolBar::IsAltCustomizeMode |
Určuje, jestli se k přetažení tlačítka používá rychlé přizpůsobení . |
CMFCToolBar::IsAutoGrayInactiveImages |
Určuje, jestli je povolené automatické generování neaktivních (nezvýrazněných) obrázků tlačítek. |
CMFCToolBar::IsBasicCommand |
Určuje, zda je příkaz v seznamu základních příkazů. |
CMFCToolBar::IsButtonExtraSizeAvailable |
Určuje, zda panel nástrojů může zobrazovat tlačítka s rozšířenými ohraničeními. |
CMFCToolBar::IsButtonHighlighted |
Určuje, zda je zvýrazněno tlačítko na panelu nástrojů. |
CMFCToolBar::IsCommandPermitted |
Určuje, zda je příkaz povolen. |
CMFCToolBar::IsCommandRarelyUsed |
Určuje, zda se příkaz používá zřídka (viz CMFCToolBar::SetCommandUsageOptions ). |
CMFCToolBar::IsCustomizeMode |
Určuje, jestli je architektura panelu nástrojů v režimu přizpůsobení. |
CMFCToolBar::IsDragButton |
Určuje, zda je tlačítko panelu nástrojů přetaženo. |
CMFCToolBar::IsExistCustomizeButton |
Určuje, zda panel nástrojů obsahuje tlačítko Přizpůsobit . |
CMFCToolBar::IsFloating |
Určuje, zda je panel nástrojů plovoucí. |
CMFCToolBar::IsLargeIcons |
Určuje, zda panely nástrojů v aplikaci aktuálně zobrazují velké ikony. |
CMFCToolBar::IsLastCommandFromButton |
Určuje, zda byl naposledy proveden příkaz odeslán z zadaného tlačítka panelu nástrojů. |
CMFCToolBar::IsLocked |
Určuje, zda je panel nástrojů uzamčen. |
CMFCToolBar::IsOneRowWithSibling |
Určuje, zda je panel nástrojů a panel nástrojů na stejné stejné straně umístěn. |
CMFCToolBar::IsUserDefined |
Určuje, jestli je panel nástrojů definovaný uživatelem. |
CMFCToolBar::LoadBitmap |
Načte obrázky panelů nástrojů z prostředků aplikace. |
CMFCToolBar::LoadBitmapEx |
Načte obrázky panelů nástrojů z prostředků aplikace. Obsahuje velké obrázky. |
CMFCToolBar::LoadParameters |
Načte globální možnosti panelu nástrojů z registru Systému Windows. |
CMFCToolBar::LoadState |
Načte informace o stavu panelu nástrojů z registru Systému Windows. (Přepsání CPane::LoadState .) |
CMFCToolBar::LoadToolBar |
Načte panel nástrojů z prostředků aplikace. |
CMFCToolBar::LoadToolBarEx |
Načte panel nástrojů z prostředků aplikace pomocí CMFCToolBarInfo pomocné třídy, aby aplikace mohla používat velké obrázky. |
CMFCToolBar::OnChangeHot |
Volá se rozhraním, když uživatel vybere tlačítko na panelu nástrojů. |
CMFCToolBar::OnFillBackground |
Volá se rozhraním, ze CBasePane::DoPaint které se vyplní pozadí panelu nástrojů. |
CMFCToolBar::OnReset |
Obnoví panel nástrojů do původního stavu. |
CMFCToolBar::OnSetAccData |
(Přepsání CBasePane::OnSetAccData .) |
CMFCToolBar::OnSetDefaultButtonText |
Obnoví text tlačítka panelu nástrojů do výchozího stavu. |
CMFCToolBar::OnUpdateCmdUI |
Používá se interně. |
CMFCToolBar::RemoveAllButtons |
Odebere všechna tlačítka z panelu nástrojů. |
CMFCToolBar::RemoveButton |
Odebere tlačítko se zadaným indexem z panelu nástrojů. |
CMFCToolBar::RemoveStateFromRegistry |
Odstraní informace o stavu panelu nástrojů z registru Systému Windows. |
CMFCToolBar::ReplaceButton |
Nahradí tlačítko panelu nástrojů jiným tlačítkem panelu nástrojů. |
CMFCToolBar::ResetAll |
Obnoví všechny panely nástrojů do původního stavu. |
CMFCToolBar::ResetAllImages |
Vymaže všechny kolekce obrázků na panelu nástrojů v aplikaci. |
CMFCToolBar::RestoreOriginalState |
Obnoví původní stav panelu nástrojů. |
CMFCToolBar::SaveState |
Uloží informace o stavu panelu nástrojů v registru Systému Windows. (Přepsání CPane::SaveState .) |
CMFCToolBar::Serialize |
(Přepsání CBasePane::Serialize .) |
CMFCToolBar::SetBasicCommands |
Nastaví seznam příkazů, které se vždy zobrazí, když uživatel otevře nabídku. |
CMFCToolBar::SetButtonInfo |
Nastaví ID příkazu, styl a ID obrázku tlačítka panelu nástrojů. |
CMFCToolBar::SetButtonStyle |
Nastaví styl tlačítka panelu nástrojů v daném indexu. |
CMFCToolBar::SetButtonText |
Nastaví textový popisek tlačítka panelu nástrojů. |
CMFCToolBar::SetButtons |
Nastaví tlačítka pro panel nástrojů. |
CMFCToolBar::SetCommandUsageOptions |
Určuje, kdy se zřídka používané příkazy nezobrazují v nabídce aplikace. |
CMFCToolBar::SetCustomizeMode |
Povolí nebo zakáže režim přizpůsobení pro všechny panely nástrojů v aplikaci. |
CMFCToolBar::SetGrayDisabledButtons |
Určuje, jestli jsou zakázaná tlačítka na panelu nástrojů neaktivní nebo jestli jsou pro zakázaná tlačítka použita zakázaná tlačítka. |
CMFCToolBar::SetHeight |
Nastaví výšku panelu nástrojů. |
CMFCToolBar::SetHotBorder |
Určuje, jestli jsou tlačítka panelu nástrojů s horkým sledováním. |
CMFCToolBar::SetHotTextColor |
Nastaví barvu textu pro tlačítka horkého panelu nástrojů. |
CMFCToolBar::SetLargeIcons |
Určuje, jestli tlačítka panelu nástrojů zobrazují velké ikony. |
CMFCToolBar::SetLockedSizes |
Nastaví velikosti uzamčených tlačítek a uzamčených obrázků na panelu nástrojů. |
CMFCToolBar::SetMenuSizes |
Nastaví velikost tlačítek nabídky panelu nástrojů a jejich obrázků. |
CMFCToolBar::SetNonPermittedCommands |
Nastaví seznam příkazů, které uživatel nemůže spustit. |
CMFCToolBar::SetOneRowWithSibling |
Umístí panel nástrojů a jeho stejné pořadí na stejném řádku. |
CMFCToolBar::SetPermament |
Určuje, jestli uživatel může panel nástrojů zavřít. |
CMFCToolBar::SetRouteCommandsViaFrame |
Určuje, jestli nadřazený rámec nebo vlastník odešle příkazy na panel nástrojů. |
CMFCToolBar::SetShowTooltips |
Určuje, jestli architektura zobrazuje popisy nástrojů. |
CMFCToolBar::SetSiblingToolBar |
Určuje stejné nastavení panelu nástrojů. |
CMFCToolBar::SetSizes |
Určuje velikosti tlačítek a obrázků na všech panelech nástrojů. |
CMFCToolBar::SetToolBarBtnText |
Určuje vlastnosti tlačítka na panelu nástrojů. |
CMFCToolBar::SetTwoRowsWithSibling |
Umístí panel nástrojů a jeho stejné umístění na samostatné řádky. |
CMFCToolBar::SetUserImages |
Nastaví kolekci uživatelsky definovaných obrázků v aplikaci. |
CMFCToolBar::StretchPane |
Roztáhne panel nástrojů svisle nebo vodorovně. (Přepsání CBasePane::StretchPane .) |
CMFCToolBar::TranslateChar |
Spustí příkaz tlačítka, pokud zadaný kód klávesy odpovídá platné klávesové zkratkě. |
CMFCToolBar::UpdateButton |
Aktualizuje stav zadaného tlačítka. |
CMFCToolBar::WrapToolBar |
Přemísťuje tlačítka panelu nástrojů v rámci daných dimenzí. |
Chráněné metody
Název | Popis |
---|---|
CMFCToolBar::AllowShowOnList |
Určuje, zda je panel nástrojů zobrazen v seznamu v podokně Panely nástrojů dialogového okna Přizpůsobit . |
CMFCToolBar::CalcMaxButtonHeight |
Vypočítá maximální výšku tlačítka na panelu nástrojů. |
CMFCToolBar::DoPaint |
Překreslí panel nástrojů. |
CMFCToolBar::DrawButton |
Překreslí tlačítko panelu nástrojů. |
CMFCToolBar::DrawSeparator |
Překreslí oddělovač na panelu nástrojů. |
CMFCToolBar::OnUserToolTip |
Volá se rozhraním, když se bude zobrazovat popis tlačítka. |
Datové členy
Název | Popis |
---|---|
CMFCToolBar::m_bDontScaleImages |
Určuje, zda se mají škálovat nebo nepanelu nástrojů v režimu vysokého DPI. |
CMFCToolBar::m_dblLargeImageRatio |
Určuje poměr mezi rozměrem (výškou nebo šířkou) velkých obrázků a rozměrem běžných obrázků. |
Poznámky
Pokud chcete do aplikace začlenit CMFCToolBar
objekt, postupujte takto:
CMFCToolBar
Přidejte objekt do okna hlavního rámce.Když zpracujete zprávu WM_CREATE pro okno hlavního rámce, zavolejte panel
CMFCToolBar::Create
nástrojů neboCMFCToolBar::CreateEx
vytvořte panel nástrojů a zadejte jeho styl.Volání
CBasePane::EnableDocking
pro určení stylu ukotvení
Chcete-li vložit speciální tlačítko, například pole se seznamem nebo rozevírací panel nástrojů, vyhraďte fiktivní tlačítko v nadřazeného prostředku a nahraďte fiktivní tlačítko za běhu pomocí CMFCToolBar::ReplaceButton
. Další informace naleznete v tématu Návod: Umístění ovládacích prvků na panely nástrojů.
CMFCToolBar
je základní třída pro třídy CMFCMenuBar
knihovny MFC, CMFCPopupMenuBar
třídu a CMFCDropDownToolBar
třídu.
Příklad
Následující příklad ukazuje, jak používat různé metody ve CMFCToolBar
třídě. Příklad ukazuje, jak nastavit text popisku okna na panelu nástrojů, nastavit ohraničení, nastavit styl podokna a povolit tlačítko Přidat nebo odebrat tlačítka , které se zobrazí na konci panelu nástrojů. Tento fragment kódu je součástí ukázky IE Demo.
CMFCToolBar m_wndToolBar;
m_wndToolBar.SetWindowText(_T("Standard"));
m_wndToolBar.SetBorders();
//------------------------------------
// Remove toolbar gripper and borders:
//------------------------------------
m_wndToolBar.SetPaneStyle(m_wndToolBar.GetPaneStyle() &
~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));
m_wndToolBar.EnableCustomizeButton(TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));
Požadavky
Záhlaví: afxtoolbar.h
Hierarchie dědičnosti
CMFCToolBar
CMFCToolBar::AddBasicCommand
Přidá příkaz nabídky do seznamu příkazů, které se vždy zobrazí, když uživatel otevře nabídku.
static void __stdcall AddBasicCommand(UINT uiCmd);
Parametry
uiCmd
[v] Určuje příkaz, který chcete přidat.
Poznámky
Při otevření nabídky se vždy zobrazí základní příkaz. Tato metoda je smysluplná, když se uživatel rozhodne zobrazit nedávno použité příkazy.
CMFCToolBar::SetBasicCommands
Pomocí metody můžete nastavit seznam příkazů, které se vždy zobrazí, když uživatel otevře nabídku. CMFCToolBar::GetBasicCommands
Pomocí této metody můžete načíst seznam základních příkazů, které vaše aplikace používá.
CMFCToolBar::AddCommandUsage
Zvýší o jeden čítač přidružený k danému příkazu.
static void __stdcall AddCommandUsage(UINT uiCommand);
Parametry
uiCommand
[v] Určuje čítač příkazu, který se má zvýšit.
Poznámky
Architektura volá tuto metodu, když uživatel vybere položku nabídky.
Architektura používá čítače příkazů k zobrazení naposledy použitých položek nabídky.
Tato metoda zvýší čítač příkazů pomocí CMFCCmdUsageCount::AddCmd
metody.
CMFCToolBar::AddToolBarForImageCollection
Přidá obrázky z prostředků uživatelského rozhraní do kolekce obrázků v aplikaci.
static BOOL __stdcall AddToolBarForImageCollection(
UINT uiResID,
UINT uiBmpResID=0,
UINT uiColdResID=0,
UINT uiMenuResID=0,
UINT uiDisabledResID=0,
UINT uiMenuDisabledResID=0);
Parametry
uiResID
[v] ID prostředku panelu nástrojů s obrázky, které se mají načíst.
uiBmpResID
[v] ID prostředku rastrového obrázku s obrázky na panelu nástrojů
uiColdResID
[v] ID prostředku rastrového obrázku s obrázky na panelu nástrojů "studená".
uiMenuResID
[v] ID prostředku rastrového obrázku s obrázky nabídek
uiDisabledResID
[v] ID prostředku rastrového obrázku se zakázanými obrázky na panelu nástrojů
uiMenuDisabledResID
[v] ID prostředku rastrového obrázku se zakázanými obrázky nabídek
Návratová hodnota
TRUE
pokud je metoda úspěšná; FALSE
pokud uiResID
nebo uiBmpResID
nezadávejte platné prostředky nebo dojde k jiné chybě.
Poznámky
Voláním této metody načtete rastrový obrázek s obrázky panelu nástrojů a přidáte ho do kolekce obrázků panelu nástrojů. Tato metoda vytvoří dočasný objekt panelu nástrojů a volání CMFCToolBar::LoadToolBar
.
CMFCToolBar::AdjustLayout
Přepočítá velikost a umístění panelu nástrojů.
virtual void AdjustLayout();
Poznámky
Volání této metody při vytvoření panelu nástrojů k přepočtu jeho velikosti a umístění.
Architektura volá tuto metodu pokaždé, když je nutné změnit rozložení panelu nástrojů. Rozložení se například musí změnit, když uživatel přesune jiný ovládací panel, změní velikost okna aplikace nebo přizpůsobí panel nástrojů.
Přepište tuto metodu tak, aby poskytovalo vlastní dynamické rozložení ve třídách, které odvozujete z CMFCToolbar
.
CMFCToolBar::AdjustSize
Přepočítá velikost panelu nástrojů.
void AdjustSize();
Poznámky
Tato metoda zajišťuje, aby se panel nástrojů vešl do hranic nadřazeného rámce. Tato metoda nedělá nic, pokud panel nástrojů nemá žádný nadřazený rámec.
Metoda CMFCToolBar::AdjustLayout
volá tuto metodu, aby přepočítala velikost, pokud nadřazený panel nástrojů není CMFCReBar
objekt.
CMFCToolBar::AllowChangeTextLabels
Určuje, jestli se popisky textu dají zobrazit pod obrázky na tlačítkách panelu nástrojů.
virtual BOOL AllowChangeTextLabels() const;
Návratová hodnota
TRUE
pokud je povoleno zobrazovat popisky textu pod obrázky; jinak FALSE
.
Poznámky
Tato metoda je volána pomocí dialogového okna přizpůsobení určit, zda chcete povolit zaškrtávací políčko Zobrazit popisky textu na stránce Panely nástrojů pro vybraný panel nástrojů.
Výchozí implementace vrátí TRUE
.
Tuto metodu přepište v objektu odvozeného z CMFCToolBar
a vrátit FALSE
, pokud nechcete, aby se uživatel rozhodl, zda jsou textové popisky zobrazeny na tlačítkách panelu nástrojů pod obrázky.
CMFCToolBar::AllowShowOnList
Určuje, zda je panel nástrojů zobrazen v seznamu panelů nástrojů v podokně Panely nástrojů dialogového okna Přizpůsobit .
virtual BOOL AllowShowOnList() const;
Návratová hodnota
TRUE
pokud lze objekt panelu nástrojů zobrazit v seznamu na stránce přizpůsobení panelu nástrojů; jinak FALSE
.
Poznámky
Tato metoda je volána rozhraním k určení, zda seznam na stránce přizpůsobení panelu nástrojů by měl obsahovat konkrétní objekt odvozený z CMFCToolBar
.
Výchozí implementace vždy vrátí TRUE
. Tuto metodu přepište, pokud nechcete, aby se panel nástrojů zobrazoval v seznamu panelů nástrojů v dialogovém okně přizpůsobení.
CMFCToolBar::AreTextLabels
Určuje, jestli se na tlačítkách panelu nástrojů aktuálně zobrazují popisky textu v obrázcích.
BOOL AreTextLabels() const;
Návratová hodnota
TRUE
pokud tlačítka panelu nástrojů zobrazují popisky textu pod obrázky; jinak FALSE
.
Poznámky
Slouží CMFCToolBar::EnableTextLabels
k určení, zda se text zobrazí. Výchozí hodnota je FALSE
. Voláním CMFCToolBar::AllowChangeTextLabels
určíte, jestli uživatel může toto nastavení změnit v dialogovém okně přizpůsobení.
CMFCToolBar::AutoGrayInactiveImages
Povolí nebo zakáže automatické generování neaktivních obrázků tlačítek.
static void AutoGrayInactiveImages(
BOOL bEnable=TRUE,
int nGrayImagePercentage=0,
BOOL bRedrawAllToolbars=TRUE);
Parametry
bEnable
[v] Logická hodnota, která určuje, jestli se mají neaktivní obrázky ztlumit. Pokud je TRUE
tento parametr , neaktivní obrázky jsou neaktivní. Jinak neaktivní obrázky nejsou zašedlé.
nGrayImagePercentage
[v] Určuje procento světelnosti neaktivních obrázků. Pokud bEnable
ano FALSE
, tato hodnota se ignoruje.
bRedrawAllToolbars
[v] Logická hodnota, která určuje, zda se mají překreslit všechny panely nástrojů v aplikaci. Pokud je TRUE
tento parametr , tato metoda překreslí všechny panely nástrojů.
Poznámky
Pokud bEnable
ano TRUE
, architektura používá nGrayImagePercentage
k vygenerování neaktivních imagí z běžných imagí. V opačném případě je nutné zadat sadu neaktivních obrázků pomocí CMFCToolBar::GetColdImages
metody. Ve výchozím nastavení je tato možnost zakázaná.
Další informace o parametru nGrayImagePercentage
naleznete v tématu CMFCToolBarImages::GrayImages
.
CMFCToolBar::ButtonToIndex
Vrátí index zadaného CMFCToolBarButton
objektu třídy na tomto panelu nástrojů.
int ButtonToIndex(const CMFCToolBarButton* pButton) const;
Parametry
pButton
[v] Ukazatel na objekt tlačítka panelu nástrojů.
Návratová hodnota
pButton
Index v interním seznamu tlačítek panelu nástrojů, nebo -1, pokud zadané tlačítko není na tomto panelu nástrojů.
CMFCToolBar::CalcFixedLayout
Vypočítá vodorovnou velikost panelu nástrojů.
virtual CSize CalcFixedLayout(
BOOL bStretch,
BOOL bHorz);
Parametry
bStretch
[v] TRUE
pro roztažení panelu nástrojů na velikost nadřazeného rámce.
bHorz
[v] TRUE
pro orientaci panelu nástrojů vodorovně; FALSE
pro orientaci panelu nástrojů svisle.
Návratová hodnota
Objekt CSize
, který určuje velikost panelu nástrojů.
Poznámky
Tato metoda vypočítá velikost panelu nástrojů pomocí CMFCToolBar::CalcLayout
metody. Předá příznak parametru LM_STRETCH
dwMode
, pokud bStretch
je TRUE
. Předá LM_HORZ
příznak, pokud bHorz
je TRUE
.
Příklad, který používá tuto metodu, najdete v ukázce VisualStudioDemo.
CMFCToolBar::CalcMaxButtonHeight
Vypočítá maximální výšku tlačítek na panelu nástrojů.
virtual int CalcMaxButtonHeight();
Návratová hodnota
Maximální výška tlačítek.
Poznámky
Tato metoda vypočítá maximální výšku všech tlačítek panelu nástrojů na panelu nástrojů. Výška se může lišit v závislosti na faktorech, jako je aktuální stav ukotvení panelu nástrojů.
Přepište tuto metodu ve třídě odvozené z CMFCToolBar
poskytnutí vlastního výpočtu výšky.
CMFCToolBar::CalcSize
Volal ho architektura jako součást procesu výpočtu rozložení.
virtual CSize CalcSize(BOOL bVertDock);
Parametry
bVertDock
[v] TRUE
určit, že je panel nástrojů ukotven svisle; FALSE
chcete-li určit, že je panel nástrojů ukotven vodorovně.
Návratová hodnota
Objekt CSize
, který určuje celkovou velikost tlačítek na panelu nástrojů.
Poznámky
Tato metoda bere v úvahu atributy, které ovlivňují velikost každého tlačítka, například oblast textového popisku a velikost ohraničení.
Pokud panel nástrojů neobsahuje žádná tlačítka, vrátí tato metoda rezervovanou velikost jednoho tlačítka pomocí CMFCToolBar::GetButtonSize
metody.
CMFCToolBar::CanBeClosed
Určuje, jestli uživatel může panel nástrojů zavřít.
virtual BOOL CanBeClosed() const;
Návratová hodnota
TRUE
je-li panel nástrojů možné zavřít uživatelem; jinak FALSE
.
Poznámky
Architektura volá tuto metodu k určení, zda uživatel může zavřít panel nástrojů. Pokud metoda vrátí TRUE
, architektura povolí SC_CLOSE
příkaz v systémové nabídce panelu nástrojů a uživatel může zavřít panel nástrojů pomocí zaškrtávacího políčka v seznamu panelů nástrojů v dialogovém okně přizpůsobení.
Výchozí implementace vrátí TRUE
. Přepište tuto metodu ve třídě odvozené z CMFCToolBar
objekty panelu nástrojů, které nelze zavřít uživatelem.
CMFCToolBar::CanBeRestored
Určuje, zda systém může obnovit panel nástrojů do původního stavu po přizpůsobení.
virtual BOOL CanBeRestored() const;
Návratová hodnota
TRUE
pokud lze panel nástrojů obnovit z prostředků aplikace; jinak FALSE
.
Poznámky
Architektura volá tuto metodu k určení, zda lze panel nástrojů vrátit do původního stavu po přizpůsobení. Původní stav se načte z prostředků aplikace.
Pokud CanBeRestored
se vrátí TRUE
, stránka Panely nástrojů dialogového okna přizpůsobení povolí tlačítko Obnovit pro vybraný panel nástrojů.
Výchozí implementace vrátí TRUE
, pokud původní ID prostředku panelu nástrojů při jeho načtení není nula. Obvykle nelze obnovit pouze uživatelsky definované panely nástrojů.
Můžete přepsat metodu CanBeRestored
pro přizpůsobení tohoto chování v odvozených třídách.
CMFCToolBar::CanFocus
Určuje, jestli může podokno přijímat fokus.
virtual BOOL CanFocus() const;
Návratová hodnota
Tato metoda vrátí FALSE
.
Poznámky
Tato metoda přepíše implementaci základní třídy, CBasePane::CanFocus
protože objekty panelu nástrojů nemohou přijímat fokus.
CMFCToolBar::CanHandleSiblings
Určuje, zda je panel nástrojů a jeho stejné umístění ve stejném podokně.
BOOL CanHandleSiblings();
Návratová hodnota
TRUE
pokud je panel nástrojů na stejné straně a panel nástrojů a jeho na stejné stejné pozici; jinak FALSE
.
Poznámky
Interní CMFCCustomizeButton::CreatePopupMenu
metoda volá tuto metodu k určení, jak zobrazit místní nabídku Vlastní nastavení . Pokud tato metoda vrátí TRUE
, architektura zobrazí tlačítka Zobrazit tlačítka na jednom řádku nebo Zobrazit tlačítka na dvou řádcích tlačítka.
Tuto metodu obvykle nemusíte používat. Pokud chcete povolit tlačítko Přizpůsobit , které se zobrazí na panelu nástrojů, zavolejte metodu CMFCToolBar::EnableCustomizeButton
. Pokud chcete povolit tlačítka Zobrazit tlačítka na jednom řádku nebo Zobrazit tlačítka na dvou řádcích, zavolejte CMFCToolBar::SetSiblingToolBar
.
CMFCToolBar::CleanUpImages
Uvolní systémové prostředky přidělené obrázkům na panelu nástrojů.
static void CMFCToolBar::CleanUpImages();
Poznámky
Architektura volá tuto metodu při vypnutí aplikace.
CMFCToolBar::CleanUpLockedImages
Uvolní systémové prostředky přidělené pro uzamčené obrázky panelu nástrojů.
void CleanUpLockedImages();
Poznámky
Tuto metodu zavolejte, když se změní vizuální styl aplikace. Příklad, který používá tuto metodu, najdete v ukázce VisualStudioDemo.
CMFCToolBar::CommandToIndex
Vrátí index tlačítka na panelu nástrojů se zadaným ID příkazu.
int CommandToIndex(
UINT nIDFind,
int iIndexFirst=0) const;
Parametry
nIDFind
[v] Určuje ID příkazu.
iIndexFirst
[v] Určuje počáteční index, od který se má začít.
Návratová hodnota
Nulový index tlačítka panelu nástrojů, pokud byla metoda úspěšná; -1, pokud neexistuje tlačítko se zadaným ID.
Poznámky
Objekt CMFCToolBar
udržuje interní seznam tlačítek na panelu nástrojů. Voláním této funkce načtěte index tlačítka v seznamu s id příkazu tlačítka.
Pokud iIndex
je větší než 0, tato metoda ignoruje jakékoli tlačítko na panelu nástrojů, které má index menší než iIndex
.
CMFCToolBar::Create
CMFCToolBar
Vytvoří objekt.
virtual BOOL Create(
CWnd* pParentWnd,
DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
UINT nID=AFX_IDW_TOOLBAR);
Parametry
pParentWnd
[v] Ukazatel na nadřazené okno panelu nástrojů
dwStyle
[v] Styl panelu nástrojů. Seznam stylů v sadě Windows SDK najdete v části Styly ovládacích prvků a tlačítek panelu nástrojů.
nID
[v] ID podřízeného okna panelu nástrojů.
Návratová hodnota
TRUE
pokud tato metoda bude úspěšná; jinak FALSE
.
Poznámky
Tato metoda vytvoří řídicí panel a připojí ho k panelu nástrojů. Vytvoří ovládací panel se stylem TBSTYLE_FLAT. Pokud chcete použít jiný styl řídicího panelu, zavolejte ho CMFCToolBar::CreateEx
.
CMFCToolBar::CreateEx
Vytvoří CMFCToolBar
objekt, který používá další možnosti stylu, například velké ikony.
virtual BOOL CreateEx(
CWnd* pParentWnd,
DWORD dwCtrlStyle=TBSTYLE_FLAT,
DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
CRect rcBorders=CRect(1,
1,
1,
1),
UINT nID=AFX_IDW_TOOLBAR);
Parametry
pParentWnd
[v] Ukazatel na nadřazené okno panelu nástrojů
dwCtrlStyle
[v] Další styly pro vytvoření vloženého objektu řídicího panelu
dwStyle
[v] Styl panelu nástrojů. Seznam vhodných stylů najdete v části Ovládací prvek panelu nástrojů a styly tlačítek.
rcBorders
[v] Objekt CRect
, který určuje šířky ohraničení okna panelu nástrojů.
nID
[v] ID podřízeného okna panelu nástrojů.
Návratová hodnota
Nenulové, pokud tato metoda bude úspěšná; jinak 0.
Poznámky
Tato metoda vytvoří řídicí panel a připojí ho k panelu nástrojů.
Tuto metodu CMFCToolBar::Create
volejte místo toho, když chcete zadat konkrétní styly. Můžete například nastavit vytvoření TBSTYLE_FLAT
| TBSTYLE_TRANSPARENT
panelu nástrojů, dwCtrlStyle
který se podobá panelům nástrojů používaných aplikací Internet Explorer 4.
Příklad
Následující příklad ukazuje, jak použít CreateEx
metodu CMFCToolBar
třídy. Tento fragment kódu je součástí ukázky IE Demo.
CMFCToolBar m_wndToolBar;
// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
!m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
TRACE0("Failed to create toolbar\n");
return -1; // fail to create
}
CMFCToolBar::Deactivate
Deaktivuje panel nástrojů.
virtual void Deactivate();
Poznámky
Tato metoda deaktivuje panel nástrojů odebráním fokusu ze zvýrazněného tlačítka panelu nástrojů. Architektura volá tuto metodu, když panel nástrojů ztratí fokus nebo je zničen.
CMFCToolBar::DoPaint
Překreslí panel nástrojů.
virtual void DoPaint(CDC* pDC);
Parametry
pDC
[v] Ukazatel na kontext zařízení.
Poznámky
Tato metoda je volána architekturou, když je nutné překreslit část panelu nástrojů.
Přepsat tuto metodu přizpůsobit vzhled objektu odvozeného z CMFCToolBar
.
CMFCToolBar::DrawButton
Překreslí tlačítko panelu nástrojů.
virtual BOOL DrawButton(
CDC* pDC,
CMFCToolBarButton* pButton,
CMFCToolBarImages* pImages,
BOOL bHighlighted,
BOOL bDrawDisabledImages);
Parametry
pDC
[v] Ukazatel na kontext zařízení.
pButton
[v] Ukazatel na tlačítko, které chcete nakreslit.
pImages
[v] Ukazatel na obrázky panelu nástrojů.
bHighlighted
[v] TRUE
pokud je tlačítko zvýrazněno; jinak FALSE
.
bDrawDisabledImages
[v] TRUE
pokud jsou zakázaná tlačítka neaktivní; jinak FALSE
.
Návratová hodnota
TRUE
pokud bylo tlačítko znovu nakreslit; FALSE
pokud je tlačítko skryté.
Poznámky
Metoda CMFCToolBar::DrawButton
volá tuto metodu, když je nutné překreslit tlačítko panelu nástrojů.
Tuto metodu přepište, pokud chcete přizpůsobit vzhled tlačítek na panelu nástrojů.
CMFCToolBar::DrawSeparator
Překreslí oddělovač na panelu nástrojů.
virtual void DrawSeparator(
CDC* pDC,
const CRect& rect,
BOOL bHorz);
Parametry
pDC
[v] Ukazatel na kontext zařízení.
rect
[v] Ohraničující obdélník umístění, kde je oddělovač nakreslen v pixelech.
bHorz
[v] TRUE
pokud je oddělovač vodorovný, FALSE
pokud je oddělovač svislý.
Poznámky
CMFCToolBar::DoPaint
volá tuto metodu pro každý CMFCToolBar::DrawSeparator
objekt, který má styl, místo volání CMFCToolBar::DrawButton
pro tato TBBS_SEPARATOR
tlačítka.
Přepište tuto metodu ve třídě odvozené z CMFCToolBar
přizpůsobení vzhledu oddělovačů na panelu nástrojů. Výchozí volání CMFCVisualManager::OnDrawSeparator
implementace, která nakreslí oddělovač, jehož vzhled určuje aktuální správce vizuálů.
CMFCToolBar::EnableCustomizeButton
Povolí nebo zakáže tlačítko Přizpůsobit, které se zobrazí na panelu nástrojů.
void EnableCustomizeButton(
BOOL bEnable,
int iCustomizeCmd,
const CString& strCustomizeText,
BOOL bQuickCustomize=TRUE);
void EnableCustomizeButton(
BOOL bEnable,
int iCustomizeCmd,
UINT uiCustomizeTextResId,
BOOL bQuickCustomize=TRUE);
Parametry
bEnable
[v] Povolí nebo zakáže tlačítko Přizpůsobit.
iCustomizeCmd
[v] ID příkazu tlačítka Přizpůsobit
strCustomizeText
[v] Textový popisek tlačítka Přizpůsobit
uiCustomizeTextResId
[v] ID řetězce prostředku popisku tlačítka Přizpůsobit
bQuickCustomize
[v] Povolí nebo zakáže možnost Přidat nebo odebrat tlačítka v nabídce, která se z tlačítka rozbalí.
Poznámky
Pokud iCustomizeCmd
je -1, architektura zobrazí tlačítko Přizpůsobit, pokud se více tlačítek panelu nástrojů nevejde do oblasti panelu nástrojů. Tlačítko zobrazí dvojitou šipku vlevo nebo dvojitou šipku dvojitou šipku, která označuje, že je k dispozici více tlačítek.
Pokud iCustomizeCmd
určuje platné ID příkazu a bEnable
je TRUE
, tlačítko Přizpůsobit se vždy zobrazí. Tlačítko má malou šipku dolů a otevře nabídku obsahující příkaz. Tento příkaz používá textový popisek určený parametrem strCustomizeText
. Pokud bQuickCustomize
ano, zobrazí se v nabídce možnost Přidat nebo odebrat tlačítkaTRUE
.
Architektura dynamicky přidává do nabídky všechna tlačítka, která se nevejdou do oblasti panelu nástrojů před položkou určenou iCustomizeCmd
. Dvojitá šipka se zobrazí vedle šipky dolů.
CMFCToolBar::EnableDocking
Umožňuje ukotvit podokno na hlavní rámec.
virtual void EnableDocking(DWORD dwAlignment);
Parametry
dwAlignment
[v] Určuje ukotvit zarovnání, které se má povolit.
Poznámky
Tato metoda rozšiřuje implementaci CBasePane::EnableDocking
základní třídy nastavením datového členu CBasePane::m_dwControlBarStyle
na AFX_CBRS_FLOAT
. Tato metoda pak předá dwAlignment
implementaci základní třídy.
CMFCToolBar::EnableLargeIcons
Povolí nebo zakáže velké ikony na tlačítkách panelu nástrojů.
void EnableLargeIcons(BOOL bEnable);
Parametry
bEnable
[v] TRUE
pokud chcete povolit velké ikony, FALSE
zakažte velké ikony.
Poznámky
Ve výchozím nastavení jsou povolené velké ikony.
CMFCToolBar::EnableQuickCustomization
Povolí nebo zakáže rychlé přizpůsobení panelů nástrojů, aby uživatel mohl stisknout klávesu Alt a přetáhnout tlačítko na nové místo.
static void EnableQuickCustomization(BOOL bEnable=TRUE);
Parametry
bEnable
[v] TRUE
chcete-li povolit rychlé přizpůsobení, FALSE
zakažte rychlé přizpůsobení.
CMFCToolBar::EnableReflections
Povolí nebo zakáže odraz příkazů.
void EnableReflections(BOOL bEnable = TRUE);
Parametry
bEnable
[v] TRUE
povolení reflexe příkazů; FALSE
zakázání odrazu příkazu.
Poznámky
Voláním této metody povolíte odraz příkazů pro tlačítka panelu nástrojů, která obsahují vložené ovládací prvky, jako jsou pole se seznamem.
Další informace o reflexi příkazů naleznete v tématu TN062: Reflexe zprávy pro ovládací prvky Windows.
CMFCToolBar::EnableTextLabels
Povolí nebo zakáže popisky textu v obrázcích tlačítek panelu nástrojů.
void EnableTextLabels(BOOL bEnable=TRUE);
Parametry
bEnable
TRUE
pokud se popisky textu zobrazí pod obrázky tlačítek panelu nástrojů; jinak FALSE
.
Poznámky
Pokud jsou textové popisky povolené, zvětší se všechna tlačítka na panelu nástrojů, aby byly popisky zobrazeny pod obrázky. Dialogové okno přizpůsobení obsahuje zaškrtávací políčko Zobrazit popisek textu na stránce Panely nástrojů . Když uživatel vybere panel nástrojů a tuto možnost zkontroluje, architektura volá EnableTextLabels
vybraný panel nástrojů. Zaškrtávací políčko pro objekt odvozený z CMFCToolBar
objektu můžete zakázat vrácením FALSE
z CMFCToolBar::AllowChangeTextLabels
.
CMFCToolBar::FromHandlePermanent
Načte ukazatel na CMFCToolBar
objekt, který obsahuje daný popisovač okna.
static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);
Parametry
hwnd
[v] Popisovač okna, který chcete vyhledat.
Návratová hodnota
Ukazatel na CMFCToolBar
objekt, který obsahuje daný popisovač okna nebo NULL
pokud neexistuje žádný odpovídající CMFCToolBar
objekt.
Poznámky
Tato sdílená metoda zkoumá každý panel nástrojů v aplikaci pro CMFCToolBar
objekt, který obsahuje daný popisovač okna.
CMFCToolBar::GetAllButtons
Vrátí seznam tlačítek jen pro čtení na panelu nástrojů.
const CObList& GetAllButtons() const;
Návratová hodnota
Konstantní odkaz na CObList
objekt Třídy , který obsahuje kolekci CMFCToolBarButton
objektů třídy .
CMFCToolBar::GetAllToolbars
Vrátí seznam všech panelů nástrojů v aplikaci jen pro čtení.
static const CObList& GetAllToolbars();
Návratová hodnota
Odkaz const na CObList
objekt třídy , který obsahuje kolekci CMFCToolBar
objektů.
CMFCToolBar::GetBasicCommands
Vrátí seznam základních příkazů definovaných v aplikaci jen pro čtení.
static const CList<UINT,UINT>& GetBasicCommands();
Návratová hodnota
Odkaz const na CList
objekt třídy , který obsahuje kolekci základních příkazů.
Poznámky
Přidejte základní příkazy voláním CMFCToolBar::AddBasicCommand
nebo CMFCToolBar::SetBasicCommands
.
CMFCToolBar::GetButton
Vrátí ukazatel na CMFCToolBarButton
objekt Class v zadaném indexu.
CMFCToolBarButton* GetButton(int iIndex) const;
Parametry
iIndex
[v] Určuje index tlačítka, který se má vrátit.
Návratová hodnota
Ukazatel na tlačítko panelu nástrojů, pokud existuje; nebo NULL
pokud takové tlačítko neexistuje.
CMFCToolBar::GetButtonInfo
Vrátí ID příkazu, styl a index obrázku tlačítka v zadaném indexu.
void GetButtonInfo(
int nIndex,
UINT& nID,
UINT& nStyle,
int& iImage) const;
Parametry
nIndex
[v] Určuje index tlačítka v seznamu tlačítek na panelu nástrojů.
nID
[ven] ID příkazu tlačítka.
nStyle
[ven] Styl tlačítka
iImage
[ven] Index obrázku tlačítka
Poznámky
Metoda GetButtonInfo
najde tlačítko panelu nástrojů v zadaném indexu a načte ID příkazu, styl a index obrázku tlačítka.
Pokud tlačítko v zadaném indexu neexistuje, architektura nastaví nID
a nStyle
na hodnotu 0 a iImage
na -1, když metoda vrátí.
CMFCToolBar::GetButtonSize
Vrátí rozměry každého tlačítka na panelu nástrojů.
CSize GetButtonSize() const;
Návratová hodnota
Objekt CSize
Třídy , který určuje rozměry každého tlačítka na panelu nástrojů.
Poznámky
Volání CMFCToolBar::SetSizes
nebo CMFCToolBar::SetLockedSizes
nastavení rozměrů jednotlivých tlačítek na panelu nástrojů
CMFCToolBar::GetButtonStyle
Vrátí aktuální styl tlačítka panelu nástrojů umístěného v zadaném indexu.
UINT GetButtonStyle(int nIndex) const;
Parametry
nIndex
[v] Určuje index tlačítka panelu nástrojů.
Návratová hodnota
Hodnota, která určuje styl tlačítka panelu nástrojů. . Seznammožnýchch
Poznámky
Volání CMFCToolBar::SetButtonStyle
pro nastavení stylu tlačítka panelu nástrojů
CMFCToolBar::GetButtonText
Vrátí textový popisek tlačítka se zadaným indexem.
CString GetButtonText(int nIndex) const;
void GetButtonText(
int nIndex,
CString& rString) const;
Parametry
nIndex
[v] Index tlačítka panelu nástrojů
rString
[ven] Text popisku tlačítka panelu nástrojů
Návratová hodnota
Text popisku tlačítka panelu nástrojů
Poznámky
Volání CMFCToolBar::SetButtonText
nebo CMFCToolBar::SetToolBarBtnText
nastavení textového popisku
CMFCToolBar::GetColdImages
Vrátí ukazatel na kolekci obrázků tlačítek studeného panelu nástrojů v aplikaci.
static CMFCToolBarImages* GetColdImages();
Návratová hodnota
Ukazatel na kolekci obrázků tlačítek studeného panelu nástrojů.
Poznámky
Studené obrázky jsou obrázky, které se používají, když uživatel nepracuje s tlačítky panelu nástrojů. Volání CMFCToolBar::LoadBitmapEx
nebo CMFCToolBar::LoadBitmap
načtení studených obrázků
CMFCToolBar::GetColumnWidth
Vrátí šířku tlačítek panelu nástrojů.
virtual int GetColumnWidth() const;
Návratová hodnota
Hodnota, která určuje šířku tlačítek panelu nástrojů.
Poznámky
Architektura volá tuto metodu pro výpočet rozložení panelu nástrojů. Přepsat tuto metodu v odvozené třídě určit jinou šířku sloupce pro váš panel nástrojů.
CMFCToolBar::GetCommandButtons
Vrátí seznam tlačítek, které mají zadané ID příkazu ze všech panelů nástrojů v aplikaci.
static int GetCommandButtons(
UINT uiCmd,
CObList& listButtons);
Parametry
uiCmd
[v] ID příkazu tlačítek.
listButtons
[ven] Odkaz na CObList
objekt Třídy , který obdrží seznam tlačítek panelu nástrojů.
Návratová hodnota
Počet tlačítek, která mají zadané ID příkazu.
CMFCToolBar::GetCount
Vrátí počet tlačítek a oddělovačů na panelu nástrojů.
int GetCount() const;
Návratová hodnota
Počet tlačítek a oddělovačů na panelu nástrojů
CMFCToolBar::GetCustomizeButton
Načte ukazatel na CMFCCustomizeButton
objekt přidružený k panelu nástrojů.
CMFCCustomizeButton* GetCustomizeButton();
Návratová hodnota
Ukazatel na CMFCCustomizeButton
objekt přidružený k panelu nástrojů.
Poznámky
Tato metoda načte tlačítko Přizpůsobit , které se zobrazí na konci panelu nástrojů. CMFCToolBar::EnableCustomizeButton
Pomocí metody přidejte tlačítko Přizpůsobit na panel nástrojů.
Můžete volat metodu CMFCToolBar::IsExistCustomizeButton
určit, zda panel nástrojů obsahuje platný CMFCCustomizeButton
objekt.
CMFCToolBar::GetDefaultImage
Vrátí index výchozího obrázku pro tlačítko panelu nástrojů se zadaným ID příkazu.
static int GetDefaultImage(UINT uiID);
Parametry
uiID
[v] Určuje ID příkazu tlačítka.
Návratová hodnota
Index obrázku panelu nástrojů ve sdíleném seznamu obrázků.
Poznámky
Pomocí této sdílené metody načtěte index výchozího obrázku pro tlačítko panelu nástrojů se zadaným ID příkazu. Návratová hodnota je index do sdílené kolekce obrázků tlačítek panelu nástrojů pro všechny panely nástrojů v aplikaci. CMFCToolBar::GetImages
Voláním metody získejte ukazatel na tuto kolekci.
CMFCToolBar::GetDisabledImages
Vrátí ukazatel na kolekci obrázků, které se používají pro zakázaná tlačítka panelu nástrojů v aplikaci.
static CMFCToolBarImages* __stdcall GetDisabledImages();
Návratová hodnota
Ukazatel na kolekci zakázaných obrázků tlačítek panelu nástrojů.
Poznámky
Obrázky tlačítek zakázaného panelu nástrojů načtěte pomocí CMFCToolBarEditBoxButton
třídy a CMFCToolBar::LoadBitmap
metod.
CMFCToolBar::GetDisabledMenuImages
Vrátí ukazatel na kolekci obrázků, které se používají pro zakázaná tlačítka nabídek v aplikaci.
static CMFCToolBarImages* __stdcall GetDisabledMenuImages();
Návratová hodnota
Ukazatel na kolekci zakázaných obrázků nabídek.
Poznámky
Načtěte zakázané obrázky pomocí CMFCToolBarEditBoxButton
metody Class .
CMFCToolBar::GetDroppedDownMenu
Načte ukazatel na objekt tlačítka nabídky, který aktuálně zobrazuje jeho dílčí nabídku.
CMFCToolBarMenuButton* GetDroppedDownMenu(int* pIndex = NULL) const;
Parametry
pIndex
[ven] Přijme index tlačítka v kolekci tlačítek na panelu nástrojů.
Návratová hodnota
Ukazatel na objekt tlačítka nabídky, který zobrazuje jeho dílčí nabídku nebo NULL
pokud žádná nabídka nezobrazuje její dílčí nabídku.
Poznámky
Pokud tato metoda vrátí hodnotu, která není null a pIndex
není NULL
, hodnota, na kterou pIndex
odkazuje, je nastavena na index tlačítka nabídky v kolekci tlačítek panelu nástrojů.
CMFCToolBar::GetGrayDisabledButtons
Určuje, jestli jsou obrázky zakázaných tlačítek neaktivní verze běžných obrázků tlačítek nebo pořízené z kolekce zakázaných obrázků tlačítek.
BOOL GetGrayDisabledButtons() const;
Návratová hodnota
TRUE
ztlumení obrázků zakázaných tlačítek; FALSE
získat obrázky z kolekce zakázaných imagí.
Poznámky
Slouží CMFCToolBar::SetGrayDisabledButtons
k přepínání mezi neaktivními obrázky a obrázky z kolekce zakázaných obrázků.
CMFCToolBar::GetHighlightedButton
Vrátí ukazatel na tlačítko panelu nástrojů, které je aktuálně zvýrazněné.
CMFCToolBarButton* GetHighlightedButton() const;
Návratová hodnota
Ukazatel na objekt tlačítka panelu nástrojů; nebo NULL
pokud není zvýrazněné žádné tlačítko.
Poznámky
Tlačítko panelu nástrojů je zvýrazněné, pokud má fokus klávesnice. Tlačítko panelu nástrojů je zvýrazněné také v případě, že jsou tlačítka panelu nástrojů v této aplikaci s horkým sledováním (další informace, viz CMFCToolBar::GetHotBorder
a CMFCToolBar::SetHotBorder
) a myš na ni ukazuje, když tlačítko panelu nástrojů nebo položka nabídky nemají fokus klávesnice.
CMFCToolBar::GetHotBorder
Určuje, zda jsou tlačítka panelu nástrojů sledována. Pokud je tlačítko s horkým sledováním, je zvýrazněné, když se přes něj přesune myš.
BOOL GetHotBorder() const;
Návratová hodnota
TRUE
pokud jsou tlačítka panelu nástrojů s horkým sledováním; v opačném případě . FALSE
Poznámky
Ve výchozím nastavení jsou tlačítka panelu nástrojů s horkým sledováním.
CMFCToolBar::GetHotTextColor
Vrátí barvu textu zvýrazněných tlačítek panelu nástrojů.
static COLORREF GetHotTextColor();
Návratová hodnota
Hodnota COLORREF
, která představuje aktuální zvýrazněnou barvu textu.
Poznámky
Volání CMFCToolBar::SetHotTextColor
pro nastavení nové barvy textu pro zvýrazněná tlačítka panelu nástrojů
CMFCToolBar::GetHwndLastFocus
Vrátí popisovač do okna, které mělo fokus vstupu těsně před panelem nástrojů.
HWND GetHwndLastFocus() const;
Návratová hodnota
Popisovač okna, který není odvozený z CMFCBaseToolBar
třídy, který dříve měl vstupní fokus, nebo NULL
pokud takové okno neexistuje.
Poznámky
CMFCToolBar
Když ovládací prvek obdrží vstupní fokus, uloží popisovač do okna, které ztratilo fokus, aby ho bylo možné později obnovit.
CMFCToolBar::GetIgnoreSetText
Určuje, jestli se budou ignorovat volání pro nastavení popisků tlačítek.
BOOL GetIgnoreSetText() const;
Návratová hodnota
TRUE
pokud jsou volání k nastavení popisků tlačítek ignorována; v opačném případě . FALSE
Poznámky
CMFCToolBar::GetImages
Vrátí ukazatel na kolekci výchozích obrázků tlačítek v aplikaci.
static CMFCToolBarImages* GetImages();
Návratová hodnota
Ukazatel na CMFCToolBarImages
objekt Class , který obsahuje kolekci výchozích obrázků pro všechny panely nástrojů v aplikaci.
Poznámky
Tato sdílená metoda poskytuje přístup ke kolekci všech výchozích obrázků panelu nástrojů pro aplikaci. CMFCToolBar::LoadBitmap
Volání metody pro přidání obrázků do kolekce.
CMFCToolBar::GetImageSize
Vrátí aktuální velikost obrázků tlačítek panelu nástrojů.
CSize GetImageSize() const;
Návratová hodnota
A CSize
Class object that represent the current size of toolbar button images.
CMFCToolBar::GetImagesOffset
Vrátí posun indexu použitý k vyhledání obrázků tlačítek panelu nástrojů pro tento panel nástrojů v globálním seznamu obrázků tlačítek panelu nástrojů.
int GetImagesOffset() const;
Návratová hodnota
Posun indexu obrázků panelu nástrojů.
Poznámky
Všechny výchozí obrázky panelu nástrojů jsou uložené v globálním CMFCToolBarImages
seznamu tříd . Obrázky pro každé tlačítko na panelu nástrojů jsou v seznamu uloženy po sobě jdoucí. Pokud chcete vypočítat index obrázku, přidejte index tlačítka na panelu nástrojů na posun začátku seznamu obrázků pro toto tlačítko panelu nástrojů.
Volání CMFCToolBar::ButtonToIndex
pro získání indexu tlačítka panelu nástrojů s ukazatelem na tlačítko
Volání CMFCToolBar::GetImages
pro získání ukazatele na kolekci obrázků na panelu nástrojů
CMFCToolBar::GetInvalidateItemRect
Načte oblast klientské oblasti, která musí být překreslena pro tlačítko v daném indexu.
virtual void GetInvalidateItemRect(
int nIndex,
LPRECT lpRect) const;
Parametry
nIndex
[v] Index tlačítka, pro které se má načíst oblast klienta.
lpRect
[ven] Ukazatel na RECT
objekt, který přijímá oblast klientské oblasti.
Poznámky
Parametr lpRect
nesmí být NULL
. Pokud v zadaném indexu neexistuje žádné tlačítko, obdrží objekt, lpRect
který je inicializován na nulu RECT
.
CMFCToolBar::GetItemID
Vrátí ID příkazu tlačítka panelu nástrojů v zadaném indexu.
UINT GetItemID(int nIndex) const;
Parametry
nIndex
[v] Určuje index tlačítka panelu nástrojů.
Návratová hodnota
ID příkazu tlačítka panelu nástrojů; nebo nulu, pokud tlačítko se zadaným indexem neexistuje.
CMFCToolBar::GetItemRect
Vrátí ohraničující obdélník tlačítka v zadaném indexu.
virtual void GetItemRect(
int nIndex,
LPRECT lpRect) const;
Parametry
nIndex
[v] Určuje index tlačítka panelu nástrojů.
lpRect
[ven] Ukazatel na CRect
objekt, který přijímá souřadnice obdélníku ohraničujícího obrázek.
Poznámky
Objekt CRect
, na který lpRect
je nastaven na hodnotu 0, pokud tlačítko v zadaném indexu neexistuje.
Příklad
Následující příklad ukazuje, jak použít GetItemRect
metodu CMFCToolBar
třídy. Tento fragment kódu je součástí ukázky IE Demo.
CMFCToolBar m_wndToolBar;
CRect rectToolBar;
m_wndToolBar.GetItemRect(0, &rectToolBar);
CMFCToolBar::GetLargeColdImages
Vrátí ukazatel na kolekci velkých obrázků tlačítek studeného panelu nástrojů v aplikaci.
static CMFCToolBarImages* GetLargeColdImages();
Návratová hodnota
Ukazatel na kolekci velkýchstudených
Poznámky
Studené obrázky jsou obrázky, které se používají, když uživatel nepracuje s tlačítky panelu nástrojů. Volání CMFCToolBar::LoadBitmapEx
pro načtení velkých studených obrázků
CMFCToolBar::GetLargeDisabledImages
Vrátí ukazatel na kolekci velkých zakázaných obrázků tlačítek panelu nástrojů v aplikaci.
static CMFCToolBarImages* GetLargeDisabledImages();
Návratová hodnota
Ukazatel na kolekci velkých zakázaných obrázků tlačítek panelu nástrojů
Poznámky
Velké obrázky jsou velké verze běžných obrázků tlačítek panelu nástrojů. Volání CMFCToolBar::LoadBitmapEx
nebo CMFCToolBar::LoadBitmap
načtení velkých obrázků
CMFCToolBar::GetLargeImages
Vrátí ukazatel na kolekci velkých obrázků tlačítek panelu nástrojů v aplikaci.
static CMFCToolBarImages* GetLargeImages();
Návratová hodnota
Ukazatel na kolekci velkých obrázků tlačítek panelu nástrojů.
Poznámky
Velké obrázky jsou velké verze běžných obrázků tlačítek panelu nástrojů. Volání CMFCToolBar::LoadBitmapEx
pro načtení velkých imagí
CMFCToolBar::GetLockedColdImages
Vrátí ukazatel na kolekci uzamčených studených obrázků na panelu nástrojů.
CMFCToolBarImages* GetLockedColdImages();
Návratová hodnota
Ukazatel na kolekci uzamčených studených obrázků nebo NULL
pokud panel nástrojů není uzamčený.
Poznámky
Uzamčené obrázky jsou verze běžných obrázků tlačítek panelu nástrojů, které architektura používá, když uživatel nemůže přizpůsobit panel nástrojů. Studené obrázky jsou obrázky, které se používají, když uživatel nepracuje s tlačítky panelu nástrojů.
Tato metoda vrátí NULL
, pokud panel nástrojů není uzamčen. Tato metoda také vygeneruje chybu kontrolního výrazu v sestavení ladění, pokud panel nástrojů není uzamčen. Další informace o uzamčených panelech nástrojů naleznete v tématu CMFCToolBar::IsLocked
.
Zavolejte metodu CMFCToolBar::LoadBitmapEx
pro načtení uzamčených studených obrázků.
CMFCToolBar::GetLockedDisabledImages
Vrátí ukazatel na kolekci uzamčených zakázaných obrázků na panelu nástrojů.
CMFCToolBarImages* GetLockedDisabledImages();
Návratová hodnota
Ukazatel na kolekci uzamčených zakázaných obrázků nebo NULL
pokud panel nástrojů není uzamčen.
Poznámky
Uzamčené obrázky jsou verze běžných obrázků tlačítek panelu nástrojů, které architektura používá, když uživatel nemůže přizpůsobit panel nástrojů. Zakázané obrázky jsou obrázky, které architektura používá, když má TBBS_DISABLED
tlačítko styl.
Tato metoda vrátí NULL
, pokud panel nástrojů není uzamčen. Tato metoda také vygeneruje chybu kontrolního výrazu v sestavení ladění, pokud panel nástrojů není uzamčen. Další informace o uzamčených panelech nástrojů naleznete v tématu CMFCToolBar::IsLocked
.
CMFCToolBar::LoadBitmapEx
Voláním metody načtěte uzamčené zakázané obrázky.
CMFCToolBar::GetLockedImages
Vrátí ukazatel na kolekci obrázků uzamčených tlačítek na panelu nástrojů.
CMFCToolBarImages* GetLockedImages();
Návratová hodnota
Ukazatel na kolekci obrázků tlačítek uzamčeného panelu nástrojů nebo NULL
pokud panel nástrojů není uzamčený.
Poznámky
Uzamčené obrázky jsou verze běžných obrázků tlačítek panelu nástrojů, které architektura používá, když uživatel nemůže přizpůsobit panel nástrojů.
Tato metoda vrátí NULL
, pokud panel nástrojů není uzamčen. Tato metoda také vygeneruje chybu kontrolního výrazu v sestavení ladění, pokud panel nástrojů není uzamčen. Další informace o uzamčených panelech nástrojů naleznete v tématu CMFCToolBar::IsLocked
.
CMFCToolBar::GetLockedImageSize
Vrátí výchozí velikost uzamčených obrázků panelu nástrojů.
CSize GetLockedImageSize() const;
Návratová hodnota
Struktura CSize
, která určuje velikost uzamčených obrázků panelu nástrojů nebo prázdné CSize
struktury, pokud panel nástrojů není uzamčen.
Poznámky
Uzamčené obrázky jsou verze běžných obrázků tlačítek panelu nástrojů, které architektura používá, když uživatel nemůže přizpůsobit panel nástrojů.
Tato metoda vrátí strukturu s nulovou šířkou CSize
a nulovou výškou, pokud panel nástrojů není uzamčen. Tato metoda také vygeneruje chybu kontrolního výrazu v sestavení ladění, pokud panel nástrojů není uzamčen. Další informace o uzamčených panelech nástrojů naleznete v tématu CMFCToolBar::IsLocked
.
Zavolejte metodu CMFCToolBar::SetLockedSizes
, která určuje zamknutou velikost obrázku.
CMFCToolBar::GetLockedMenuImages
Vrátí ukazatel na kolekci obrázků nabídek uzamčených panelů nástrojů na panelu nástrojů.
CMFCToolBarImages* GetLockedMenuImages();
Návratová hodnota
Ukazatel na kolekci obrázků nabídek uzamčeného panelu nástrojů nebo NULL
pokud panel nástrojů není uzamčený.
Poznámky
Uzamčené obrázky jsou verze běžných obrázků nabídek panelu nástrojů, které architektura používá, když uživatel nemůže přizpůsobit panel nástrojů.
Tato metoda vrátí NULL
, pokud panel nástrojů není uzamčen. Tato metoda také vygeneruje chybu kontrolního výrazu v sestavení ladění, pokud panel nástrojů není uzamčen. Další informace o uzamčených panelech nástrojů naleznete v tématu CMFCToolBar::IsLocked
.
CMFCToolBar::LoadBitmapEx
Voláním metody načtěte obrázky uzamčených nabídek.
CMFCToolBar::GetMenuButtonSize
Vrátí velikost tlačítek nabídky v aplikaci.
static CSize GetMenuButtonSize();
Návratová hodnota
Objekt CSize
, který představuje velikost tlačítek nabídky v pixelech.
Poznámky
Velikost tlačítek nabídky na panelech nástrojů je zachována jako globální proměnná a lze ji načíst touto statickou metodou.
Volání CMFCToolBar::SetMenuSizes
pro nastavení této globální proměnné
CMFCToolBar::GetMenuImages
Vrátí ukazatel na kolekci obrázků tlačítek nabídky v aplikaci.
static CMFCToolBarImages* GetMenuImages();
Návratová hodnota
Ukazatel na kolekci obrázků nabídek.
Poznámky
CMFCToolBar::LoadBitmapEx
Voláním metody načtěte obrázky nabídek.
CMFCToolBar::SetMenuSizes
Zavoláním metody nastavíte velikost tlačítek a jejich obrázků.
CMFCToolBar::GetMenuImageSize
Vrátí velikost obrázků tlačítek nabídky v aplikaci.
static CSize GetMenuImageSize();
Návratová hodnota
Objekt CSize
, který představuje velikost obrázků nabídky.
Poznámky
Tato metoda vrátí velikost obrázků na tlačítkách nabídek na panelu nástrojů, která jsou zachována jako globální proměnná. Volání CMFCToolBar::SetMenuSizes
pro nastavení této globální proměnné
CMFCToolBar::GetOrigButtons
Načte kolekci nespravovaných tlačítek panelu nástrojů.
const CObList& GetOrigButtons() const;
Návratová hodnota
Odkaz na seznam neupravovaných tlačítek na panelu nástrojů.
Poznámky
Architektura vytvoří kopii tlačítek panelu nástrojů před tím, než je uživatel přizpůsobí. Metoda CMFCToolBar::SetButtons
přidá kopii každého tlačítka v zadaném poli do seznamu původních tlačítek. Metoda CMFCToolBar::RestoreOriginalState
obnoví původní stav panelu nástrojů načtením ze souboru prostředků.
Chcete-li nastavit seznam původních tlačítek pro panel nástrojů, zavolejte metodu CMFCToolBar::SetOrigButtons
.
CMFCToolBar::GetOrigResetButtons
Načte kolekci neupravovaných tlačítek pro resetování panelu nástrojů.
const CObList& GetOrigResetButtons() const;
Návratová hodnota
Odkaz na seznam neupravovaných tlačítek pro resetování panelu nástrojů
Poznámky
Když uživatel vybere tlačítko Obnovit během režimu přizpůsobení, architektura používá tuto metodu k obnovení tlačítek, které byly odebrány z panelu nástrojů.
Metoda CMFCToolBar::SetButtons
přidá kopii každého tlačítka panelu nástrojů do seznamu původních tlačítek pro resetování po volání CMFCToolBar::OnReset
metody. Metodu CMFCToolBar::OnReset
můžete přepsat tak, aby se vzhled tlačítek přizpůsobil po stisknutí tlačítka Obnovit .
CMFCToolBar::GetResourceID
Načte ID prostředku panelu nástrojů.
UINT GetResourceID() const;
Návratová hodnota
ID prostředku panelu nástrojů.
Poznámky
CMFCToolBar::LoadToolBarEx
Voláním metody nastavte ID prostředku panelu nástrojů.
CMFCToolBar::GetRouteCommandsViaFrame
Určuje, který objekt, nadřazený rámec nebo vlastník, odešle příkazy na panel nástrojů.
BOOL GetRouteCommandsViaFrame();
Návratová hodnota
Nenulové, pokud nadřazený rámec odesílá příkazy na panel nástrojů; 0, pokud vlastník odešle příkazy na panel nástrojů.
Poznámky
Ve výchozím nastavení nadřazený rámec odesílá příkazy na panel nástrojů. Volání CMFCToolBar::SetRouteCommandsViaFrame
ke změně tohoto chování
Pokud tato metoda vrátí nenulovou hodnotu, můžete pomocí metody načíst ukazatel na nadřazený objekt CMFCToolBar::GetCommandTarget
rámce. Příklad, který používá tuto metodu, najdete v ukázce VisualStudioDemo.
CMFCToolBar::GetRowHeight
Vrátí výšku tlačítek panelu nástrojů.
virtual int GetRowHeight() const;
Návratová hodnota
Výška tlačítek panelu nástrojů v pixelech
Poznámky
Architektura volá tuto metodu pro výpočet rozložení panelu nástrojů. Přepsat tuto metodu v odvozené třídě určit jinou výšku panelu nástrojů.
CMFCToolBar::GetShowTooltips
Určuje, jestli jsou u tlačítek panelu nástrojů zobrazeny popisky nástrojů.
static BOOL GetShowTooltips();
Návratová hodnota
TRUE
pokud jsou zobrazeny tipy pro tlačítka panelu nástrojů; jinak FALSE
.
Poznámky
Ve výchozím nastavení se zobrazují tipy pro nástroje. Tento statický příznak můžete změnit voláním CMFCToolBar::SetShowTooltips
.
CMFCToolBar::GetSiblingToolBar
Načte na stejné straně panelu nástrojů.
CMFCToolBar* GetSiblingToolBar();
Návratová hodnota
Ukazatel na panel nástrojů na stejné straně
Poznámky
Další informace o tom, jak povolit tlačítka zobrazit na jednom řádku a zobrazit tlačítka na dvou řádcích , naleznete v tématu CMFCToolBar::SetSiblingToolBar
.
CMFCToolBar::GetUserImages
Vrátí ukazatel na kolekci obrázků tlačítek panelu nástrojů definovaných uživatelem v aplikaci.
static CMFCToolBarImages* GetUserImages();
Návratová hodnota
Ukazatel na kolekci obrázků tlačítek panelu nástrojů definovaných uživatelem pro všechny panely nástrojů v aplikaci.
Poznámky
Zavolejte metodu CMFCToolBar::SetUserImages
, která nastaví kolekci uživatelsky definovaných obrázků v aplikaci.
CMFCToolBar::HitTest
Vrátí index tlačítka panelu nástrojů umístěného na zadané pozici.
virtual int HitTest(CPoint point);
Parametry
point
[v] Bod, který se má testovat, v souřadnicích klienta.
Návratová hodnota
Index tlačítka umístěného na zadané pozici nebo -1, pokud takové tlačítko neexistuje nebo tlačítko je oddělovač.
CMFCToolBar::InsertButton
Vloží tlačítko na panel nástrojů.
virtual int InsertButton(
const CMFCToolBarButton& button,
INT_PTR iInsertAt=-1);
virtual int InsertButton(
CMFCToolBarButton* pButton,
int iInsertAt=-1);
Parametry
button
[v] Určuje tlačítko, které chcete vložit.
iInsertAt
[v] Určuje pozici založenou na nule, na které se má tlačítko vložit.
Návratová hodnota
Pozice, na které bylo tlačítko vloženo, nebo -1, pokud dojde k chybě.
Poznámky
Pokud iInsertAt
je -1, tato metoda přidá tlačítko na konec seznamu tlačítek panelu nástrojů.
CMFCToolBar::InsertSeparator
Voláním metody vložte oddělovač do panelu nástrojů.
CMFCToolBar::InsertSeparator
Vloží oddělovač na panel nástrojů.
virtual int InsertSeparator(INT_PTR iInsertAt=-1);
Parametry
iInsertAt
[v] Určuje pozici založenou na nule, do které se má vložit oddělovač. Tento parametr musí být větší než 0.
Návratová hodnota
Pozice, ve které byl oddělovač vložen, nebo -1, pokud dojde k chybě.
Poznámky
Voláním této metody vložíte oddělovač mezi dvě existující tlačítka. Pokud iInsertAt
je -1, tato metoda přidá oddělovač na konec seznamu tlačítek panelu nástrojů.
Tuto metodu nelze použít k přidání oddělovače na prázdný panel nástrojů.
CMFCToolBar::InsertButton
Voláním metody vložíte tlačítko na panel nástrojů.
CMFCToolBar::InvalidateButton
Zneplatní klientskou oblast tlačítka panelu nástrojů, která existuje v zadaném indexu.
CMFCToolBarButton* InvalidateButton(int nIndex);
Parametry
nIndex
[v] Index tlačítka založený na nule na panelu nástrojů.
Návratová hodnota
Ukazatel na CMFCToolBarButton
objekt, který existuje v zadaném indexu nebo NULL
pokud takový objekt neexistuje.
Poznámky
Architektura volá tuto metodu, když aktualizuje klientskou oblast přidruženou k tlačítku panelu nástrojů. Volá metodu CWnd::InvalidateRect
s klientským obdélníkem objektu CMFCToolBarButton
, který existuje v zadaném indexu.
CMFCToolBar::IsAddRemoveQuickCustomize
Určuje, zda uživatel může přidat nebo odebrat tlačítka panelu nástrojů pomocí možnosti Přizpůsobit nabídku.
BOOL IsAddRemoveQuickCustomize();
Návratová hodnota
TRUE
pokud uživatel může použít možnost Přizpůsobit nabídku k úpravě panelu nástrojů; jinak . FALSE
Poznámky
CMFCToolBar::IsAltCustomizeMode
Určuje, jestli se k přetažení tlačítka používá rychlé přizpůsobení . Když je povolené rychlé přizpůsobení, může uživatel stisknout a podržet klávesu Alt a přetáhnout tlačítko na nové místo.
static BOOL __stdcall IsAltCustomizeMode();
Návratová hodnota
TRUE
pokud se k přetažení tlačítka používá rychlé přizpůsobení; v opačném případě . FALSE
Poznámky
CMFCToolBar::IsAutoGrayInactiveImages
Určuje, jestli je povolené automatické generování neaktivních (nezvýrazněných) obrázků tlačítek.
static BOOL IsAutoGrayInactiveImages();
Návratová hodnota
TRUE
pokud je povolená možnost automatického ztlumení neaktivních obrázků; jinak FALSE
.
Poznámky
Automatické zašednutí neaktivních obrázků můžete povolit nebo zakázat voláním CMFCToolBar::AutoGrayInactiveImages
.
CMFCToolBar::IsBasicCommand
Určuje, zda je příkaz v seznamu základních příkazů.
static BOOL IsBasicCommand(UINT uiCmd);
Parametry
uiCmd
[v] Určuje příkaz, který se má zkontrolovat.
Návratová hodnota
TRUE
pokud zadaný příkaz patří do seznamu základních příkazů; jinak FALSE
.
Poznámky
Tato statická metoda určuje, zda příkaz určený uiCmd
patří do globálního seznamu základních příkazů. Seznam základních příkazů můžete změnit voláním CMFCToolBar::AddBasicCommand
nebo CMFCToolBar::SetBasicCommands
.
CMFCToolBar::IsButtonExtraSizeAvailable
Určuje, zda panel nástrojů může zobrazovat tlačítka s rozšířenými ohraničeními.
virtual BOOL IsButtonExtraSizeAvailable() const;
Návratová hodnota
TRUE
pokud pruh může zobrazit tlačítka s dodatečnou velikostí ohraničení; jinak FALSE
.
Poznámky
Objekt panelu nástrojů se vrátí TRUE
, pokud může zobrazit tlačítka s rozšířenými ohraničeními. Tlačítko panelu nástrojů volá tuto metodu CMFCToolBarButton::OnChangeParentWnd
, když zpracovává oznámení a odpovídajícím způsobem nastaví příznak vnitřní velikosti ohraničení. Tento interní příznak může být načten později voláním CMFCToolBarButton::IsExtraSize
.
Přepsat tuto metodu ve třídě odvozené z CMFCToolBar
a vrátit TRUE
, pokud panel může zobrazit tlačítka panelu nástrojů s extra velikost ohraničení a vrátit FALSE
jinak. Výchozí implementace vrátí TRUE
.
CMFCToolBar::IsButtonHighlighted
Určuje, zda je zadané tlačítko zvýrazněno.
BOOL IsButtonHighlighted(int iButton) const;
Parametry
iButton
[v] Určuje index tlačítka panelu nástrojů.
Návratová hodnota
TRUE
je-li zadané tlačítko zvýrazněno; v opačném případě . FALSE
Poznámky
CMFCToolBar::IsCommandPermitted
Určuje, zda je příkaz povolen.
static BOOL IsCommandPermitted(UINT uiCmd);
Parametry
uiCmd
[v] Určuje příkaz, který se má zkontrolovat.
Návratová hodnota
TRUE
je-li zadaný příkaz povolen; jinak FALSE
.
Poznámky
Tato statická metoda určuje, zda příkaz určený uiCmd
patří do globálního seznamu nepovolených příkazů.
Seznam nepovolených příkazů můžete změnit voláním CMFCToolBar::SetNonPermittedCommands
.
CMFCToolBar::IsCommandRarelyUsed
Určuje, jestli se příkaz používá zřídka.
static BOOL IsCommandRarelyUsed(UINT uiCmd);
Parametry
uiCmd
[v] Určuje příkaz, který se má zkontrolovat.
Návratová hodnota
TRUE
je-li zadaný příkaz používán zřídka; jinak FALSE
.
Poznámky
Metoda IsCommandRarelyUsed
vrátí FALSE
, když dojde k jedné nebo několika z následujících podmínek:
Zadaný příkaz patří do seznamu základních příkazů.
Zadaný příkaz je jedním ze standardních příkazů.
Architektura je v režimu přizpůsobení.
Seznam základních příkazů je prázdný.
Více než 20 % volání příkazů je volání zadaného příkazu.
CMFCToolBar::IsCustomizeMode
Určuje, jestli je architektura panelu nástrojů v režimu přizpůsobení.
static BOOL IsCustomizeMode();
Návratová hodnota
TRUE
pokud je architektura v režimu přizpůsobení; jinak FALSE
.
Poznámky
Režim přizpůsobení můžete přepnout voláním CMFCToolBar::SetCustomizeMode
.
Architektura změní režim, když uživatel vyvolá dialogové okno přizpůsobení ( CMFCToolBarsCustomizeDialog
třída).
CMFCToolBar::IsDragButton
Určuje, zda je tlačítko panelu nástrojů přetaženo.
BOOL IsDragButton(const CMFCToolBarButton* pButton) const;
Parametry
pButton
[v] Ukazatel na tlačítko panelu nástrojů
Návratová hodnota
TRUE
pokud je zadané tlačítko přetaženo; v opačném případě . FALSE
Poznámky
CMFCToolBar::IsExistCustomizeButton
Určuje, zda panel nástrojů obsahuje tlačítko Přizpůsobit .
BOOL IsExistCustomizeButton();
Návratová hodnota
TRUE
pokud panel nástrojů obsahuje tlačítko Přizpůsobit ; jinak FALSE
.
Poznámky
Pokud tato metoda vrátí TRUE
, CMFCToolBar::GetCustomizeButton
metoda vrátí ukazatel na tlačítko Přizpůsobit , které se zobrazí na konci panelu nástrojů.
CMFCToolBar::EnableCustomizeButton
Pomocí metody přidejte tlačítko Přizpůsobit na panel nástrojů.
CMFCToolBar::IsFloating
Určuje, zda je panel nástrojů plovoucí.
virtual BOOL IsFloating() const;
Návratová hodnota
TRUE
pokud je panel nástrojů plovoucí; v opačném případě . FALSE
CMFCToolBar::IsLargeIcons
Určuje, zda panely nástrojů v aplikaci aktuálně zobrazují velké ikony.
static BOOL IsLargeIcons();
Návratová hodnota
TRUE
pokud aplikace používá velké ikony; jinak FALSE
.
Poznámky
Volání CMFCToolBar::SetLargeIcons
pro přepínání mezi velkými ikonami a běžnými ikonami
Architektura automaticky změní režim, když uživatel přepíná zaškrtávací políčko Velké ikony na stránce Možnosti dialogového okna Vlastní nastavení .
CMFCToolBar::IsLastCommandFromButton
Určuje, zda byl naposledy proveden příkaz odeslán z zadaného tlačítka panelu nástrojů.
static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);
Parametry
pButton
[v] Ukazatel na tlačítko.
Návratová hodnota
TRUE
pokud byl poslední příkaz odeslán z tlačítka, které pButton
určuje; jinak FALSE
.
Poznámky
Tato metoda získá ukazatel na MSG
strukturu voláním CWnd::GetCurrentMessage
. Pak porovná HWND
tlačítko s MSG::lParam
členy a MSG::hwnd
určí, jestli bylo tlačítko zdrojem příkazu.
CMFCToolBar::IsLocked
Určuje, zda je panel nástrojů uzamčen.
BOOL IsLocked() const;
Návratová hodnota
TRUE
je-li panel nástrojů uzamčen; v opačném případě . FALSE
Poznámky
Tato metoda se vrátí TRUE
, když uživatel nemůže provádět úlohy přizpůsobení, jako je změna umístění tlačítek panelu nástrojů.
Uzamčené panely nástrojů používají samostatné seznamy obrázků. Další informace o těchto seznamech obrázků naleznete v tématu CMFCToolBar::LoadBitmapEx
.
CMFCToolBar::IsOneRowWithSibling
Určuje, zda je panel nástrojů a panel nástrojů na stejné stejné straně umístěn.
BOOL IsOneRowWithSibling();
Návratová hodnota
TRUE
pokud je panel nástrojů a jeho stejné umístění na stejném řádku; jinak FALSE
.
Poznámky
Metoda CMFCCustomizeButton::CreatePopupMenu
volá tuto metodu k určení, jak zobrazit přizpůsobit místní nabídku. Pokud tato metoda vrátí TRUE
, architektura zobrazí tlačítka Zobrazit tlačítka na jednom řádku tlačítko. V opačném případě se v rámci zobrazí tlačítko Zobrazit tlačítka na dvou řádcích .
Tuto metodu obvykle nemusíte používat. Pokud chcete povolit tlačítka Zobrazit tlačítka na jednom řádku nebo Zobrazit tlačítka na dvou řádcích, zavolejte CMFCToolBar::SetSiblingToolBar
.
CMFCToolBar::IsResourceChanged
virtual BOOL IsResourceChanged() const;
Návratová hodnota
Poznámky
CMFCToolBar::IsSibling
BOOL IsSibling();
Návratová hodnota
Poznámky
CMFCToolBar::IsUserDefined
Určuje, jestli je panel nástrojů definovaný uživatelem.
BOOL IsUserDefined() const;
Návratová hodnota
TRUE
pokud byl panel nástrojů vytvořen uživatelem; jinak FALSE
.
CMFCToolBar::LoadBitmap
Načte obrázky panelů nástrojů z prostředků aplikace.
virtual BOOL LoadBitmap(
UINT uiResID,
UINT uiColdResID=0,
UINT uiMenuResID=0,
BOOL bLocked=FALSE,
UINT uiDisabledResID=0,
UINT uiMenuDisabledResID=0);
Parametry
uiResID
[v] ID prostředku rastrového obrázku, který odkazuje na obrázky horkého panelu nástrojů.
uiColdResID
[v] ID prostředku rastrového obrázku, který odkazuje na obrázky studeného panelu nástrojů.
uiMenuResID
[v] ID prostředku rastrového obrázku, který odkazuje na běžné obrázky nabídek.
bLocked
[v] TRUE
k uzamčení panelu nástrojů; jinak FALSE
.
uiDisabledResID
[v] ID prostředku rastrového obrázku, který odkazuje na zakázané obrázky panelu nástrojů.
uiMenuDisabledResID
[v] ID prostředku rastrového obrázku, který odkazuje na obrázky zakázané nabídky.
Návratová hodnota
Nenulové, pokud je metoda úspěšná; jinak 0.
Poznámky
Metoda CMFCToolBar::LoadToolBarEx
volá tuto metodu pro načtení obrázků přidružených k panelu nástrojů. Tuto metodu přepište tak, aby prováděla vlastní načítání prostředků image.
LoadBitmapEx
Voláním metody načtěte další obrázky po vytvoření panelu nástrojů.
CMFCToolBar::LoadBitmapEx
virtual BOOL LoadBitmapEx(
CMFCToolBarInfo& params,
BOOL bLocked = FALSE);
Parametry
[v] params
[v] bLocked
\
Návratová hodnota
Poznámky
CMFCToolBar::LoadLargeIconsState
static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);
Parametry
[v] lpszProfileName
\
Návratová hodnota
Poznámky
CMFCToolBar::LoadParameters
Načte globální možnosti panelu nástrojů z registru Systému Windows.
static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);
Parametry
lpszProfileName
[v] Určuje relativní cestu klíče registru Systému Windows.
Návratová hodnota
Nenulové, pokud je metoda úspěšná; jinak 0.
Poznámky
Tato metoda načte globální parametry, jako je typ animace nabídky, styl stínu nabídky a zda se mají zobrazovat velké ikony z registru Systému Windows.
Metoda CWinAppEx::LoadState
volá tuto metodu jako součást procesu inicializace aplikace.
CMFCToolBar::LoadState
Načte informace o stavu panelu nástrojů z registru Systému Windows.
virtual BOOL LoadState(
LPCTSTR lpszProfileName=NULL,
int nIndex=-1,
UINT uiID=(UINT)-1);
Parametry
lpszProfileName
[v] Určuje relativní cestu klíče registru Systému Windows.
nIndex
[v] Určuje ID ovládacího prvku panelu nástrojů.
uiID
[v] Určuje ID prostředku panelu nástrojů.
Návratová hodnota
Nenulové, pokud je metoda úspěšná; jinak 0.
Poznámky
Architektura volá tuto metodu jako součást procesu inicializace aplikace. Další informace najdete na webu CWinAppEx::LoadState
.
CMFCToolBar::LoadToolBar
Načte panel nástrojů z prostředků aplikace.
virtual BOOL LoadToolBar(
UINT uiResID,
UINT uiColdResID=0,
UINT uiMenuResID=0,
BOOL bLocked=FALSE,
UINT uiDisabledResID=0,
UINT uiMenuDisabledResID=0,
UINT uiHotResID=0);
Parametry
uiResID
[v] ID prostředku panelu nástrojů.
uiColdResID
[v] ID prostředku rastrového obrázku, který odkazuje na obrázky studeného panelu nástrojů.
uiMenuResID
[v] ID prostředku rastrového obrázku, který odkazuje na běžné obrázky nabídek.
bLocked
[v] Logická hodnota, která určuje, zda je panel nástrojů uzamčen nebo ne. Pokud je TRUE
tento parametr, panel nástrojů je uzamčený. V opačném případě není panel nástrojů uzamčen.
uiDisabledResID
[v] ID prostředku rastrového obrázku, který odkazuje na zakázané obrázky panelu nástrojů.
uiMenuDisabledResID
[v] ID prostředku rastrového obrázku, který odkazuje na obrázky zakázané nabídky.
uiHotResID
[v] ID prostředku rastrového obrázku, který odkazuje na obrázky horkého panelu nástrojů.
Návratová hodnota
Nenulové, pokud je metoda úspěšná; jinak 0.
Poznámky
Architektura volá tuto metodu během inicializace k načtení obrázků přidružených k panelu nástrojů.
Příklad
Následující příklad ukazuje, jak použít metodu LoadToolBar
CMFCToolBar
ve třídě. Tento fragment kódu je součástí ukázky IE Demo.
CMFCToolBar m_wndToolBar;
// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
!m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
TRACE0("Failed to create toolbar\n");
return -1; // fail to create
}
CMFCToolBar::LoadToolBarEx
Načte panel nástrojů z prostředků aplikace pomocí CMFCToolBarInfo
pomocné třídy, aby aplikace mohla používat velké obrázky.
virtual BOOL LoadToolBarEx(
UINT uiToolbarResID,
CMFCToolBarInfo& params,
BOOL bLocked=FALSE);
Parametry
uiToolbarResID
[v] ID prostředku panelu nástrojů.
params
[v] Odkaz na CMFCToolBarInfo
objekt, který obsahuje ID prostředků pro obrázky panelu nástrojů.
bLocked
[v] Logická hodnota, která určuje, zda je panel nástrojů uzamčen nebo ne. Pokud je TRUE
tento parametr, panel nástrojů je uzamčený. V opačném případě není panel nástrojů uzamčen.
Návratová hodnota
Nenulové, pokud je metoda úspěšná; jinak 0.
Poznámky
Voláním této metody načtěte obrázky panelů nástrojů z prostředků aplikace.
CMFCToolBar::m_dblLargeImageRatio
Určuje poměr mezi rozměrem (výškou nebo šířkou) velkých obrázků a rozměrem běžných obrázků.
AFX_IMPORT_DATA static double m_dblLargeImageRatio;
Poznámky
Výchozí poměr je 2. Tuto hodnotu můžete změnit, aby byly velké obrázky panelů nástrojů větší nebo menší.
Tato architektura používá tento datový člen, pokud nezadáte sadu velkých imagí. Pokud například zadáte jenom sadu malých obrázků s velikostí 16 × 16 a chcete, aby velké obrázky měly velikost 24 × 24, nastavte tento datový člen na 1,5.
CMFCToolBar::NextMenu
virtual BOOL NextMenu();
Návratová hodnota
Poznámky
CMFCToolBar::OnBeforeRemoveButton
virtual BOOL OnBeforeRemoveButton(
CMFCToolBarButton* pButton,
DROPEFFECT dropEffect);
Parametry
pButton
[v] Nepoužitý.
dropEffect
[v] Nepoužitý.
Návratová hodnota
Poznámky
CMFCToolBar::OnChangeHot
Volá se rozhraním, když uživatel vybere tlačítko na panelu nástrojů.
virtual void OnChangeHot(int iHot);
Parametry
iHot
[v] Určuje index tlačítka panelu nástrojů, které je vybráno; nebo -1, pokud není vybráno tlačítko panelu nástrojů.
Poznámky
Tuto metodu přepište tak, aby zpracovávala oznámení, že uživatel vybral tlačítko na panelu nástrojů.
CMFCToolBar::OnChangeVisualManager
virtual void OnChangeVisualManager();
Poznámky
CMFCToolBar::OnFillBackground
Volá se rozhraním, ze CBasePane::DoPaint
které se vyplní pozadí panelu nástrojů.
virtual void OnFillBackground(CDC* pDC);
Parametry
pDC
[v] Ukazatel na kontext zařízení.
Poznámky
CMFCToolBar::DoPaint
volá tuto metodu, pokud bylo vyplněno pozadí panelu nástrojů. Výchozí implementace nic nedělá.
Přepsat tuto metodu nakreslit vlastní pozadí v odvozených třídách.
CMFCToolBar::OnGlobalFontsChanged
virtual void OnGlobalFontsChanged();
Poznámky
CMFCToolBar::OnReset
Obnoví panel nástrojů do původního stavu.
virtual void OnReset();
Poznámky
Přepsat tuto metodu pro zpracování oznámení o resetování panelu nástrojů.
Výchozí implementace nic nedělá. Přepsat OnReset
ve třídě odvozené z CMFCToolBar
doby, kdy panel nástrojů obsahuje fiktivní tlačítka, která musí být nahrazena, když se panel nástrojů vrátí do původního stavu.
CMFCToolBar::OnSetAccData
virtual BOOL OnSetAccData(long lVal);
Parametry
[v] lVal
\
Návratová hodnota
Poznámky
CMFCToolBar::OnSetDefaultButtonText
Obnoví text tlačítka panelu nástrojů do výchozího stavu.
virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);
Parametry
pButton
[v] Odkazuje na tlačítko, jehož text je nastavený.
Návratová hodnota
TRUE
pokud byl text úspěšně obnoven; jinak FALSE
.
Poznámky
Tuto metodu přepište tak, aby zpracovávala oznámení o změně textu tlačítka panelu nástrojů na výchozí hodnotu.
Výchozí implementace načte text tlačítka z prostředků aplikace.
CMFCToolBar::OnUserToolTip
Volá se rozhraním, když se bude zobrazovat popis tlačítka.
virtual BOOL OnUserToolTip(
CMFCToolBarButton* pButton,
CString& strTTText) const;
Parametry
pButton
[v] Odkazuje na tlačítko panelu nástrojů, pro které se má zobrazit popis.
strTTText
[ven] Odkaz na CString
objekt, který obdrží text popisu.
Návratová hodnota
TRUE
byla strTTText
vyplněna textem popisu, jinak FALSE
.
Poznámky
Rozhraní tuto metodu volá, když se bude zobrazovat popis tlačítka panelu nástrojů. Pokud OnUserToolTip
se vrátí TRUE
, architektura zobrazí popis, který obsahuje text vrácený OnUserToolTip
v strTTText
. V opačném případě obsahuje popisek text tlačítka.
Přepsání OnUserToolTip
úpravou popisků tlačítek na panelu nástrojů Výchozí volání CMFCToolBar::OnUserToolTip
implementace pro získání textu popisu.
CMFCToolBar::PrevMenu
virtual BOOL PrevMenu();
Návratová hodnota
Poznámky
CMFCToolBar::ProcessCommand
Publikuje WM_COMMAND
zprávu do okna, které vlastní panel nástrojů.
BOOL ProcessCommand(CMFCToolBarButton* pButton);
Parametry
pButton
[v] Ukazatel na tlačítko na panelu nástrojů
Návratová hodnota
Tato metoda by měla vždy vrátit TRUE
. MFC používá FALSE
hodnoty interně.
Poznámky
Tato metoda odešle WM_COMMAND
zprávu do okna, které vlastní panel nástrojů voláním CWnd::PostMessage
a předáním ID příkazu zadaného tlačítka jako parametru wParam
.
ON_COMMAND
Pomocí makra namapujte WM_COMMAND
zprávu na členovou funkci.
CMFCToolBar::RemoveAllButtons
Odebere všechna tlačítka a oddělovače z panelu nástrojů.
virtual void RemoveAllButtons();
Poznámky
Architektura volá tuto metodu při opětovném vytvoření nebo zničení panelu nástrojů.
CMFCToolBar::RemoveButton
Odebere z panelu nástrojů tlačítko se zadaným indexem.
virtual BOOL RemoveButton(int iIndex);
Parametry
iIndex
[v] Určuje index tlačítka založený na nule, který se má odebrat.
Návratová hodnota
TRUE
pokud je metoda úspěšná nebo FALSE
pokud zadaný index je neplatný nebo index odkazuje na tlačítko Přizpůsobit .
Poznámky
Tato metoda aktualizuje další atributy panelu nástrojů, které jsou ovlivněny odebráním tlačítka. Tato metoda například odebere ze panelu nástrojů žádné zásadní oddělovače a znovu sestaví tabulku klávesových zkratek.
Další informace o tlačítku Přizpůsobit naleznete v tématu CMFCToolBar::EnableCustomizeButton
.
CMFCToolBar::RemoveStateFromRegistry
Odstraní informace o stavu panelu nástrojů z registru Systému Windows.
virtual BOOL RemoveStateFromRegistry(
LPCTSTR lpszProfileName=NULL,
int nIndex=-1,
UINT uiID=(UINT)-1);
Parametry
lpszProfileName
[v] Určuje klíč registru, ve kterém se nacházejí informace o stavu.
nIndex
[v] ID ovládacího prvku panelu nástrojů.
uiID
[v] ID prostředku panelu nástrojů. Pokud je tento parametr -1, tato metoda používá metodu CWnd::GetDlgCtrlID
k načtení ID prostředku.
Návratová hodnota
Nenulové, pokud je metoda úspěšná; jinak 0.
Poznámky
Architektura volá tuto metodu při odstranění uživatelem definovaného panelu nástrojů.
Tuto metodu přepište, pokud do registru Systému Windows uložíte další informace o stavu.
CMFCToolBar::ReplaceButton
Nahradí tlačítko panelu nástrojů jiným tlačítkem panelu nástrojů.
int ReplaceButton(
UINT uiCmd,
const CMFCToolBarButton& button,
BOOL bAll=FALSE);
Parametry
uiCmd
[v] ID příkazu tlačítka, které chcete nahradit.
button
[v] Odkaz na CMFCToolBarButton
vložení.
bAll
[v] Logická hodnota, která určuje, zda se mají nahradit všechna tlačítka, která mají ID příkazu určeného uiCmd
. Pokud je TRUE
tento parametr, nahradí se všechna tlačítka se zadaným ID příkazu. Jinak se první tlačítko nahradí.
Návratová hodnota
Počet nahrazených tlačítek. Tato metoda vrátí hodnotu 0, pokud na panelu nástrojů neexistuje tlačítko se zadaným ID příkazu.
Poznámky
Tuto metodu zavolejte, pokud chcete přidat tlačítka panelu nástrojů, která nelze načíst z prostředků. Při inicializaci panelu nástrojů můžete vytvořit zástupné tlačítko v době návrhu a nahradit ho vlastním tlačítkem. Příklad, který používá tuto metodu, najdete v ukázce VisualStudioDemo.
Příklad
Následující příklad ukazuje, jak použít metodu ReplaceButton
CMFCToolBar
ve třídě. Tento fragment kódu je součástí ukázky IE Demo.
CMFCToolBar m_wndToolBar;
// CMenu menuHistory
// CString str
m_wndToolBar.ReplaceButton(ID_GO_BACK,
CMFCToolBarMenuButton(ID_GO_BACK, menuHistory,
GetCmdMgr()->GetCmdImage(ID_GO_BACK), str));
CMFCToolBar::ResetAll
Obnoví všechny panely nástrojů do původního stavu.
static void __stdcall ResetAll();
Poznámky
Tato metoda volá metodu CMFCToolBar::RestoreOriginalState
na každém panelu nástrojů v aplikaci, kterou lze obnovit. Používá metodu CMFCToolBar::CanBeRestored
k určení, zda lze obnovit panel nástrojů.
CMFCToolBar::ResetAllImages
Vymaže všechny kolekce obrázků na panelu nástrojů v aplikaci.
static void __stdcall ResetAllImages();
Poznámky
Tato metoda vymaže kolekce obrázků, které jsou inicializovány metodami CMFCToolBar::LoadToolBar
a CMFCToolBar::LoadBitmap
metodami.
CMFCToolBar::ResetImages
virtual void ResetImages();
Poznámky
CMFCToolBar::RestoreFocus
virtual void RestoreFocus();
Poznámky
CMFCToolBar::RestoreOriginalState
Obnoví původní stav panelu nástrojů.
virtual BOOL RestoreOriginalState();
Návratová hodnota
TRUE
pokud je metoda úspěšná nebo FALSE
pokud metoda selže nebo je panel nástrojů definovaný uživatelem.
Poznámky
Tato metoda pomocí metody načte panel nástrojů ze souboru CMFCToolBar::LoadToolBar
prostředků.
Architektura volá tuto metodu, když uživatel zvolí tlačítko Obnovit vše na stránce panely nástrojů dialogového okna přizpůsobení.
CMFCToolBar::SaveParameters
static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);
Parametry
[v] lpszProfileName
\
Návratová hodnota
Poznámky
CMFCToolBar::SaveState
Uloží informace o stavu panelu nástrojů v registru Systému Windows.
virtual BOOL SaveState(
LPCTSTR lpszProfileName=NULL,
int nIndex=-1,
UINT uiID=(UINT)-1);
Parametry
lpszProfileName
[v] Určuje relativní cestu klíče registru Systému Windows.
nIndex
[v] ID ovládacího prvku panelu nástrojů.
uiID
[v] ID prostředku panelu nástrojů.
Návratová hodnota
Nenulové, pokud je metoda úspěšná; jinak 0.
Poznámky
Architektura volá tuto metodu, když uloží stav aplikace do registru. Další informace najdete na webu CWinAppEx::SaveState
.
CMFCToolBar::SetBasicCommands
Nastaví seznam příkazů, které se vždy zobrazí, když uživatel otevře nabídku.
static void __stdcall SetBasicCommands(CList<UINT,UINT>& lstCommands);
Parametry
lstCommands
[v] Odkaz na CList
objekt, který obsahuje kolekci příkazů.
Poznámky
Při otevření nabídky se vždy zobrazí základní příkaz. Tato metoda je smysluplná, když se uživatel rozhodne zobrazit nedávno použité příkazy.
CMFCToolBar::AddBasicCommand
Pomocí metody přidejte příkaz do seznamu základních příkazů. CMFCToolBar::GetBasicCommands
Pomocí této metody můžete načíst seznam základních příkazů, které vaše aplikace používá.
Příklad, který používá tuto metodu, najdete v ukázce Průzkumníka.
CMFCToolBar::SetButtonInfo
Nastaví ID příkazu, styl a ID obrázku tlačítka panelu nástrojů.
void SetButtonInfo(
int nIndex,
UINT nID,
UINT nStyle,
int iImage);
Parametry
nIndex
[v] Index tlačítka založený na nule, jehož vlastnosti jsou nastaveny.
nID
[v] ID příkazu tlačítka.
nStyle
[v] Styl tlačítka Seznam dostupných stylů tlačítek panelu nástrojů najdete v části Styly ovládacích prvků ToolBar.
iImage
[v] Index obrázku založeného na nule tlačítka (to znamená index v kolekci obrázků na panelu nástrojů).
Poznámky
Voláním této metody nastavíte vlastnosti tlačítka panelu nástrojů.
V ladění sestavení tato metoda generuje chybu kontrolního výrazu, pokud je index určený nIndex
neplatným.
CMFCToolBar::SetButtonStyle
Voláním metody nastavíte pouze styl tlačítka.
CMFCToolBar::SetButtons
Nastaví tlačítka pro panel nástrojů.
virtual BOOL SetButtons(
const UINT* lpIDArray,
int nIDCount,
BOOL bRemapImages=TRUE);
Parametry
lpIDArray
[v] Ukazatel na pole ID příkazů tlačítek, která se mají vložit.
nIDCount
[v] Počet položek v lpIDArray
.
bRemapImages
[v] Logická hodnota, která určuje, jestli chcete přidružit existující obrázky tlačítek k vloženým tlačítkům. Pokud je TRUE
tento parametr, obrázky se znovu namapují.
Návratová hodnota
Nenulové, pokud je metoda úspěšná; jinak 0.
Poznámky
Voláním této metody odeberete existující tlačítka z panelu nástrojů a vložíte kolekci nových tlačítek.
Tato metoda přidá tlačítko Přizpůsobit na panel nástrojů a odešle AFX_WM_RESETTOOLBAR
zprávu do nadřazeného okna panelu nástrojů. Další informace o tlačítku Přizpůsobit naleznete v tématu CMFCToolBar::EnableCustomizeButton
.
CMFCToolBar::SetButtonStyle
Nastaví styl tlačítka panelu nástrojů v daném indexu.
virtual void SetButtonStyle(
int nIndex,
UINT nStyle);
Parametry
nIndex
[v] Nulový index tlačítka panelu nástrojů, jehož styl se má nastavit.
nStyle
[v] Styl tlačítka Seznam dostupných stylů tlačítek panelu nástrojů najdete v části Styly ovládacích prvků ToolBar.
Poznámky
Tato metoda odebere TBBS_PRESSED
styl, pokud nStyle
je TBBS_DISABLED
to proto, že uživatel nemůže vybrat zakázané tlačítko.
CMFCToolBar::SetButtonText
Nastaví textový popisek tlačítka panelu nástrojů.
BOOL SetButtonText(
int nIndex,
LPCTSTR lpszText);
Parametry
nIndex
[v] Index tlačítka panelu nástrojů
lpszText
[v] Textový popisek tlačítka panelu nástrojů Musí být nenulová.
Návratová hodnota
TRUE
pokud je metoda úspěšná; jinak FALSE
.
Poznámky
Tato metoda vrátí FALSE
, pokud zadaný index neodkazuje na platné tlačítko panelu nástrojů.
CMFCToolBar::SetCommandUsageOptions
Určuje, kdy se zřídka používané příkazy nezobrazují v nabídce aplikace.
static BOOL SetCommandUsageOptions(
UINT nStartCount,
UINT nMinUsagePercentage=5);
Parametry
nStartCount
[v] Určuje, kolikrát musí být příkazy spuštěny před tím, než architektura zobrazí pouze základní a nedávno použité příkazy.
nMinUsagePercentage
[v] Procento času, po který musí být příkaz proveden, aby se považoval za nedávno použitý příkaz.
Návratová hodnota
FALSE
je-li nMinUsagePercentage
rovna nebo větší než 100; jinak TRUE
.
Poznámky
Voláním této metody můžete přizpůsobit algoritmus, který architektura používá k určení, jak se zobrazují základní a naposledy použité položky nabídky. Další informace o základníchpříkazch CMFCToolBar::AddBasicCommand
Tato třída používá CMFCCmdUsageCount
třídu ke sledování počtu použití příkazů. Další informace o této třídě naleznete v tématu CMFCCmdUsageCount
Třída.
CMFCToolBar::SetCustomizeMode
Povolí nebo zakáže režim přizpůsobení pro všechny panely nástrojů v aplikaci.
static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);
Parametry
bSet
[v] Logická hodnota, která určuje, jestli se má povolit nebo zakázat režim přizpůsobení. Nastavte tento parametr tak, aby TRUE
povolil režim přizpůsobení nebo FALSE
ho zakázal.
Návratová hodnota
TRUE
při volání této metody změní režim přizpůsobení; jinak FALSE
.
Poznámky
Tato metoda upraví rozložení a překreslí každý panel nástrojů v aplikaci. CMFCToolBar::IsCustomizeMode
Volání metody k určení, zda je aplikace v režimu přizpůsobení,
CMFCToolBar::SetGrayDisabledButtons
Určuje, jestli jsou nedostupná tlačítka na panelu nástrojů neaktivní nebo jestli se používají obrázky, které nejsou k dispozici.
void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);
Parametry
bGrayDisabledButtons
[v] Logická hodnota, která určuje, jak zobrazit nedostupná tlačítka. Pokud je TRUE
tento parametr, architektura ztlumí tlačítka. V opačném případě architektura používá kolekci imagí, které nejsou k dispozici.
Poznámky
Ve výchozím nastavení jsou nedostupná tlačítka neaktivní.
CMFCToolBar::SetHeight
Nastaví výšku panelu nástrojů.
void SetHeight(int cyHeight);
Parametry
cyHeight
[v] Výška panelu nástrojů v pixelech
Poznámky
Tato metoda překreslí panel nástrojů poté, co nastaví výšku.
CMFCToolBar::SetHelpMode
static void __stdcall SetHelpMode(BOOL bOn = TRUE);
Parametry
[v] bOn
\
Poznámky
CMFCToolBar::SetHot
BOOL SetHot(CMFCToolBarButton* pMenuButton);
Parametry
[v] pMenuButton
\
Návratová hodnota
Poznámky
CMFCToolBar::SetHotBorder
Určuje, jestli jsou tlačítka panelu nástrojů s horkým sledováním.
void SetHotBorder(BOOL bShowHotBorder);
Parametry
bShowHotBorder
[v] Logická hodnota, která určuje, jestli se mají tlačítka panelu nástrojů s teplou stopou. Pokud je TRUE
tento parametr, panel nástrojů sleduje jeho tlačítka za tepla. V opačném případě panel nástrojů nesleduje jeho tlačítka za horká.
Poznámky
Pokud je tlačítko s horkým sledováním, architektura tlačítko zvýrazní, když se přes něj přesune myš. Ve výchozím nastavení každý panel nástrojů sleduje svá tlačítka.
Zavolejte metodu CMFCToolBar::GetHotBorder
, abyste zjistili, jestli panel nástrojů sleduje jeho tlačítka.
CMFCToolBar::SetHotTextColor
Nastaví barvu textu pro tlačítka horkého panelu nástrojů.
static void SetHotTextColor(COLORREF clrText);
Parametry
clrText
[v] Určuje barvu textu pro tlačítka panelu nástrojů, která jsou sledována.
Poznámky
Další informace o tlačítkách panelu nástrojů s horkým sledováním naleznete CMFCToolBar::GetHotBorder
a CMFCToolBar::SetHotBorder
.
CMFCToolBar::SetIgnoreSetText
void SetIgnoreSetText(BOOL bValue);
Parametry
[v] bValue
\
Poznámky
CMFCToolBar::SetLargeIcons
Určuje, jestli tlačítka panelu nástrojů zobrazují velké ikony.
static void SetLargeIcons(BOOL bLargeIcons=TRUE);
Parametry
bLargeIcons
[v] Logická hodnota, která určuje, které ikony se mají použít. Pokud je TRUE
tento parametr, architektura zobrazí velké ikony. V opačném případě architektura zobrazuje běžné ikony.
Poznámky
Architektura volá tuto metodu, když uživatel změní stav velké ikony zaškrtávací políčko na kartě Možnosti dialogového okna Přizpůsobit . Tato metoda změní velikost všech panelů nástrojů v aplikaci.
Ve výchozím nastavení architektura zobrazuje běžné ikony.
Další informace o dialogovém okně Přizpůsobit naleznete v tématu CMFCToolBarsCustomizeDialog
Třída.
CMFCToolBar::SetLockedSizes
Nastaví velikosti uzamčených tlačítek a uzamčených obrázků na panelu nástrojů.
void SetLockedSizes(
SIZE sizeButton,
SIZE sizeImage,
BOOL bDontScale = FALSE);
Parametry
sizeButton
[v] Určuje velikost uzamčených tlačítek panelu nástrojů.
sizeImage
[v] Určuje velikost uzamčených obrázků panelu nástrojů.
bDontScale
Určuje, jestli se mají škálovat nebo neblokované obrázky panelů nástrojů v režimu vysokého DPI.
Poznámky
Výchozí velikost uzamčených tlačítek je 23x22 pixelů. Výchozí velikost uzamčených obrázků je 16 × 15 pixelů.
Zavoláním CMFCToolBar::GetLockedImageSize
metody načtěte velikost uzamčených obrázků. Zavolejte metodu CMFCToolBar::GetButtonSize
, která načte velikost uzamčených tlačítek panelu nástrojů.
CMFCToolBar::SetMaskMode
void SetMaskMode(BOOL bMasked);
Parametry
[v] bMasked
\
Poznámky
CMFCToolBar::SetMenuSizes
Nastaví velikost tlačítek nabídky panelu nástrojů a jejich obrázků.
static void __stdcall SetMenuSizes(
SIZE sizeButton,
SIZE sizeImage);
Parametry
sizeButton
[v] Určuje velikost tlačítek panelu nástrojů v pixelech.
sizeImage
[v] Určuje velikost obrázků na panelu nástrojů v pixelech.
Poznámky
Ve výchozím nastavení mají tlačítka nabídek a jejich obrázky nedefinovanou velikost.
Zavolejte metodu CMFCToolBar::GetMenuButtonSize
, která určuje velikost tlačítek nabídky a metodu CMFCToolBar::GetMenuImageSize
pro určení velikosti obrázků tlačítek nabídky.
Příklady, které používají tuto metodu, najdete v ukázkách IEDemo a MSMoneyDemo.
CMFCToolBar::SetNonPermittedCommands
Nastaví seznam příkazů, které uživatel nemůže spustit.
static void SetNonPermittedCommands(CList<UINT,UINT>& lstCommands);
Parametry
lstCommands
[v] Odkaz na CList
objekt, který obsahuje příkazy, které uživatel nemůže spustit.
Poznámky
Voláním této metody zabráníte uživateli v výběru určitých příkazů. Můžete například chtít zabránit uživateli v výběru určitých příkazů z bezpečnostních důvodů. Příklady, které tuto metodu používají, najdete v ukázkách MDITabsDemo a MenuSubSet.
Tato metoda vymaže předchozí seznam nepovolených příkazů. Ve výchozím nastavení je seznam nepovolených příkazů prázdný.
CMFCToolBar::SetOneRowWithSibling
Umístí panel nástrojů a jeho stejné pořadí na stejném řádku.
void SetOneRowWithSibling();
Poznámky
Architektura volá tuto metodu, když uživatel vybere tlačítko Zobrazit tlačítka na jednom řádku .
Zavolejte metodu CMFCToolBar::SetSiblingToolBar
, která povolí tlačítka Zobrazit na jednom řádku nebo zobrazit tlačítka na dvou řádcích . Pokud voláte CMFCToolBar::SetSiblingToolBar
pro tento panel nástrojů, panel nástrojů na stejné straně se přesune na řádek tohoto panelu nástrojů. V opačném případě se tento panel nástrojů přesune na řádek stejné skupiny.
Architektura volá metodu CMFCToolBar::SetTwoRowsWithSibling
, když uživatel vybere tlačítko Zobrazit tlačítka na dvou řádcích .
CMFCToolBar::SetOrigButtons
void SetOrigButtons(const CObList& lstOrigButtons);
Parametry
[v] lstOrigButtons
\
Poznámky
CMFCToolBar::SetPermament
Určuje, jestli uživatel může panel nástrojů zavřít.
void SetPermament(BOOL bPermament=TRUE);
Parametry
bPermament
[v] Logická hodnota, která určuje, zda uživatel může zavřít panel nástrojů. Pokud je TRUE
tento parametr , uživatel nemůže zavřít panel nástrojů. V opačném případě může uživatel panel nástrojů zavřít.
Poznámky
Ve výchozím nastavení může uživatel zavřít každý panel nástrojů.
CMFCToolBar::CanBeClosed
Voláním metody určete, zda uživatel může zavřít panel nástrojů.
CMFCToolBar::SetRouteCommandsViaFrame
Určuje, jestli nadřazený rámec nebo vlastník odešle příkazy na panel nástrojů.
void SetRouteCommandsViaFrame(BOOL bValue);
Parametry
bValue
[v] Pokud je TRUE
tento parametr , nadřazený rámec odešle příkazy na panel nástrojů. Jinak vlastník odešle příkazy na panel nástrojů.
Poznámky
Ve výchozím nastavení nadřazený rámec odesílá příkazy na panel nástrojů. CMFCToolBar::GetRouteCommandsViaFrame
Voláním metody určete, zda nadřazený rámec nebo vlastník odesílá příkazy na panel nástrojů.
CMFCToolBar::SetShowTooltips
Určuje, jestli architektura zobrazuje popisy nástrojů.
static void SetShowTooltips(BOOL bValue);
Parametry
bValue
[v] Pokud je TRUE
tento parametr, architektura zobrazuje tipy pro nástroje. V opačném případě rozhraní skryje popisy nástrojů.
Poznámky
Ve výchozím nastavení se v rozhraní zobrazují tipy pro nástroje.
CMFCToolBar::GetShowTooltips
Voláním metody určete, jestli architektura zobrazuje tipy k nástrojům.
CMFCToolBar::SetSiblingToolBar
Určuje stejné nastavení panelu nástrojů.
void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);
Parametry
pBrotherToolbar
[v] Ukazatel na panel nástrojů na stejné straně
Poznámky
Tato metoda umožňuje zobrazit tlačítka na jednom řádku nebo Zobrazit tlačítka na dvou řádcích tlačítka, která jsou zobrazena , když uživatel zobrazí místní nabídku Přizpůsobit . Volání této metody, pokud chcete povolit uživateli určit, zda se související panely nástrojů zobrazí na stejném řádku nebo na různých řádcích.
Volejte tuto metodu po povolení tlačítka Přizpůsobit , které se zobrazí na panelu nástrojů. Pokud chcete povolit tlačítko Přizpůsobit , zavolejte metodu CMFCToolBar::EnableCustomizeButton
.
Chcete-li načíst stejné číslo panelu nástrojů, zavolejte CMFCToolBar::GetSiblingToolBar
.
CMFCToolBar::SetSizes
Určuje velikosti tlačítek a obrázků na všech panelech nástrojů.
static void __stdcall SetSizes(
SIZE sizeButton,
SIZE sizeImage);
Parametry
sizeButton
[v] Velikost tlačítek panelu nástrojů v pixelech
sizeImage
[v] Velikost obrázků tlačítek panelu nástrojů v pixelech
Poznámky
Výchozí velikost tlačítek panelu nástrojů je 23x22 pixelů. Výchozí velikost obrázků tlačítek panelu nástrojů je 16 × 15 pixelů.
CMFCToolBar::GetImageSize
Voláním metody načtěte velikost obrázků tlačítek panelu nástrojů. CMFCToolBar::GetButtonSize
Voláním metody načtěte velikost tlačítek panelu nástrojů.
CMFCToolBar::SetToolBarBtnText
Určuje vlastnosti tlačítka na panelu nástrojů.
void SetToolBarBtnText(
UINT nBtnIndex,
LPCTSTR szText=NULL,
BOOL bShowText=TRUE,
BOOL bShowImage=TRUE);
Parametry
nBtnIndex
[v] Index panelu nástrojů založený na nule v seznamu tlačítek panelu nástrojů.
szText
[v] Určuje textový popisek tlačítka panelu nástrojů.
bShowText
[v] Pokud je TRUE
tento parametr, architektura zobrazí textový popisek. V opačném případě architektura skryje textový popisek.
bShowImage
[v] Pokud je TRUE
tento parametr, architektura zobrazuje obrázek tlačítka panelu nástrojů. V opačném případě architektura skryje obrázek tlačítka panelu nástrojů.
Poznámky
Ve výchozím nastavení architektura zobrazuje obrázky tlačítek panelu nástrojů, ale nezobrazuje textový popisek tlačítek panelu nástrojů.
Tato metoda v buildech Debug generuje chybu kontrolního výrazu, pokud nBtnIndex
neodkazuje na platné tlačítko panelu nástrojů nebo je tlačítko panelu nástrojů oddělovač.
CMFCToolBar::SetTwoRowsWithSibling
Umístí panel nástrojů a jeho stejné umístění na samostatné řádky.
void SetTwoRowsWithSibling();
Poznámky
Architektura volá tuto metodu, když uživatel vybere tlačítko Zobrazit tlačítka na dvou řádcích .
Zavolejte metodu CMFCToolBar::SetSiblingToolBar
, která povolí tlačítka Zobrazit na jednom řádku nebo zobrazit tlačítka na dvou řádcích . Pokud voláte CMFCToolBar::SetSiblingToolBar
pro tento panel nástrojů, panel nástrojů na stejné straně se přesune na samostatný řádek. Jinak se tento panel nástrojů přesune na samostatný řádek.
Architektura volá metodu CMFCToolBar::SetOneRowWithSibling
, když uživatel vybere tlačítko Zobrazit tlačítka na jednom řádku .
CMFCToolBar::SetUserImages
Nastaví kolekci uživatelsky definovaných obrázků v aplikaci.
static BOOL SetUserImages(CMFCToolBarImages* pUserImages);
Parametry
pUserImages
[v] Ukazatel na kolekci uživatelsky definovaných obrázků.
Návratová hodnota
Nenulové, pokud je metoda úspěšná; jinak 0, pokud zadaný CMFCToolBarImages
objekt není platný nebo má velikost obrázku, která se liší od výchozí velikosti obrázku panelu nástrojů.
Poznámky
Tato architektura používá uživatelsky definované obrázky k kreslení tlačítek panelu nástrojů, které si uživatel přizpůsobil. Seznam obrázků zadaný pomocí pUserImages
se sdílí mezi všemi panely nástrojů v aplikaci.
Tato metoda vygeneruje chybu kontrolního výrazu v buildech Debug, pokud zadaný CMFCToolBarImages
objekt není platný nebo má velikost obrázku, která se liší od výchozí velikosti obrázku panelu nástrojů.
Ukázky OutlookDemo, ToolTipDemo a VisualStudioDemo používají tuto metodu k nastavení globální kolekce uživatelsky definovaných obrázků. Načtou soubor s názvem UserImages.bmp, který se nachází v pracovním adresáři aplikace.
Volání CMFCToolBar::GetUserImages metoda načtení kolekce uživatelem definovaných obrázků v aplikaci.
CMFCToolBar::StretchPane
Roztáhne panel nástrojů svisle nebo vodorovně a v případě potřeby přemísťuje tlačítka.
virtual CSize StretchPane(
int nLength,
BOOL bVert);
Parametry
nLength
[v] Množství v pixelech, o které chcete podokno roztáhnout.
bVert
[v] Pokud TRUE
podokno roztáhne svisle. Pokud FALSE
podokno roztáhne vodorovně.
Návratová hodnota
Objekt CSize
, který určuje velikost klientské oblasti panelu nástrojů.
Poznámky
Tato metoda volá CMFCToolBar::WrapToolBar
přemísťování tlačítek na roztaženém panelu nástrojů.
Vrácená hodnota je určena voláním CMFCToolBar::CalcSize
.
CMFCToolBar::TranslateChar
Spustí příkaz tlačítka, pokud zadaný kód klávesy odpovídá platné klávesové zkratkě.
virtual BOOL TranslateChar(UINT nChar);
Parametry
nChar
[v] Určuje kód virtuálního klíče. Seznam standardních kódů virtuálních klíčů najdete v tématu . Winuser.h
Návratová hodnota
FALSE
pokud je zadaný kód klíče netisknutelný nebo neodpovídá platné klávesové zkratce; TRUE
pokud zadaný kód klíče odpovídá možnosti rozevírací nabídky; v opačném případě vrácená hodnota z CMFCToolBar::ProcessCommand
.
Poznámky
Architektura volá tuto metodu při stisknutí klávesy spolu s klávesou Alt .
CMFCToolBar::UpdateButton
Aktualizuje stav zadaného tlačítka.
void UpdateButton(int nIndex);
Parametry
nIndex
[v] Určuje index tlačítka založený na nule, který se má aktualizovat.
Poznámky
CMFCToolBar::WrapToolBar
Přemísťuje tlačítka panelu nástrojů v rámci daných dimenzí.
int WrapToolBar(
int nWidth,
int nHeight = 32767,
CDC* pDC = NULL,
int nColumnWidth = -1,
int nRowHeight = -1);
Parametry
nWidth
[v] Maximální šířka panelu nástrojů
nHeight
[v] Maximální výška panelu nástrojů Nepoužívá se, pokud je panel nástrojů plovoucí.
pDC
[v] Ukazatel na kontext zařízení Pokud NULL
se použije kontext zařízení pro panel nástrojů.
nColumnWidth
[v] Šířka tlačítka Pokud -1, použije se aktuální šířka.
[v] m
nRowHeight
Výška tlačítka Pokud -1, použije se aktuální výška.
Návratová hodnota
Počet řádků tlačítek na panelu nástrojů
Poznámky
Tato metoda přemísťuje tlačítka na panelu nástrojů a v případě potřeby zalamuje tlačítka na další řádky.
CMFCToolBar::m_bDontScaleImages
Určuje, jestli se mají škálovat obrázky panelů nástrojů v režimu vysokého DPI nebo ne.
Pokud velikost obrázku neodpovídá velikosti tlačítka, nastaví se tak, aby TRUE
se zabránilo škálování obrázku.
AFX_IMPORT_DATA static BOOL m_bDontScaleImages;
Viz také
Graf hierarchie
Třídy
CMFCMenuBar
Třída
CMFCPopupMenuBar
Třída
CMFCDropDownToolBar
Třída
Návod: Umístění ovládacích prvků na panely nástrojů