`CMFCRibbonBar` Třída

Článek
07/05/2024

Třída CMFCRibbonBar implementuje pás karet podobný panelu, který se používá v Office 2007.

Další podrobnosti najdete ve zdrojovém kódu umístěném mfc ve složce instalace sady Visual Studio. Například %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Syntaxe

class CMFCRibbonBar : public CPane

Členové

Veřejné konstruktory

Název	Popis
`CMFCRibbonBar::CMFCRibbonBar`	Výchozí konstruktor.

Veřejné metody

Název	Popis
`CMFCRibbonBar::ActivateContextCategory`	Aktivuje kontextovou kategorii, která je již viditelná.
`CMFCRibbonBar::AddCategory`	Přidá na pás karet novou kategorii pásu karet.
`CMFCRibbonBar::AddContextCategory`	Přidá kontextovou kategorii.
`CMFCRibbonBar::AddMainCategory`	Přidá novou kategorii hlavního pásu karet.
`CMFCRibbonBar::AddPrintPreviewCategory`
`CMFCRibbonBar::AddQATOnlyCategory`
`CMFCRibbonBar::AddToTabs`	Přidejte prvek pásu karet na pravou stranu panelu pásu karet.
`CMFCRibbonBar::CreateEx`	Vytvoří řídicí panel a připojí ho k objektu `CPane` . (Přepsání `CPane::CreateEx`.)
`CMFCRibbonBar::Create`	Vytvoří ovládací prvek pásu karet a připojí ho k panelu pásu karet.
`CMFCRibbonBar::DeactivateKeyboardFocus`
`CMFCRibbonBar::DrawMenuImage`
`CMFCRibbonBar::DWMCompositionChanged`
`CMFCRibbonBar::EnableKeyTips`	Povolte nebo zakažte klávesové zkratky pro ovládací prvek pásu karet.
`CMFCRibbonBar::EnablePrintPreview`	Povolte kartu Náhled tisku.
`CMFCRibbonBar::EnableToolTips`	Povolí nebo zakáže popisy tlačítek a popisy na pásu karet.
`CMFCRibbonBar::FindByData`	Najděte prvek pásu karet pomocí dat, která určuje uživatel.
`CMFCRibbonBar::FindByID`	Najde prvek pásu karet, který má zadané ID příkazu.
`CMFCRibbonBar::FindCategoryIndexByData`	Vyhledá index kategorie pásu karet, která obsahuje uživatelsky definovaná data.
`CMFCRibbonBar::ForceRecalcLayout`
`CMFCRibbonBar::GetActiveCategory`	Získá ukazatel na aktivní kategorii.
`CMFCRibbonBar::GetCaptionHeight`	Vrátí výšku titulku. (Přepsání `CBasePane::GetCaptionHeight`.)
`CMFCRibbonBar::GetCategory`	Získá ukazatel na kategorii umístěnou v zadaném indexu.
`CMFCRibbonBar::GetCategoryCount`	Získá počet kategorií pásu karet na panelu karet.
`CMFCRibbonBar::GetCategoryHeight`
`CMFCRibbonBar::GetCategoryIndex`	Vrátí index kategorie pásu karet.
`CMFCRibbonBar::GetContextName`	Načte název titulku kontextové kategorie, který zadáte pomocí ID.
`CMFCRibbonBar::GetDroppedDown`
`CMFCRibbonBar::GetElementsByID`	Získá pole obsahující ukazatele na všechny prvky pásu karet, které mají zadané ID.
`CMFCRibbonBar::GetApplicationButton`	Získá ukazatel na tlačítko pásu karet.
`CMFCRibbonBar::GetFocused`	Vrátí prioritní prvek.
`CMFCRibbonBar::GetHideFlags`
`CMFCRibbonBar::GetItemIDsList`
`CMFCRibbonBar::GetKeyboardNavigationLevel`
`CMFCRibbonBar::GetKeyboardNavLevelCurrent`
`CMFCRibbonBar::GetKeyboardNavLevelParent`
`CMFCRibbonBar::GetMainCategory`	Vrátí ukazatel na kategorii pásu karet, která je aktuálně vybrána.
`CMFCRibbonBar::GetQATCommandsLocation`
`CMFCRibbonBar::GetQATDroppedDown`
`CMFCRibbonBar::GetQuickAccessCommands`	Vyplní seznam obsahující ID příkazů všech prvků, které se zobrazí na panelu nástrojů Rychlý přístup.
`CMFCRibbonBar::GetQuickAccessToolbarLocation`
`CMFCRibbonBar::GetTabTrancateRatio`
`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`
`CMFCRibbonBar::GetTooltipFixedWidthRegular`
`CMFCRibbonBar::GetVisibleCategoryCount`
`CMFCRibbonBar::HideAllContextCategories`	Skryje všechny aktivní a viditelné kategorie.
`CMFCRibbonBar::HideKeyTips`
`CMFCRibbonBar::HitTest`	Vyhledá ukazatel na prvek pásu karet umístěný v zadaném bodu v souřadnicích klienta na pásu karet.
`CMFCRibbonBar::IsKeyTipEnabled`	Určuje, zda jsou povoleny popisy klíčů.
`CMFCRibbonBar::IsMainRibbonBar`
`CMFCRibbonBar::IsPrintPreviewEnabled`	Určuje, zda je povolená karta Náhled tisku.
`CMFCRibbonBar::IsQATEmpty`
`CMFCRibbonBar::IsQuickAccessToolbarOnTop`	Určuje, jestli se panel nástrojů Rychlý přístup nachází nad panelem karet.
`CMFCRibbonBar::IsReplaceFrameCaption`	Určuje, zda panel pásu karet nahrazuje titulek hlavního rámce nebo je přidán pod titulek rámečku.
`CMFCRibbonBar::IsShowGroupBorder`
`CMFCRibbonBar::IsToolTipDescrEnabled`	Určuje, zda jsou popisy popisů povoleny.
`CMFCRibbonBar::IsToolTipEnabled`	Určuje, zda jsou povoleny popisy panelu pásu karet.
`CMFCRibbonBar::IsTransparentCaption`
`CMFCRibbonBar::IsWindows7Look`	Označuje, jestli má pás karet vzhled ve stylu Windows 7 (malé obdélníkové tlačítko aplikace).
`CMFCRibbonBar::LoadFromResource`	Přetíženo. Načte pás karet z prostředků aplikace.
`CMFCRibbonBar::OnClickButton`
`CMFCRibbonBar::OnEditContextMenu`
`CMFCRibbonBar::OnRTLChanged`	(Přepsání `CPane::OnRTLChanged`.)
`CMFCRibbonBar::OnSetAccData`	(Přepsání `CBasePane::OnSetAccData`.)
`CMFCRibbonBar::OnShowRibbonContextMenu`
`CMFCRibbonBar::OnShowRibbonQATMenu`
`CMFCRibbonBar::OnSysKeyDown`
`CMFCRibbonBar::OnSysKeyUp`
`CMFCRibbonBar::PopTooltip`
`CMFCRibbonBar::PreTranslateMessage`	(Přepsání `CBasePane::PreTranslateMessage`.)
`CMFCRibbonBar::RecalcLayout`	(Přepsání `CPane::RecalcLayout`.)
`CMFCRibbonBar::RemoveAllCategories`	Odebere všechny kategorie pásu karet z panelu karet.
`CMFCRibbonBar::RemoveAllFromTabs`	Odebere všechny prvky pásu karet z oblasti karty.
`CMFCRibbonBar::RemoveCategory`	Odebere kategorii pásu karet umístěnou v zadaném indexu.
`CMFCRibbonBar::SaveToXMLBuffer`	Uloží panel pásu karet do vyrovnávací paměti.
`CMFCRibbonBar::SaveToXMLFile`	Uloží panel karet do souboru XML.
`CMFCRibbonBar::SetActiveCategory`	Nastaví zadanou kategorii pásu karet na aktivní.
`CMFCRibbonBar::SetActiveMDIChild`
`CMFCRibbonBar::SetElementKeys`	Nastaví zadané klávesové zkratky pro všechny prvky pásu karet, které mají zadané ID příkazu.
`CMFCRibbonBar::SetApplicationButton`	Přiřadí tlačítko pásu karet aplikace na panelu karet.
`CMFCRibbonBar::SetKeyboardNavigationLevel`
`CMFCRibbonBar::SetMaximizeMode`
`CMFCRibbonBar::SetQuickAccessCommands`	Přidá jeden nebo více prvků pásu karet na panel nástrojů Rychlý přístup.
`CMFCRibbonBar::SetQuickAccessDefaultState`	Určuje výchozí stav panelu nástrojů Rychlý přístup.
`CMFCRibbonBar::SetQuickAccessToolbarOnTop`	Umístí panel nástrojů Rychlý přístup nad panel karet nebo pod panel karet.
`CMFCRibbonBar::SetTooltipFixedWidth`
`CMFCRibbonBar::SetWindows7Look`	Povolení nebo zakázání vzhledu pásu karet ve Stylu Windows 7 (malé obdélníkové tlačítko aplikace)
`CMFCRibbonBar::ShowCategory`	Zobrazí nebo skryje zadanou kategorii pásu karet.
`CMFCRibbonBar::ShowContextCategories`	Zobrazí nebo skryje kontextové kategorie, které mají zadané ID.
`CMFCRibbonBar::ShowKeyTips`
`CMFCRibbonBar::ToggleMimimizeState`	Přepíná panel pásu karet mezi minimalizované a maximalizované stavy.
`CMFCRibbonBar::TranslateChar`

Poznámky

Microsoft představil pás karet Fluent pro Office, když byl současně vydán systém Microsoft Office 2007. Tento panel pásu karet není jenom nový ovládací prvek. Představuje nové paradigma uživatelského rozhraní. Pás karet je podokno, které obsahuje sadu karet označovaných jako kategorie. Každá kategorie je logicky rozdělená na panely pásu karet a každý panel může obsahovat různé ovládací prvky a příkazová tlačítka.

Prvky, které se zobrazí na panelu pásu karet, rozbalí a zvětší kontrakt, aby se co nejlépe využilo dostupné místo. Pokud například panel pásu karet nemá dostatek místa k zobrazení jeho prvků, stane se tlačítkem nabídky, které zobrazí dílčí položky v místní nabídce. Pás karet se chová jako statický (ne plovoucí) řídicí panel a lze jej ukotvit v horní části rámečku.

Třídu můžete použít CMFCRibbonStatusBar k implementaci stavového řádku podobného stavovém řádku použitému v Office 2007. Kategorie pásu karet obsahuje (a zobrazuje) skupinu panelů pásu karet. Každý panel pásu karet obsahuje jeden nebo více prvků pásu karet, které jsou odvozeny z CMFCRibbonBaseElement.

Informace o tom, jak přidat pruh pásu karet do existující aplikace MFC, naleznete v tématu Návod: Aktualizace aplikace MFC Scribble.

Hierarchie dědičnosti

Požadavky

Záhlaví: afxribbonbar.h

`CMFCRibbonBar::ActivateContextCategory`

Aktivuje kontextovou kategorii, která je již viditelná.

BOOL ActivateContextCategory(UINT uiContextID);

Parametry

uiContextID
[v] ID kontextové kategorie.

Návratová hodnota

TRUE je-li nalezena a aktivována kontextová kategorie uiContextID ; jinak FALSE.

`CMFCRibbonBar::AddCategory`

Vytvoří a inicializuje novou kategorii pásu karet pro pruh pásu karet.

CMFCRibbonCategory* AddCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage= CSize(16,
    16),
    CSize sizeLargeImage= CSize(32,
    32),
    int nInsertAt = -1,
    CRuntimeClass* pRTI= NULL);

Parametry

lpszName
[v] Název kategorie pásu karet

uiSmallImagesResID
[v] ID prostředku malého seznamu obrázků pro kategorii pásu karet

uiLargeImagesResID
[v] ID prostředku velkého seznamu obrázků pro kategorii pásu karet

sizeSmallImage
[v] Určuje velikost malých obrázků pro kategorii pásu karet.

sizeLargeImage
[v] Určuje velikost velkých obrázků pro kategorii pásu karet.

nInsertAt
[v] Index založený na nule umístění kategorie

pRTI
[v] Ukazatel na CMFCRibbonCategory třídu run-time třídy pro dynamické vytvoření kategorie pásu karet za běhu.

Návratová hodnota

Ukazatel na novou kategorii pásu karet, pokud byla metoda úspěšná; v opačném případě . NULL

Poznámky

pRTI Pokud parametr neníNULL, vytvoří se nová kategorie pásu karet dynamicky pomocí třídy run-time.

Příklad

Následující příklad ukazuje, jak použít metodu AddCategory CMFCRibbonBar ve třídě.

// Add "Home" category.
// CMFCRibbonBar m_wndRibbonBar
strTemp.LoadString(IDS_RIBBON_HOME);
CMFCRibbonCategory *pCategoryHome = m_wndRibbonBar.AddCategory(strTemp,
                                                               IDB_WRITESMALL, IDB_WRITELARGE);

`CMFCRibbonBar::AddContextCategory`

Vytvoří a inicializuje novou kategorii kontextu pro panel pásu karet.

CMFCRibbonCategory* AddContextCategory(
    LPCTSTR lpszName,
    LPCTSTR lpszContextName,
    UINT uiContextID,
    AFX_RibbonCategoryColor clrContext,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32),
    CRuntimeClass* pRTI = NULL);

Parametry

lpszName
[v] Název kategorie.

lpszContextName
[v] Název titulku kontextové kategorie

uiContextID
[v] ID kontextu.

clrContext
[v] Barva titulku kontextové kategorie

uiSmallImagesResID
[v] ID prostředku malého obrázku kontextové kategorie

uiLargeImagesResID
[v] ID prostředku velkého obrázku kontextové kategorie

sizeSmallImage
[v] Velikost malého obrázku

sizeLargeImage
[v] Velikost velkého obrázku

pRTI
[v] Ukazatel na třídu modulu runtime.

Návratová hodnota

Ukazatel na nově vytvořenou kategorii nebo NULL pokud CreateObject metoda pRTI nemůže vytvořit zadanou kategorii.

Poznámky

Pomocí této funkce můžete přidat kontextovou kategorii. Kontextové kategorie jsou speciálním typem kategorie, která se dá zobrazit nebo skrýt za běhu v závislosti na aktuálním kontextu aplikace. Když například uživatel vybere objekt, můžete zobrazit speciální karty s kontextovými kategoriemi, které slouží ke změně konkrétního vybraného objektu.

Barva kontextové kategorie může být jedna z následujících hodnot:

AFX_CategoryColor_None
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet

`CMFCRibbonBar::AddMainCategory`

Vytvoří novou hlavní kategorii pásu karet pro panel pásu karet.

CMFCRibbonMainPanel* AddMainCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32));

Parametry

lpszName
[v] Název hlavní kategorie pásu karet

uiSmallImagesResID
[v] ID prostředku malých imagí

uiLargeImagesResID
[v] ID prostředku velkých imagí

sizeSmallImage
[v] Velikost malýchobrázkůch

