CMFCRibbonBaseElement – třída
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
| Jméno | popis |
|---|---|
CMFCRibbonBaseElement |
CMFCRibbonBaseElement Vytvoří objekt. |
Veřejné metody
| Jméno | 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::Is Kdo leRowHeight | 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 | Aktualizace popis prvku pásu karet. |
| CMFCRibbonBaseElement::OnAutoRepeat | Aktualizace prvek pásu karet v reakci na trvalý uživatelský vstup. |
| 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 | Aktualizace 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::StretchTo Kdo leRow | Změní výšku zobrazení prvku pásu karet na zadanou výšku řádku. |
| CMFCRibbonBaseElement::UpdateTooltipInfo | Aktualizace text popisu pomocí prostředku příkazu pro prvek pásu karet. |
Chráněné metody
| Jméno | 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:
RibbonImageLargeRibbonImageSmall
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
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á.
Vrácená 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;
Vrácená 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;
Vrácená 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();
Vrácená 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();
Vrácená 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
Vrácená 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.
Vrácená 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
Vrácená 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
Vrácená 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í.
Vrácená 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;
Vrácená 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;
Vrácená 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();
Vrácená 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();
Vrácená 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;
Vrácená 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;
Vrácená 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í.
Vrácená 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;
Vrácená 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.
Vrácená 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í
Vrácená 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;
Vrácená 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;
Vrácená 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();
Vrácená hodnota
ID příkazu oznámení.
Poznámky
CMFCRibbonBaseElement::GetOriginal
Načte původní prvek pásu karet.
CMFCRibbonBaseElement* GetOriginal() const;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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();
Vrácená 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;
Vrácená 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;
Vrácená 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í.
Vrácená 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í.
Vrácená hodnota
Aktuální velikost prvku pásu karet.
CMFCRibbonBaseElement::GetText
Vrátí text přidružený k prvku pásu karet.
LPCTSTR GetText() const;
Vrácená hodnota
Text přidružený k prvku pásu karet.
CMFCRibbonBaseElement::GetToolTipText
Vrátí text popisu prvku pásu karet.
virtual CString GetToolTipText() const;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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á.
Vrácená 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;
Vrácená 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;
Vrácená 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á.
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená 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;
Vrácená hodnota
TRUE, pokud je prvek pásu karet aktuálně zobrazen; jinak NEPRAVDA.
Poznámky
CMFCRibbonBaseElement::Is Kdo leRowHeight
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;
Vrácená 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.
Vrácená 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
Vrácená 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
Aktualizace 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
Aktualizace prvek pásu karet v reakci na trvalý uživatelský vstup.
virtual BOOL OnAutoRepeat();
Vrácená 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
Vrácená 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.
Vrácená 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á.
Vrácená 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á.
Vrácená 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
Aktualizace 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
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í.
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 | Žádná změna. |
| 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::StretchTo Kdo leRow
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.
Vrácená 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
Aktualizace 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;
Vrácená hodnota
TRUE, pokud je prvek pásu karet zaměřen; jinak NEPRAVDA.
Poznámky
Viz také
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro