CMFCToolBarButton – třída

Článek
08/04/2024

Poskytuje funkce tlačítek na panely nástrojů.

Syntaxe

class CMFCToolBarButton : public CObject

Členové

Veřejné konstruktory

Název	Popis
CMFCToolBarButton::CMFCToolBarButton	Vytvoří a inicializuje `CMFCToolBarButton` objekt.
`CMFCToolBarButton::~CMFCToolBarButton`	Destruktor.

Veřejné metody

Název	Popis
CMFCToolBarButton::CanBeDropped	Určuje, jestli uživatel může během přizpůsobení umístit tlačítko na panel nástrojů nebo nabídku.
CMFCToolBarButton::CanBeStored	Určuje, jestli se tlačítko dá uložit.
CMFCToolBarButton::CanBeStretched	Určuje, jestli uživatel může tlačítko během přizpůsobení roztáhnout.
CMFCToolBarButton::CompareWith	Porovná tuto instanci se zadaným `CMFCToolBarButton` objektem.
CMFCToolBarButton::CopyFrom	Zkopíruje vlastnosti jiného tlačítka panelu nástrojů na aktuální tlačítko.
CMFCToolBarButton::CreateFromOleData	`CMFCToolBarButton` Vytvoří objekt z poskytnutého `COleDataObject` objektu.
`CMFCToolBarButton::CreateObject`	Používá se architekturou k vytvoření dynamické instance tohoto typu třídy.
CMFCToolBarButton::EnableWindow	Povolí nebo zakáže vstup myši a klávesnice.
CMFCToolBarButton::ExportToMenuButton	Zkopíruje text z tlačítka panelu nástrojů do nabídky.
CMFCToolBarButton::GetClipboardFormat	Načte globální formát schránky pro aplikaci.
CMFCToolBarButton::GetHwnd	Načte úchyt okna přidružený k tlačítku panelu nástrojů.
CMFCToolBarButton::GetImage	Načte index obrázku tlačítka.
CMFCToolBarButton::GetInvalidateRect	Načte oblast klientské oblasti tlačítka, která se musí překreslit.
CMFCToolBarButton::GetParentWnd	Načte nadřazené okno tlačítka.
CMFCToolBarButton::GetProtectedCommands	Načte seznam příkazů, které uživatel nemůže přizpůsobit.
CMFCToolBarButton::GetTextSize	Načte velikost textu tlačítka.
CMFCToolBarButton::HasFocus	Určuje, jestli má tlačítko aktuální fokus vstupu.
CMFCToolBarButton::HaveHotBorder	Určuje, zda se zobrazí ohraničení tlačítka, když uživatel tlačítko vybere.
CMFCToolBarButton::IsDrawImage	Určuje, zda se na tlačítku zobrazí obrázek.
CMFCToolBarButton::IsDrawText	Určuje, zda se na tlačítku zobrazí textový popisek.
CMFCToolBarButton::IsDroppedDown	Určuje, zda tlačítko zobrazuje podnabídku.
CMFCToolBarButton::IsEditable	Určuje, zda lze tlačítko přizpůsobit.
CMFCToolBarButton::IsExtraSize	Určuje, zda lze tlačítko zobrazit s rozšířeným ohraničením.
CMFCToolBarButton::IsFirstInGroup	Určuje, zda je tlačítko na prvním místě ve skupině tlačítek.
CMFCToolBarButton::IsHidden	Určuje, zda je tlačítko skryté.
CMFCToolBarButton::IsHorizontal	Určuje, zda je tlačítko umístěno na vodorovném panelu nástrojů.
CMFCToolBarButton::IsLastInGroup	Určuje, jestli je tlačítko na poslední pozici ve skupině tlačítek.
CMFCToolBarButton::IsLocked	Určuje, zda je tlačítko na zamknutém (ne přizpůsobitelném) panelu nástrojů.
CMFCToolBarButton::IsOwnerOf	Určuje, zda je tlačítko vlastníkem poskytnutého popisovače okna.
CMFCToolBarButton::IsVisible	Určuje, zda je tlačítko panelu nástrojů viditelné.
CMFCToolBarButton::IsWindowVisible	Určuje, zda je viditelný podkladový úchyt okna tlačítka.
CMFCToolBarButton::NotifyCommand	Určuje, jestli tlačítko zpracovává zprávu WM_COMMAND .
CMFCToolBarButton::OnAddToCustomizePage	Volá se rozhraním při přidání tlačítka do dialogového okna Přizpůsobit .
CMFCToolBarButton::OnBeforeDrag	Určuje, zda lze tlačítko přetáhnout.
CMFCToolBarButton::OnBeforeDrop	Určuje, jestli uživatel může tlačítko přetáhnout na cílový panel nástrojů.
CMFCToolBarButton::OnCalculateSize	Volané rozhraním pro výpočet velikosti tlačítka pro zadaný kontext zařízení a stav ukotvení.
CMFCToolBarButton::OnCancelMode	Volá se rozhraním pro zpracování WM_CANCELMODE zprávy.
CMFCToolBarButton::OnChangeParentWnd	Volá se rozhraním při vložení tlačítka do nového panelu nástrojů.
CMFCToolBarButton::OnClick	Volá se rozhraním, když uživatel klikne na tlačítko myši.
CMFCToolBarButton::OnClickUp	Volá se rozhraním, když uživatel uvolní tlačítko myši.
CMFCToolBarButton::OnContextHelp	Volá se rozhraním, když nadřazený panel nástrojů zpracovává zprávu WM_HELPHITTEST.
CMFCToolBarButton::OnCtlColor	Volá se rozhraním, když nadřazený panel nástrojů zpracovává zprávu WM_CTLCOLOR.
CMFCToolBarButton::OnCustomizeMenu	Umožňuje tlačítku změnit poskytnutou nabídku, když aplikace zobrazí místní nabídku na nadřazené panelu nástrojů.
CMFCToolBarButton::OnDblClk	Volá se rozhraním, když nadřazený panel nástrojů zpracovává zprávu WM_LBUTTONDBLCLK .
CMFCToolBarButton::OnDraw	Volá se rozhraním pro kreslení tlačítka pomocí zadaných stylů a možností.
CMFCToolBarButton::OnDrawOnCustomizeList	Volá se rozhraním pro kreslení tlačítka v podokně Příkazy dialogového okna Přizpůsobit .
CMFCToolBarButton::OnGetCustomToolTipText	Zavolá se rozhraním pro načtení vlastního textu popisu tlačítka.
CMFCToolBarButton::OnGlobalFontsChanged	Volá se architekturou, když se globální písmo změnilo.
CMFCToolBarButton::Onmove	Volá se rozhraním, když se nadřazený panel nástrojů přesune.
CMFCToolBarButton::OnShow	Volá se rozhraním, když se tlačítko stane viditelným nebo neviditelným.
CMFCToolBarButton::Onsize	Volá se rozhraním, když nadřazený panel nástrojů změní jeho velikost nebo umístění a tato změna vyžaduje, aby tlačítko změnilo velikost.
CMFCToolBarButton::OnToolHitTest	Volá se rozhraním, když nadřazený panel nástrojů musí určit, zda je bod v ohraničující obdélník tlačítka.
CMFCToolBarButton::OnUpdateToolTip	Volá se rozhraním, když nadřazený panel nástrojů aktualizuje text popisu.
CMFCToolBarButton::P repareDrag	Volá se rozhraním, když se tlačítko chystá provést operaci přetažení.
CMFCToolBarButton::Rect	Načte ohraničující obdélník tlačítka.
CMFCToolBarButton::ResetImageToDefault	Nastaví výchozí hodnotu obrázku přidruženého k tlačítku.
CMFCToolBarButton::SaveBarState	Uloží stav tlačítka panelu nástrojů.
CMFCToolBarButton::Serialize	Načte tento objekt z archivu nebo ho zapíše do archivu. (Přepsání CObject::Serialize.)
CMFCToolBarButton::SetACCData	Naplní zadaný `CAccessibilityData` objekt daty přístupnosti z tlačítka panelu nástrojů.
CMFCToolBarButton::SetClipboardFormatName	Přejmenuje globální formát schránky.
CMFCToolBarButton::SetImage	Nastaví index obrázku tlačítka.
CMFCToolBarButton::SetProtectedCommands	Nastaví seznam příkazů, které uživatel nemůže přizpůsobit.
CMFCToolBarButton::SetRadio	Volá se rozhraním, když tlačítko změní jeho stav zaškrtnutí.
CMFCToolBarButton::SetRect	Nastaví ohraničující obdélník tlačítka.
CMFCToolBarButton::SetStyle	Nastaví styl tlačítka.
CMFCToolBarButton::SetVisible	Určuje, jestli je tlačítko viditelné.
CMFCToolBarButton::Show	Zobrazí nebo skryje tlačítko.