sizeLargeImage
[v] Velikost velkých obrázků.

Návratová hodnota

Ukazatel na novou hlavní kategorii pásu karet, pokud byla metoda úspěšná; v opačném případě . NULL

Poznámky

Pokud už hlavní kategorie pásu karet existuje, odstraní se.

Příklad

Následující příklad ukazuje, jak použít metodu AddMainCategory CMFCRibbonBar ve třídě.

// m_wndRibbonBar is declared as a protected member variable
// CMFCRibbonBar m_wndRibbonBar.
// strTemp is a CString variable.
strTemp.LoadString(IDS_RIBBON_FILE);
CMFCRibbonMainPanel *pMainPanel = m_wndRibbonBar.AddMainCategory(strTemp,
                                                                 IDB_FILESMALL, IDB_FILELARGE);

`CMFCRibbonBar::AddPrintPreviewCategory`

Vytvoří kategorii náhledu tisku na pásu karet.

CMFCRibbonCategory* AddPrintPreviewCategory();

Návratová hodnota

Ukazatel na novou kategorii pásu karet, pokud byla metoda úspěšná; v opačném případě . NULL

Poznámky

Tato metoda vytvoří kategorii pásu karet a ovládací prvky, které potřebuje k poskytnutí náhledu tisku.

`CMFCRibbonBar::AddQATOnlyCategory`

Vytvoří kategorii pásu karet s rychlým přístupem.

CMFCRibbonCategory* AddQATOnlyCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    CSize sizeSmallImage = CSize(16,
    16));

Parametry

lpszName
[v] Název kategorie.

uiSmallImagesResID
[v] ID prostředku seznamu obrázků pro kategorii.

sizeSmallImage
[v] Velikost obrázků pro prvky pásu karet v kategorii

Návratová hodnota

Ukazatel na novou kategorii, pokud byla metoda úspěšná; v opačném případě . NULL

Poznámky

Kategorie pásu karet panelu nástrojů Rychlý přístup se používá pouze v dialogovém okně pro přizpůsobení panelu nástrojů Rychlý přístup.

`CMFCRibbonBar::AddToTabs`

Přidá zadaný prvek pásu karet na řádek karet na panelu karet.

void AddToTabs(CMFCRibbonBaseElement* pElement);

Parametry

pElement
[v] Ukazatel na prvek pásu karet

Poznámky

Prvek pásu karet se umístí před všechna systémová tlačítka.

`CMFCRibbonBar::CMFCRibbonBar`

Vytvoří a inicializuje CMFCRibbonBar objekt.

CMFCRibbonBar(BOOL bReplaceFrameCaption = TRUE);

Parametry

bReplaceFrameCaption
[v] TRUE pro panel pásu karet nahradit titulek hlavního okna rámečku; FALSE najděte panel pásu karet pod titulkem hlavního okna rámečku.

Poznámky

`CMFCRibbonBar::Create`

Vytvoří okno pro panel pásu karet.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parametry

pParentWnd
[v] Ukazatel na nadřazené okno panelu pásu karet

dwStyle
[v] Logická kombinace stylů pro nové okno.

nID
[v] ID nového okna.

Návratová hodnota

TRUE pokud bylo okno vytvořeno; jinak FALSE.

Poznámky

Příklad

Následující příklad ukazuje, jak použít Create metodu CMFCRibbonBar třídy.

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.Create(this, WS_CHILD | CBRS_TOP);

`CMFCRibbonBar::CreateEx`

Vytvoří okno pro panel pásu karet.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = 0,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parametry

pParentWnd
[v] Ukazatel na nadřazené okno panelu pásu karet

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

dwStyle
[v] Logická kombinace stylů pro nové okno.

nID
[v] ID nového okna.

Návratová hodnota

TRUE pokud bylo okno vytvořeno; jinak FALSE.

Poznámky

`CMFCRibbonBar::DeactivateKeyboardFocus`

Zavře všechny ovládací prvky klávesové zkratky na panelu karet.

void DeactivateKeyboardFocus(BOOL bSetFocus = TRUE);

Parametry

bSetFocus
[v] TRUE nastavte fokus na nadřazené okno panelu pásu karet.

Poznámky

`CMFCRibbonBar::DrawMenuImage`

Nakreslí obrázek tlačítka nabídky.

BOOL DrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuItem,
    const CRect& rectImage);

Parametry

pDC
[v] Ukazatel na kontext zařízení pro tlačítko nabídky.

pMenuItem
[v] Ukazatel na tlačítko nabídky panelu nástrojů

rectImage
[v] Obdélník zobrazení tlačítka nabídky

Návratová hodnota

TRUE pokud byl obrázek nakreslen; jinak FALSE.

Poznámky

`CMFCRibbonBar::DWMCompositionChanged`

Upraví zobrazení panelu pásu karet, když je povolené nebo zakázané složení Správce oken plochy (DWM).

virtual void DWMCompositionChanged();

Poznámky

`CMFCRibbonBar::EnableKeyTips`

Povolí nebo zakáže funkci klávesové zkratky pro panel pásu karet.

void EnableKeyTips(BOOL bEnable = TRUE);

Parametry

bEnable
[v] TRUE povolení funkce popisů klíčů; FALSE zakázat funkci popisů klíčů.

Poznámky

Když tuto funkci povolíte, zobrazí se klávesové zkratky, když uživatel stiskne klávesy ALT nebo F10 . Když uživatel stiskne klávesu ALT , zobrazí se klávesové zkratky se zpožděním 200 milisekund. Toto zpoždění umožňuje spuštění klávesových zkratek, aby stisknutá klávesa ALT nenarušovala jiné kombinace, které obsahují klávesu ALT .

`CMFCRibbonBar::EnablePrintPreview`

Povolí nebo zakáže funkci Náhled tisku.

void EnablePrintPreview(BOOL bEnable = TRUE);

Parametry

bEnable
[v] TRUE k povolení funkce Náhled tisku. FALSE Chcete-li zakázat funkci Náhled tisku.

Poznámky

Pokud bEnable je FALSE a existuje kategorie náhledu tisku, odstraní se.

Ve výchozím nastavení je povolená funkce Náhled tisku.

`CMFCRibbonBar::EnableToolTips`

Povolí nebo zakáže popisy tlačítek a volitelné popisy popisů na pásu karet.

void EnableToolTips(
    BOOL bEnable = TRUE,
    BOOL bEnableDescr = TRUE);

Parametry

bEnable
[v] TRUE povolení popisů na pásu karet; FALSE pokud chcete zakázat popisy na pásu karet.

bEnableDescr
[v] TRUE povolit popisy popisů v popisu; FALSE popisy popisů tlačítek zakážete.

Poznámky

Parametr bEnable určuje, jestli se popisy zobrazí, když ukazatel myši najede na prvek pásu karet. Parametr bEnableDescr určuje, zda se zobrazí další popisný text s textem popisu.

`CMFCRibbonBar::FindByData`

Načte ukazatel na prvek pásu karet, pokud má zadaná data a viditelnost.

CMFCRibbonBaseElement* FindByData(
    DWORD_PTR dwData,
    BOOL bVisibleOnly = TRUE) const;

Parametry

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

bVisibleOnly
[v] TRUE pro vyhledávání pouze viditelných prvků pásu karet; FALSE prohledat všechny prvky pásu karet.

Návratová hodnota

Ukazatel na prvek pásu karet, pokud má zadaná data a viditelnost; jinak NULL.

Poznámky

Prvek pásu karet je libovolný ovládací prvek, který můžete přidat na pás karet, například tlačítko pásu karet nebo kategorii pásu karet nebo posuvník pásu karet.

`CMFCRibbonBar::FindByID`

