CMFCRibbonBaseElement – třída

Článek
08/04/2024

Třída CMFCRibbonBaseElement je základní třídou pro všechny prvky, které můžete přidat na panel pásu karet. Příklady prvků pásu karet jsou tlačítka pásu karet, zaškrtávací políčka pásu karet a pole se seznamem pásu karet.

Syntaxe

class CMFCRibbonBaseElement : public CObject

Členové

Veřejné konstruktory

Název	Popis
`CMFCRibbonBaseElement`	`CMFCRibbonBaseElement` Vytvoří objekt.

Veřejné metody

Název	Popis
CMFCRibbonBaseElement::AddToKeyList	Přidá popis pro prvek pásu karet do pole popisů kláves.
CMFCRibbonBaseElement::AddToListBox	Přidá prvek pásu karet do zadaného seznamu příkazů pásu karet.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar	Určuje, zda lze prvek pásu karet přidat na panel nástrojů Rychlý přístup.
CMFCRibbonBaseElement::CanBeCompacted	Určuje, zda je možné komprimovat velikost prvku pásu karet.
CMFCRibbonBaseElement::CanBeStretched	Určuje, zda výška prvku pásu karet může vertikálně navýšit na výšku řádku pásu karet.
CMFCRibbonBaseElement::CanBeStretchedHorizontally	Určuje, zda se může změnit šířka prvku pásu karet.
CMFCRibbonBaseElement::CleanUpSizes	Vyčistí nastavení dimenze pro prvek pásu karet.
CMFCRibbonBaseElement::ClosePopupMenu	Zavře místní nabídku pro prvek pásu karet.
CMFCRibbonBaseElement::CopyFrom	Zkopíruje stav zadaného `CMFCRibbonBaseElement` objektu do aktuálního objektu.
CMFCRibbonBaseElement::D estroyCtrl	Zničí prvek pásu karet.
CMFCRibbonBaseElement::D rawImage	Nakreslí obrázek prvku pásu karet.
CMFCRibbonBaseElement::Najít	Vrátí zadaný ukazatel na prvek pásu karet, pokud odkazuje na aktuální objekt.
CMFCRibbonBaseElement::FindByData	Načte ukazatel na prvek pásu karet, pokud obsahuje zadaná data.
CMFCRibbonBaseElement::FindByID	Načte ukazatel na prvek pásu karet, pokud je tento prvek identifikován zadaným ID příkazu.
CMFCRibbonBaseElement::FindByOriginal	Načte ukazatel na prvek pásu karet, pokud původní prvek pásu karet odpovídá zadanému prvku pásu karet.
CMFCRibbonBaseElement::GetCompactSize	Vrátí kompaktní velikost prvku pásu karet.
CMFCRibbonBaseElement::GetData	Načte uživatelem definovaná data přidružená k prvku pásu karet.
CMFCRibbonBaseElement::GetDescription	Vrátí popis prvku pásu karet.
CMFCRibbonBaseElement::GetDroppedDown	Načte ukazatel na prvek pásu karet, pokud se místní nabídka rozbalí.
CMFCRibbonBaseElement::GetElements	Přidá aktuální prvek pásu karet do zadaného pole.
CMFCRibbonBaseElement::GetElementsByID	Přidá aktuální prvek pásu karet do zadaného pole, pokud aktuální prvek pásu karet obsahuje zadané ID příkazu.
CMFCRibbonBaseElement::GetHighlighted	Načte ukazatel na prvek pásu karet, pokud je zvýrazněný.
CMFCRibbonBaseElement::GetID	Vrátí ID příkazu prvku pásu karet.
CMFCRibbonBaseElement::GetImageSize	Vrátí velikost obrázku prvku pásu karet.
CMFCRibbonBaseElement::GetIntermediateSize	Vrátí velikost prvku pásu karet v jeho přechodném stavu.
CMFCRibbonBaseElement::GetKeys	Vrátí popisek přidružený k prvku pásu karet.
CMFCRibbonBaseElement::GetKeyTipRect	Načte obdélník hranice popisku pro prvek pásu karet.
CMFCRibbonBaseElement::GetKeyTipSize	Načte velikost textu s popisem klíče.
CMFCRibbonBaseElement::GetLocationInGroup	Označuje umístění zobrazení prvku pásu karet ve skupině pásu karet.
CMFCRibbonBaseElement::GetMenuKeys	Vrátí klávesové zkratky přidružené k tlačítku.
CMFCRibbonBaseElement::GetNotifyID	Načte ID příkazu oznámení pro prvek pásu karet.
CMFCRibbonBaseElement::GetOriginal	Načte původní prvek pásu karet.
CMFCRibbonBaseElement::GetParentCategory	Načte kategorii pásu karet pro prvek pásu karet.
CMFCRibbonBaseElement::GetParentPanel	Načte panel pásu karet, který obsahuje prvek pásu karet.
CMFCRibbonBaseElement::GetParentRibbonBar	Načte nadřazený panel pásu karet pro prvek pásu karet.
CMFCRibbonBaseElement::GetParentWnd	Načte nadřazené okno prvku pásu karet.
CMFCRibbonBaseElement::GetPressed	Načte ukazatel na prvek pásu karet, pokud ho uživatel právě stiskne.
CMFCRibbonBaseElement::GetQuickAccessToolBarID	Načte ID příkazu prvku pásu karet, když se nachází na panelu nástrojů Rychlý přístup.
CMFCRibbonBaseElement::GetRect	Vrátí ohraničující obdélník prvku pásu karet.
CMFCRibbonBaseElement::GetRegularSize	Vrátí běžnou velikost prvku pásu karet.
CMFCRibbonBaseElement::GetSize	Vrátí aktuální velikost prvku pásu karet.
CMFCRibbonBaseElement::GetText	Vrátí text přidružený k prvku pásu karet.
CMFCRibbonBaseElement::GetToolTipText	Vrátí text popisu prvku pásu karet.
CMFCRibbonBaseElement::GetTopLevelRibbonBar	Načte panel pásu karet nejvyšší úrovně pro prvek pásu karet.
CMFCRibbonBaseElement::HasCompactMode	Určuje, zda má prvek pásu karet kompaktní režim.
CMFCRibbonBaseElement::HasFocus	Určuje, zda nadřazený prvek obsahuje fokus klávesnice.
CMFCRibbonBaseElement::HasIntermediateMode	Určuje, zda má prvek pásu karet přechodný režim.
CMFCRibbonBaseElement::HasLargeMode	Určuje, zda má prvek pásu karet velký režim.
CMFCRibbonBaseElement::HasMenu	Určuje, zda má prvek pásu karet nabídku.
CMFCRibbonBaseElement::HitTest	Načte ukazatel na prvek pásu karet, pokud je v něm umístěný zadaný bod.
CMFCRibbonBaseElement::IsAlignByColumn	Určuje, jestli je prvek pásu karet zarovnaný svisle s jinými prvky pásu karet.
CMFCRibbonBaseElement::IsAlwaysLargeImage	Určuje, jestli je velikost obrázku prvku pásu karet vždy velká.
CMFCRibbonBaseElement::IsAutoRepeatMode	Určuje, zda je prvek pásu karet v režimu automatického opakování.
CMFCRibbonBaseElement::IsChecked	Určuje, zda je prvek pásu karet zaškrtnutý.
CMFCRibbonBaseElement::IsCompactMode	Určuje, zda je prvek pásu karet v kompaktním režimu.
CMFCRibbonBaseElement::IsDefaultMenuLook
CMFCRibbonBaseElement::IsDisabled	Určuje, jestli je prvek pásu karet zakázaný.
CMFCRibbonBaseElement::IsDroppedDown	Určuje, zda prvek pásu karet zobrazuje místní nabídku a je vyřazen.
CMFCRibbonBaseElement::IsFocused	Určuje, zda má prvek pásu karet fokus.
CMFCRibbonBaseElement::IsGalleryIcon	Určuje, zda je prvek pásu karet obsažen v galerii pásu karet.
CMFCRibbonBaseElement::IsHighlighted	Určuje, zda je zvýrazněn prvek pásu karet.
CMFCRibbonBaseElement::IsIntermediateMode	Určuje, jestli je aktuální obrázek prvku pásu karet zprostředkující velikost.
CMFCRibbonBaseElement::IsLargeMode	Určuje, jestli je aktuální obrázek prvku pásu karet velký.
CMFCRibbonBaseElement::IsMenuMode	Určuje, zda je prvek pásu karet obsažen v nabídce.
CMFCRibbonBaseElement::IsPressed	Určuje, jestli uživatel kliknul na prvek pásu karet.
CMFCRibbonBaseElement::IsQATMode	Určuje, zda je prvek pásu karet obsažen na panelu nástrojů Rychlý přístup.
CMFCRibbonBaseElement::IsSeparator	Určuje, zda je prvek pásu karet oddělovačem zobrazení.
CMFCRibbonBaseElement::IsShowGroupBorder	Určuje, zda je prvek pásu karet obsažen ve skupině, která zobrazuje společné ohraničení.
CMFCRibbonBaseElement::IsShowTooltipOnBottom	Určuje, zda je popis zobrazen pod prvkem pásu karet.
CMFCRibbonBaseElement::IsTabStop	Určuje, zda lze prvek pásu karet vybrat pomocí klávesnice.
CMFCRibbonBaseElement::IsTextAlwaysOnRight	Určuje, zda je text prvku pásu karet zobrazen vpravo.
CMFCRibbonBaseElement::IsVisible	Určuje, zda je prvek pásu karet aktuálně zobrazen.
CMFCRibbonBaseElement::IsWholeRowHeight	Určuje, zda je zobrazená heigth prvku pásu karet stejná jako výška zobrazení panelu pásu karet, který ho obsahuje.
CMFCRibbonBaseElement::NotifyCommand	Odešle oznámení příkazu do nadřazeného okna prvku pásu karet.
CMFCRibbonBaseElement::NotifyHighlightListItem	Upozorní nadřazené okno panelu pásu karet, když uživatel zvýrazní prvek pásu karet umístěný v seznamu.
CMFCRibbonBaseElement::OnAddToQaToolbar	Přidá prvek pásu karet na zadaný panel nástrojů Rychlý přístup.
CMFCRibbonBaseElement::OnAfterChangeRect	Aktualizuje popis prvku pásu karet.
CMFCRibbonBaseElement::OnAutoRepeat	Aktualizuje prvek pásu karet v reakci na trvalý vstup uživatele.
CMFCRibbonBaseElement::OnCalcTextsize	Vypočítá velikost textu pro prvek pásu karet.
CMFCRibbonBaseElement::OnChangeMenuHighlight	Volá se rozhraním, když se zvýraznění změní pro prvek pásu karet, který se nachází v nabídce.
CMFCRibbonBaseElement::OnDraw	Volá se rozhraním pro kreslení prvku pásu karet.
CMFCRibbonBaseElement::OnDrawKeyTip	Volá se rozhraním pro vykreslení popisu prvku pásu karet.
CMFCRibbonBaseElement::OnDrawMenuImage	Volá se rozhraním, když je nakreslen obrázek nabídky pro prvek pásu karet.
CMFCRibbonBaseElement::OnDrawOnList	Volá se rozhraním pro kreslení prvku pásu karet v seznamu příkazů.
CMFCRibbonBaseElement::OnKey	Volá se rozhraním, když uživatel stiskne klávesu a prvek pásu karet má fokus.
CMFCRibbonBaseElement::OnMenuKey
CMFCRibbonBaseElement::OnRTLChanged	Volá se rozhraním, když se změní směr rozložení.
CMFCRibbonBaseElement::OnShow	Volá se rozhraním pro zobrazení nebo skrytí prvku pásu karet.
CMFCRibbonBaseElement::OnShowPopupMenu	Volá se rozhraním, když prvek pásu karet zobrazí místní nabídku.
CMFCRibbonBaseElement::P ostMenuCommand
CMFCRibbonBaseElement::Redraw	Aktualizuje zobrazení prvku pásu karet.
CMFCRibbonBaseElement::SetACCData	Nastaví data přístupnosti pro prvek pásu karet.
CMFCRibbonBaseElement::SetCompactMode	Nastaví velikost zobrazení pro prvek pásu karet.
CMFCRibbonBaseElement::SetData	Přidruží datovou položku k prvku pásu karet.
CMFCRibbonBaseElement::SetDefaultMenuLook
CMFCRibbonBaseElement::SetDescription	Nastaví popis prvku pásu karet.
CMFCRibbonBaseElement::SetID	Nastaví ID příkazu prvku pásu karet.
CMFCRibbonBaseElement::SetInitialMode	Nastaví počáteční velikost zobrazení pro prvek pásu karet.
CMFCRibbonBaseElement::SetKeys	Nastaví popis pro prvek pásu karet.
CMFCRibbonBaseElement::SetOriginal	Nastaví původní prvek pásu karet pro prvek pásu karet.
CMFCRibbonBaseElement::SetParentCategory	Nastaví nadřazenou kategorii pro prvek pásu karet.
CMFCRibbonBaseElement::SetParentMenu	Nastaví nadřazený kontejner nabídek pro prvek pásu karet.
CMFCRibbonBaseElement::SetParentRibbonBar	Nastaví nadřazený panel pásu karet pro prvek pásu karet.
CMFCRibbonBaseElement::SetRect	Nastaví rozměry fot, které zobrazí obdélník pro prvek pásu karet.
CMFCRibbonBaseElement::SetText	Nastaví text pro prvek pásu karet.
CMFCRibbonBaseElement::SetTextAlwaysOnRight	Nastaví text prvku pásu karet tak, aby se zobrazil vpravo.
CMFCRibbonBaseElement::SetToolTipText	Nastaví text popisu prvku pásu karet.
CMFCRibbonBaseElement::SetVisible	Nastaví stav viditelnosti prvku pásu karet.
CMFCRibbonBaseElement::StretchHorizontally	Roztáhne šířku prvku pásu karet.
CMFCRibbonBaseElement::StretchToWholeRow	Změní výšku zobrazení prvku pásu karet na zadanou výšku řádku.
CMFCRibbonBaseElement::UpdateTooltipInfo	Aktualizuje text popisu pomocí prostředku příkazu pro prvek pásu karet.