Datové členy

Název	Popis
CMFCToolBarButton::m_bImage	Určuje, jestli se na tlačítku zobrazí obrázek.
CMFCToolBarButton::m_bText	Určuje, jestli se na tlačítku zobrazí textový popisek.
CMFCToolBarButton::m_bTextBelow	Určuje, jestli se textový popisek zobrazí pod obrázkem na tlačítku.
CMFCToolBarButton::m_bUserButton	Určuje, jestli má tlačítko uživatelsky definovaný obrázek.
CMFCToolBarButton::m_bWholeText	Určuje, zda tlačítko zobrazí celý text popisek, i když se nevejde do ohraničujícího obdélníku.
CMFCToolBarButton::m_bWrap	Určuje, jestli se tlačítko vedle oddělovače umístí na další řádek.
CMFCToolBarButton::m_bWrapText	Určuje, jestli jsou povolené popisky textu s více řádky.
CMFCToolBarButton::m_nID	ID příkazu tlačítka.
CMFCToolBarButton::m_nStyle	Styl tlačítka
CMFCToolBarButton::m_strText	Textový popisek tlačítka.

Poznámky

Objekt CMFCToolbarButton je ovládací prvek, který se nachází na panelu nástrojů. Jeho chování se podobá běžnému tlačítku. K tomuto objektu můžete přiřadit obrázek a textový popisek. Tlačítko panelu nástrojů může mít také ID příkazu. Když uživatel klikne na tlačítko panelu nástrojů, architektura spustí příkaz, který toto ID určuje.

Tlačítka panelu nástrojů se obvykle dají přizpůsobit: uživatel může přetahovat tlačítka z jednoho panelu nástrojů do druhého a kopírovat, vkládat, odstraňovat a upravovat popisky textu a obrázky. Pokud chcete zabránit uživateli v přizpůsobení panelu nástrojů, můžete panel nástrojů uzamknout jedním ze dvou způsobů. Buď nastavte bLocked příznak na TRUE při volání CMFCToolBar::LoadToolBar, nebo přidejte ID příkazu jednotlivého tlačítka do globálního seznamu chráněných příkazů pomocí CMFCToolBarButton::SetProtectedCommands metoda.

CMFCToolBarButton objekty zobrazují obrázky z globálních kolekcí obrázků na panelu nástrojů v aplikaci. Tyto kolekce jsou udržovány nadřazeným panelem nástrojů CMFCToolBar Třída. Další informace naleznete v tématu CMFCToolBarImages – třída.

Když uživatel klikne na tlačítko panelu nástrojů, jeho nadřazený panel nástrojů zpracuje zprávu myši a sdělí příslušné akce tlačítku. Pokud má tlačítko platné ID příkazu, nadřazený panel nástrojů odešle WM_COMMAND zprávu do nadřazeného rámce.

Třída CMFCToolBarButton je základní třídou pro jiné třídy tlačítek panelu nástrojů, jako je CMFCToolBarMenuButton Třída, CMFCToolBarEditBoxButton Třída a CMFCToolBarComboBoxButton Třída.

Příklad

Následující příklad ukazuje, jak nakonfigurovat CMFCToolBarButton objekt pomocí různých metod ve CMFCToolBarButton třídě. Příklad ukazuje, jak povolit vstup myši a klávesnice, nastavit index obrázku tlačítka, nastavit ohraničující obdélník tlačítka a nastavit tlačítko jako viditelné. Tento fragment kódu je součástí ukázky ovládacího prvku Tab.

CMFCToolBarButton *pOffice2007 = NULL;
int nIndex = -1;

for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
{
   // CMFCToolBar m_wndToolBarTheme
   nIndex = m_wndToolBarTheme.CommandToIndex(uiCmd);

   CMFCToolBarButton *pButton = m_wndToolBarTheme.GetButton(nIndex);

   if (pButton != NULL)
   {
      pOffice2007 = pButton;
      break;
   }
}

pOffice2007->EnableWindow();
pOffice2007->SetImage(1);
pOffice2007->SetRect(CRect(1, 1, 1, 1));
pOffice2007->SetVisible();
pOffice2007->Show(true);

Hierarchie dědičnosti

Objekt CObject

CMFCToolBarButton

Požadavky

Hlavička: afxtoolbarbutton.h

CMFCToolBarButton::CanBeDropped

Určuje, jestli uživatel může během přizpůsobení umístit tlačítko na panel nástrojů nebo nabídku.

virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);

Parametry

pToolbar
[v] Nepoužitý.

Návratová hodnota

Tato metoda vrátí hodnotu TRUE.

Poznámky

Ve výchozím nastavení lze tlačítko panelu nástrojů přehodit na každý přizpůsobitelný (tj. nezamčený) panel nástrojů.

Výchozí implementace této metody vrátí hodnotu TRUE. Tuto metodu přepište a vraťte hodnotu FALSE, pokud chcete zabránit uživateli v přemísťování tlačítka.

CMFCToolBarButton::CanBeStored

Určuje, zda lze tlačítko uložit.

virtual BOOL CanBeStored() const;

Návratová hodnota

Tato metoda vrátí hodnotu TRUE.

Poznámky

Architektura používá tuto metodu k určení, zda se tlačítko může účastnit operace přetažení.

Výchozí implementace vrátí hodnotu TRUE. Tuto metodu přepište, pokud tlačítko nelze uložit jako součást operace přetažení. Další informace ooperacích

CMFCToolBarButton::CanBeStretched

Určuje, jestli uživatel může tlačítko během přizpůsobení roztáhnout.

virtual BOOL CanBeStretched() const;

Návratová hodnota

Tato metoda vrátí hodnotu FALSE.

Poznámky

Tato metoda je používána architekturou k určení, zda lze tlačítko roztáhnout v režimu přizpůsobení.

Výchozí implementace této metody vrátí hodnotu FALSE. Tuto metodu přepište tak, aby vrátila hodnotu TRUE pro ovládací prvek s proměnnou šířkou, například pole se seznamem nebo posuvník.

Další informace o režimu přizpůsobení naleznete v tématu CMFCToolBar::SetCustomizeMode.

CMFCToolBarButton::CMFCToolBarButton

Vytvoří a inicializuje CMFCToolBarButton objekt.

CMFCToolBarButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE,
    BOOL bLocked=FALSE);

Parametry

UIID
[v] ID příkazu tlačítka.

iImage
[v] Index obrázku tlačítka v kolekci obrázků.

lpszText
[v] Textový popisek tlačítka. Může mít hodnotu NULL.