Načte ukazatel na prvek pásu karet, který má zadané ID příkazu a hodnoty hledání.

CMFCRibbonBaseElement* FindByID(
    UINT uiCmdID,
    BOOL bVisibleOnly = TRUE,
    BOOL bExcludeQAT = FALSE) const;

Parametry

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

bVisibleOnly
[v] TRUE pro vyhledávání pouze viditelných prvků pásu karet; FALSE prohledat všechny prvky pásu karet.

bExcludeQAT
[v] TRUE vyloučit prvky panelu nástrojů rychlý přístup z hledání; v opačném případě . FALSE

Návratová hodnota

Ukazatel na prvek pásu karet, pokud má zadané ID příkazu a hodnoty hledání; v opačném případě . NULL

Poznámky

Prvek pásu karet je jakýkoli ovládací prvek pásu karet, který lze přidat na pás karet, například tlačítko pásu karet nebo kategorii pásu karet nebo posuvník pásu karet.

Obecně může existovat více než jeden prvek pásu karet, který má stejné ID příkazu. Pokud chcete získat ukazatele na všechny prvky pásu karet, které používají zadané ID příkazu, použijte metodu CMFCRibbonBar::GetElementsByID .

`CMFCRibbonBar::FindCategoryIndexByData`

Načte index kategorie pásu karet, která obsahuje zadaná data.

int FindCategoryIndexByData(DWORD dwData) const;

Parametry

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

Návratová hodnota

Nulový index kategorie pásu karet, pokud byla metoda úspěšná; jinak -1.

`CMFCRibbonBar::ForceRecalcLayout`

Upraví rozložení všech položek na pásu karet a nadřazené okno a překreslí celé okno.

void ForceRecalcLayout();

Poznámky

`CMFCRibbonBar::GetActiveCategory`

Načte ukazatel na aktivní kategorii pásu karet.

CMFCRibbonCategory* GetActiveCategory() const;

Návratová hodnota

Ukazatel na aktivní kategorii pásu karet; nebo NULL pokud není žádná kategorie aktivní.

Poznámky

Kategorie je aktivní, pokud má fokus. Ve výchozím nastavení je aktivní kategorie první kategorií na levé straně panelu pásu karet.

Hlavní kategorie se zobrazí, když uživatel stiskne tlačítko aplikace a nemůže být aktivní kategorií.

`CMFCRibbonBar::GetApplicationButton`

Načte ukazatel na tlačítko aplikace.

CMFCRibbonApplicationButton* GetApplicationButton() const;

Návratová hodnota

Ukazatel na tlačítko aplikace; nebo NULL pokud tlačítko nebylo nastaveno.

`CMFCRibbonBar::GetCaptionHeight`

Načte výšku oblasti titulků pro pruh pásu karet.

int GetCaptionHeight() const;

Návratová hodnota

Výška oblasti titulků na pásu karet v pixelech

Poznámky

`CMFCRibbonBar::GetCategory`

Načte ukazatel na kategorii pásu karet v zadaném indexu.

CMFCRibbonCategory* GetCategory(int nIndex) const;

Parametry

nIndex
[v] Index kategorie pásu karet založený na nule v seznamu kategorií pásu karet, které jsou obsaženy na panelu pásu karet.

Návratová hodnota

Ukazatel na kategorii pásu karet v zadaném indexu; jinak, NULL pokud nIndex byl mimo rozsah.

`CMFCRibbonBar::GetCategoryCount`

Načte počet kategorií pásu karet na panelu karet.

int GetCategoryCount() const;

Návratová hodnota

Počet kategorií pásu karet na panelu karet

`CMFCRibbonBar::GetCategoryHeight`

Načte výšku kategorie.

int GetCategoryHeight() const;

Návratová hodnota

Výška kategorie.

Poznámky

Výška kategorie zahrnuje výšku karty kategorie.

`CMFCRibbonBar::GetCategoryIndex`

Načte index zadané kategorie pásu karet.

int GetCategoryIndex(CMFCRibbonCategory* pCategory) const;

Parametry

pCategory
[v] Ukazatel na kategorii pásu karet

Návratová hodnota

Index založený na nule kategorie pásu karet určený hodnotou pCategory; nebo -1, pokud kategorie pásu karet nebyla nalezena.

`CMFCRibbonBar::GetContextName`

Načte název titulku kontextové kategorie určeného ID kontextu.

BOOL GetContextName(
    UINT uiContextID,
    CString& strName) const;

Parametry

uiContextID
[v] ID kontextu kategorie pásu karet.

strName
[ven] Název titulku kontextové kategorie.

Návratová hodnota

TRUE pokud byla metoda úspěšná; jinak, FALSE pokud uiContextID byl nulový nebo kontextový titulek kategorie nebyl nalezen.

`CMFCRibbonBar::GetDroppedDown`

Načte prvek pásu karet, který je aktuálně vyřazen.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Návratová hodnota

Prvek pásu karet, který je nyní vyřazen; nebo NULL pokud není aktuálně odstraněn žádný prvek pásu karet.

Poznámky

`CMFCRibbonBar::GetElementsByID`

Načte pole ukazatelů na všechny prvky pásu karet, které mají konkrétní ID příkazu.

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

Parametry

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

arButtons
[ven] Pole ukazatelů na prvky pásu karet

Poznámky

Více prvků pásu karet může mít stejné ID příkazu, protože některé prvky pásu karet lze zkopírovat na panel nástrojů Rychlý přístup.

`CMFCRibbonBar::GetHideFlags`

Načte příznaky, které označují, kolik pásu karet je viditelné.

DWORD GetHideFlags() const;

Návratová hodnota

Příznaky, které označují, jak velká část pásu karet je viditelná.

Poznámky

Následující tabulka uvádí možnou kombinaci příznaků pro vrácenou hodnotu:

Příznak	Popis
`AFX_RIBBONBAR_HIDE_ELEMENTS`	Panel pásu karet je minimalizovaný svisle a jsou viditelné jenom karty kategorií, hlavní tlačítko a panel nástrojů Rychlý přístup.
`AFX_RIBBONBAR_HIDE_ALL`	Šířka pruhu pásu karet je menší než minimální šířka a je zcela skrytá.

`CMFCRibbonBar::GetItemIDsList`

Načte ID příkazů pro zadanou kolekci prvků pásu karet na panelu karet.

void GetItemIDsList(CList<UINT, UINT>& lstItems,
    BOOL bHiddenOnly = FALSE) const;

Parametry

lstItems
[ven] Seznam ID příkazů pro prvky pásu karet, které jsou obsaženy na panelu pásu karet

bHiddenOnly
[v] TRUE vyloučit prvky pásu karet, které jsou zobrazeny; FALSE a zahrnout všechny prvky pásu karet do panelu pásu karet.

Poznámky

`CMFCRibbonBar::GetKeyboardNavigationLevel`

Načte aktuální úroveň navigace, když uživatel stiskne klávesové zkratky, které jsou obsaženy na pásu karet.

int GetKeyboardNavigationLevel() const;

Návratová hodnota

Aktuální úroveň navigace, když uživatel stiskne klávesové zkratky, které jsou obsaženy na pásu karet. Následující tabulka uvádí možné návratové hodnoty:

Hodnota	Popis
-1	Popisy kláves se nezobrazují.
0	Zobrazí se klávesové zkratky.
0	Uživatel stiskl zobrazený popis.

Poznámky

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

Načte aktuální navigační objekt klávesnice na panelu karet.

CObject* GetKeyboardNavLevelCurrent() const;

Návratová hodnota

Aktuální objekt navigace pomocí klávesnice na panelu karet; v opačném případě NULL , pokud žádný objekt aktuálně nezobrazuje klávesové zkratky.

