Sdílet prostřednictvím


CMFCToolBarMenuButton – třída

Tlačítko panelu nástrojů, které obsahuje místní nabídku Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.

Syntaxe

class CMFCToolBarMenuButton : public CMFCToolBarButton

Členové

Veřejné konstruktory

Jméno popis
CMFCToolBarMenuButton::CMFCToolBarMenuButton CMFCToolBarMenuButton Vytvoří objekt.

Veřejné metody

Jméno popis
CMFCToolBarMenuButton::CompareWith Porovná tuto instanci se zadaným CMFCToolBarButton objektem. (Přepsání CMFCToolBarButton::CompareWith.)
CMFCToolBarMenuButton::CopyFrom Zkopíruje vlastnosti jiného tlačítka panelu nástrojů na aktuální tlačítko. (Přepsání CMFCToolBarButton::CopyFrom.)
CMFCToolBarMenuButton::CreateFromMenu Inicializuje nabídku panelu nástrojů z úchytu nabídky Systému Windows.
CMFCToolBarMenuButton::CreateMenu Vytvoří nabídku Windows, která se skládá z příkazů v nabídce panelu nástrojů. Vrátí popisovač nabídky Windows.
CMFCToolBarMenuButton::CreatePopupMenu Vytvoří objekt místní nabídky ( CMFCPopupMenu Class) pro zobrazení nabídky panelu nástrojů.
CMFCToolBarMenuButton::EnableQuickCustomize
CMFCToolBarMenuButton::GetCommands Poskytuje přístup jen pro čtení k seznamu příkazů v nabídce panelu nástrojů.
CMFCToolBarMenuButton::GetImageRect Načte ohraničující obdélník obrázku tlačítka.
CMFCToolBarMenuButton::GetPaletteRows Vrátí počet řádků v místní nabídce, když je nabídka v režimu palety.
CMFCToolBarMenuButton::GetPopupMenu Vrátí ukazatel na objekt místní nabídky přidružený k tlačítku.
CMFCToolBarMenuButton::HasButton
CMFCToolBarMenuButton::HaveHotBorder Určuje, zda se zobrazí ohraničení tlačítka, když uživatel tlačítko vybere. (Přepsání CMFCToolBarButton::HaveHotBorder.)
CMFCToolBarMenuButton::IsBorder
CMFCToolBarMenuButton::IsClickedOnMenu
CMFCToolBarMenuButton::IsDroppedDown Určuje, zda je zobrazena místní nabídka.
CMFCToolBarMenuButton::IsEmptyMenuAllowed Volané architekturou k určení, zda uživatel může otevřít podnabídku z vybrané položky nabídky.
CMFCToolBarMenuButton::IsExclusive Určuje, zda je tlačítko ve výhradním režimu, to znamená, zda místní nabídka zůstane otevřená, i když uživatel přesune ukazatel na jiný panel nástrojů nebo tlačítko.
CMFCToolBarMenuButton::IsMenuPaletteMode Určuje, zda je místní nabídka v režimu palety.
CMFCToolBarMenuButton::IsQuickMode
CMFCToolBarMenuButton::IsTearOffMenu Určuje, jestli má místní nabídka odtrženou lištu.
CMFCToolBarMenuButton::OnAfterCreatePopupMenu
CMFCToolBarMenuButton::OnBeforeDrag Určuje, zda lze tlačítko přetáhnout. (Přepsání CMFCToolBarButton::OnBeforeDrag.)
CMFCToolBarMenuButton::OnCalculateSize Volané rozhraním pro výpočet velikosti tlačítka pro zadaný kontext zařízení a stav ukotvení. (Přepsání CMFCToolBarButton::OnCalculateSize.)
CMFCToolBarMenuButton::OnCancelMode Volá se rozhraním pro zpracování WM_CANCELMODE zprávy. (Přepsání CMFCToolBarButton::OnCancelMode.)
CMFCToolBarMenuButton::OnChangeParentWnd Volá se rozhraním při vložení tlačítka do nového panelu nástrojů. (Přepsání CMFCToolBarButton::OnChangeParentWnd.)
CMFCToolBarMenuButton::OnClick Volá se rozhraním, když uživatel klikne na tlačítko myši. (Přepsání CMFCToolBarButton::OnClick.)
CMFCToolBarMenuButton::OnClickMenuItem Volá se podle architektury, když uživatel vybere položku v místní nabídce.
CMFCToolBarMenuButton::OnContextHelp Volá se rozhraním, když nadřazený panel nástrojů zpracovává zprávu WM_HELPHITTEST. (Přepsání CMFCToolBarButton::OnContextHelp.)
CMFCToolBarMenuButton::OnDraw Volá se rozhraním pro kreslení tlačítka pomocí zadaných stylů a možností. (Přepsání CMFCToolBarButton::OnDraw.)
CMFCToolBarMenuButton::OnDrawOnCustomizeList Volá se rozhraním pro kreslení tlačítka v podokně Příkazy dialogového okna Přizpůsobit . (Přepsání CMFCToolBarButton::OnDrawOnCustomizeList.)
CMFCToolBarMenuButton::OpenPopupMenu Volá se rozhraním, když uživatel otevře místní nabídku.
CMFCToolBarMenuButton::ResetImageToDefault Nastaví výchozí hodnotu obrázku přidruženého k tlačítku. (Přepsání CMFCToolBarButton::ResetImageToDefault.)
CMFCToolBarMenuButton::SaveBarState Uloží stav tlačítka panelu nástrojů. (Přepsání CMFCToolBarButton::SaveBarState.)
CMFCToolBarMenuButton::Serialize Načte tento objekt z archivu nebo ho zapíše do archivu. (Přepsání CMFCToolBarButton::Serialize.)
CMFCToolBarMenuButton::SetACCData Naplní zadaný CAccessibilityData objekt daty přístupnosti z tlačítka panelu nástrojů. (Přepsání CMFCToolBarButton::SetACCData.)
CMFCToolBarMenuButton::SetMenuOnly Určuje, jestli se tlačítko dá přidat na panel nástrojů.
CMFCToolBarMenuButton::SetMenuPaletteMode Určuje, jestli je místní nabídka v režimu palety.
CMFCToolBarMenuButton::SetMessageWnd
CMFCToolBarMenuButton::SetRadio Vynutí tlačítko nabídky panelu nástrojů zobrazit ikonu označující, že je vybraná.
CMFCToolBarMenuButton::SetTearOff Určuje ID pruhu pro odtržení pro místní nabídku.

Chráněné metody

Jméno popis
CMFCToolBarMenuButton::D rawDocumentIcon Nakreslí ikonu na tlačítko nabídky.

Datové členy

Jméno popis
CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw Pokud true, architektura vždy volá CFrameWndEx::OnDrawMenuImage při vykreslení tlačítka.

Poznámky

A CMFCToolBarMenuButton se může zobrazit jako nabídka, položka nabídky s dílčí nabídkou, tlačítko, které buď spustí příkaz, nebo zobrazí nabídku nebo tlačítko, které zobrazuje pouze nabídku. Chování a vzhled tlačítka nabídky určíte zadáním parametrů, jako je obrázek, text, popisovač nabídky a ID příkazu, které je přidruženo k tlačítku v konstruktoru CMFCToolbarMenuButton::CMFCToolbarMenuButton.

Vlastní třída odvozená z CMFCToolbarMenuButton třídy musí používat makro DECLARE_SERIAL . Makro DECLARE_DYNCREATE při zavření aplikace vygeneruje chybu.

Příklad

Následující příklad ukazuje, jak nakonfigurovat CMFCToolBarMenuButton objekt. Kód ukazuje, jak určit, že rozevírací nabídka je v režimu palety, a zadat ID pro pruh pro odtržení, který se vytvoří, když uživatel přetáhne tlačítko nabídky mimo řádek nabídek. Tento fragment kódu je součástí ukázky wordové oblasti.

pBorderType->SetMenuPaletteMode(TRUE, 2 /* Rows number */);
pBorderType->SetTearOff(ID_BORDER_TEAROFF);

Hierarchie dědičnosti

Objekt CObject

CMFCToolBarButton

CMFCToolBarMenuButton

Požadavky

Hlavička: afxtoolbarmenubutton.h

CMFCToolBarMenuButton::CMFCToolBarMenuButton

CMFCToolBarMenuButton Vytvoří objekt.

CMFCToolBarMenuButton();
CMFCToolBarMenuButton(const CMFCToolBarMenuButton& src);

CMFCToolBarMenuButton(
    UINT uiID,
    HMENU hMenu,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE);

Parametry

Src
[v] Existující CMFCToolBarMenuButton objekt, který se má do tohoto CMFCToolBarMenuButton objektu zkopírovat.

UIID
[v] ID příkazu, který se má spustit, když uživatel klikne na tlačítko; nebo (UINT)-1 pro tlačítko nabídky, které nespustí příkaz přímo.

hMenu
[v] Popisovač nabídky; nebo NULL, pokud tlačítko nemá nabídku.

iImage
[v] Index obrázku tlačítka; nebo -1, pokud toto tlačítko nemá ikonu nebo používá ikonu pro příkaz určený pomocí UIID. Index je stejný pro každý CMFCToolBarImages objekt v aplikaci.

lpszText
[v] Text tlačítka nabídky panelu nástrojů

bUserButton
[v] TRUE, pokud tlačítko zobrazí uživatelsky definovaný obrázek; FALSE, pokud tlačítko zobrazí předdefinovaný obrázek přidružený k příkazu určenému pomocí UIID.

Poznámky

Pokud je ID uživatelského rozhraní platné ID příkazu, tlačítko provede tento příkaz, když na něj uživatel klikne. Pokud je hNabídka platným úchytem nabídky, zobrazí se po zobrazení na panelu nástrojů nebo podnabídce v nabídce rozevírací nabídka. Pokud jsou id uživatelského rozhraní i hMenu platné, tlačítko je rozdělené tlačítko s částí, která provede příkaz, když na něj uživatel klikne, a část se šipkou dolů, která zobrazí rozevírací nabídku, když na ni uživatel klikne. Pokud je však hodnota hMenu platná, uživatel nebude moci kliknout na tlačítko a provést příkaz při vložení tlačítka do nabídky.

Příklad

Následující příklad ukazuje, jak vytvořit objekt CMFCToolBarMenuButton třídy. Tento fragment kódu je součástí ukázky wordové oblasti.

CMFCToolBarMenuButton *pBorderType = new CMFCToolBarMenuButton(ID_BORDER_1, pPopup->GetSafeHmenu(),
                                                               GetCmdMgr()->GetCmdImage(ID_BORDER_1, FALSE),
                                                               _T("Borders"));

CMFCToolBarMenuButton::CompareWith

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parametry

[v] Další

Vrácená hodnota

Poznámky

CMFCToolBarMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parametry

[v] Src

Poznámky

CMFCToolBarMenuButton::CreateFromMenu

Inicializuje nabídku panelu nástrojů z úchytu nabídky Systému Windows.

virtual void CreateFromMenu(HMENU hMenu);

Parametry

hMenu
[v] Popisovač nabídky.

Poznámky

Tlačítko nabídky panelu nástrojů může zobrazit podnabídku rozevíracího seznamu.

Architektura volá tuto metodu pro inicializaci příkazů v podnabídce z nabídky.

CMFCToolBarMenuButton::CreateMenu

Vytvoří nabídku, která se skládá z příkazů v nabídce panelu nástrojů. Vrátí popisovač nabídky.

virtual HMENU CreateMenu() const;

Vrácená hodnota

Popisovač nabídky v případě úspěchu. Hodnota NULL, pokud je seznam příkazů přidružených k tlačítku nabídky panelu nástrojů prázdný.

Poznámky

Tuto metodu můžete přepsat v odvozené třídě, abyste přizpůsobili způsob generování nabídky.

CMFCToolBarMenuButton::CreatePopupMenu

CMFCPopupMenu Vytvoří objekt pro zobrazení nabídky panelu nástrojů.

virtual CMFCPopupMenu* CreatePopupMenu();

Vrácená hodnota

Ukazatel na CMFCPopupMenu objekt, který zobrazuje rozevírací nabídku přidruženou k tlačítku nabídky panelu nástrojů.

Poznámky

Tato metoda je volána rozhraním pro přípravu zobrazení rozevírací nabídky přidružené k tlačítku.

Výchozí implementace pouze vytvoří a vrátí nový CMFCPopupMenu objekt. Tuto metodu přepište, pokud chcete použít odvozený typ CMFCPopupMenu Třídy nebo provést další inicializaci.

CMFCToolBarMenuButton::D rawDocumentIcon

Nakreslí ikonu dokumentu na tlačítku nabídky.

void DrawDocumentIcon(
    CDC* pDC,
    const CRect& rectImage,
    HICON hIcon);

Parametry

Pdc
[v] Ukazatel na kontext zařízení.

rectImage
[v] Souřadnice ohraničujícího obdélníku obrázku

hIcon
[v] Úchyt ikony.

Poznámky

Tato metoda přebírá ikonu dokumentu a nakreslí ji na tlačítko nabídky na střed v oblasti určené rectImage.

CMFCToolBarMenuButton::EnableQuickCustomize

void EnableQuickCustomize();

Poznámky

CMFCToolBarMenuButton::HasButton

virtual BOOL HasButton() const;

Vrácená hodnota

Poznámky

CMFCToolBarMenuButton::HaveHotBorder

virtual BOOL HaveHotBorder() const;

Vrácená hodnota

Poznámky

CMFCToolBarMenuButton::IsBorder

virtual BOOL IsBorder() const;

Vrácená hodnota

Poznámky

CMFCToolBarMenuButton::IsClickedOnMenu

BOOL IsClickedOnMenu() const;

Vrácená hodnota

Poznámky

CMFCToolBarMenuButton::IsQuickMode

BOOL IsQuickMode();

Vrácená hodnota

Poznámky

CMFCToolBarMenuButton::GetCommands

Poskytuje přístup jen pro čtení k seznamu příkazů v nabídce panelu nástrojů.

const CObList& GetCommands() const;

Vrácená hodnota

Const odkaz na CObList Class objekt, který obsahuje kolekci CMFCToolBarButton Class objekty.

Poznámky

Tlačítko nabídky panelu nástrojů může zobrazit podnabídku. Seznam příkazů můžete zadat v podnabídce v konstruktoru nebo v CMFCToolBarMenuButton::CreateFromMenu jako popisovač nabídky (HMENU). Nabídka je převedena na seznam objektů, které jsou odvozeny z CMFCToolBarButton Třídy a uloženy v interním CObList objektu. K tomuto seznamu se dostanete voláním této metody.

CMFCToolBarMenuButton::GetImageRect

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

void GetImageRect(CRect& rectImage);

Parametry

rectImage
[ven] Odkaz na CRect objekt, který přijímá souřadnice ohraničujícího obdélníku obrázku.

CMFCToolBarMenuButton::GetPaletteRows

Vrátí počet řádků v rozevírací nabídce, když je nabídka v režimu palety.

int GetPaletteRows() const;

Vrácená hodnota

Počet řádků v paletě

Poznámky

Když je tlačítko nabídky nastavené na režim palety, položky nabídky se zobrazí ve více sloupcích s omezeným počtem řádků. Voláním této metody získáte počet řádků. Režim palety můžete povolit nebo zakázat a určit počet řádků pomocí CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::GetPopupMenu

Vrátí ukazatel na OBJEKT CMFCPopupMenu Class , který představuje rozevírací nabídku tlačítka.

CMFCPopupMenu* GetPopupMenu() const;

Vrácená hodnota

