Třída CMFCRibbonButton

Článek
03/04/2013

CMFCRibbonButton Třída implementuje tlačítek, která můžete umístit na pásu karet panel prvky jako rozbalovací nabídky, panely a panely nástrojů Rychlý přístup.

class CMFCRibbonButton : public CMFCRibbonBaseElement

Členy

Veřejné konstruktory

Název	Description
CMFCRibbonButton::CMFCRibbonButton	Vytvoří objekt tlačítka pásu karet.

Veřejné metody

Název	Description
CMFCRibbonButton::AddSubItem	Přidá položku nabídky rozbalovací nabídky spojené s tlačítka.
CMFCRibbonButton::CanBeStretched	(Přepíše CMFCRibbonBaseElement::CanBeStretched.)
CMFCRibbonButton::CleanUpSizes	(Přepíše CMFCRibbonBaseElement::CleanUpSizes.)
CMFCRibbonButton::ClosePopupMenu	(Přepíše CMFCRibbonBaseElement::ClosePopupMenu.)
CMFCRibbonButton::DrawBottomText
CMFCRibbonButton::DrawImage	(Přepíše CMFCRibbonBaseElement::DrawImage.)
CMFCRibbonButton::DrawRibbonText
CMFCRibbonButton::FindSubItemIndexByID	Vrátí index položku rozbalovací nabídky spojené s ID zadaný příkaz.
CMFCRibbonButton::GetCommandRect
CMFCRibbonButton::GetCompactSize	Vrátí kompaktní velikosti prvku na pásu karet.(Přepíše CMFCRibbonBaseElement::GetCompactSize.)
CMFCRibbonButton::GetIcon
CMFCRibbonButton::GetImageIndex	Vrátí index obrázku, který je spojen s tlačítka.
CMFCRibbonButton::GetImageSize	Vrátí velikost obrazu prvku na pásu karet.(Přepíše CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButton::GetIntermediateSize	Vrátí velikost prvku na pásu karet v mezilehlých stavu.(Přepíše CMFCRibbonBaseElement::GetIntermediateSize.)
CMFCRibbonButton::GetMenu	Vrátí popisovač přiřazené k pásu tlačítko nabídky systému Windows.
CMFCRibbonButton::GetMenuRect
CMFCRibbonButton::GetRegularSize	Vrátí normální velikost prvku na pásu karet.(Přepíše CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButton::GetSubItems
CMFCRibbonButton::GetTextRowHeight
CMFCRibbonButton::GetToolTipText	Vrátí text popisu prvku na pásu karet.(Přepíše CMFCRibbonBaseElement::GetToolTipText.)
CMFCRibbonButton::HasCompactMode	Určuje, zda má prvek pásu kompaktní režim.(Přepíše CMFCRibbonBaseElement::HasCompactMode.)
CMFCRibbonButton::HasIntermediateMode	Určuje, zda má prvek pásu zprostředkující režimu.(Přepíše CMFCRibbonBaseElement::HasIntermediateMode.)
CMFCRibbonButton::HasLargeMode	Určuje, zda má prvek pásu velkých režimu.(Přepíše CMFCRibbonBaseElement::HasLargeMode.)
CMFCRibbonButton::HasMenu	(Přepíše CMFCRibbonBaseElement::HasMenu.)
CMFCRibbonButton::IsAlwaysDrawBorder
CMFCRibbonButton::IsAlwaysLargeImage	(Přepíše CMFCRibbonBaseElement::IsAlwaysLargeImage.)
CMFCRibbonButton::IsApplicationButton
CMFCRibbonButton::IsCommandAreaHighlighted
CMFCRibbonButton::IsDefaultCommand	Určuje, zda je povolena výchozí příkaz pro tlačítko pásu karet.
CMFCRibbonButton::IsDefaultPanelButton
CMFCRibbonButton::IsDrawTooltipImage
CMFCRibbonButton::IsLargeImage
CMFCRibbonButton::IsMenuAreaHighlighted
CMFCRibbonButton::IsMenuOnBottom
CMFCRibbonButton::IsPopupDefaultMenuLook
CMFCRibbonButton::IsRightAlignMenu	Určuje, zda je v nabídce, zarovnané vpravo.
CMFCRibbonButton::IsSingleLineText
CMFCRibbonButton::OnCalcTextSize	(Přepíše CMFCRibbonBaseElement::OnCalcTextSize.)
CMFCRibbonButton::OnDrawBorder
CMFCRibbonButton::OnDraw	Volat rámec pro nakreslení prvku na pásu karet.(Přepíše CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonButton::OnFillBackground
CMFCRibbonButton::RemoveAllSubItems	Odebere všechny položky nabídky z rozbalovací nabídky.
CMFCRibbonButton::RemoveSubItem	Odebere položku nabídky z rozbalovací nabídky.
CMFCRibbonButton::SetACCData	(Přepíše CMFCRibbonBaseElement::SetACCData.)
CMFCRibbonButton::SetAlwaysLargeImage	Určuje, zda toto tlačítko se zobrazí velký nebo malý obrázek při sbalí uživatel na tlačítko.
CMFCRibbonButton::SetDefaultCommand	Povolí výchozí příkaz pro tlačítko pásu karet.
CMFCRibbonButton::SetDescription	Nastaví popis prvku na pásu karet.(Přepíše CMFCRibbonBaseElement::SetDescription.)
CMFCRibbonButton::SetImageIndex	Obrázek tlačítka přiřadí indexu.
CMFCRibbonButton::SetMenu	Přiřadí rozbalovací nabídky tlačítka pásu karet.
CMFCRibbonButton::SetParentCategory	(Přepíše CMFCRibbonBaseElement::SetParentCategory.)
CMFCRibbonButton::SetRightAlignMenu	Zarovná rozbalovací nabídky vpravo od tlačítka.
CMFCRibbonButton::SetText	Nastaví text prvku na pásu karet.(Přepíše CMFCRibbonBaseElement::SetText.)

Chráněné metody

Název	Description
CMFCRibbonButton::OnClick	Když uživatel klepne na tlačítko volat rozhraní.

Příklad

Následující příklad demonstruje použití různých metod v CMFCRibbonButton třídy.Příklad ukazuje, jak vytvořit objekt CMFCRibbonButton třídy, rozbalovací nabídky přiřadit tlačítko pásu, nastavit popis tlačítka, odebrat z rozbalovací nabídky položky nabídky a rozbalovací nabídky okraj tlačítka zarovnání vpravo.

    strTemp.LoadString(IDS_RIBBON_STYLE);
    // The first parameter is the command ID of the button.
    // The third parameter is a zero-based index of the button's small image in the 
    // image list of the parent category.
    // The fourth parameter is a zero-based index of the button's large image in the 
    // image list of the parent category.
    CMFCRibbonButton* pVisualStyleButton = new CMFCRibbonButton(1, strTemp, -1, -1);
    
    pVisualStyleButton->SetMenu(IDR_THEME_MENU, TRUE, TRUE);

    strTemp.LoadString(IDS_RIBBON_STYLE_TIP);
    pVisualStyleButton->SetToolTipText(strTemp);
    strTemp.LoadString(IDS_RIBBON_STYLE_DESC);
    pVisualStyleButton->SetDescription(strTemp);
    pVisualStyleButton->RemoveSubItem(0);
    pVisualStyleButton->SetRightAlignMenu(TRUE);

Poznámky

Použít tlačítko pásu karet v aplikaci, sestavit objekt tlačítka a přidat do pásu odpovídající panel.

CMFCRibbonPanel* pPanel = pCategory->AddPanel (
    _T("Clipboard"),                       // Panel name
    m_PanelIcons.ExtractIcon (0));  // Panel icon
// Create the first button ("Paste"):
CMFCRibbonButton* pPasteButton = 
    new CMFCRibbonButton (ID_EDIT_PASTE, _T("Paste"), -1, 0);
// The third parameter (-1) disables small images for button.
// This button is always displayed with a large image
// Associate a pop-up menu with the "Paste" button:
pPasteButton->SetMenu (IDR_CONTEXT_MENU);
// Add buttons to the panel. These buttons have only small images.
pPanel->Add (new CMFCRibbonButton (ID_EDIT_CUT, _T("Cut"), 1));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_COPY, _T("Copy"), 2));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_PAINT, _T("Paint"), 9));