bUserButton
[v] Logická hodnota, která určuje, jestli je tlačítko definované uživatelem. Pokud je tento parametr TRUE, tlačítko je definováno uživatelem. Jinak se obrázek tlačítka načte z prostředku.

blokovaný
[v] Logická hodnota, která určuje, zda lze tlačítko přizpůsobit. Pokud je tento parametr TRUE, tlačítko nelze přizpůsobit. V opačném případě lze tlačítko přizpůsobit.

CMFCToolBarButton::CompareWith

Porovná tuto instanci se zadaným CMFCToolBarButton objektem.

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parametry

jiný
[v] Odkaz na objekt, který se má porovnat s touto instancí.

Návratová hodnota

Nenulové, pokud se zadaný objekt rovná hodnotě této instance; jinak, 0.

Poznámky

Výchozí implementace určuje, zda se ID příkazu zadaného objektu rovná ID příkazu této instance. Tuto metodu přepište, pokud je nutné provést další zpracování, abyste zjistili, zda jsou dva CMFCToolBarButton objekty stejné.

CMFCToolBarButton::CopyFrom

Zkopíruje vlastnosti jiného tlačítka panelu nástrojů na aktuální tlačítko.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parametry

Src
[v] Odkaz na tlačítko zdroje, ze kterého chcete kopírovat.

Poznámky

Voláním této metody zkopírujte na toto tlačítko panelu nástrojů další tlačítko panelu nástrojů.

CMFCToolBarButton::CreateFromOleData

CMFCToolBarButton Vytvoří objekt z poskytnutého COleDataObject objektu.

static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);

Parametry

pDataObject
[v] Zdrojový datový objekt OLE.

Návratová hodnota

Vytvořený objekt CMFCToolBarButton.

Poznámky

Tato metoda je používána architekturou k provádění přenosu dat v různých formátech. Metoda například používá tuto metodu CMFCOutlookBarPane::OnDragOver k provádění operací přetažení myší.

CMFCToolBarButton::EnableWindow

Povolí nebo zakáže vstup myši a klávesnice.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parametry

bEnable
[v] Nastavením tohoto parametru na hodnotu TRUE povolíte vstup nebo hodnotu FALSE zakážete.

Poznámky

Tato metoda volá EnableWindow funkci, která povolí nebo zakáže vstup. Další informace naleznete v tématu EnableWindow v sadě Windows SDK.

CMFCToolBarButton::ExportToMenuButton

Zkopíruje text z tlačítka panelu nástrojů do nabídky.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parametry

menuButton
[v] Odkaz na tlačítko cílové nabídky.

Návratová hodnota

Tato metoda vrátí hodnotu TRUE.

Poznámky

Architektura volá tuto metodu ke zkopírování textu z tlačítka panelu nástrojů na tlačítko nabídky. Výchozí implementace zkopíruje textový popisek tlačítka. Pokud je textový popisek prázdný, zkopíruje tato metoda text popisu tlačítka.

Výchozí implementace této metody vrátí hodnotu TRUE. Tuto metodu přepište, pokud chcete provést další akce při rozhraní převede objekt odvozený z CMFCToolbarButton na tlačítko nabídky.

CMFCToolBarButton::GetClipboardFormat

Načte globální formát schránky pro aplikaci.

static CLIPFORMAT __stdcall GetClipboardFormat();

Návratová hodnota

Globální hodnota CLIPFORMAT pro aplikaci.

Poznámky

Architektura volá tuto metodu k načtení formátu schránky pro operace přenosu dat OLE. Například CMFCToolBarButton::CreateFromOleData metoda používá tuto metodu ke kopírování dat ze zdrojového objektu OLE dat.

Tato metoda nastaví globální hodnotu CLIPFORMAT při prvním zavolání této metody. Všechna následná volání této metody vrátí tuto hodnotu.

Chcete-li povolit operace přetažení mezi aplikacemi, zavolejte CMFCToolBarButton::SetClipboardFormatName metoda.

Další informace o schránkách v prostředí MFC naleznete v tématu Schránka.

CMFCToolBarButton::GetHwnd

Načte úchyt okna přidružený k tlačítku panelu nástrojů.

virtual HWND GetHwnd();

Návratová hodnota

Popisovač okna přidružený k tlačítku panelu nástrojů nebo null, pokud tlačítko panelu nástrojů nemá přidružený popisovač okna.

Poznámky

Výchozí implementace této metody vrátí hodnotu NULL. Tuto metodu přepište tak, aby se vrátil popisovač okna konkrétního ovládacího prvku.

CMFCToolBarButton::GetImage

Načte index obrázku tlačítka.

int GetImage() const;

Návratová hodnota

Index obrázku přidruženého k tomuto tlačítku.

Poznámky

Pokud má tlačítko uživatelsky definovaný obrázek (to znamená, že pokud bUserButton byl v konstruktoru TRUE), vrácený index určuje obrázek v kolekci uživatelsky definovaných obrázků (viz CMFCToolBar::GetUserImages). V opačném případě index určuje image v kolekci imagí načtených ze souboru prostředků (viz CMFCToolBar::GetImages). Další informace o souborech prostředků naleznete v tématu Práce se soubory prostředků.

CMFCToolBarButton::GetInvalidateRect

Načte oblast klientské oblasti tlačítka, která se musí překreslit.

virtual const CRect GetInvalidateRect() const;

Návratová hodnota

CRect Objekt, který určuje oblast, která musí být překreslena.

Poznámky

Výchozí implementace této metody vrátí celou oblast klienta. Tuto metodu přepište, pokud chcete překreslit jinou oblast.

CMFCToolBarButton::GetParentWnd

Načte nadřazené okno tlačítka.

CWnd* GetParentWnd() const;

Návratová hodnota

Nadřazené okno tlačítka

CMFCToolBarButton::GetProtectedCommands

Načte seznam příkazů, které uživatel nemůže přizpůsobit.

static const CList<UINT,UINT>& GetProtectedCommands();

Návratová hodnota

Seznam chráněných příkazů

Poznámky

V režimu přizpůsobení architektura zakáže příkazy tlačítek panelu nástrojů, které jsou chráněné. Uživatel nemůže na zakázaných tlačítkách panelu nástrojů provádět operace přetažení a úprav.

Pomocí CMFCToolBarButton::SetProtectedCommands metoda definovat seznam chráněných příkazů.

CMFCToolBarButton::GetTextSize

Načte velikost textu tlačítka.

SIZE GetTextSize() const;

Návratová hodnota

Objekt SIZE, který obsahuje velikost textu tlačítka v pixelech.

CMFCToolBarButton::HasFocus

Určuje, jestli má tlačítko aktuální fokus vstupu.

virtual BOOL HasFocus() const;

Návratová hodnota

Nenulové, pokud má tlačítko vstupní fokus; jinak 0.

Poznámky

Výchozí implementace této metody vrátí nenulové, pokud má tlačítko vstupní fokus nebo je podřízený nebo potomk okna okna, které má vstupní fokus. Tuto funkci můžete přepsat, abyste toto chování přizpůsobili.

CMFCToolBarButton::HaveHotBorder

Určuje, zda se zobrazí ohraničení tlačítka, když uživatel tlačítko vybere.

virtual BOOL HaveHotBorder() const;

Návratová hodnota

Tato metoda vrátí hodnotu TRUE.

Poznámky

Architektura volá tuto metodu k určení, zda má tlačítko panelu nástrojů zobrazit jeho ohraničení, když ho uživatel vybere.

Výchozí implementace vrátí hodnotu TRUE. Tuto metodu můžete přepsat, abyste toto chování přizpůsobili.

CMFCToolBarButton::IsDrawImage

Určuje, zda se na tlačítku zobrazí obrázek.

BOOL IsDrawImage() const;

Návratová hodnota

Nenulové, pokud je na tlačítku zobrazen obrázek; jinak 0.

Poznámky

Tato metoda vrátí HODNOTU FALSE, pokud tlačítko panelu nástrojů nemá žádný přidružený obrázek ( CMFCToolBarButton::GetImage vrátí -1) nebo pokud CMFCToolBarButton::m_bImage je nastavena na FALSE.

CMFCToolBarButton::IsDrawText

Určuje, zda se na tlačítku zobrazí textový popisek.

BOOL IsDrawText() const;

Návratová hodnota

Nenulové, pokud se zobrazí textový popisek; jinak 0.

Poznámky

Tato metoda vrátí HODNOTU FALSE, pokud tlačítko panelu nástrojů nemá žádný přidružený textový popisek ( CMFCToolBarButton::m_strText je prázdný) nebo CMFCToolBarButton::m_bText je nastavena na FALSE.

CMFCToolBarButton::IsDroppedDown

Určuje, zda tlačítko zobrazuje podnabídku.

virtual BOOL IsDroppedDown() const;

Návratová hodnota

Tato metoda vrátí hodnotu FALSE.

Poznámky

Výchozí implementace této metody vrátí hodnotu FALSE. Tuto metodu přepište tak, aby vrátil hodnotu TRUE, pokud ovládací prvek zobrazí podnabídku.

CMFCToolBarButton::IsEditable

Určuje, zda lze tlačítko přizpůsobit.

virtual BOOL IsEditable() const;

Návratová hodnota

Nenulové, pokud lze tlačítko přizpůsobit uživatelem; jinak 0.

Poznámky

Architektura volá tuto metodu k určení, zda uživatel může přizpůsobit tlačítko panelu nástrojů pomocí operací přetažení nebo úprav.

Výchozí implementace vrátí hodnotu FALSE, pokud je ID příkazu tlačítka standardním příkazem (můžete to zjistit voláním IsStandardCommand funkce) nebo pokud je ID příkazu v seznamu chráněných příkazů. Další informace o chráněných příkazech naleznete v tématu CMFCToolBarButton::GetProtectedCommands a CMFCToolBarButton::SetProtectedCommands.

Tuto metodu přepište, aby se přizpůsobilo jeho chování.

CMFCToolBarButton::IsExtraSize

Určuje, zda lze tlačítko zobrazit s rozšířeným ohraničením.

virtual BOOL IsExtraSize() const;

Návratová hodnota

Nenulové, pokud lze tlačítko panelu nástrojů zobrazit s rozšířeným ohraničení; jinak 0.

Poznámky

Pro ohraničení tlačítek na panelu nástrojů používá několik skinů větší velikost (například kruhová tlačítka).

Pokud uživatel přesune toto tlačítko z jednoho panelu nástrojů do jiné, rozhraní volá CMFCToolBarButton::OnChangeParentWnd metoda. CMFCToolBarButton::OnChangeParentWnd metoda nastaví příznak dodatečné velikosti na nový nadřazený panel nástrojů (další informace naleznete v CMFCToolBar::IsButtonExtraSizeAvailable).

CMFCToolBarButton::IsFirstInGroup

Určuje, zda je tlačítko na prvním místě ve skupině tlačítek.

virtual BOOL IsFirstInGroup() const;

Návratová hodnota

TRUE Pokud je tlačítko prvním tlačítkem ve skupině tlačítek; jinak NEPRAVDA.

Poznámky

Tato metoda definuje skupinu tlačítek jako sousední sadu tlačítek umístěných na stejném řádku a jsou ohraničeny oddělovači nebo ohraničením panelu nástrojů. Tato metoda vrátí hodnotu FALSE, pokud tlačítko panelu nástrojů odkazuje na tlačítko Přizpůsobit . Další informace o tlačítku Přizpůsobit naleznete v tématu CMFCToolBar::GetCustomizeButton.

Volání CMFCToolBarButton::IsLastInGroup metoda určit, zda tlačítko je na poslední pozici ve skupině tlačítek.

CMFCToolBarButton::IsHidden

Určuje, zda je tlačítko skryté.

BOOL IsHidden() const;

Návratová hodnota

Nenulové, pokud je tlačítko skryté (neviditelné); jinak 0.

Poznámky

Architektura volá tuto metodu, když je nadřazený panel nástrojů roztažen, aby bylo možné určit, zda je tlačítko panelu nástrojů viditelné.

Pokud nastavíte tlačítko na neviditelné pomocí CMFCToolBarButton::SetVisible metoda, použijte CMFCToolBarButton::IsVisible k určení, zda je tlačítko panelu nástrojů viditelné.

Ve výchozím nastavení jsou zobrazena všechna tlačítka panelu nástrojů. Pomocí CMFCToolBarButton::Show metoda skrýt nebo zobrazit tlačítka panelu nástrojů.

CMFCToolBarButton::IsHorizontal

Určuje, zda je tlačítko umístěno na vodorovném panelu nástrojů.

BOOL IsHorizontal() const;

Návratová hodnota

Nenulové, pokud je tlačítko panelu nástrojů umístěné na vodorovném panelu nástrojů; jinak 0.

Poznámky

Architektura volá tuto metodu k určení rozložení tlačítek panelu nástrojů.

Tato metoda vrátí m_bHorz datový člen. Výchozí hodnota datového členu m_bHorz je TRUE; při každém volání CMFCToolBarButton::OnDraw metoda.

CMFCToolBarButton::IsLastInGroup

Určuje, jestli je tlačítko na poslední pozici ve skupině tlačítek.

virtual BOOL IsLastInGroup() const;

Návratová hodnota

TRUE Pokud je tlačítko posledním tlačítkem ve skupině tlačítek; jinak NEPRAVDA.

Poznámky

Tato metoda definuje skupinu tlačítek jako sousední sadu tlačítek umístěných na stejném řádku a jsou ohraničeny oddělovači nebo ohraničením panelu nástrojů Tato metoda vrátí hodnotu FALSE, pokud tlačítko panelu nástrojů nemá nadřazený panel nástrojů nebo tlačítko panelu nástrojů odkazuje na tlačítko Přizpůsobit . Další informace o tlačítku Přizpůsobit naleznete v tématu CMFCToolBar::GetCustomizeButton.

Volání CMFCToolBarButton::IsFirstInGroup metoda určit, zda tlačítko je v první pozici ve skupině tlačítek.

CMFCToolBarButton::IsLocked

Určuje, zda je tlačítko na zamknutém (ne přizpůsobitelném) panelu nástrojů.

BOOL IsLocked() const;

Návratová hodnota

Nenulové, pokud je tlačítko na zamknutém panelu nástrojů; jinak 0.

Poznámky

Architektura volá tuto metodu k určení, zda uživatel může přizpůsobit tlačítko panelu nástrojů pomocí operací přetažení nebo úprav. Nastavte uzamčený atribut na nadřazený panel nástrojů pomocí CMFCToolBar::LoadToolBar metoda. Architektura předá hodnotu tohoto atributu konstruktoru každého tlačítka panelu nástrojů ( CMFCToolbarButton), který vloží do nadřazeného panelu nástrojů.

CMFCToolBarButton::IsOwnerOf

Určuje, zda je tlačítko vlastníkem poskytnutého popisovače okna.

virtual BOOL IsOwnerOf(HWND hwnd);

Parametry

hwnd
[v] Úchyt okna.

Návratová hodnota

Nenulové, pokud je tlačítko vlastníkem poskytnutého úchytu okna; jinak 0.

Poznámky