Poznámky

Objekt, který aktuálně zobrazuje klávesové zkratky, je aktuální objekt navigace pomocí klávesnice.

`CMFCRibbonBar::GetKeyboardNavLevelParent`

Načte nadřazený navigační objekt klávesnice na panelu karet.

CObject* GetKeyboardNavLevelParent() const;

Návratová hodnota

Nadřazený navigační objekt klávesnice na panelu karet; jinak NULL.

Poznámky

Když uživatel stiskne na pásu karet klávesovou zkratku, stane se aktuální navigační objekt klávesnice nadřazeným navigačním objektem klávesnice.

`CMFCRibbonBar::GetMainCategory`

Načte ukazatel na hlavní kategorii pásu karet.

CMFCRibbonCategory* GetMainCategory() const;

Návratová hodnota

Ukazatel na hlavní kategorii pásu karet.

Poznámky

Hlavní kategorie pásu karet obsahuje hlavní panel pásu karet.

`CMFCRibbonBar::GetQATCommandsLocation`

Načte obdélník zobrazení pro oddíl příkazů panelu nástrojů Rychlý přístup.

CRect GetQATCommandsLocation() const;

Návratová hodnota

Obdélník zobrazení pro oddíl příkazů na panelu nástrojů Rychlý přístup

Poznámky

Oddíl příkazů obdélníku zobrazení neobsahuje tlačítko přizpůsobení.

`CMFCRibbonBar::GetQATDroppedDown`

Načte ukazatel na prvek pásu karet na panelu nástrojů Rychlý přístup, který obsahuje rozevírací nabídku, která je mimo provoz.

CMFCRibbonBaseElement* GetQATDroppedDown();

Návratová hodnota

Ukazatel na prvek pásu karet na panelu nástrojů Rychlý přístup, který obsahuje rozevírací nabídku, je mimo provoz.

Poznámky

`CMFCRibbonBar::GetQuickAccessCommands`

Načte seznam ID příkazů pro prvky pásu karet na panelu nástrojů Rychlý přístup.

void GetQuickAccessCommands(CList<UINT,UINT>& lstCommands);

Parametry

lstCommands
[ven] Seznam ID příkazů pro prvky pásu karet na panelu nástrojů Rychlý přístup

Poznámky

Seznam neobsahuje prvky pásu karet, které jsou oddělovačem ovládacích prvků.

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

Načte obdélník zobrazení pro panel nástrojů Rychlý přístup.

CRect GetQuickAccessToolbarLocation() const;

Návratová hodnota

Obdélník zobrazení panelu nástrojů Rychlý přístup

Poznámky

`CMFCRibbonBar::GetTabTrancateRatio`

Načte zmenšení procentuální velikosti v šířce zobrazení karet kategorií.

int GetTabTrancateRatio() const;

Návratová hodnota

Procento zmenšení šířky zobrazení karet kategorií.

Poznámky

Karty kategorií se zmenšují šířkou, pokud na panelu pásu karet není dostatek šířky.

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

Načte velkou velikost šířky popisu panelu pásu karet.

int GetTooltipFixedWidthLargeImage() const;

Návratová hodnota

Velká velikost šířky popisu v pixelech.

Poznámky

Pokud je šířka popisu velká 0, šířka se liší.

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

Načte běžnou velikost šířky popisu panelu pásu karet.

int GetTooltipFixedWidthRegular() const;

Návratová hodnota

Běžná velikost šířky popisu v pixelech.

Poznámky

Pokud je běžná velikost šířky popisu 0, šířka se liší.

`CMFCRibbonBar::GetVisibleCategoryCount`

Načte počet viditelných kategorií na panelu karet.

int GetVisibleCategoryCount() const;

Návratová hodnota

Počet viditelných kategorií na pásu karet

Poznámky

`CMFCRibbonBar::HideAllContextCategories`

Skryje všechny kontextové kategorie na panelu karet.

BOOL HideAllContextCategories();

Návratová hodnota

TRUEpokud byla skrytá alespoň jedna kontextová kategorie; v opačném případě . FALSE

Poznámky

Pokud je kontextová kategorie aktivní, aktivní kategorie se resetuje na první viditelnou kategorii v seznamu kategorií.

`CMFCRibbonBar::HideKeyTips`

Skryje všechny klávesové zkratky na panelu karet.

void HideKeyTips();

Poznámky

`CMFCRibbonBar::HitTest`

Načte ukazatel na prvek pásu karet určený umístěním bodu.

virtual CMFCRibbonBaseElement* HitTest(
    CPoint point,
    BOOL bCheckActiveCategory= FALSE,
    BOOL bCheckPanelCaption= FALSE);

Parametry

point
[v] Umístění bodu v souřadnicích pruhu pásu karet

bCheckActiveCategory
[v] TRUE prohledat aktivní kategorii; FALSE nehledat aktivní kategorii.

bCheckPanelCaption
[v] TRUE k otestování titulku panelu pásu karet s bodem umístěným v něm; FALSE nechcete testovat titulek panelu pásu karet s bodem, který je v něm umístěný. Další informace najdete v části Poznámky .

Návratová hodnota

Ukazatel na prvek pásu karet umístěný v zadaném bodě; v opačném případě NULL , pokud bod není umístěn v prvku pásu karet.

Poznámky

Titulek panelu pásu karet s bodem umístěným v něm není testován, pokud bCheckActiveCategory parametr není TRUE.

`CMFCRibbonBar::IsKeyTipEnabled`

Určuje, jestli je povolená funkce popisů klíčů.

BOOL IsKeyTipEnabled() const;

Návratová hodnota

TRUE pokud je povolená funkce popisů klíčů; jinak FALSE.

`CMFCRibbonBar::IsMainRibbonBar`

Určuje, jestli je pruh pásu karet primárním panelem pásu karet.

virtual BOOL IsMainRibbonBar() const;

Návratová hodnota

Vždy vrátí hodnotu TRUE.

Poznámky

Ve výchozím nastavení tato metoda vždy vrátí TRUE. Tuto metodu přepište tak, aby označí, jestli je pruh pásu karet primárním panelem pásu karet.

`CMFCRibbonBar::IsPrintPreviewEnabled`

Určuje, jestli je povolená funkce Náhled tisku.

BOOL IsPrintPreviewEnabled() const;

Návratová hodnota

TRUE pokud je povolena funkce Náhled tisku, jinak FALSE.

`CMFCRibbonBar::IsQATEmpty`

Určuje, jestli panel nástrojů Rychlý přístup obsahuje příkazová tlačítka.

BOOL IsQATEmpty() const;

Návratová hodnota

TRUE pokud panel nástrojů Rychlý přístup obsahuje příkazová tlačítka; jinak FALSE.

Poznámky

`CMFCRibbonBar::IsQuickAccessToolbarOnTop`

Určuje, jestli je panel nástrojů Rychlý přístup umístěný nad nebo pod panelem pásu karet.

BOOL IsQuickAccessToolbarOnTop() const;

Návratová hodnota

TRUE pokud je panel nástrojů Rychlý přístup umístěn přes panel karet; FALSE pokud je panel nástrojů Rychlý přístup umístěn pod panelem pásu karet.

`CMFCRibbonBar::IsReplaceFrameCaption`

Určuje, jestli se pruh na pásu karet nahrazuje nebo je pod titulkem okna hlavního rámečku.

BOOL IsReplaceFrameCaption() const;

Návratová hodnota

TRUE pokud panel pásu karet nahradí titulek hlavního okna rámečku; FALSE pokud je panel pásu karet pod titulkem okna hlavního rámečku.