Ukazatel na objekt CMFCPopupMenu Class , který byl vytvořen při vytvoření architektury nakreslil podnabídku tlačítka nabídky panelu nástrojů; Null pokud se nezobrazí žádná podnabídka.

Poznámky

Když tlačítko nabídky panelu nástrojů zobrazí rozevírací nabídku, tlačítko vytvoří CMFCPopupMenu Class objekt představující nabídku. Voláním této metody získáte ukazatel na CMFCPopupMenu objekt. Vrácený ukazatel byste neměli ukládat, protože je dočasný a stane se neplatným, když uživatel zavře rozevírací nabídku.

CMFCToolBarMenuButton::IsDroppedDown

Určuje, zda je aktuálně zobrazena místní nabídka.

virtual BOOL IsDroppedDown() const;

Vrácená hodnota

TRUE, pokud tlačítko nabídky panelu nástrojů zobrazí jeho podnabídku; jinak NEPRAVDA.

CMFCToolBarMenuButton::IsEmptyMenuAllowed

Určuje, zda položky nabídky zobrazují prázdné podnabídky.

virtual BOOL IsEmptyMenuAllowed() const;

Vrácená hodnota

TRUE, pokud architektura otevře podnabídku z aktuálně vybrané položky nabídky, i když podnabídka je prázdná; jinak NEPRAVDA.

Poznámky

Architektura volá tuto metodu, když se uživatel pokusí otevřít podnabídku z aktuálně vybrané položky nabídky. Pokud je podnabídka prázdná a IsEmptyMenuAllowed vrátí hodnotu FALSE, podnabídka se neotevře.

Výchozí implementace vrátí hodnotu FALSE. Tuto metodu přepište, abyste toto chování přizpůsobili.

CMFCToolBarMenuButton::IsExclusive

Určuje, jestli je tlačítko ve výhradním režimu.

virtual BOOL IsExclusive() const;

Vrácená hodnota

TRUE, pokud tlačítko pracuje ve výhradním režimu; jinak NEPRAVDA.

Poznámky

Když uživatel otevře místní nabídku tlačítka a pak přesune ukazatel myši na jiný panel nástrojů nebo tlačítko nabídky, místní nabídka se zavře, pokud není tlačítko ve výhradním režimu.

Výchozí implementace vždy vrátí hodnotu FALSE. Tuto metodu přepište v odvozené třídě, pokud chcete zapnout výhradní režim.

CMFCToolBarMenuButton::IsMenuPaletteMode

Určuje, zda je rozevírací nabídka v režimu palety.

BOOL IsMenuPaletteMode() const;

Vrácená hodnota

TRUE, pokud je povolen režim palety, jinak NEPRAVDA.

Poznámky

Když je tlačítko nabídky nastavené na režim palety, položky nabídky se zobrazí ve více sloupcích s omezeným počtem řádků. Voláním této metody získáte počet řádků. Režim palety můžete povolit nebo zakázat voláním CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::IsTearOffMenu

Určuje, jestli rozevírací nabídka obsahuje odtržený pruh.

virtual BOOL IsTearOffMenu() const;

Vrácená hodnota

TRUE, pokud tlačítko nabídky panelu nástrojů má odtrhaný pruh; jinak NEPRAVDA.

Poznámky

Chcete-li povolit funkci odtržení a nastavit ID pruhu pro odtržení, zavolejte CMFCToolBarMenuButton::SetTearOff.

CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw

Určuje, zda architektura vždy volá CFrameWndEx::OnDrawMenuImage při vykreslení tlačítka.

static BOOL m_bAlwaysCallOwnerDraw;

Poznámky

Pokud je tato členová proměnná nastavena na TRUE, tlačítko vždy volá CFrameWndEx::OnDrawMenuImage metoda pro zobrazení obrázku na tlačítku. Když m_bAlwaysCallOwnerDraw je false, tlačítko samotné nakreslí obrázek, pokud je obrázek předdefinovaný. V opačném případě volá OnDrawMenuImage.