Tato metoda vrátí nenulovou hodnotu, pokud hwnd odkazuje buď na přímý úchyt okna, nebo je podřízený popisovač okna, který je přidružen k tlačítku. Tato metoda vrátí hodnotu 0, pokud je hwnd null.

CMFCToolBarButton::IsVisible

Určuje, zda je tlačítko panelu nástrojů viditelné.

BOOL IsVisible() const;

Návratová hodnota

Nenulové, pokud je tlačítko panelu nástrojů viditelné; jinak 0.

Poznámky

Tlačítko panelu nástrojů můžete zobrazit nebo skrýt pomocí metody CMFCToolBarButton::SetVisible . Volání CPane::AdjustSizeImmediate metoda na nadřazený panel nástrojů po volání CMFCToolBarButton::SetVisible přepočítat rozložení nadřazeného panelu nástrojů.

CMFCToolBarButton::IsWindowVisible

Určuje, zda je viditelný podkladový úchyt okna tlačítka.

virtual BOOL IsWindowVisible();

Návratová hodnota

Nenulové, pokud je viditelný podkladový úchyt okna tlačítka; jinak 0.

Poznámky

Tato metoda vrátí nenulový, pokud styly atributu podkladového popisovače okna obsahuje WS_VISIBLE styl. Tato metoda vrátí hodnotu FALSE, pokud podkladový popisovač okna tlačítka má hodnotu NULL.

CMFCToolBarButton::m_bImage

Určuje, jestli se na tlačítku zobrazí obrázek.

BOOL m_bImage;

Poznámky

Pokud je tento datový člen nastaven na HODNOTU TRUE, architektura zobrazí obrázek přidružený k tlačítku panelu nástrojů; v opačném případě architektura nezobrazí obrázek. Tento člen ovlivňuje návratovou hodnotu CMFCToolBarButton::m_bImage metoda.

CMFCToolBarButton::m_bText

Určuje, jestli se na tlačítku zobrazí textový popisek.

BOOL m_bText;

Poznámky

Pokud je tento datový člen nastaven na TRUE, rozhraní zobrazí textový popisek tlačítka panelu nástrojů; jinak architektura nezobrazuje textový popisek. Tento člen ovlivňuje návratovou hodnotu CMFCToolBarButton::m_bText metoda.

CMFCToolBarButton::m_bTextBelow

Určuje, jestli se textový popisek zobrazí pod obrázkem na tlačítku.

BOOL m_bTextBelow;

Poznámky

Pokud je tato členová proměnná nastavená na HODNOTU TRUE, zobrazí architektura text tlačítka pod obrázkem. Výchozí hodnota tohoto člena je FALSE.

CMFCToolBarButton::m_bUserButton

Určuje, jestli má tlačítko uživatelsky definovaný obrázek.

BOOL m_bUserButton;

Poznámky

Tento datový člen je nastaven na HODNOTU TRUE, pokud je k tlačítku přidružený obrázek definovaný uživatelem.

CMFCToolBarButton::m_bWholeText

Určuje, zda tlačítko zobrazí celý text popisek, i když se nevejde do ohraničujícího obdélníku.

BOOL m_bWholeText;

Poznámky

Pokud je tento datový člen nastaven na hodnotu TRUE, rozhraní zobrazí popisek celého textu zvětšením tlačítka. V opačném případě architektura zkrátí a připojí tři tečky ( ...) k textovému popisku.

CMFCToolBarButton::m_bWrap

Určuje, jestli se tlačítko vedle oddělovače umístí na další řádek.

BOOL m_bWrap;

Poznámky

Rozhraní nastaví tento datový člen na hodnotu TRUE, pokud se tlačítko panelu nástrojů nevejde na aktuální řádek nebo když zadáte rozložení (například určitý počet tlačítek panelu nástrojů na řádek).

Rozhraní toto tlačítko umístí na další řádek, pokud je tento datový člen nastaven na HODNOTU TRUE a panel nástrojů je ukotven vodorovně nebo plovoucí.

Výchozí hodnota tohoto datového členu je FALSE.

CMFCToolBarButton::m_bWrapText

Určuje, jestli jsou povolené popisky textu s více řádky.

AFX_IMPORT_DATA static BOOL m_bWrapText;

Poznámky

Pokud má tato statická členová proměnná hodnotu TRUE, umožňuje rozhraní všem panelům nástrojů zobrazit víceřádkové popisky textu na tlačítkách panelu nástrojů.

Výchozí hodnota tohoto datového členu je FALSE.

CMFCToolBarButton::m_nID

ID příkazu tlačítka.

UINT m_nID;

Poznámky

ID příkazu -1 označuje, že je tlačítko oddělovačem. Všechny oddělovače tlačítek mají styl TBBS_SEPARATOR. Další informace o stylech tlačítek najdete v tématu CMFCToolBarButton::m_nStyle .

CMFCToolBarButton::m_nStyle

Styl tlačítka

UINT m_nStyle;

Poznámky

Seznam dostupných stylů tlačítek panelu nástrojů najdete v části Styly ovládacích prvků ToolBar.

CMFCToolBarButton::m_strText

Textový popisek tlačítka.

CString m_strText;

Poznámky

Tento datový člen obsahuje textový popisek tlačítka. Textový popisek může být prázdný.

CMFCToolBarButton::NotifyCommand

Určuje, jestli tlačítko zpracovává zprávu WM_COMMAND .

virtual BOOL NotifyCommand(int iNotifyCode);

Parametry

iNotifyCode
[v] Zpráva s oznámením, která je přidružená k příkazu.

Návratová hodnota

Tato metoda vrátí hodnotu FALSE.

Poznámky

Architektura volá tuto metodu, když se chystá odeslat WM_COMMAND zprávu do nadřazeného okna.

Ve výchozím nastavení vrátí tato metoda hodnotu FALSE. Tuto metodu přepište tak, aby vracela hodnotu TRUE, pokud chcete zpracovat WM_COMMAND zprávu nebo NEPRAVDA, aby bylo uvedeno, že nadřazený panel nástrojů by měl zprávu zpracovat.

CMFCToolBarButton::OnAddToCustomizePage

Volá se rozhraním při přidání tlačítka do dialogového okna Přizpůsobit .

virtual void OnAddToCustomizePage();

Poznámky

Výchozí implementace této metody nic nedělá. Tuto metodu přepište, pokud chcete provést nějakou akci při přidání tlačítka do dialogového okna Přizpůsobit .

CMFCToolBarButton::OnBeforeDrag

Určuje, zda lze tlačítko přetáhnout.

virtual BOOL OnBeforeDrag() const;

Návratová hodnota

TRUE, pokud tlačítko lze přetáhnout; jinak NEPRAVDA.

Poznámky

Architektura volá tuto metodu před tím, než uživatel začne přetahovat tlačítko.

Výchozí implementace této metody vrátí hodnotu TRUE. Tuto metodu přepište tak, aby se vrátila hodnota FALSE, aby se zakázalo přetahování tlačítka.

CMFCToolBarButton::OnBeforeDrop

Určuje, jestli uživatel může tlačítko přetáhnout na cílový panel nástrojů.

virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);

Parametry

pTarget
[v] Cíl operace přetažení.

Návratová hodnota

TRUE, pokud lze tlačítko přehodit na poskytnutý cílový panel nástrojů; jinak NEPRAVDA.

Poznámky

Architektura volá tuto metodu před tím, než se tlačítko přehodí na panel nástrojů.

Výchozí implementace této metody vrátí hodnotu TRUE. Tuto metodu přepište tak, aby se vrátila NEPRAVDA, aby se zakázala operace vyřazení zadaného cíle.

CMFCToolBarButton::OnCalculateSize

Volané rozhraním pro výpočet velikosti tlačítka pro zadaný kontext zařízení a stav ukotvení.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parametry