`CMFCRibbonBar::IsShowGroupBorder`

Určuje, zda skupiny tlačítek umístěné na pásu karet zobrazují ohraničení skupiny.

virtual BOOL IsShowGroupBorder(CMFCRibbonButtonsGroup* pGroup) const;

Parametry

pGroup
[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 vrátí FALSE. Tuto metodu přepište tak, aby označí, jestli skupiny tlačítek umístěné na pásu karet zobrazují ohraničení skupiny.

`CMFCRibbonBar::IsToolTipDescrEnabled`

Označuje, zda jsou povoleny popisy popisů.

BOOL IsToolTipDescrEnabled() const;

Návratová hodnota

TRUE pokud jsou povoleny popisy popisů; FALSE pokud jsou popisy popisů zakázané.

Poznámky

Popisy popisů jsou další popisný text zobrazený s textem popisu.

`CMFCRibbonBar::IsToolTipEnabled`

Označuje, jestli jsou pro panel pásu karet povolené nebo zakázané popisy.

BOOL IsToolTipEnabled() const;

Návratová hodnota

TRUE pokud jsou povoleny popisy; FALSE pokud jsou popisy zakázané.

`CMFCRibbonBar::IsTransparentCaption`

Určuje, zda je zobrazení nastaveno pro barevné schéma Windows Aero.

BOOL IsTransparentCaption() const;

Návratová hodnota

TRUE pokud je barevné schéma Windows Aero; jinak FALSE.

Poznámky

`CMFCRibbonBar::OnClickButton`

Tato metoda je zachována kvůli zpětné kompatibilitě s existujícími aplikacemi a neměla by se používat pro nový vývoj.

virtual void OnClickButton(
    CMFCRibbonButton* pButton,
    CPoint point);

Parametry

pButton
[v] Ukazatel myši na tlačítko, na které bylo kliknutí.

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

Poznámky

`CMFCRibbonBar::OnEditContextMenu`

virtual void OnEditContextMenu(
    CMFCRibbonRichEditCtrl* pEdit,
    CPoint point);

Parametry

[v] pEdit
[v] point\

Poznámky

`CMFCRibbonBar::OnRTLChanged`

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

virtual void OnRTLChanged(BOOL bIsRTL);

Parametry

bIsRTL
[v] TRUE pokud je rozložení zprava doleva; FALSE pokud je rozložení zleva doprava.

Poznámky

Tato metoda upraví rozložení všech ovládacích prvků na pásu karet pro nový směr rozložení.

`CMFCRibbonBar::OnSetAccData`

Tato metoda je interní pro architekturu a není určena k zavolání z uživatelského kódu.

BOOL OnSetAccData(long lVal);

Parametry

long lVal Index přístupného objektu.

Návratová hodnota

S_OK v případě úspěchu; jinak FALSE nebo S_FALSE.

Poznámky

`CMFCRibbonBar::OnShowRibbonContextMenu`

virtual BOOL OnShowRibbonContextMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parametry

[v] pWnd
[v] x
[v] y
[v] pHit\

Návratová hodnota

Poznámky

`CMFCRibbonBar::OnShowRibbonQATMenu`

virtual BOOL OnShowRibbonQATMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parametry

[v] pWnd
[v] x
[v] y
[v] pHit\

Návratová hodnota

Poznámky

`CMFCRibbonBar::OnSysKeyDown`

Volá se rozhraním, když uživatel stiskne klávesu F10 nebo podrží klávesu ALT a pak stiskne jinou klávesu.

BOOL OnSysKeyDown(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parametry

pFrameWnd
[v] Ukazatel na nadřazené okno hlavního rámce na pásu karet

wParam
[v] Kód virtuálního klíče stisknuté klávesy

lParam
[v] Příznaky stavu klávesnice při stisknutí klávesy

Návratová hodnota

TRUE byla-li zpracována událost stisknutí kláves; jinak FALSE.

Poznámky

`CMFCRibbonBar::OnSysKeyUp`

Volá se rozhraním, když uživatel uvolní klávesu F10, klávesu ALT nebo klávesu, která byla stisknuta při stisknutí klávesy ALT.

BOOL OnSysKeyUp(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parametry

pFrameWnd
[v] Ukazatel na nadřazené okno hlavního rámce na pásu karet

wParam
[v] Kód virtuálního klíče vydaného klíče

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

Návratová hodnota

TRUE byla-li zpracována událost stisknutí kláves; jinak FALSE.

Poznámky

`CMFCRibbonBar::PopTooltip`

Odebere popis ze zobrazení.

void PopTooltip();

Poznámky

`CMFCRibbonBar::PreTranslateMessage`

Určuje, zda je zadaná zpráva zpracována panelem pásu karet.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametry

pMsg
[v] Ukazatel na zprávu

Návratová hodnota

TRUE pokud byla zpráva zpracována panelem pásu karet; jinak FALSE.

Poznámky

`CMFCRibbonBar::RecalcLayout`

Upraví rozložení všech ovládacích prvků na pásu karet.

virtual void RecalcLayout();

Poznámky

Po úpravě rozložení se aktualizuje zobrazení panelu pásu karet.

`CMFCRibbonBar::RemoveAllCategories`

Odstraní všechny kategorie pásu karet z panelu pásu karet.

void RemoveAllCategories();

Poznámky

Tato metoda odstraní všechny kategorie pásu karet z paměti a ze seznamu kategorií.

`CMFCRibbonBar::RemoveAllFromTabs`

Odebere všechny prvky pásu karet z oblasti karty.

void RemoveAllFromTabs();

Poznámky

Tuto funkci použijte, pokud chcete odebrat všechny prvky, které jste přidali do oblasti karty pomocí CMFCRibbonBar::AddToTabs metody.

`CMFCRibbonBar::RemoveCategory`

Odstraní zadanou kategorii pásu karet z panelu pásu karet.

BOOL RemoveCategory(int nIndex);

Parametry

nIndex
[v] Index kategorie založený na nule v seznamu kategorií pásu karet, které jsou obsaženy na panelu pásu karet.

Návratová hodnota

TRUE pokud byla zadaná kategorie pásu karet odstraněna; jinak FALSE.

Poznámky

Zadaná kategorie pásu karet se odstraní z paměti a ze seznamu kategorií.

`CMFCRibbonBar::SetActiveCategory`

Nastaví zadanou kategorii pásu karet jako aktivní kategorii.

BOOL SetActiveCategory(
    CMFCRibbonCategory* pCategory,
    BOOL bForceRestore= FALSE);

Parametry

pCategory
[v] Kategorie pásu karet, která je obsažena na panelu pásu karet.

bForceRestore
[v] TRUE k maximalizaci panelu pásu karet, pokud je minimalizovaný; FALSE zobrazení aktivní kategorie v automaticky otevíraném okně, pokud je panel pásu karet minimalizovaný.

Návratová hodnota

TRUE pokud byla zadaná kategorie nastavena jako aktivní kategorie; jinak FALSE.

Poznámky

Hlavní kategorie pásu karet nemůže být aktivní kategorií.

Pokud se kategorie zadaná uživatelem pCategory nezobrazí, nedá se nastavit jako aktivní kategorie.

`CMFCRibbonBar::SetActiveMDIChild`

Přidruží systémová tlačítka na panelu karet, která patří do podřízeného okna rozhraní MDI (multiple-document interface) k zadanému podřízenému okně MDI.

void SetActiveMDIChild(CWnd* pWnd);

Parametry

pWnd
[v] Ukazatel na podřízené okno MDI

Poznámky

`CMFCRibbonBar::SetApplicationButton`

Přiřadí tlačítko pásu karet aplikace na panelu karet.

void SetApplicationButton(
    CMFCRibbonApplicationButton* pButton,
    CSize sizeButton);

Parametry

pButton
[v] Ukazatel na tlačítko pásu karet aplikace

sizeButton
[v] Velikost tlačítka pásu karet aplikace

Poznámky

Tlačítko pásu karet aplikace je velké zaoblené tlačítko umístěné v levém horním rohu ovládacího prvku Pás karet.

Příklad

Následující příklad ukazuje, jak použít metodu SetApplicationButton CMFCRibbonBar ve třídě.

// Init main button:
// CMFCRibbonApplicationButton m_MainButton
m_MainButton.SetImage(IDB_MAIN);
m_MainButton.SetText(_T("\nf"));
m_MainButton.SetToolTipText(strTemp);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetApplicationButton(&m_MainButton, CSize(45, 45));

`CMFCRibbonBar::SetElementKeys`

Nastaví klávesové zkratky pro všechny prvky pásu karet, které mají zadané ID příkazu.

BOOL SetElementKeys(
    UINT uiCmdID,
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys= NULL);

Parametry

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

lpszKeys
[v] Popis tlačítka.

lpszMenuKeys
[v] Popis nabídky.

Návratová hodnota

TRUE pokud jsou nastaveny klávesové zkratky alespoň jednoho prvku pásu karet; jinak FALSE.

Poznámky

Volitelný popis nabídky je pro prvky pásu karet s tlačítkem rozdělení, které otevře místní nabídku.

`CMFCRibbonBar::SetKeyboardNavigationLevel`

Nastaví úroveň navigace pomocí klávesnice tak, jak uživatel stiskne klávesové zkratky obsažené na pásu karet.

void SetKeyboardNavigationLevel(
    CObject* pLevel,
    BOOL bSetFocus = TRUE);

Parametry

pLevel
[v] Ukazatel na aktuální navigační objekt klávesnice

bSetFocus
[v] TRUE pro nastavení fokusu klávesnice na pásu karet.

Poznámky

Navigace pomocí klávesnice na pásu karet se spustí, když uživatel stiskne klávesu ALT nebo F10 . Uživatel vybere další navigační úroveň stisknutím klávesové zkratky na panelu karet. Uživatel se může vrátit na předchozí navigační úroveň stisknutím řídicí klávesy.

`CMFCRibbonBar::SetMaximizeMode`

Upraví panel pásu karet, když velikost okna podřízeného okna s více dokumenty (MDI) zadá nebo opustí maximalizované stav.

void SetMaximizeMode(
    BOOL bMax,
    CWnd* pWnd = NULL);

Parametry

bMax
[v] TRUE k zobrazení systémových tlačítek pro podřízené okno MDI na pásu karet; FALSE pokud chcete ze panelu pásu karet odebrat systémová tlačítka podřízeného okna MDI.

pWnd
[v] Ukazatel na okno hlavního rámečku pro panel pásu karet

Poznámky

Panel pásu karet zobrazuje systémová tlačítka podřízeného okna MDI na řádku karet, když je maximalizované podřízené okno MDI.

`CMFCRibbonBar::SetQuickAccessCommands`

Přidá jeden nebo více prvků pásu karet na panel nástrojů Rychlý přístup.

void SetQuickAccessCommands(
    const CList<UINT,UINT>& lstCommands,
    BOOL bRecalcLayout=TRUE);

Parametry

lstCommands
[v] Seznam příkazů, které se mají umístit na panel nástrojů Rychlý přístup

bRecalcLayout
[v] TRUE pokud chcete překreslit pás karet po přidání prvků pásu karet; FALSE jinak.

Příklad

Následující příklad ukazuje, jak použít metodu SetQuickAccessCommands CMFCRibbonBar ve třídě.

// Add quick access commands to the toolbar
CList<UINT, UINT> lstQATCmds;

lstQATCmds.AddTail(ID_FILE_NEW);
lstQATCmds.AddTail(ID_FILE_OPEN);
lstQATCmds.AddTail(ID_FILE_SAVE);
lstQATCmds.AddTail(ID_FILE_PRINT_DIRECT);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessCommands(lstQATCmds);

`CMFCRibbonBar::SetQuickAccessDefaultState`

Nastaví panel nástrojů Rychlý přístup na výchozí stav.

void SetQuickAccessDefaultState(const CMFCRibbonQuickAccessToolBarDefaultState& state);

Parametry

state
[v] Výchozí stav panelu nástrojů Rychlý přístup

Poznámky

Stav panelu nástrojů Rychlý přístup obsahuje seznam příkazů a jejich viditelnost.

Příklad

Následující příklad ukazuje, jak použít metodu SetQuickAccessDefaultState CMFCRibbonBar ve třídě.

CMFCRibbonQuickAccessToolBarDefaultState *qaToolBarState =
    new CMFCRibbonQuickAccessToolBarDefaultState();
qaToolBarState->AddCommand(ID_FILE_NEW, true);
qaToolBarState->AddCommand(ID_FILE_OPEN, true);
// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessDefaultState(*qaToolBarState);

`CMFCRibbonBar::SetQuickAccessToolbarOnTop`

Umístí panel nástrojů Rychlý přístup nad panel karet nebo pod panel karet.

void SetQuickAccessToolbarOnTop(BOOL bOnTop);

Parametry

bOnTop
[v] TRUE umístění panelu nástrojů Rychlý přístup nad panelem pásu karet; FALSE a umístěte panel nástrojů Rychlý přístup pod panelem pásu karet.

`CMFCRibbonBar::SetTooltipFixedWidth`

Nastaví běžnou a velkou velikost popisků s pevnou šířkou pruhu pásu karet.

void SetTooltipFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parametry

nWidthRegular
[v] Šířka v pixelech běžného popisku s pevnou velikostí.

nWidthLargeImage
[v] Šířka v pixelech velkého popisku s pevnou velikostí

Poznámky

Nastavení parametru na 0 způsobí, že se odpovídající šířka bude lišit.

`CMFCRibbonBar::ShowCategory`

Zobrazí nebo skryje zadanou kategorii pásu karet.

void ShowCategory(
    int nIndex,
    BOOL bShow=TRUE);

Parametry

nIndex
[v] Index kategorie pásu karet.

bShow
[v] Pokud TRUE, zobrazit kategorii pásu karet; jinak skrýt kategorii pásu karet.

`CMFCRibbonBar::ShowContextCategories`

Zobrazí nebo skryje kontextové kategorie, které mají zadané ID.

void ShowContextCategories(
    UINT uiContextID,
    BOOL bShow=TRUE);

Parametry

uiContextID
[v] ID kontextové kategorie.

bShow
[v] Pokud TRUEzobrazíte kategorie, které mají zadané ID, jinak skryjte kategorie, které mají zadané ID.

`CMFCRibbonBar::ShowKeyTips`

Zobrazuje klávesové zkratky pro jednotlivé prvky pásu karet na panelu karet.

void ShowKeyTips();

Poznámky

`CMFCRibbonBar::ToggleMimimizeState`

Přepíná panel pásu karet mezi minimalizované a maximalizované stavy.

void ToggleMimimizeState();

Poznámky

Chybně napsané v názvu metody je známý problém.

V minimalizovaném stavu je ovládací prvek pásu karet skrytý a zobrazí se jenom karty. Když uživatel klikne na kartu, ovládací prvek pásu karet se zobrazí jako automaticky otevírané okno. Okno se zavře, když uživatel klikne nebo spustí příkaz.

`CMFCRibbonBar::TranslateChar`

Určuje, zda je zadaný kód znaku stisknutí kláves zpracován panelem pásu karet.

virtual BOOL TranslateChar(UINT nChar);

Parametry

nChar
[v] Kód znaku stisknutí klávesy uživatele.

Návratová hodnota

TRUE pokud byl kód znaku zpracován panelem pásu karet; jinak FALSE.

Poznámky

Funkce popisů kláves umožňuje uživatelům přecházet na pásu karet pomocí klávesnice.

`CMFCRibbonBar::GetFocused`

Vrátí prioritní prvek.

virtual CMFCRibbonBaseElement* GetFocused();

Návratová hodnota

Ukazatel na prioritní prvek nebo NULL.

Poznámky

`CMFCRibbonBar::IsWindows7Look`

Označuje, jestli má pás karet vzhled Windows 7 (malé obdélníkové tlačítko aplikace).

BOOL IsWindows7Look() const;

Návratová hodnota

TRUE pokud má pás karet vzhled Windows 7; jinak FALSE.

Poznámky

`CMFCRibbonBar::LoadFromResource`

Přetíženo. Načte pás karet z prostředků aplikace.

virtual BOOL LoadFromResource(
    UINT uiXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

virtual BOOL LoadFromResource(
    LPCTSTR lpszXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

Parametry

uiXMLResID
Určuje ID prostředku řetězce XML s informacemi na pásu karet.

lpszResType
Určuje typ prostředku umístěného v uiXMLResIDumístění .

hInstance
Popisovač modulu, jehož spustitelný soubor obsahuje prostředek. Pokud hInstance ano NULL, systém načte prostředek z modulu, který se použil k vytvoření aktuálního procesu.

lpszXMLResID
Určuje ID prostředku (ve formuláři řetězce) s informacemi na pásu karet.

Návratová hodnota

TRUE pokud je zatížení úspěšné; jinak FALSE.

Poznámky

`CMFCRibbonBar::SaveToXMLBuffer`

Uloží panel pásu karet do vyrovnávací paměti.

UINT SaveToXMLBuffer(LPBYTE* ppBuffer) const;

Parametry

ppBuffer
Pokud tato funkce vrátí, ppBuffer odkazuje na vyrovnávací paměť přidělenou touto metodou a obsahuje informace pásu karet ve formátu XML.

Návratová hodnota

TRUE v případě úspěchu; jinak FALSE.

Poznámky

`CMFCRibbonBar::SaveToXMLFile`

Uloží panel karet do souboru XML.

BOOL SaveToXMLFile(LPCTSTR lpszFilePath) const;

Parametry

lpszFilePath
Určuje výstupní soubor.

Návratová hodnota

TRUE v případě úspěchu; jinak FALSE.

Poznámky

`CMFCRibbonBar::SetWindows7Look`

Povolí nebo zakáže vzhled Systému Windows 7 (malé obdélníkové tlačítko aplikace) na pásu karet.

void SetWindows7Look(
    BOOL bWindows7Look,
    BOOL bRecalc = TRUE);

Parametry

bWindows7Look
TRUE nastaví vzhled Systému Windows 7; FALSE jinak.

bRecalc
TRUE přepočítá rozložení pásu karet; FALSE jinak.

Poznámky

Viz také

Graf hierarchie
Třídy
CPane Třída
CMFCRibbonCategory Třída
CMFCRibbonPanel Třída
CMFCRibbonBaseElement Třída
Návod: Aktualizace aplikace MFC Scribble

Sdílet prostřednictvím

CMFCRibbonBar Třída

Syntaxe

Členové

Veřejné konstruktory

Veřejné metody

Poznámky

Hierarchie dědičnosti

Požadavky

CMFCRibbonBar::ActivateContextCategory

Parametry

Návratová hodnota

CMFCRibbonBar::AddCategory

Parametry

Návratová hodnota

Poznámky

Příklad

CMFCRibbonBar::AddContextCategory

Parametry

Návratová hodnota

Poznámky

CMFCRibbonBar::AddMainCategory

Parametry

Návratová hodnota

Poznámky

Příklad

CMFCRibbonBar::AddPrintPreviewCategory

Návratová hodnota

Poznámky

CMFCRibbonBar::AddQATOnlyCategory

Parametry

Návratová hodnota

Poznámky

CMFCRibbonBar::AddToTabs

Parametry

Poznámky

CMFCRibbonBar::CMFCRibbonBar

Parametry

Poznámky

CMFCRibbonBar::Create

Parametry

Návratová hodnota

Poznámky

Příklad

CMFCRibbonBar::CreateEx

Parametry

Návratová hodnota

Poznámky

CMFCRibbonBar::DeactivateKeyboardFocus

Parametry

Poznámky

CMFCRibbonBar::DrawMenuImage

Parametry

Návratová hodnota

Poznámky

CMFCRibbonBar::DWMCompositionChanged

Poznámky

CMFCRibbonBar::EnableKeyTips

Parametry

Poznámky

CMFCRibbonBar::EnablePrintPreview

Parametry

Poznámky

CMFCRibbonBar::EnableToolTips

Parametry

Poznámky

CMFCRibbonBar::FindByData

Parametry

Návratová hodnota

Poznámky

CMFCRibbonBar::FindByID

Parametry

Návratová hodnota

Poznámky

CMFCRibbonBar::FindCategoryIndexByData

Parametry

Návratová hodnota

CMFCRibbonBar::ForceRecalcLayout

Poznámky

CMFCRibbonBar::GetActiveCategory

`CMFCRibbonBar` Třída

`CMFCRibbonBar::ActivateContextCategory`

`CMFCRibbonBar::AddCategory`

`CMFCRibbonBar::AddContextCategory`

`CMFCRibbonBar::AddMainCategory`

`CMFCRibbonBar::AddPrintPreviewCategory`

`CMFCRibbonBar::AddQATOnlyCategory`

`CMFCRibbonBar::AddToTabs`

`CMFCRibbonBar::CMFCRibbonBar`

`CMFCRibbonBar::Create`

`CMFCRibbonBar::CreateEx`

`CMFCRibbonBar::DeactivateKeyboardFocus`

`CMFCRibbonBar::DrawMenuImage`

`CMFCRibbonBar::DWMCompositionChanged`

`CMFCRibbonBar::EnableKeyTips`

`CMFCRibbonBar::EnablePrintPreview`

`CMFCRibbonBar::EnableToolTips`

`CMFCRibbonBar::FindByData`

`CMFCRibbonBar::FindByID`

`CMFCRibbonBar::FindCategoryIndexByData`

`CMFCRibbonBar::ForceRecalcLayout`

`CMFCRibbonBar::GetActiveCategory`

`CMFCRibbonBar::GetApplicationButton`

`CMFCRibbonBar::GetCaptionHeight`

`CMFCRibbonBar::GetCategory`

`CMFCRibbonBar::GetCategoryCount`

`CMFCRibbonBar::GetCategoryHeight`

`CMFCRibbonBar::GetCategoryIndex`

`CMFCRibbonBar::GetContextName`

`CMFCRibbonBar::GetDroppedDown`

`CMFCRibbonBar::GetElementsByID`

`CMFCRibbonBar::GetHideFlags`

`CMFCRibbonBar::GetItemIDsList`

`CMFCRibbonBar::GetKeyboardNavigationLevel`

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

`CMFCRibbonBar::GetKeyboardNavLevelParent`

`CMFCRibbonBar::GetMainCategory`

`CMFCRibbonBar::GetQATCommandsLocation`

`CMFCRibbonBar::GetQATDroppedDown`

`CMFCRibbonBar::GetQuickAccessCommands`

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

`CMFCRibbonBar::GetTabTrancateRatio`

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

`CMFCRibbonBar::GetVisibleCategoryCount`