Chráněné metody

Název	Popis
CMFCRibbonBaseElement::OnProcessKey	Volá se rozhraním, když uživatel stiskne klávesovou zkratku.
CMFCRibbonBaseElement::OnSetFocus	Volá se rozhraním, když prvek pásu karet přijme nebo ztratí vstupní fokus.

Poznámky

Třída CMFCRibbonBaseElement definuje vlastnosti, které jsou společné pro všechny prvky pásu karet, které zahrnují ID příkazu, popisek textu, popisek prvku, popis a stav (které se dají zaměřit, zvýraznit, zvýraznit, zakázat, zaškrtnuto nebo vynechat).

Velikost obrázku prvku pásu karet je definována RibbonImageType členem, což může být jedna z následujících hodnot:

RibbonImageLarge
RibbonImageSmall

V závislosti na velikosti se na pásu karet zobrazuje malý nebo velký obrázek.

Příklad

Následující příklad ukazuje, jak používat různé metody ve CMFCRibbonBaseElement třídě. Příklad ukazuje, jak získat CMFCRibbonBaseElement objekt z CMFCRibbonStatusBar třídy, nastavit popis prvku pásu karet, nastavit text, nastavit popis a nastavit text popisu pásu karet. Tento fragment kódu je součástí ukázky Klienta kreslení.

// CMFCRibbonStatusBar m_wndStatusBar
CMFCRibbonBaseElement *pPane = m_wndStatusBar.FindByID(nID);

pPane->SetDescription(_T("a pane"));
// CString strText
pPane->SetText(strText);
pPane->SetKeys(_T("p"));
pPane->SetToolTipText(_T("this is a pane"));

Hierarchie dědičnosti

Objekt CObject

CMFCRibbonBaseElement

Požadavky

Hlavička: afxbaseribbonelement.h

CMFCRibbonBaseElement::AddToKeyList

Přidá popis pro prvek pásu karet do pole popisů kláves.

virtual void AddToKeyList(
    CArray<CMFCRibbonKeyTip*, CMFCRibbonKeyTip*>& arElems);

Parametry

arElems
[v] Odkaz na CArray popisů klíčů.

Poznámky

Pokud je funkce popisů pásu karet povolená, zobrazí rozhraní popisky pásu karet, když uživatel stiskne klávesu ALT nebo klávesu F10.

CMFCRibbonBaseElement::AddToListBox

Přidá prvek pásu karet do zadaného seznamu příkazů pásu karet.

virtual int AddToListBox(
    CMFCRibbonCommandsListBox* pWndListBox,
    BOOL bDeep);

Parametry

pWndListBox
[v] Ukazatel na seznam příkazů

bDeep
[v] Tento parametr se nepoužívá.

Návratová hodnota

Index založený na nule přidaného prvku pásu karet.

Poznámky

Architektura přidá prvky pásu karet do seznamu příkazů, aby uživatel mohl přizpůsobit uživatelské rozhraní.

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

Určuje, zda lze prvek pásu karet přidat na panel nástrojů Rychlý přístup.

virtual BOOL CanBeAddedToQuickAccessToolBar() const;

Návratová hodnota

TRUE, pokud lze přidat prvek; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::CanBeCompacted

Určuje, zda je možné komprimovat velikost prvku pásu karet.

virtual BOOL CanBeCompacted() const;

Návratová hodnota

TRUE, pokud velikost prvku pásu karet může být kompaktní; jinak NEPRAVDA.

Poznámky

Velikost prvku pásu karet může být kompaktní, zprostředkující nebo velká.

CMFCRibbonBaseElement::CanBeStretched

Určuje, zda výška prvku pásu karet může vertikálně navýšit na výšku řádku pásu karet.

virtual BOOL CanBeStretched();

Návratová hodnota

Vždy vrátí hodnotu PRAVDA.

Poznámky

Ve výchozím nastavení tato metoda vždy vrátí hodnotu TRUE. Přepište tuto metodu, aby bylo možné určit, zda výška prvku pásu karet může zvýšit svisle na výšku řádku pásu karet.

CMFCRibbonBaseElement::CanBeStretchedHorizontally

Určuje, zda se může změnit šířka prvku pásu karet.

virtual BOOL CanBeStretchedHorizontally();

Návratová hodnota

Vždy vrátí hodnotu FALSE.

Poznámky

Ve výchozím nastavení tato metoda vždy vrací HODNOTU FALSE. Přepište tuto metodu, aby bylo možné určit, zda se může změnit šířka prvku pásu karet.

CMFCRibbonBaseElement::CleanUpSizes

Vyčistí nastavení dimenze pro prvek pásu karet.

virtual void CleanUpSizes();

Poznámky

Ve výchozím nastavení tato metoda nic nedělá. Přepsat tuto metodu v odvozené třídě obnovit nastavení dimenze pro prvek pásu karet.

CMFCRibbonBaseElement::ClosePopupMenu

Zavře místní nabídku pro prvek pásu karet.

virtual void ClosePopupMenu();

Poznámky

CMFCRibbonBaseElement::CopyFrom

Zkopíruje stav zadaného CMFCRibbonBaseElement do aktuálního objektu.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parametry

Src
[v] Zdrojový CMFCRibbonBaseElement objekt.

Poznámky

CMFCRibbonBaseElement::D estroyCtrl

Zničí prvek pásu karet.

virtual void DestroyCtrl();

Poznámky

Ve výchozím nastavení tato metoda nic nedělá. Přepsat tuto metodu v odvozené třídě zničit pásu karet elementu.

CMFCRibbonBaseElement::D rawImage

Nakreslí obrázek prvku pásu karet.

virtual void DrawImage(
    CDC* pDC,
    RibbonImageType type,
    CRect rectImage);

Parametry

pDC
[v] Ukazatel na kontext zařízení

type
[v] Typ obrázku vyčíslenou hodnotu. Seznam možných hodnot najdete v části Poznámky.

rectImage
[v] Obdélník obrázku.

Poznámky

Ve výchozím nastavení tato metoda nic nedělá. Přepsat tuto metodu v odvozené třídě nakreslit obrázek pro prvek pásu karet.

V následující tabulce jsou uvedeny možné hodnoty parametru typu :

Hodnota	Popis
`RibbonImageLarge`	Velký obrázek o velikosti 32 × 32 pixelů.
`RibbonImageSmall`	Velikost malého obrázku o velikosti 16 × 16 pixelů

CMFCRibbonBaseElement::Najít

Vrátí zadaný ukazatel, pokud odkazuje na aktuální objekt.

virtual CMFCRibbonBaseElement* Find(const CMFCRibbonBaseElement* pElement);

Parametry

pElement
[v] Ukazatel na prvek pásu karet

Návratová hodnota

Ukazatel na prvek pásu karet, pokud pElement odkazuje na aktuální objekt; jinak NULL.

Poznámky

CMFCRibbonBaseElement::FindByData

Načte ukazatel na prvek pásu karet, pokud obsahuje zadaná data.

virtual CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData);

Parametry

dwData
[v] Data přidružená k prvku pásu karet.

Návratová hodnota

Ukazatel na prvek pásu karet, pokud obsahuje zadaná data; jinak NULL.

Poznámky

CMFCRibbonBaseElement::FindByID

Načte ukazatel na prvek pásu karet, pokud je tento prvek identifikován zadaným ID příkazu.

virtual CMFCRibbonBaseElement* FindByID(UINT uiCmdID);

Parametry

uiCmdID
[v] ID příkazu pro prvek pásu karet

Návratová hodnota

Ukazatel na prvek pásu karet, pokud je tento prvek identifikován zadaným ID příkazu; jinak NULL.

Poznámky

CMFCRibbonBaseElement::FindByOriginal

Načte ukazatel na aktuální prvek pásu karet, pokud původní prvek pásu karet odpovídá zadanému prvku pásu karet.

virtual CMFCRibbonBaseElement* FindByOriginal(CMFCRibbonBaseElement* pOriginal);

Parametry

pOriginal
[v] Ukazatel na prvek pásu karet

Návratová hodnota

Ukazatel na prvek pásu karet, pokud jeho původní prvek pásu karet odpovídá zadanému prvku pásu karet; jinak NULL.

Poznámky

Prvky pásu karet, které se zkopírují do jiného kontejneru, zachovají ukazatel na původní prvek pásu karet.

CMFCRibbonBaseElement::GetCompactSize

Vrátí kompaktní velikost prvku pásu karet.