CMFCToolBarMenuButton::OnAfterCreatePopupMenu

virtual void OnAfterCreatePopupMenu();

Poznámky

CMFCToolBarMenuButton::OnBeforeDrag

virtual BOOL OnBeforeDrag() const;

Vrácená hodnota

Poznámky

CMFCToolBarMenuButton::OnCalculateSize

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

Parametry

[v] Pdc
[v] sizeDefault
[v] bHorz

Vrácená hodnota

Poznámky

CMFCToolBarMenuButton::OnCancelMode

virtual void OnCancelMode();

Poznámky

CMFCToolBarMenuButton::OnChangeParentWnd

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parametry

[v] pWndParent

Poznámky

CMFCToolBarMenuButton::OnClick

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

Parametry

[v] pWnd
[v] bDelay

Vrácená hodnota

Poznámky

CMFCToolBarMenuButton::OnClickMenuItem

Volá se rozhraním, když uživatel vybere položku v rozevírací nabídce.

virtual BOOL OnClickMenuItem();

Vrácená hodnota

NEPRAVDA, pokud by architektura měla pokračovat ve zpracování výchozí položky nabídky; jinak PRAVDA. Výchozí implementace vždy vrátí hodnotu FALSE.

Poznámky

Když uživatel klikne na položku nabídky, architektura spustí příkaz přidružený k této položce.

Chcete-li přizpůsobit zpracování položky nabídky, přepsání OnClickMenuItem třídy odvozené z CMFCToolBarMenuButton třídy. Musíte také přepsat CFrameWndEx::OnShowPopupMenu a nahradit tlačítka nabídky, které vyžadují speciální zpracování instancemi odvozené třídy.

CMFCToolBarMenuButton::OnContextHelp

virtual BOOL OnContextHelp(CWnd* pWnd);

Parametry

[v] pWnd

Vrácená hodnota

Poznámky

CMFCToolBarMenuButton::OnDraw

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

[v] Pdc
[v] Rect
[v] pImages
[v] bHorz
[v] bCustomizeMode
[v] bHighlight
[v] bDrawBorder
[v] bGrayDisabledButtons

Poznámky

CMFCToolBarMenuButton::OnDrawOnCustomizeList

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

Parametry

[v] Pdc
[v] Rect
[v] bSelected

Vrácená hodnota

Poznámky

CMFCToolBarMenuButton::OpenPopupMenu

Volá se rozhraním, když uživatel otevře rozevírací nabídku tlačítka nabídky panelu nástrojů.

virtual BOOL OpenPopupMenu(CWnd* pWnd=NULL);

Parametry

pWnd
[v] Určuje okno, které přijímá příkazy rozevírací nabídky. Může mít hodnotu NULL pouze v případě, že tlačítko nabídky panelu nástrojů obsahuje nadřazené okno.

Vrácená hodnota

TRUE, když CMFCPopupMenu Class objekt byl vytvořen a úspěšně otevřen; jinak NEPRAVDA.

Poznámky

Tato funkce je volána architekturou, když uživatel otevře rozevírací nabídku z tlačítka nabídky panelu nástrojů.

CMFCToolBarMenuButton::ResetImageToDefault

virtual void ResetImageToDefault();

Poznámky

CMFCToolBarMenuButton::SaveBarState

virtual void SaveBarState();

Poznámky

Architektura volá tuto metodu, když vytvoří tlačítko panelu nástrojů v důsledku operace přetažení a přetažení. Tato metoda volá CMFCPopupMenu::SaveState metoda místní nabídky nejvyšší úrovně, která způsobí, že nadřazené tlačítko místní nabídky znovu vytvoří její nabídku.

CMFCToolBarMenuButton::Serialize

virtual void Serialize(CArchive& ar);

Parametry

[v] ar

Poznámky

CMFCToolBarMenuButton::SetACCData

Nastaví data přístupnosti pro prvek pásu karet.

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

Parametry

pParent
Nadřazené okno prvku pásu karet

Dat
Data přístupnosti pro prvek pásu karet