pDC
[v] Kontext zařízení, který tlačítko zobrazí.

sizeDefault
[v] Výchozí velikost tlačítka.

bHorz
[v] Stav ukotvení nadřazeného panelu nástrojů Tento parametr je TRUE, pokud je panel nástrojů ukotven vodorovně nebo plovoucí, nebo NEPRAVDA, pokud je panel nástrojů ukotven svisle.

Návratová hodnota

Struktura SIZE , která obsahuje rozměry tlačítka v pixelech.

Poznámky

Architektura volá tuto metodu k určení velikosti tlačítka panelu nástrojů pro zadaný kontext zařízení a stav docku.

Výchozí implementace bere v úvahu velikost textu a obrázků (pokud jsou zobrazeny), umístění textu a obrázku (text pod nebo na pravé straně obrázku) a stav ukotvení panelu nástrojů.

Tuto metodu přepište, pokud chcete zadat nestandardní tlačítko (například tlačítko pro úpravy).

CMFCToolBarButton::OnCancelMode

Volá se rozhraním pro zpracování WM_CANCELMODE zprávy.

virtual void OnCancelMode();

Poznámky

Výchozí implementace této metody nic nedělá. Tuto metodu přepište, pokud chcete zpracovat WM_CANCELMODE zprávu.

CMFCToolBarButton::OnChangeParentWnd

Volá se rozhraním při vložení tlačítka do nového panelu nástrojů.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parametry

pWndParent
[v] Nové nadřazené okno.

Poznámky

Tlačítko se vloží do panelu nástrojů, například když ho uživatel přetáhne z jednoho panelu nástrojů na jiný panel nástrojů.

Výchozí implementace této metody nic nedělá.

CMFCToolBarButton::OnClick

Volá se rozhraním, když uživatel klikne na tlačítko myši.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay=TRUE);

Parametry

pWnd
[v] Nadřazené okno tlačítka panelu nástrojů

bDelay
[v] TRUE, pokud by zpráva měla být zpracována se zpožděním.

Návratová hodnota

Tato metoda vrátí hodnotu FALSE.

Poznámky

Architektura volá tuto metodu, když uživatel klikne na tlačítko panelu nástrojů.

Výchozí implementace nic nedělá a vrací hodnotu FALSE. Tuto metodu přepište tak, aby vrátil nenulovou hodnotu, pokud tlačítko zpracuje zprávu kliknutí.

CMFCToolBarButton::OnClickUp

Volá se rozhraním, když uživatel uvolní tlačítko myši.

virtual BOOL OnClickUp();

Návratová hodnota

Tato metoda vrátí hodnotu FALSE.

Poznámky

Architektura volá tuto metodu, když uživatel uvolní tlačítko panelu nástrojů.

Výchozí implementace nic nedělá a vrací hodnotu FALSE. Tuto metodu přepište tak, aby vrátil nenulovou hodnotu, pokud tlačítko zpracuje zprávu kliknutí.

CMFCToolBarButton::OnContextHelp

Volá se rozhraním, když nadřazený panel nástrojů zpracovává zprávu WM_HELPHITTEST.

virtual BOOL OnContextHelp(CWnd* pWnd);

Parametry

pWnd
[v] Nadřazené okno tlačítka panelu nástrojů

Návratová hodnota

Tato metoda vrátí hodnotu FALSE.

Poznámky

Výchozí implementace této metody nedělá nic a vrací hodnotu FALSE. Tuto metodu přepište tak, aby vrátil nenulovou hodnotu, pokud tlačítko zpracuje zprávu nápovědy.

Další informace o WM_HELPHITTEST zprávě naleznete v tématu TN028: Podpora kontextové nápovědy.

CMFCToolBarButton::OnCtlColor

Volá se rozhraním, když nadřazený panel nástrojů zpracovává zprávu WM_CTLCOLOR.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parametry

pDC
[v] Kontext zařízení, který tlačítko zobrazí.

nCtlColor
[v] Konkrétní barevné oznámení.

Návratová hodnota

Úchyt objektu štětce, který rozhraní používá k vykreslení pozadí tlačítka.

Poznámky

Architektura volá tuto metodu, když nadřazený panel nástrojů zpracuje WM_CTLCOLOR zprávu pro tlačítko panelu nástrojů, které obsahuje ovládací prvek Windows. Architektura tuto metodu nevolá, pokud je tlačítko panelu nástrojů bez oken.

Architektura volá tuto metodu, pokud je architektura panelu nástrojů v režimu přizpůsobení a tlačítko panelu nástrojů je odemknuté. Další informace o režimu přizpůsobení naleznete v tématu CMFCToolBar::SetCustomizeMode. Další informace o uzamčení tlačítek panelu nástrojů naleznete v tématu CMFCToolBarButton::IsLocked.

Výchozí implementace nic nedělá a vrací hodnotu NULL.

CMFCToolBarButton::OnCustomizeMenu

Umožňuje tlačítku změnit poskytnutou nabídku, když aplikace zobrazí místní nabídku na nadřazené panelu nástrojů.

virtual BOOL OnCustomizeMenu(CMenu* pMenu);

Parametry

pMenu
[v] Nabídka, která se má přizpůsobit.

Návratová hodnota

Tato metoda vrátí hodnotu FALSE.

Poznámky

Výchozí implementace nic nedělá a vrací hodnotu FALSE. Tuto metodu přepište a vraťte nenulovou hodnotu, pokud chcete změnit obsah poskytnuté nabídky.

CMFCToolBarButton::OnDblClk

Volá se rozhraním, když nadřazený panel nástrojů zpracovává zprávu WM_LBUTTONDBLCLK .

virtual void OnDblClk(CWnd* pWnd);

Parametry

pWnd
[in] – nadřazené okno tlačítka.

Poznámky

Tato metoda je volána metodou CMFCToolBar::OnLButtonDblClk , když nadřazený panel nástrojů zpracovává WM_LBUTTONDBLCLK zprávu.

Výchozí implementace této metody nic nedělá.

CMFCToolBarButton::OnDraw

Volá se rozhraním pro kreslení tlačítka pomocí zadaných stylů a možností.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz=TRUE,
    BOOL bCustomizeMode=FALSE,
    BOOL bHighlight=FALSE,
    BOOL bDrawBorder=TRUE,
    BOOL bGrayDisabledButtons=TRUE);

Parametry

pDC
[v] Kontext zařízení, který tlačítko zobrazí.

Rect
[v] Ohraničující obdélník tlačítka.

pImages
[v] Kolekce obrázků panelu nástrojů, které jsou přidružené k tlačítku.

bHorz
[v] Stav ukotvení nadřazeného panelu nástrojů Tento parametr je TRUE, pokud je tlačítko ukotveno vodorovně a NEPRAVDA, pokud je tlačítko ukotveno svisle.

bCustomizeMode
[v] Určuje, jestli je panel nástrojů v režimu přizpůsobení. Tento parametr je TRUE, pokud je panel nástrojů v režimu přizpůsobení a NEPRAVDA, pokud panel nástrojů není v režimu přizpůsobení.

bHighlight
[v] Určuje, jestli je tlačítko zvýrazněné. Tento parametr je TRUE, pokud je tlačítko zvýrazněné a NEPRAVDA, pokud tlačítko není zvýrazněno.

bDrawBorder
[v] Určuje, jestli má tlačítko zobrazit jeho ohraničení. Tento parametr je TRUE, pokud by mělo tlačítko zobrazit jeho ohraničení a NEPRAVDA, pokud by se nemělo zobrazit jeho ohraničení.

