Sdílet prostřednictvím


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\mfcnapří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:

  1. CMFCToolBar Přidejte objekt do okna hlavního rámce.

  2. Když zpracujete zprávu WM_CREATE pro okno hlavního rámce, zavolejte panel CMFCToolBar::Create nástrojů nebo CMFCToolBar::CreateEx vytvořte panel nástrojů a zadejte jeho styl.

  3. 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ů.

CMFCToolBarje 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

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

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 TRUEtento 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 TRUEtento 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::CanFocusprotož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::DoPaintvolá 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::EnableDockingzá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

TRUEpokud 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

TRUEpokud 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

TRUEpokud 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

TRUEpokud 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

TRUEje-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

TRUEpokud 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

TRUEpokud 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

TRUEje-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 TRUEtento 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 TRUEtento 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 TRUEtento 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 TRUEtento 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 TRUEtento 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 TRUEtento 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 TRUEtento 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 TRUEtento 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 TRUEtento 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 TRUEtento 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 TRUEtento parametr, architektura zobrazí textový popisek. V opačném případě architektura skryje textový popisek.

bShowImage
[v] Pokud je TRUEtento 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 TRUEpodokno roztáhne svisle. Pokud FALSEpodokno 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 NULLse 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ů