Vrácená hodnota

Vždy vrátí hodnotu PRAVDA.

Poznámky

Ve výchozím nastavení tato metoda nastaví data přístupnosti pro prvek pásu karet a vždy vrátí hodnotu TRUE. Tuto metodu přepište, pokud chcete nastavit data přístupnosti a vrátit hodnotu, která značí úspěch nebo selhání.

CMFCToolBarMenuButton::SetMenuOnly

Určuje, jestli je tlačítko nakreslené jako tlačítko nabídky nebo rozdělené tlačítko, pokud má platné ID příkazu i podnabídku.

void SetMenuOnly(BOOL bMenuOnly);

Parametry

bNabídkaOnly
[v] PRAVDA, pokud chcete toto tlačítko zobrazit jako tlačítko nabídky, pokud má platné ID příkazu i podnabídku, FALSE zobrazí toto tlačítko jako rozdělené tlačítko, pokud má platné ID příkazu i podnabídku.

Poznámky

Když má tlačítko nabídky panelu nástrojů podnabídku i ID příkazu, vypadá nabídka jako rozdělené tlačítko, které obsahuje hlavní tlačítko a připojené tlačítko šipky dolů. Pokud zavoláte tuto metodu a bMenuOnly je PRAVDA, místo toho se tlačítko zobrazí jako jediné tlačítko nabídky se šipkou dolů na tlačítku. Když uživatel klikne na šipku v jiném režimu, podnabídka se otevře a když uživatel klikne na nešipekovou část tlačítka v obou režimech, spustí příkaz .

CMFCToolBarMenuButton::SetMenuPaletteMode

Určuje, jestli je rozevírací nabídka v režimu palety.

void SetMenuPaletteMode(
    BOOL bMenuPaletteMode=TRUE,
    int nPaletteRows=1);

Parametry

bMenuPaletteMode
[v] Určuje, jestli je rozevírací nabídka v režimu palety.

nPaletteRows
[v] Počet řádků v paletě

Poznámky

V režimu palety se všechny položky nabídky zobrazí jako paleta s více sloupci. Počet řádků zadáte pomocí nPaletteRows.

CMFCToolBarMenuButton::SetMessageWnd

void SetMessageWnd(CWnd* pWndMessage);

Parametry

[v] pWndMessage

Poznámky

CMFCToolBarMenuButton::SetRadio

Nastaví tlačítko nabídky panelu nástrojů tak, aby se při zaškrtnutí zobrazila ikona stylu přepínačů.

virtual void SetRadio();

Poznámky

Když je tlačítko nabídky nakresleno, když je zaškrtnuté, volá CMFCVisualManager::OnDrawMenuCheck pro kreslení ikony zaškrtnutí. Ve výchozím nastavení požaduje, OnDrawMenuCheck aby aktuální správce vizuálů na tlačítku nabídky nakreslil značku stylu zaškrtávacího políčka. Po volání této metody aktuální správce vizuálů místo toho nakreslí zaškrtnutí stylu přepínač na tlačítko nabídky. Tuto změnu nelze vrátit zpět.

Když zavoláte tuto metodu a tlačítko nabídky se právě zobrazí, aktualizuje se.

CMFCToolBarMenuButton::SetTearOff

Určuje ID pruhu pro odtržování rozevírací nabídky.

virtual void SetTearOff(UINT uiBarID);

Parametry

uiBarID
[v] Určuje nové ID pruhu odtrhání.

Poznámky

Voláním této metody určíte ID pro odtržený pruh, který se vytvoří, když uživatel přetáhne tlačítko nabídky mimo řádek nabídek. Pokud je parametr uiBarID 0, uživatel nemůže tlačítko nabídky vypnout.

Zavolejte CWinAppEx::EnableTearOffMenus a povolte funkci nabídky pro odtržení ve vaší aplikaci.

Viz také

Graf hierarchie
Třídy
CMFCToolBarButton – třída
CMFCToolBar – třída
CMFCPopupMenu – třída