bGrayDisabledButtons
[v] Určuje, jestli se mají vystínovat zakázaná tlačítka nebo použít zakázanou kolekci obrázků. Tento parametr je TRUE, pokud by zakázaná tlačítka měla být stínována a FALSE, pokud by tato metoda měla používat zakázanou kolekci obrázků.

Poznámky

Tuto metodu přepište, pokud chcete přizpůsobit výkres tlačítka panelu nástrojů.

CMFCToolBarButton::OnDrawOnCustomizeList

Volá se rozhraním pro kreslení tlačítka v podokně Příkazy dialogového okna Přizpůsobit .

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parametry

pDC
[v] Kontext zařízení, který tlačítko zobrazí.

Rect
[v] Ohraničující obdélník tlačítka.

bSelected
[v] Určuje, zda je tlačítko vybráno. Pokud je tento parametr TRUE, je tlačítko vybráno. Pokud je tento parametr NEPRAVDA, tlačítko není vybráno.

Návratová hodnota

Šířka tlačítka v pixelech v zadaném kontextu zařízení.

Poznámky

Tato metoda je volána pomocí dialogového okna přizpůsobení ( příkazy karta), když se tlačítko chystá zobrazit v seznamu vlastník-kreslení.

Výchozí implementace této metody zobrazí obrázek a textový popisek tlačítka, pokud jsou k dispozici. Pokud textový popisek tlačítka není k dispozici, metoda zobrazí text popisu.

Přepište tuto metodu pro vlastní výkres.

CMFCToolBarButton::OnGetCustomToolTipText

Zavolá se rozhraním pro načtení vlastního textu popisu tlačítka.

virtual BOOL OnGetCustomToolTipText(CString& strToolTip);

Parametry

strToolTip
[ven] Objekt CString , který obdrží vlastní text popisu.

Návratová hodnota

Tato metoda vrátí hodnotu FALSE.

Poznámky

Architektura volá tuto metodu, když zobrazí popis tlačítka panelu nástrojů. Pokud tato metoda vrátí HODNOTU FALSE, architektura používá výchozí popis.

Výchozí implementace nic nedělá a vrací hodnotu FALSE. Přepište tuto metodu a vraťte nenulovou hodnotu a zadejte vlastní text popisu pro tlačítko panelu nástrojů.

CMFCToolBarButton::OnGlobalFontsChanged

Volá se architekturou, když se globální písmo změnilo.

virtual void OnGlobalFontsChanged();

Poznámky

Výchozí implementace této metody nic nedělá. Tuto metodu přepište tak, aby se aktualizovalo písmo použité k zobrazení textu tlačítka.

CMFCToolBarButton::Onmove

Volá se rozhraním, když se nadřazený panel nástrojů přesune.

virtual void OnMove();

Poznámky

Výchozí implementace této metody nic nedělá. Přepsat tuto metodu pro změnu umístění tlačítka při přesunutí nadřazeného panelu nástrojů.

CMFCToolBarButton::OnShow

Volá se rozhraním, když se tlačítko stane viditelným nebo neviditelným.

virtual void OnShow(BOOL bShow);

Parametry

BShow
[v] Určuje, jestli je tlačítko viditelné. Pokud je tento parametr TRUE, tlačítko je viditelné. Jinak tlačítko není viditelné.

Poznámky

Výchozí implementace této metody nic nedělá. Tuto metodu přepište, aby se aktualizovala viditelnost tlačítka.

CMFCToolBarButton::Onsize

Volá se rozhraním, když nadřazený panel nástrojů změní jeho velikost nebo umístění a tato změna způsobí změnu velikosti tlačítka.

virtual void OnSize(int iSize);

Parametry

iSize
[v] Nová šířka tlačítka.

Poznámky

Výchozí implementace této metody nic nedělá. Tuto metodu přepište tak, aby se při změně velikosti nebo umístění nadřazeného panelu nástrojů změnila velikost tlačítka.

CMFCToolBarButton::OnToolHitTest

Volá se rozhraním, když nadřazený panel nástrojů musí určit, zda je bod v ohraničující obdélník tlačítka.

virtual BOOL OnToolHitTest(
    const CWnd* pWnd,
    TOOLINFO* pTI);

Parametry

pWnd
[v] Nadřazené okno tlačítka Může mít hodnotu NULL.

Pti
[v] Struktura TOOLINFO , která obsahuje informace o nástroji v ovládacím prvku popisku

Návratová hodnota

Výsledek OnMenuButtonToolHitTest , jestli tlačítko může načíst ukazatel na nadřazené okno rámce, jinak NEPRAVDA.

Poznámky

Tato metoda volá jednu z následujících metod, pokud může převést nadřazené okno na platný objekt rámce:

CMFCToolBarButton::OnUpdateToolTip

Volá se rozhraním, když nadřazený panel nástrojů aktualizuje text popisu.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parametry

pWndParent
[v] Nadřazené okno.

iButtonIndex
[v] Index tlačítka založený na nule v kolekci nadřazených tlačítek.

wndToolTip
[v] Ovládací prvek, který zobrazuje text popisu.

Str
[ven] Objekt CString , který obdrží aktualizovaný text popisu.

Návratová hodnota

Tato metoda vrátí hodnotu FALSE.

Poznámky

Výchozí implementace této metody nedělá nic a vrací hodnotu FALSE. Tuto metodu přepište tak, aby vracela nenulovou hodnotu, pokud zadáte textový řetězec popisu.

CMFCToolBarButton::P repareDrag

Volá se rozhraním, když se tlačítko chystá provést operaci přetažení.

virtual BOOL PrepareDrag(COleDataSource& srcItem);

Parametry

srcItem
[v] COleDataSource Objekt, který ukládá informace o stavu operace přetažení.

Návratová hodnota

TRUE, pokud operace proběhne úspěšně; jinak NEPRAVDA.

Poznámky

Architektura volá tuto metodu k přípravě tlačítka panelu nástrojů pro uložení jeho stavu v poskytnutém COleDataSource objektu. Tato metoda ukládá svůj stav serializací do sdíleného souboru a následným předáním tohoto souboru do metody COleDataSource::CacheGlobalData . Další informace o serializaci tlačítka panelu nástrojů naleznete v tématu CMFCToolBarButton::Serialize.

Tato metoda nedělá nic a vrátí hodnotu TRUE, pokud tlačítko nelze uložit ( CMFCToolBarButton::CanBeStored metoda vrátí HODNOTU FALSE). Vrátí hodnotu FALSE, pokud dojde k výjimce během serializace objektu.

Další informace o operacích přetahování myší OLE naleznete v tématu Přetažení a přetažení OLE.

CMFCToolBarButton::Rect

Načte ohraničující obdélník tlačítka.

const CRect& Rect() const;

Návratová hodnota

Objekt CRect , který obsahuje ohraničující obdélník tlačítka.

CMFCToolBarButton::ResetImageToDefault

Nastaví výchozí hodnotu obrázku přidruženého k tlačítku.

virtual void ResetImageToDefault();

Poznámky

Tato metoda načte výchozí obrázek z nadřazeného panelu nástrojů pomocí metody CMFCToolBar::GetDefaultImage . Pokud tlačítko nemá přidružený výchozí obrázek, tato metoda nastaví textový popisek tlačítka podle jeho řetězcového prostředku pomocí CStringT::LoadString metoda. Další informace o řetězcových prostředcích naleznete v tématu Práce se soubory prostředků.

Tato metoda nedělá nic, pokud má tlačítko uživatelsky definovaný obrázek.

CMFCToolBarButton::SaveBarState

Uloží stav tlačítka panelu nástrojů.

virtual void SaveBarState();

Poznámky

Architektura volá tuto metodu CMFCToolBarButton při vytvoření objektu v důsledku operace přetažení a přetažení.