virtual CSize GetCompactSize(CDC* pDC);

Parametry

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

Návratová hodnota

Kompaktní velikost prvku pásu karet.

Poznámka:

Kompaktní velikost znamená, že je prvek pásu karet zkrácený (zobrazuje malý obrázek nebo obrázek bez textu).

CMFCRibbonBaseElement::GetData

Načte uživatelem definovaná data přidružená k prvku pásu karet.

DWORD_PTR GetData() const;

Návratová hodnota

Uživatelem definovaná data přidružená k prvku pásu karet.

CMFCRibbonBaseElement::GetDescription

Vrátí popis prvku pásu karet.

virtual CString GetDescription() const;

Návratová hodnota

Popis prvku pásu karet Popis se zobrazí buď na stavovém řádku, nebo v popisu, nebo pod tlačítkem nabídky, pokud je prvek pásu karet umístěn v CMFCRibbonMainPanel Třída.

CMFCRibbonBaseElement::GetDroppedDown

Načte ukazatel na prvek pásu karet, pokud se místní nabídka rozbalí.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Návratová hodnota

Ukazatel na prvek pásu karet, pokud je místní nabídka vyřazena; jinak NULL.

Poznámky

CMFCRibbonBaseElement::GetElements

Přidá aktuální prvek pásu karet do zadaného pole.