Výchozí implementace této metody nic nedělá. Tuto metodu přepište, pokud chcete uložit stav tlačítka panelu nástrojů do externího zdroje dat.

CMFCToolBarButton::Serialize

Načte tento objekt z archivu nebo ho zapíše do archivu.

virtual void Serialize(CArchive& ar);

Parametry

ar
[v] Objekt CArchive , ze kterého nebo do kterého se má serializovat.

Poznámky

Tato metoda podporuje procesy přenosu dat, jako je schránka nebo operace přetažení. Čte nebo zapisuje vlastnosti tlačítka, jako je ID, textový popisek a ID obrázku z nebo do zadaného CArchive objektu.

Příklady serializace naleznete v tématu Serializace: Serializace objektu.

CMFCToolBarButton::SetACCData

Naplní zadaný CAccessibilityData objekt daty přístupnosti z tlačítka panelu nástrojů.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parametry

pParent
[v] Nadřazené okno tlačítka panelu nástrojů

data
[v] Objekt CAccessibilityData , který je naplněný daty přístupnosti tlačítka panelu nástrojů.

Návratová hodnota

Tato metoda vrátí hodnotu TRUE.

Poznámky

Tuto metodu přepište tak, aby se vrátila NEPRAVDA, pokud tlačítko panelu nástrojů neposkytuje data přístupnosti.

CMFCToolBarButton::SetClipboardFormatName

Přejmenuje globální formát schránky.

static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);

Parametry

lpszName
[v] Nový název globálního formátu schránky. Nesmí mít hodnotu NULL.

Poznámky

Tato metoda umožňuje provádět operace přetažení mezi více aplikacemi. Každá aplikace musí zadat stejný název formátu schránky.

Tuto metodu je nutné volat před voláním rozhraní CMFCToolBarButton::GetClipboardFormat.

CMFCToolBarButton::SetImage

Nastaví index obrázku tlačítka.

virtual void SetImage(int iImage);

Parametry

iImage
[v] Index obrázku v kolekci obrázků na panelu nástrojů

Poznámky

Pokud je tlačítko panelu nástrojů oddělovačem, iImage odkazuje na novou šířku tlačítka oddělovače.

Pokud je iImage menší než nula, tato metoda zakáže kreslení obrázku a povolí kreslení textového popisku tlačítka.

CMFCToolBarButton::SetProtectedCommands

Nastaví seznam příkazů, které uživatel nemůže přizpůsobit.

static void SetProtectedCommands(const CList<UINT,UINT>& lstCmds);

Parametry

lstCmds
[v] Seznam chráněných příkazů

Poznámky

K načtení seznamu chráněných příkazů použijte metodu CMFCToolBarButton::GetProtectedCommands .

CMFCToolBarButton::SetRadio

Volá se rozhraním, když tlačítko změní jeho stav zaškrtnutí.

virtual void SetRadio();

Poznámky

Výchozí implementace této metody nic nedělá. Přepsat tuto metodu provést vlastní akci, když tlačítko změní jeho stav zaškrtnuté.

CMFCToolBarButton::SetRect

Nastaví ohraničující obdélník tlačítka.

void SetRect(const CRect rect);

Parametry

Rect
[v] Nový ohraničující obdélník tlačítka.

Poznámky

Tato metoda volá CMFCToolBarButton::OnMove metoda po nastavení nového ohraničujícího obdélníku.

CMFCToolBarButton::SetStyle

Nastaví styl tlačítka.

virtual void SetStyle(UINT nStyle);

Parametry

nStyle
[v] Nový styl tlačítka.

Poznámky

Výchozí implementace nastaví CMFCToolBarButton::m_nStyle datový člen na nStyle. Tuto metodu přepište, pokud chcete provést další zpracování pro zpracování změny ve stylu. Seznam platných příznaků stylu najdete v části Styly ovládacího prvku ToolBar.

CMFCToolBarButton::SetVisible

Určuje, jestli je tlačítko viditelné.

void SetVisible(BOOL bShow=TRUE);

Parametry

BShow
[v] Logická hodnota, která určuje, jestli se má tlačítko zobrazit nebo skrýt. Pokud je tento parametr TRUE, zobrazí se tlačítko. Pokud je parametr NEPRAVDA, tlačítko je skryté.

Poznámky

Pomocí této funkce můžete skrýt nebo zobrazit konkrétní tlačítko panelu nástrojů. Volání CPane::AdjustSizeImmediate metoda po volání této metody.

CMFCToolBarButton::Show

Zobrazí nebo skryje tlačítko.

void Show(BOOL bShow);

Parametry

BShow
[v] Logická hodnota, která určuje, jestli se má tlačítko zobrazit nebo skrýt. Pokud je tento parametr TRUE, zobrazí se tlačítko. Pokud je parametr NEPRAVDA, tlačítko je skryté.

Poznámky

Architektura volá tuto metodu pro aktualizaci viditelnosti tlačítek panelu nástrojů při změně velikosti nadřazeného panelu nástrojů. Architektura volá tuto metodu s bShow nastavena na FALSE, když tlačítko již nevejde do hranic panelu nástrojů. Architektura volá tuto metodu s bShow nastavenou na TRUE, když po změně velikosti tlačítka znovu zapadá do hranic panelu nástrojů.

K nastavení obecné viditelnosti tlačítka použijte CMFCToolBarButton::SetVisible metoda.

Tato metoda volá CMFCToolBarButton::OnShow metoda po aktualizaci stavu viditelnosti tlačítka.

Viz také

Graf hierarchie
Třídy
CMFCToolBar – třída
CMFCToolBarImages – třída

Sdílet prostřednictvím

CMFCToolBarButton – třída

Syntaxe

Členové

Veřejné konstruktory

Veřejné metody

Datové členy

Poznámky

Příklad

Hierarchie dědičnosti

Požadavky

CMFCToolBarButton::CanBeDropped

Parametry

Návratová hodnota

Poznámky

CMFCToolBarButton::CanBeStored

Návratová hodnota

Poznámky

CMFCToolBarButton::CanBeStretched

Návratová hodnota

Poznámky

CMFCToolBarButton::CMFCToolBarButton

Parametry

CMFCToolBarButton::CompareWith

Parametry

Návratová hodnota

Poznámky

CMFCToolBarButton::CopyFrom

Parametry

Poznámky

CMFCToolBarButton::CreateFromOleData

Parametry

Návratová hodnota

Poznámky

CMFCToolBarButton::EnableWindow

Parametry

Poznámky

CMFCToolBarButton::ExportToMenuButton

Parametry

Návratová hodnota

Poznámky

CMFCToolBarButton::GetClipboardFormat

Návratová hodnota

Poznámky

CMFCToolBarButton::GetHwnd

Návratová hodnota

Poznámky

CMFCToolBarButton::GetImage

Návratová hodnota

Poznámky

CMFCToolBarButton::GetInvalidateRect

Návratová hodnota

Poznámky

CMFCToolBarButton::GetParentWnd

Návratová hodnota

CMFCToolBarButton::GetProtectedCommands

Návratová hodnota

Poznámky

CMFCToolBarButton::GetTextSize

Návratová hodnota

CMFCToolBarButton::HasFocus

Návratová hodnota

Poznámky

CMFCToolBarButton::HaveHotBorder

Návratová hodnota

Poznámky

CMFCToolBarButton::IsDrawImage

Návratová hodnota

Poznámky

CMFCToolBarButton::IsDrawText

Návratová hodnota

Poznámky

CMFCToolBarButton::IsDroppedDown

Návratová hodnota

Poznámky

CMFCToolBarButton::IsEditable

Návratová hodnota

Poznámky

CMFCToolBarButton::IsExtraSize

Návratová hodnota