virtual void GetElements(
    CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parametry

ArElements
[in, out] Pole prvků pásu karet

Poznámky

CMFCRibbonBaseElement::GetElementsByID

Přidá aktuální prvek pásu karet do zadaného pole, pokud aktuální prvek pásu karet obsahuje zadané ID příkazu.

virtual void GetElementsByID(
    UINT uiCmdID,
    CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parametry

uiCmdID
[v] ID příkazu prvku pásu karet

ArElements
[v] Pole prvků pásu karet

Poznámky

CMFCRibbonBaseElement::GetHighlighted

Načte ukazatel na prvek pásu karet, pokud je zvýrazněný.

virtual CMFCRibbonBaseElement* GetHighlighted();

Návratová hodnota

Ukazatel na prvek pásu karet, pokud je zvýrazněn; jinak NULL.

Poznámky

CMFCRibbonBaseElement::GetID

Vrátí ID příkazu prvku pásu karet.

UINT GetID() const;

Návratová hodnota

ID příkazu prvku pásu karet.

CMFCRibbonBaseElement::GetImageSize

Vrátí velikost obrázku prvku pásu karet.

virtual CSize GetImageSize(RibbonImageType R) const;

Návratová hodnota

Velikost obrázku prvku pásu karet

CMFCRibbonBaseElement::GetIntermediateSize

Vrátí velikost prvku pásu karet v jeho přechodném stavu.

virtual CSize GetIntermediateSize(CDC* pDC);

Parametry

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

Návratová hodnota

Velikost prvku pásu karet v jeho přechodném stavu.

CMFCRibbonBaseElement::GetKeys

Vrátí popisek přidružený k prvku pásu karet.

LPCTSTR GetKeys() const;

Návratová hodnota

Popisek přidružený k prvku pásu karet

CMFCRibbonBaseElement::GetKeyTipRect

Načte obdélník hranice popisku pro prvek pásu karet.

virtual CRect GetKeyTipRect(
    CDC* pDC,
    BOOL bIsMenu);

Parametry

pDC
[v] Ukazatel na kontext zařízení

bIsMenu
[v] TRUE, pokud prvek pásu karet zobrazí místní nabídku; jinak NEPRAVDA.

Návratová hodnota

Vždy vrátí obdélník s 0 hodnotami.

Poznámky

Přepište tuto metodu v odvozené třídě tak, aby vrátil obdélník hranice popisku.

CMFCRibbonBaseElement::GetKeyTipSize

Načte velikost textu s popisem klíče.

virtual CSize GetKeyTipSize(CDC* pDC);

Parametry

pDC
[v] Ukazatel na kontext zařízení

Návratová hodnota

Velikost textu s popisem klávesy

Poznámky

CMFCRibbonBaseElement::GetLocationInGroup

Označuje umístění zobrazení prvku pásu karet ve skupině pásu karet.

RibbonElementLocation GetLocationInGroup() const;

Návratová hodnota

Výčtová RibbonElementLocation hodnota. V následující tabulce jsou uvedeny možné hodnoty.

Hodnota	Popis
`RibbonElementNotInGroup`	Prvek pásu karet není obsažen ve skupině pásu karet.
`RibbonElementSingleInGroup`	Prvek pásu karet se zobrazí jako jediná položka ve skupině pásu karet.
`RibbonElementFirstInGroup`	Prvek pásu karet se zobrazí na levém konci skupiny pásu karet.
`RibbonElementLastInGroup`	Prvek pásu karet se zobrazí na pravém konci skupiny pásu karet.
`RibbonElementMiddleInGroup`	Prvek pásu karet se nezobrazuje na obou koncích skupiny pásu karet.

Poznámky

Skupiny prvků pásu karet jsou zarovnány pouze vodorovně.

CMFCRibbonBaseElement::GetMenuKeys

Vrátí popis nabídky pro prvek pásu karet.

LPCTSTR GetMenuKeys() const;

Návratová hodnota

Popis nabídky přidružený k prvku pásu karet.

Poznámky

Při vyvolání se v popisu nabídky zobrazí místní nabídka.

CMFCRibbonBaseElement::GetNotifyID

Načte ID příkazu oznámení pro prvek pásu karet.

virtual UINT GetNotifyID();

Návratová hodnota

ID příkazu oznámení.

Poznámky

CMFCRibbonBaseElement::GetOriginal

Načte původní prvek pásu karet.

CMFCRibbonBaseElement* GetOriginal() const;

Návratová hodnota

Ukazatel na původní prvek pásu karet

Poznámky

Prvky pásu karet, které se zkopírují do jiného kontejneru, zachovají ukazatel na původní prvek pásu karet.

CMFCRibbonBaseElement::GetParentCategory

Načte kategorii pásu karet pro prvek pásu karet.

CMFCRibbonCategory* GetParentCategory() const;

Návratová hodnota

Ukazatel na kategorii pásu karet

Poznámky

CMFCRibbonBaseElement::GetParentPanel

Načte panel pásu karet, který obsahuje prvek pásu karet.

virtual CMFCRibbonPanel* GetParentPanel() const;

Návratová hodnota

Ukazatel na panel pásu karet, který obsahuje prvek pásu karet.

Poznámky

CMFCRibbonBaseElement::GetParentRibbonBar

Načte nadřazený panel pásu karet pro prvek pásu karet.

CMFCRibbonBar* GetParentRibbonBar() const;

Návratová hodnota

Ukazatel na nadřazený panel pásu karet pro prvek pásu karet

Poznámky

CMFCRibbonBaseElement::GetParentWnd

Načte nadřazené okno prvku pásu karet.

virtual CWnd* GetParentWnd() const;

Návratová hodnota

Ukazatel na nadřazené okno prvku pásu karet, pokud byla metoda úspěšná; v opačném případě null.

Poznámky

Nadřazené okno pro prvek pásu karet je CMFCRibbonBar Třída nebo CMFCRibbonPanelMenuBar.

CMFCRibbonBaseElement::GetPressed

Načte ukazatel na prvek pásu karet, pokud ho uživatel právě stiskne.

virtual CMFCRibbonBaseElement* GetPressed();

Návratová hodnota

Ukazatel na prvek pásu karet, pokud ho uživatel aktuálně stiskne; v opačném případě null.

Poznámky

CMFCRibbonBaseElement::GetQuickAccessToolBarID

Načte ID příkazu prvku pásu karet, když se nachází na panelu nástrojů Rychlý přístup.

virtual UINT GetQuickAccessToolBarID() const;

Návratová hodnota

ID příkazu prvku pásu karet, když se nachází na panelu nástrojů Rychlý přístup.

Poznámky

CMFCRibbonBaseElement::GetRect

Vrátí ohraničující obdélník prvku pásu karet.

CRect GetRect() const;

Návratová hodnota

Ohraničující obdélník prvku pásu karet. Pozice obdélníku je ve souřadnicích nadřazeného ovládacího prvku pásu karet.

CMFCRibbonBaseElement::GetRegularSize

Vrátí běžnou velikost prvku pásu karet.

virtual CSize GetRegularSize(CDC* pDC) = 0;

Parametry

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

Návratová hodnota

Běžná velikost prvku pásu karet.

Poznámky

Poznámka:

Běžná velikost je maximální možnou velikost prvku pásu karet.

CMFCRibbonBaseElement::GetSize

Vrátí aktuální velikost prvku pásu karet.

virtual CSize GetSize(CDC* pDC);

Parametry

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

Návratová hodnota

Aktuální velikost prvku pásu karet.

CMFCRibbonBaseElement::GetText

Vrátí text přidružený k prvku pásu karet.

LPCTSTR GetText() const;

Návratová hodnota

Text přidružený k prvku pásu karet.

CMFCRibbonBaseElement::GetToolTipText

Vrátí text popisu prvku pásu karet.

virtual CString GetToolTipText() const;

Návratová hodnota

Text popisu prvku pásu karet

CMFCRibbonBaseElement::GetTopLevelRibbonBar

Načte panel pásu karet nejvyšší úrovně pro prvek pásu karet.

CMFCRibbonBar* GetTopLevelRibbonBar() const;

Návratová hodnota

Ukazatel na panel pásu karet nejvyšší úrovně pro prvek pásu karet, pokud byla metoda úspěšná; v opačném případě null.

Poznámky

CMFCRibbonBaseElement::HasCompactMode

Určuje, zda má prvek pásu karet kompaktní režim.

virtual BOOL HasCompactMode() const;

Návratová hodnota

TRUE, pokud má prvek pásu karet kompaktní režim. JINAK NEPRAVDA.

Poznámky

Poznámka:

V kompaktním režimu zobrazí prvek jenom malý obrázek.

CMFCRibbonBaseElement::HasIntermediateMode

Určuje, zda má prvek pásu karet přechodný režim.

virtual BOOL HasIntermediateMode() const;

Návratová hodnota

TRUE, pokud má prvek pásu karet přechodný režim, nePRAVDA jinak. V přechodném režimu zobrazí prvek malý obrázek a text na pravé straně obrázku.

Poznámky

CMFCRibbonBaseElement::HasLargeMode

Určuje, zda má prvek pásu karet velký režim.

virtual BOOL HasLargeMode() const;

Návratová hodnota

TRUE, pokud má prvek pásu karet velký režim. JINAK NEPRAVDA.

Poznámky

Ve velkém režimu může prvek převzít plnou výšku nadřazeného panelu.

CMFCRibbonBaseElement::HasMenu

Určuje, zda má prvek pásu karet nabídku.

virtual BOOL HasMenu() const;

Návratová hodnota

Vždy vrátí hodnotu FALSE.

Poznámky

Ve výchozím nastavení tato metoda vždy vrací HODNOTU FALSE. Přepište tuto metodu v odvozené třídě tak, aby indikovala, zda prvek pásu karet má nabídku.

CMFCRibbonBaseElement::HitTest

Načte ukazatel na prvek pásu karet, pokud je v něm umístěný zadaný bod.

virtual CMFCRibbonBaseElement* HitTest(CPoint point);

Parametry

bod
[v] Tento parametr se nepoužívá.

Návratová hodnota

Ukazatel na prvek pásu karet, pokud existuje; jinak NEPRAVDA.

Poznámky

Ve výchozím nastavení tato metoda vždy vrátí platný ukazatel na prvek pásu karet, pokud existuje. Tuto metodu přepište, pokud se bod nachází v prvku pásu karet.

CMFCRibbonBaseElement::IsAlignByColumn

Určuje, jestli je prvek pásu karet zarovnaný svisle s jinými prvky pásu karet.

virtual BOOL IsAlignByColumn() const;

Návratová hodnota

Vždy vrátí hodnotu PRAVDA.

Poznámky

Ve výchozím nastavení tato metoda vždy vrátí hodnotu TRUE. Přepište tuto metodu v odvozené třídě, která označuje, zda je odvozený prvek pásu karet zarovnaný svisle s jinými prvky pásu karet.

CMFCRibbonBaseElement::IsAlwaysLargeImage

Určuje, jestli je velikost obrázku prvku pásu karet vždy velká.

virtual BOOL IsAlwaysLargeImage() const;

Návratová hodnota

TRUE, pokud je velikost obrázku prvku pásu karet vždy velká; jinak NEPRAVDA.

Poznámky

Velikost velkého obrázku je 32 x 32 pixelů.

CMFCRibbonBaseElement::IsAutoRepeatMode

Určuje, zda je prvek pásu karet v režimu automatického opakování.

virtual BOOL IsAutoRepeatMode(int& nDelay) const;

Parametry

nDelay
[v] Tento parametr se nepoužívá.

Návratová hodnota

Vždy vrátí hodnotu FALSE.

Poznámky

Ve výchozím nastavení tato metoda vždy vrací HODNOTU FALSE. Přepište tuto metodu tak, aby označovala, zda je prvek pásu karet v režimu automatického opakování.

V režimu automatického opakování reaguje prvek pásu karet v nastaveném intervalu měřeném v milisekundách na trvalý uživatelský vstup.

CMFCRibbonBaseElement::IsChecked

Určuje, zda je prvek pásu karet zaškrtnutý.

virtual BOOL IsChecked() const;

Návratová hodnota

TRUE, pokud je prvek pásu karet zaškrtnut; jinak NEPRAVDA.

CMFCRibbonBaseElement::IsCompactMode

Určuje, zda je prvek pásu karet v kompaktním režimu.

BOOL IsCompactMode() const;

Návratová hodnota

TRUE, pokud je prvek pásu karet v kompaktním režimu; jinak NEPRAVDA.

CMFCRibbonBaseElement::IsDefaultMenuLook

Určuje, jestli je prvek pásu karet nastavený tak, aby se zobrazoval jako automaticky otevíraný příkaz.

BOOL IsDefaultMenuLook() const;

Návratová hodnota

TRUE, pokud je prvek pásu karet nastaven jako automaticky otevíraný příkaz; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::IsDisabled

Určuje, jestli je prvek pásu karet zakázaný.

virtual BOOL IsDisabled() const;

Návratová hodnota

TRUE, pokud je prvek pásu karet zakázán; jinak NEPRAVDA.

CMFCRibbonBaseElement::IsDroppedDown

Určuje, jestli prvek pásu karet zobrazuje místní nabídku a je vyřazen.

virtual BOOL IsDroppedDown() const;

Návratová hodnota

TRUE, pokud je prvek pásu karet vyřazen a zobrazí místní nabídku; jinak NEPRAVDA.

CMFCRibbonBaseElement::IsFocused

Určuje, zda má prvek pásu karet fokus.

virtual BOOL IsFocused() const;

Návratová hodnota

TRUE, pokud má prvek pásu karet fokus; jinak NEPRAVDA.

CMFCRibbonBaseElement::IsGalleryIcon

Určuje, zda je prvek pásu karet obsažen v galerii pásu karet.

virtual BOOL IsGalleryIcon() const;

Návratová hodnota

Vždy vrátí hodnotu FALSE.

Poznámky

Ve výchozím nastavení tato metoda vždy vrací HODNOTU FALSE. Přepište tuto metodu v odvozené třídě, která označuje, zda je prvek pásu karet obsažen v galerii pásu karet.

CMFCRibbonBaseElement::IsHighlighted

Určuje, zda je zvýrazněn prvek pásu karet.

virtual BOOL IsHighlighted() const;

Návratová hodnota

TRUE, pokud je zvýrazněn prvek pásu karet; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::IsIntermediateMode

Určuje, jestli je aktuální obrázek prvku pásu karet zprostředkující velikost.

BOOL IsIntermediateMode() const;

Návratová hodnota

TRUE, pokud obrázek pro prvek pásu karet je střední velikost; jinak NEPRAVDA.

Poznámky

Zprostředkující velikost obrázku je 16 x 16 pixelů.

CMFCRibbonBaseElement::IsLargeMode

Určuje, jestli je aktuální obrázek prvku pásu karet velký.

BOOL IsLargeMode() const;

Návratová hodnota

TRUE, pokud je obrázek prvku pásu karet velký; jinak NEPRAVDA.

Poznámky

Velikost velkého obrázku je 32 x 32 pixelů.

CMFCRibbonBaseElement::IsMenuMode

Určuje, zda je prvek pásu karet obsažen v nabídce.

BOOL IsMenuMode() const;

Návratová hodnota

TRUE, pokud je prvek pásu karet obsažen v nabídce; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::IsPressed

Určuje, jestli uživatel kliknul na prvek pásu karet.

virtual BOOL IsPressed() const;

Návratová hodnota

TRUE, pokud uživatel kliknul na prvek pásu karet; jinak NEPRAVDA.

CMFCRibbonBaseElement::IsQATMode

Určuje, zda je prvek pásu karet obsažen na panelu nástrojů Rychlý přístup.

BOOL IsQATMode() const;

Návratová hodnota

TRUE, pokud je prvek pásu karet obsažen v panelu nástrojů Rychlý přístup; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::IsSeparator

Určuje, zda je prvek pásu karet oddělovačem zobrazení.

virtual BOOL IsSeparator() const;

Návratová hodnota

TRUE, pokud je prvek pásu karet oddělovač zobrazení; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::IsShowGroupBorder

Určuje, zda je prvek pásu karet obsažen ve skupině, která zobrazuje společné ohraničení.

BOOL IsShowGroupBorder() const;

Návratová hodnota

TRUE, pokud je prvek pásu karet obsažen ve skupině, která zobrazuje společné ohraničení; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::IsShowTooltipOnBottom

Určuje, zda je popis zobrazen pod prvkem pásu karet.

virtual BOOL IsShowTooltipOnBottom() const;

Návratová hodnota

TRUE, pokud je popis zobrazen pod prvkem pásu karet; NEPRAVDA, pokud se popis zobrazí poblíž ukazatele.

Poznámky

CMFCRibbonBaseElement::IsTabStop

Určuje, zda lze prvek pásu karet vybrat pomocí klávesnice.

virtual BOOL IsTabStop() const;

Návratová hodnota

Vždy vrátí hodnotu PRAVDA.

Poznámky

Ve výchozím nastavení tato metoda vždy vrátí hodnotu TRUE. Přepište tuto metodu, aby bylo možné určit, zda je možné vybrat prvek pásu karet pomocí klávesnice.

CMFCRibbonBaseElement::IsTextAlwaysOnRight

Určuje, zda je text prvku pásu karet zobrazen vpravo.

BOOL IsTextAlwaysOnRight() const;

Návratová hodnota

TRUE, pokud text pro prvek pásu karet je zobrazen vpravo; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::IsVisible

Určuje, zda je prvek pásu karet aktuálně zobrazen.

BOOL IsVisible() const;

Návratová hodnota

TRUE, pokud je prvek pásu karet aktuálně zobrazen; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::IsWholeRowHeight

Určuje, zda je výška zobrazení prvku pásu karet stejná jako výška zobrazení panelu pásu karet, který ho obsahuje.

virtual BOOL IsWholeRowHeight() const;

Návratová hodnota

Vždy vrátí hodnotu FALSE.

Poznámky

Ve výchozím nastavení tato metoda vždy vrací HODNOTU FALSE. Přepište tuto metodu, která určuje, zda je výška zobrazení prvku pásu karet stejná jako výška zobrazení panelu pásu karet, který ho obsahuje.

CMFCRibbonBaseElement::NotifyCommand

Odešle oznámení příkazu do nadřazeného okna prvku pásu karet.

BOOL NotifyCommand(BOOL bWithDelay = FALSE);

Parametry

bWithDelay
[v] TRUE pro přidání oznámení příkazu do fronty zpráv nadřazeného okna; NEPRAVDA, aby se zpráva okamžitě odeslala do nadřazeného okna.

Návratová hodnota

TRUE, pokud byla zpráva odeslána; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::NotifyHighlightListItem

Upozorní nadřazené okno panelu pásu karet, když uživatel zvýrazní prvek pásu karet umístěný v seznamu.

virtual void NotifyHighlightListItem(int nIndex);

Parametry

nIndex
[v] Index prvku pásu karet v seznamu.

Poznámky

CMFCRibbonBaseElement::OnAddToQaToolbar

Přidá prvek pásu karet na zadaný panel nástrojů Rychlý přístup.

virtual BOOL OnAddToQAToolbar(CMFCRibbonQuickAccessToolBar& qat);

Parametry

qat
[v] Panel nástrojů Rychlý přístup

Návratová hodnota

Vždy vrátí hodnotu TRUE označující, že prvek pásu karet byl přidán na panel nástrojů Rychlý přístup.

Poznámky

CMFCRibbonBaseElement::OnAfterChangeRect

Aktualizuje popis prvku pásu karet.

virtual void OnAfterChangeRect(CDC* pDC);

Parametry

pDC
[v] Tento parametr se nepoužívá.

Poznámky

Ve výchozím nastavení tato metoda aktualizuje popis prvku pásu karet. Tuto metodu přepište tak, aby po změně obdélníku zobrazení aktualizoval prvek pásu karet.

CMFCRibbonBaseElement::OnAutoRepeat

Aktualizuje prvek pásu karet v reakci na trvalý vstup uživatele.

virtual BOOL OnAutoRepeat();

Návratová hodnota

Vždy vrátí hodnotu FALSE.

Poznámky

Ve výchozím nastavení tato metoda vždy vrací HODNOTU FALSE. Tuto metodu přepište tak, aby zpracovávala trvalý vstup uživatele.

CMFCRibbonBaseElement::OnCalcTextsize

Vypočítá velikost textu pro prvek pásu karet.

virtual void OnCalcTextSize(CDC* pDC);

Parametry

pDC
[v] Tento parametr se nepoužívá.

Poznámky

Ve výchozím nastavení tato metoda nic nedělá. Přepište tuto metodu pro výpočet velikosti textu prvku pásu karet.

CMFCRibbonBaseElement::OnChangeMenuHighlight

Volá se rozhraním, když se zvýraznění změní pro prvek pásu karet, který se nachází v nabídce.

virtual void OnChangeMenuHighlight(CMFCRibbonPanelMenuBar* pPanelMenuBar
    CMFCRibbonBaseElement* pHot);

Parametry

pPanelMenuBar
[v] Tento parametr se nepoužívá.

pHot
[v] Tento parametr se nepoužívá.

Poznámky

Ve výchozím nastavení tato metoda nic nedělá. Tuto metodu přepište, pokud chcete aktualizovat prvek pásu karet umístěný v nabídce při změně zvýraznění.

CMFCRibbonBaseElement::OnDraw

Volá se rozhraním pro kreslení prvku pásu karet.

virtual void OnDraw(CDC* pDC) = 0;

Parametry

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

Poznámky

Tuto metodu přepište v odvozené třídě, pokud chcete přizpůsobit výkres konkrétního prvku pásu karet.

CMFCRibbonBaseElement::OnDrawKeyTip

Volá se rozhraním pro vykreslení popisu prvku pásu karet.

virtual void OnDrawKeyTip(
    CDC* pDC,
    const CRect& rect,
    BOOL bIsMenu);

Parametry

pDC
[v] Ukazatel na kontext zařízení

Rect
[v] Obdélník hranice pro popisek klíče

bIsMenu
[v] TRUE, pokud je popis pro tlačítko místní nabídky; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::OnDrawMenuImage

Volá se rozhraním, když je nakreslen obrázek nabídky pro prvek pásu karet.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    CRect rect);

Parametry

pDC
[v] Ukazatel na kontext zařízení

Rect
[v] Obdélník obrázku nabídky

Návratová hodnota

Vždy vrátí hodnotu PRAVDA, která označuje, že byl obrázek nakreslen.

Poznámky

CMFCRibbonBaseElement::OnDrawOnList

Volá se rozhraním pro kreslení prvku pásu karet v seznamu příkazů.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parametry

pDC
[v] Ukazatel na kontext zařízení pro prvek pásu karet

strText
[v] Zobrazený text.

nTextOffset
[v] Vzdálenost v pixelech od levé strany seznamu k zobrazovaného textu.

Rect
[v] Obdélník zobrazení pro prvek pásu karet.

BIsSelected
[v] Tento parametr se nepoužívá.

bHighlighted
[v] Tento parametr se nepoužívá.

Poznámky

Seznam příkazů zobrazuje prvky pásu karet, které uživatelům umožní přizpůsobit panel nástrojů Rychlý přístup.

CMFCRibbonBaseElement::OnKey

Volá se rozhraním, když uživatel stiskne klávesu a prvek pásu karet má fokus.

virtual BOOL OnKey(BOOL bIsMenuKey);

Parametry

bIsMenuKey
[v] TRUE, pokud se v popisu zobrazí místní nabídka; jinak NEPRAVDA.

Návratová hodnota

TRUE, pokud byla událost zpracována; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::OnMenuKey

Volá se rozhraním, když uživatel stiskne na hlavním panelu popisek nabídky.

virtual BOOL OnMenuKey(UINT nUpperChar);

Parametry

nUpperChar
[v] Tento parametr se nepoužívá.

Návratová hodnota

Vždy vrátí hodnotu FALSE.

Poznámky

Ve výchozím nastavení tato metoda vždy vrací HODNOTU FALSE. Tuto metodu přepište tak, aby reagovala, když uživatel na hlavním panelu stiskne klávesu nabídky.

CMFCRibbonBaseElement::OnProcessKey

Volá se rozhraním, když uživatel stiskne klávesovou zkratku.

virtual BOOL OnProcessKey(UINT nChar);

Parametry

nChar
[v] Tento parametr se nepoužívá.

Návratová hodnota

Vždy vrátí hodnotu FALSE.

Poznámky

Tuto metodu přepište, pokud chcete, aby prvek pásu karet zpracovával klávesovou zkratku.

CMFCRibbonBaseElement::OnRTLChanged

Volá se rozhraním, když se změní směr rozložení.

virtual void OnRTLChanged(BOOL bIsRTL);

Parametry

bIsRTL
[v] Tento parametr se nepoužívá.

Poznámky

Ve výchozím nastavení tato metoda nic nedělá. Přepsat tuto metodu pro úpravu prvku pásu karet při změně směru rozložení. Výchozí směr rozložení je zleva doprava.

CMFCRibbonBaseElement::OnSetFocus

Volá se rozhraním, když prvek pásu karet přijme nebo ztratí vstupní fokus.

virtual void OnSetFocus(BOOL B);

Poznámky

Tuto metodu přepište v odvozené třídě, pokud chcete, aby aplikace zpracovávala změnu v fokusu prvku pásu karet.

CMFCRibbonBaseElement::OnShow

Volá se rozhraním pro zobrazení nebo skrytí prvku pásu karet.

virtual void OnShow(BOOL bShow);

Parametry

BShow
[v] Tento parametr se nepoužívá.

Poznámky

Ve výchozím nastavení tato metoda nic nedělá. Tuto metodu přepište tak, aby se zobrazil nebo skryl prvek pásu karet.

CMFCRibbonBaseElement::OnShowPopupMenu

Před elementem pásu karet se zobrazí místní nabídka.

virtual void OnShowPopupMenu();

Poznámky

Tato metoda upozorní nadřazené okno panelu pásu karet, že prvek pásu karet zobrazí místní nabídku.

CMFCRibbonBaseElement::P ostMenuCommand

Zavře místní nabídku prvku pásu karet a odešle zprávu o zavření do nadřazené nabídky.

void PostMenuCommand(UINT uiCmdId);

Parametry

uiCmdId
[v] Parametr se nepoužívá.

Poznámky

Zpráva o zavření se odešle pouze v případě, že se prvek pásu karet nachází v místní nabídce.

CMFCRibbonBaseElement::Redraw

Aktualizuje zobrazení prvku pásu karet.

virtual void Redraw();

Poznámky

Tato metoda překresluje obdélník zobrazení pro prvek pásu karet voláním CWnd::RedrawWindow s RDW_INVALIDATE, RDW_ERASE a RDW_UPDATENOW příznaky nastaveny.

CMFCRibbonBaseElement::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

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

Návratová 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í.

CMFCRibbonBaseElement::SetCompactMode

Nastaví velikost zobrazení pro prvek pásu karet.

virtual void SetCompactMode(BOOL bCompactMode = TRUE);

Parametry

bCompactMode
[v] TRUE pro zmenšení velikosti zobrazení prvku pásu karet; NEPRAVDA, pokud chcete zvětšit velikost zobrazení prvku pásu karet.

Poznámky

Následující tabulka shrnuje logiku pro tuto metodu.

bCompactMode	Aktuální velikost prvku pásu karet	Nová velikost prvku pásu karet
TRUE	Compact	Ve výstupu nedošlo k žádné změně.
TRUE	Středně pokročilý	Kompaktní, pokud je to možné.
TRUE	Velká	Zprostředkující, pokud je to možné.
FALSE	Compact	Zprostředkující, pokud je to možné; jinak velký.

CMFCRibbonBaseElement::SetData

Přidruží datovou položku k prvku pásu karet.

void SetData(DWORD_PTR dwData);

Parametry

dwData
[v] Hodnota dat.

CMFCRibbonBaseElement::SetDefaultMenuLook

Nastaví prvek pásu karet tak, aby se zobrazoval jako automaticky otevíraný příkaz.

void SetDefaultMenuLook(BOOL bIsDefaultMenuLook = TRUE);

Parametry

bIsDefaultMenuLook
[v] PRAVDA, pokud chcete nastavit prvek pásu karet, aby se zobrazil jako automaticky otevíraný příkaz; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::SetDescription

Nastaví popis prvku pásu karet.

virtual void SetDescription(LPCTSTR lpszText);

Parametry

lpszText
[v] Popis prvku pásu karet.

Poznámky

Architektura zobrazí nový popis buď na stavovém řádku, nebo v popisu nebo pod tlačítkem nabídky.

CMFCRibbonBaseElement::SetID

Nastaví ID příkazu prvku pásu karet.

virtual void SetID(UINT nID);

Parametry

Nid
[v] ID příkazu.

CMFCRibbonBaseElement::SetInitialMode

Nastaví počáteční velikost zobrazení pro prvek pásu karet.

virtual void SetInitialMode(BOOL bOneRow = FALSE);

Parametry

bOneRow
[v] PRAVDA, pokud chcete omezit velikost zobrazení pro prvek pásu karet na kompaktní nebo přechodné; jinak NEPRAVDA.

Poznámky

Velikost zobrazení prvků pásu karet může být kompaktní, zprostředkující nebo velká.

CMFCRibbonBaseElement::SetKeys

Nastaví popisy kláves pro prvek pásu karet.

virtual void SetKeys(
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys=NULL);

Parametry

lpszKeys
[v] Popis prvku pásu karet

lpszMenuKeys
[v] Popis pro místní nabídku prvku pásu karet.

CMFCRibbonBaseElement::SetOriginal

Nastaví původní prvek pásu karet pro prvek pásu karet.

virtual void SetOriginal(CMFCRibbonBaseElement* pOriginal);

Parametry

pOriginal
[v] Ukazatel na prvek pásu karet

Poznámky

Prvky pásu karet, které se zkopírují do jiného kontejneru, zachovají ukazatel na původní prvek pásu karet.

CMFCRibbonBaseElement::SetParentCategory

Nastaví nadřazenou kategorii pro prvek pásu karet.

virtual void SetParentCategory(CMFCRibbonCategory* pParent);

Parametry

pParent
[v] Ukazatel na kategorii pásu karet

Poznámky

Skupiny s kartami v ovládacích prvcích pásu karet se nazývají kategorie.

CMFCRibbonBaseElement::SetParentMenu

Nastaví nadřazený kontejner nabídek pro prvek pásu karet.

virtual void SetParentMenu(CMFCRibbonPanelMenuBar* pMenuBar);

Parametry

pMenuBar
[v] Nadřazená nabídka.

Poznámky

CMFCRibbonBaseElement::SetParentRibbonBar

Nastaví nadřazený panel pásu karet pro prvek pásu karet.

virtual void SetParentRibbonBar(CMFCRibbonBar* pRibbonBar);

Parametry

pRibbonBar
[v] Ukazatel na nadřazený panel pásu karet

Poznámky

CMFCRibbonBaseElement::SetRect

Nastaví rozměry obdélníku zobrazení pro prvek pásu karet.

void SetRect(CRect rect);

Parametry

Rect
[v] Rozměry obdélníku.

Poznámky

CMFCRibbonBaseElement::SetText

Nastaví text a popis pro prvek pásu karet.

virtual void SetText(LPCTSTR lpszText);

Parametry

lpszText
[v] Text a popis prvku pásu karet

Poznámky

Chcete-li nastavit popis prvku pásu karet, připojte řídicí sekvenci nového řádku následované znaky s popisem klávesy k lpszText.

Příklad

//Set the text for the ribbon element
SetText(_T("Margins"))
//Set the text and a single-letter keytip
SetText(_T("Margins\nm"))
//Set the text and a multiple-letter keytip
SetText(_T("Line Numbers\nln"))

CMFCRibbonBaseElement::SetTextAlwaysOnRight

Nastaví text prvku pásu karet tak, aby se zobrazil vpravo.

virtual void SetTextAlwaysOnRight(BOOL bSet = TRUE);

Parametry

bSet
[v] TRUE pro zobrazení textu vpravo; jinak NEPRAVDA.

Poznámky

CMFCRibbonBaseElement::SetToolTipText

Nastaví text popisu prvku pásu karet.

virtual void SetToolTipText(LPCTSTR lpszText);

Parametry

lpszText
[v] Text popisu.

CMFCRibbonBaseElement::SetVisible

Nastaví viditelnost prvku pásu karet.

void SetVisible(BOOL bIsVisible);

Parametry

bIsVisible
[v] TRUE pro zobrazení prvku pásu karet; FALSE pro skrytí prvku pásu karet.

Poznámky

CMFCRibbonBaseElement::StretchHorizontally

Roztáhne šířku prvku pásu karet.

virtual void StretchHorizontally();

Poznámky

Ve výchozím nastavení tato metoda generuje chybu kontrolního výrazu v buildech ladění, a proto by neměla být volána. Přepište tuto metodu pro roztažení šířky prvku pásu karet.

CMFCRibbonBaseElement::StretchToWholeRow

Změní výšku zobrazení prvku pásu karet na zadanou výšku řádku.

virtual BOOL StretchToWholeRow(
    CDC* pDC,
    int nHeight);

Parametry

pDC
[v] Tento parametr se nepoužívá.

nHeight
[v] Výška řádku.

Návratová hodnota

TRUE, pokud byla nastavena výška zobrazení; jinak NEPRAVDA.

Poznámky

Přepište tuto metodu, chcete-li změnit výšku zobrazení prvku pásu karet na zadanou výšku řádku.

CMFCRibbonBaseElement::UpdateTooltipInfo

Aktualizuje text popisu pomocí prostředku příkazu pro prvek pásu karet.

virtual void UpdateTooltipInfo();

Poznámky

CMFCRibbonBaseElement::HasFocus

Určuje, zda nadřazený prvek obsahuje fokus klávesnice.

virtual BOOL HasFocus() const;

Sdílet prostřednictvím

CMFCRibbonBaseElement – třída

Syntaxe

Členové

Veřejné konstruktory

Veřejné metody

Chráněné metody

Poznámky

Příklad

Hierarchie dědičnosti

Požadavky

CMFCRibbonBaseElement::AddToKeyList

Parametry

Poznámky

CMFCRibbonBaseElement::AddToListBox

Parametry

Návratová hodnota

Poznámky

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

Návratová hodnota

Poznámky

CMFCRibbonBaseElement::CanBeCompacted

Návratová hodnota

Poznámky

CMFCRibbonBaseElement::CanBeStretched

Návratová hodnota

Poznámky

CMFCRibbonBaseElement::CanBeStretchedHorizontally

Návratová hodnota

Poznámky

CMFCRibbonBaseElement::CleanUpSizes

Poznámky

CMFCRibbonBaseElement::ClosePopupMenu

Poznámky

CMFCRibbonBaseElement::CopyFrom

Parametry

Poznámky

CMFCRibbonBaseElement::D estroyCtrl

Poznámky

CMFCRibbonBaseElement::D rawImage

Parametry

Poznámky

CMFCRibbonBaseElement::Najít

Parametry

Návratová hodnota

Poznámky

CMFCRibbonBaseElement::FindByData

Parametry

Návratová hodnota

Poznámky

CMFCRibbonBaseElement::FindByID

Parametry

Návratová hodnota

Poznámky

CMFCRibbonBaseElement::FindByOriginal

Parametry

Návratová hodnota

Poznámky

CMFCRibbonBaseElement::GetCompactSize

Parametry

Návratová hodnota

CMFCRibbonBaseElement::GetData

Návratová hodnota

CMFCRibbonBaseElement::GetDescription

Návratová hodnota

CMFCRibbonBaseElement::GetDroppedDown

Návratová hodnota

Poznámky

CMFCRibbonBaseElement::GetElements

Parametry

Poznámky

CMFCRibbonBaseElement::GetElementsByID

Parametry

Poznámky

CMFCRibbonBaseElement::GetHighlighted

Návratová hodnota

Poznámky

CMFCRibbonBaseElement::GetID

Návratová hodnota

CMFCRibbonBaseElement::GetImageSize