CMFCRibbonCategory – třída
Třída CMFCRibbonCategory implementuje kartu pásu karet, která obsahuje skupinu panelů pásu karet.
Syntaxe
class CMFCRibbonCategory : public CObject
Členové
Chráněné konstruktory
| Název | Popis |
|---|---|
| CMFCRibbonCategory::CMFCRibbonCategory | Konstruktor |
Veřejné metody
Poznámky
Kategorii pásu karet obvykle vytvoříte nepřímo voláním CMFCRibbonBar::AddCategory, který vrátí ukazatel na nově vytvořenou kategorii pásu karet. Panely do kategorie přidáte voláním CMFCRibbonCategory::AddPanel.
Třída CMFCRibbonTab nakreslí kategorie pásu karet. Je odvozen z CMFCRibbonBaseElement Třída.
Následující příklad ukazuje, jak vytvořit kategorii pásu karet a přidat do ní panel.
// Create a new ribbon category and get a pointer to it`
CMFCRibbonCategory* pCategory = m_wndRibbonBar.AddCategory
(_T("&Write"), // Category name
IDB_WRITE, // Category small images (16 x 16)
IDB_WRITE_LARGE); // Category large images (32 x 32)
// Add a panel to the new category
CMFCRibbonPanel* pPanel = pCategory->AddPanel (
_T("Clipboard"), // Panel name
m_PanelIcons.ExtractIcon (0)); // Panel icon
Následující diagram znázorňuje obrázek kategorie Domů z ukázkové aplikace RibbonApp.
Hierarchie dědičnosti
CMFCRibbonCategory
Požadavky
Záhlaví: afxribboncategory.h
CMFCRibbonCategory::AddHidden
Přidá zadaný prvek pásu karet do pole prvků pásu karet, které jsou zobrazeny v dialogovém okně přizpůsobení.
void AddHidden(CMFCRibbonBaseElement* pElem);
Parametry
pElem
[v] Ukazatel na prvek pásu karet
Poznámky
Prvky pásu karet v dialogovém okně přizpůsobení jsou příkazy, které můžete přidat na panel nástrojů Rychlý přístup.
CMFCRibbonCategory::AddPanel
Vytvoří panel pásu karet pro kategorii pásu karet.
CMFCRibbonPanel* AddPanel(
LPCTSTR lpszPanelName,
HICON hIcon = 0,
CRuntimeClass* pRTI = NULL);
Parametry
lpszPanelName
[v] Ukazatel na název nového panelu pásu karet
hIcon
[v] Úchyt pro výchozí ikonu nového panelu pásu karet
pRTI
[v] Ukazatel na informace o třídě modulu runtime pro vlastní panel pásu karet
Návratová hodnota
Ukazatel na nový panel pásu karet, pokud byla metoda úspěšná; v opačném případě null, pokud panel nebyl vytvořen.
Poznámky
Pokud chcete vytvořit vlastní panel pásu karet, je nutné zadat informace o třídě modulu runtime v nástroji pRTI. Vlastní třída panelu CMFCRibbonPanel pásu karet musí být odvozena z třídy.
Pokud není dostatek místa k zobrazení prvků pásu karet, zobrazí se výchozí ikona panelu pásu karet.
Příklad
Následující příklad ukazuje, jak použít metodu AddPanel CMFCRibbonCategory ve třídě.
// Create "Favorites" panel:
strTemp.LoadString(IDS_RIBBON_FAVORITES);
// CMFCRibbonCategory* pCategoryCustom
CMFCRibbonPanel *pPanelFavorites = pCategoryCustom->AddPanel(strTemp,
m_PanelImages.ExtractIcon(15));
CMFCRibbonCategory::CMFCRibbonCategory
Vytvoří a inicializuje CMFCRibbonCategory objektu.
CMFCRibbonCategory(
CMFCRibbonBar* pParenrRibbonBar,
LPCTSTR lpszName,
UINT uiSmallImagesResID,
UINT uiLargeImagesResID,
CSize sizeSmallImage = CSize(16,
16),
CSize sizeLargeImage = CSize(32,
32));
Parametry
pParenrRibbonBar
[v] Ukazatel na nadřazený panel pásu karet v kategorii pásu karet
lpszName
[v] Název kategorie pásu karet
uiSmallImagesResID
[v] ID prostředku seznamu obrázků pro malé obrázky, které jsou používány prvky pásu karet v kategorii pásu karet.
uiLargeImagesResID
[v] ID prostředku seznamu obrázků pro velké obrázky, které jsou používány prvky pásu karet v kategorii pásu karet.
sizeSmallImage
[v] Výchozí velikost malých obrázků pro prvky pásu karet v kategorii pásu karet
sizeLargeImage
[v] Výchozí velikost velkých obrázků pro prvky pásu karet v kategorii pásu karet
CMFCRibbonCategory::CopyFrom
Zkopíruje stav zadané CMFCRibbonCategory do aktuálníHO CMFCRibbonCategory objektu.
virtual void CopyFrom(CMFCRibbonCategory& src);
Parametry
Src
[v] Zdrojový CMFCRibbonCategory objekt.
Poznámky
CMFCRibbonCategory::FindByData
Načte prvek pásu karet přidružený k zadaným datům.
CMFCRibbonBaseElement* FindByData(
DWORD_PTR dwData,
BOOL bVisibleOnly = TRUE) const;
Parametry
dwData
[v] Data přidružená k prvku pásu karet.
bVisibleOnly
[v] PRAVDA pro zahrnutí prvků pásu karet rychlý přístup do hledání; NEPRAVDA pro vyloučení prvků pásu karet s rychlým přístupem ve vyhledávání
Návratová hodnota
Ukazatel na prvek pásu karet, pokud byla metoda úspěšná; jinak NULL.
Poznámky
CMFCRibbonCategory::FindByID
Načte prvek pásu karet přidružený k zadanému ID příkazu.
CMFCRibbonBaseElement* FindByID(
UINT uiCmdID,
BOOL bVisibleOnly = TRUE) const;
Parametry
uiCmdID
[v] ID příkazu přidružené k prvku pásu karet
bVisibleOnly
[v] PRAVDA pro zahrnutí prvků pásu karet rychlý přístup do hledání; NEPRAVDA pro vyloučení prvků pásu karet s rychlým přístupem ve vyhledávání
Návratová hodnota
Ukazatel na prvek pásu karet, pokud byla metoda úspěšná; jinak NULL.
Poznámky
CMFCRibbonCategory::FindPanelWithElem
Načte panel pásu karet, který obsahuje zadaný prvek pásu karet.
CMFCRibbonPanel* FindPanelWithElem(const CMFCRibbonBaseElement* pElement);
Parametry
pElement
[v] Ukazatel na prvek pásu karet
Návratová hodnota
Ukazatel na panel pásu karet, pokud byla metoda úspěšná; jinak NULL.
Poznámky
CMFCRibbonCategory::GetContextID
Načte ID kontextu kategorie pásu karet.
UINT GetContextID() const;
Návratová hodnota
Id kontextu kategorie pásu karet
Poznámky
ID kontextu je 0, pokud kategorie pásu karet není kontextovou kategorií pásu karet.
CMFCRibbonCategory::GetData
Načte uživatelem definovaná data přidružená k kategorii pásu karet.
DWORD_PTR GetData() const;
Návratová hodnota
Uživatelsky definovaná data přidružená k kategorii pásu karet.
CMFCRibbonCategory::GetDroppedDown
Načte ukazatel na prvek pásu karet, který má aktuálně zobrazenou místní nabídku.
CMFCRibbonBaseElement* GetDroppedDown();
Návratová hodnota
Ukazatel na prvek pásu karet, pokud byla metoda úspěšná; jinak NULL.
Poznámky
CMFCRibbonCategory::GetElements
Načte všechny prvky pásu karet v kategorii pásu karet.
void GetElements(
CArray <CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parametry
ArElements
[in, out] Odkaz na CArray prvků pásu karet.
Poznámky
Prvky pásu karet, které jsou navržené pro použití na panelu nástrojů Rychlý přístup, jsou součástí pole.
CMFCRibbonCategory::GetElementsByID
Načte všechny prvky pásu karet přidružené k zadanému ID příkazu.
void GetElementsByID(
UINT uiCmdID,
CArray <CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parametry
uiCmdID
[v] ID příkazu přidružené k prvku pásu karet
ArElements
[in, out] Odkaz na CArray prvků pásu karet.
Poznámky
Prvky pásu karet, které jsou navržené pro použití na panelu nástrojů Rychlý přístup, jsou součástí pole.
CMFCRibbonCategory::GetFirstVisibleElement
Načte první viditelný prvek, který patří do kategorie pásu karet.
CMFCRibbonBaseElement* GetFirstVisibleElement() const;
Návratová hodnota
Ukazatel na první viditelný prvek; může mít hodnotu NULL, pokud kategorie neobsahuje žádné viditelné prvky.
Poznámky
CMFCRibbonCategory::GetFocused
Vrátí prioritní prvek.
CMFCRibbonBaseElement* GetFocused();
Návratová hodnota
Ukazatel na prioritní prvek nebo hodnotu NULL.
Poznámky
CMFCRibbonCategory::GetHighlighted
Vrátí zvýrazněný prvek.
CMFCRibbonBaseElement* GetHighlighted();
Návratová hodnota
Ukazatel na zvýrazněný prvek nebo hodnotu NULL, pokud nejsou zvýrazněny žádné prvky.
Poznámky
CMFCRibbonCategory::GetImageCount
Načte počet obrázků v zadaném seznamu obrázků, který je obsažen v kategorii pásu karet.
int GetImageCount(BOOL bIsLargeImage) const;
Parametry
bIsLargeImage
[v] TRUE pro počet obrázků v seznamu velkých obrázků; NEPRAVDA pro počet obrázků v seznamu malých obrázků.
Návratová hodnota
Počet obrázků v zadaném seznamu obrázků
Poznámky
CMFCRibbonCategory::GetImageSize
Načte velikost obrázku v zadaném seznamu obrázků, který je obsažen v kategorii pásu karet.
CSize GetImageSize(BOOL bIsLargeImage) const;
Parametry
bIsLargeImage
[v] TRUE pro velikost velkých obrázků; NEPRAVDA pro velikost malých obrázků.
Návratová hodnota
Velikost obrázku v zadaném seznamu obrázků.
Poznámky
Načtená velikost zahrnuje faktor globálního měřítka image.
CMFCRibbonCategory::GetItemIDsList
Načte ID příkazů pro prvky pásu karet obsažené v kategorii pásu karet.
void GetItemIDsList(
CList<UINT, UINT>& lstItems,
BOOL bHiddenOnly = FALSE) const;
Parametry
lstItems
[ven] Seznam ID příkazů pro prvky pásu karet v kategorii pásu karet
bHiddenOnly
[v] PRAVDA pro vyloučení prvků pásu karet zobrazených na panelech pásu karet v kategorii pásu karet; NEPRAVDA pro zahrnutí všech prvků pásu karet do kategorie pásu karet.
Poznámky
CMFCRibbonCategory::GetLargeImages
Načte seznam velkých obrázků obsažených v kategorii pásu karet.
CMFCToolBarImages& GetLargeImages();
Návratová hodnota
Seznam velkých obrázků obsažených v kategorii pásu karet
CMFCRibbonCategory::GetLastVisibleElement
Načte poslední viditelný prvek, který patří do kategorie pásu karet.
CMFCRibbonBaseElement* GetLastVisibleElement() const;
Návratová hodnota
Ukazatel na poslední viditelný prvek; může mít hodnotu NULL, pokud kategorie neobsahuje žádné viditelné prvky.
Poznámky
CMFCRibbonCategory::GetMaxHeight
Načte maximální výšku panelů pásu karet obsažených v kategorii pásu karet.
int GetMaxHeight(CDC* pDC);
Parametry
pDC
[v] Ukazatel na kontext zařízení pro panely pásu karet
Návratová hodnota
Maximální výška panelů pásu karet, které jsou obsaženy v kategorii pásu karet.
Poznámky
Načtená hodnota zahrnuje výšku horního a dolního okraje pro panely pásu karet.
CMFCRibbonCategory::GetName
Načte název kategorie pásu karet.
LPCTSTR GetName() const;
Návratová hodnota
Název kategorie pásu karet
Poznámky
CMFCRibbonCategory::GetPanel
Vrátí ukazatel na panel pásu karet umístěný v zadaném indexu.
CMFCRibbonPanel* GetPanel(int nIndex);
Parametry
nIndex
[v] Index na pásu karet založený na nule.
Návratová hodnota
Ukazatel na panel pásu karet umístěný v zadaném indexu.
Poznámky
Výjimka je vyvolán, pokud nIndex je mimo rozsah.
CMFCRibbonCategory::GetPanelCount
Vrátí počet panelů pásu karet v kategorii pásu karet.
int GetPanelCount() const;
Návratová hodnota
Počet panelů pásu karet v kategorii pásu karet
CMFCRibbonCategory::GetPanelFromPoint
Načte ukazatel na panel pásu karet, pokud je v něm umístěný zadaný bod.
CMFCRibbonPanel* GetPanelFromPoint(CPoint point) const;
Parametry
bod
[v] Souřadnice x a y ukazatele vzhledem k levému hornímu rohu okna.
Návratová hodnota
Ukazatel na panel pásu karet, pokud byla metoda úspěšná; jinak NULL.
Poznámky
Testují se pouze panely pásu karet obsažené v kategorii pásu karet.
CMFCRibbonCategory::GetPanelIndex
Načte index založený na nule zadaného panelu pásu karet.
int GetPanelIndex(const CMFCRibbonPanel* pPanel) const;
Parametry
pPanel
[v] Ukazatel na panel pásu karet
Návratová hodnota
Nulový index zadaného panelu pásu karet, pokud byla metoda úspěšná; jinak -1.
Poznámky
Prohledávají se jenom panely pásu karet obsažené v kategorii pásu karet.
CMFCRibbonCategory::GetParentButton
Načte nadřazený prvek pásu karet kategorie pásu karet.
CMFCRibbonBaseElement* GetParentButton() const;
Návratová hodnota
Vrátí ukazatel na nadřazený prvek pásu karet nebo hodnotu NULL, pokud neexistuje nadřazený prvek.
Poznámky
CMFCRibbonCategory::GetParentMenuBar
Vrátí ukazatel na nadřazený řádek nabídek objektu CMFCRibbonCategory .
CMFCRibbonPanelMenuBar* GetParentMenuBar() const;
Návratová hodnota
Vrátí obsah chráněného člena m_pParentMenuBar .
Poznámky
CMFCRibbonCategory::GetParentRibbonBar
Načte nadřazený panel pásu karet pro kategorii pásu karet.
CMFCRibbonBar* GetParentRibbonBar() const;
Návratová hodnota
Ukazatel na nadřazený panel pásu karet pro kategorii pásu karet
Poznámky
CMFCRibbonCategory::GetRect
Načte obdélník zobrazení pro kategorii pásu karet.
CRect GetRect() const;
Návratová hodnota
Obdélník zobrazení pro kategorii pásu karet.
Poznámky
Obdélník zobrazení pro kategorii pásu karet neobsahuje kartu kategorie.
CMFCRibbonCategory::GetSmallImages
Načte seznam malých obrázků obsažených v kategorii pásu karet.
CMFCToolBarImages& GetSmallImages();
Návratová hodnota
Seznam malých obrázků obsažených v kategorii pásu karet
CMFCRibbonCategory::GetTabColor
Vrátí aktuální barvu karty kategorie pásu karet.
AFX_RibbonCategoryColor GetTabColor() const;
Návratová hodnota
Aktuální barva karty kategorie pásu karet
Poznámky
Vrácená hodnota může být jedna z následujících výčtových hodnot:
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet
CMFCRibbonCategory::GetTabRect
Načte obdélník zobrazení pro kartu kategorie pásu karet.
CRect GetTabRect() const;
Návratová hodnota
Obdélník zobrazení karty kategorie pásu karet
Poznámky
CMFCRibbonCategory::GetTextTopLine
Načte svislé umístění textu na tlačítkách pásu karet v kategorii pásu karet, která zobrazuje velké obrázky.
int GetTextTopLine() const;
Návratová hodnota
Svislé umístění textu v pixelech na tlačítkách pásu karet, která zobrazují velké obrázky.
Poznámky
CMFCRibbonCategory::GetVisibleElements
Načte všechny viditelné prvky, které patří do kategorie pásu karet.
void GetVisibleElements(
CArray <CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);
Parametry
ArElements
Pole všech viditelných prvků
Poznámky
CMFCRibbonCategory::HighlightPanel
Zvýrazní zadaný panel pásu karet.
CMFCRibbonPanel* HighlightPanel(
CMFCRibbonPanel* pHLPanel,
CPoint point);
Parametry
pHLPanel
[v] Ukazatel na panel pásu karet, který chcete zvýraznit.
bod
[v] Souřadnice x a y ukazatele vzhledem k levému hornímu rohu okna.
Návratová hodnota
Ukazatel na dříve zvýrazněný panel pásu karet; v opačném případě null pokud není zvýrazněn žádný panel pásu karet při vyvolání této metody.
Poznámky
Další informace o zvýraznění panelu pásu karet naleznete v tématu CMFCRibbonPanel::Zvýraznění.
CMFCRibbonCategory::HitTest
Načte ukazatel na prvek pásu karet, pokud je v něm umístěný zadaný bod.
CMFCRibbonBaseElement* HitTest(
CPoint point,
BOOL bCheckPanelCaption = FALSE) const;
Parametry
bod
[v] Souřadnice x a y ukazatele myši vzhledem k levému hornímu rohu okna.
bCheckPanelCaption
[v] TRUE pro otestování titulku panelu pásu karet; NEPRAVDA, pokud chcete vyloučit titulek panelu pásu karet.
Návratová hodnota
Ukazatel na prvek pásu karet, pokud byla metoda úspěšná; jinak NULL.
Poznámky
Testují se pouze prvky pásu karet obsažené v kategorii pásu karet.
CMFCRibbonCategory::HitTestEx
Načte index založený na nule prvku pásu karet, pokud je v něm umístěný zadaný bod.
int HitTestEx(CPoint point) const;
Parametry
bod
[v] Souřadnice x a y ukazatele myši vzhledem k levému hornímu rohu okna.
Návratová hodnota
Nulový index prvku pásu karet, pokud byla metoda úspěšná; jinak -1.
Poznámky
Testují se pouze prvky pásu karet obsažené v kategorii pásu karet.
CMFCRibbonCategory::HitTestScrollButtons
Pokud bod spadá do kategorie pásu karet vlevo nebo vpravo, vrátí ukazatel na toto tlačítko.
CMFCRibbonBaseElement* HitTestScrollButtons(CPoint point) const;
Parametry
bod
[v] Bod k otestování.
Návratová hodnota
Pokud bod spadá do ohraničujícího obdélníku levého nebo pravého posuvníku kategorie pásu karet, vrátí ukazatel na toto tlačítko nebo jinak vrátí hodnotu NULL.
Poznámky
CMFCRibbonCategory::IsActive
Určuje, jestli je kategorie pásu karet aktivní kategorií na panelu karet.
BOOL IsActive() const;
Návratová hodnota
TRUE, pokud je kategorie pásu karet aktivní kategorií; jinak NEPRAVDA.
Poznámky
Aktivní kategorie pásu karet zobrazuje její panely pásu karet.
CMFCRibbonCategory::IsVisible
Určuje, jestli je kategorie pásu karet viditelná.
BOOL IsVisible() const;
Návratová hodnota
TRUE, pokud je kategorie pásu karet viditelná; jinak NEPRAVDA.
Poznámky
Kategorie pásu karet, které jsou viditelné, zobrazují kartu kategorie.
CMFCRibbonCategory::IsWindows7Look
Určuje, jestli má nadřazený pás karet vzhled Windows 7 (malé obdélníkové tlačítko aplikace).
BOOL IsWindows7Look() const;
Návratová hodnota
TRUE, pokud nadřazený pás karet má Windows 7 vzhled; jinak NEPRAVDA.
Poznámky
CMFCRibbonCategory::NotifyControlCommand
Doručí zprávu příkazu WM_NOTIFY všem CMFCRibbonPanel prvkům CMFCRibbonCategory , dokud se zpráva nezpracuje.
virtual BOOL NotifyControlCommand(
BOOL bAccelerator,
int nNotifyCode,
WPARAM wParam,
LPARAM lParam);
Parametry
bAccelerator
[v] TRUE, pokud tento příkaz pochází z akcelerátoru nebo nepravda jinak.
nNotifyCode
[v] Kód oznámení.
wParam
[v] Pole WPARAM zprávy.
lParam
[v] Pole LPARAM zprávy.
Návratová hodnota
Vrátí hodnotu TRUE, pokud byla zpráva zpracována, nebo NEPRAVDA, pokud ne.
Poznámky
CMFCRibbonCategory::OnCancelMode
Vyvolá režim zrušení ve všech CMFCRibbonPanel prvcích .CMFCRibbonCategory
virtual void OnCancelMode();
Poznámky
CMFCRibbonCategory::OnDraw
Volá se rozhraním pro kreslení kategorie pásu karet.
virtual void OnDraw(CDC* pDC);
Parametry
pDC
[v] Ukazatel na kontext zařízení pro kategorii pásu karet
Poznámky
CMFCRibbonCategory::OnDrawImage
Volá se rozhraním pro vykreslení zadaného obrázku v kategorii pásu karet.
virtual BOOL OnDrawImage(
CDC* pDC,
CRect rect,
CMFCRibbonBaseElement* pElement,
BOOL bIsLargeImage,
BOOL nImageIndex,
BOOL bCenter);
Parametry
pDC
[v] Ukazatel na kontext zařízení pro obrázek.
Rect
[v] Zobrazí obdélník obrázku.
pElement
[v] Ukazatel na prvek pásu karet, který obsahuje obrázek.
bIsLargeImage
[v] TRUE, pokud je obrázek velká velikost; NEPRAVDA, pokud je obrázek malá velikost.
nImageIndex
[v] Index obrázku založený na nule v poli obrázků, který je obsažen v kategorii pásu karet.
bCenter
[v] PRAVDA pro zarovnání obrázku do obdélníku zobrazení; NEPRAVDA pro vykreslení obrázku v levém horním rohu obdélníku zobrazení.
Návratová hodnota
TRUE, pokud byla metoda úspěšná; jinak NEPRAVDA.
Poznámky
CMFCRibbonCategory::OnDrawMenuBorder
Volá se rozhraním pro vykreslení ohraničení místní nabídky.
virtual void OnDrawMenuBorder(
CDC* pDC,
CMFCRibbonPanelMenuBar* pMenuBar);
Parametry
pDC
[v] Tento parametr se nepoužívá.
pMenuBar
[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 nakreslit ohraničení místní nabídky.
CMFCRibbonCategory::OnKey
Volá se rozhraním, když uživatel stiskne tlačítko klávesnice.
virtual BOOL OnKey(UINT nChar);
Parametry
nChar
Kód virtuálního klíče pro klávesu, kterou uživatel stiskl.
Poznámky
CMFCRibbonCategory::OnLButtonDown
Volá se rozhraním pro načtení prvku pásu karet pod zadaným bodem, když uživatel stiskne levé tlačítko myši.
virtual CMFCRibbonBaseElement* OnLButtonDown(CPoint point);
Parametry
bod
[v] Souřadnice x a y ukazatele myši vzhledem k levému hornímu rohu okna.
Návratová hodnota
Ukazatel na prvek pásu karet, pokud byla metoda úspěšná; jinak NULL.
Poznámky
CMFCRibbonCategory::OnLButtonUp
Volá se rozhraním, když uživatel uvolní levé tlačítko myši a ukazatel je nad kategorií pásu karet.
virtual void OnLButtonUp(CPoint point);
Parametry
bod
[v] Souřadnice x a y ukazatele vzhledem k levému hornímu rohu okna.
Poznámky
CMFCRibbonCategory::OnMouseMove
Volá se rozhraním, když se ukazatel přesune na pásu karet, aby se aktualizovala kategorie pásu karet.
virtual void OnMouseMove(CPoint point);
Parametry
bod
[v] Souřadnice x a y ukazatele vzhledem k levému hornímu rohu okna.
Poznámky
CMFCRibbonCategory::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; NEPRAVDA, pokud je rozložení zleva doprava.
Poznámky
Tato metoda upraví rozložení všech panelů pásu karet a prvků pásu karet obsažených v kategorii pásu karet.
CMFCRibbonCategory::OnScrollHorz
Posune kategorii pásu karet vodorovně.
virtual BOOL OnScrollHorz(
BOOL bScrollLeft,
int nScrollOffset = 0);
Parametry
bScrollLeft
[v] TRUE se posune doleva; FALSE se posune doprava.
nScrollOffset
[v] Vzdálenost posouvání v pixelech.
Návratová hodnota
TRUE, pokud se kategorie pásu karet přesunula ve vodorovném směru; jinak NEPRAVDA.
Poznámky
CMFCRibbonCategory::OnUpdateCmdUI
OnUpdateCmdUI Volá členovou funkci v každém z CMFCRibbonPanel prvků objektuCMFCRibbonCategory, aby bylo možné povolit nebo zakázat prvky uživatelského rozhraní v nich.
virtual void OnUpdateCmdUI(
CMFCRibbonCmdUI* pCmdUI,
CFrameWnd* pTarget,
BOOL bDisableIfNoHndler);
Parametry
pCmdUI
[v] Ukazatel na CMFCRibbonCmdUI objekt, který určuje, které prvky uživatelského rozhraní mají být povoleny a které mají být zakázány.
pTarget
[v] Ukazatel na okno, které řídí povolení nebo zakázání prvků uživatelského rozhraní.
bDisableIfNoHndler
[v] TRUE zakázat položku uživatelského rozhraní, pokud není definována žádná obslužná rutina v mapě zpráv; jinak NEPRAVDA.
Poznámky
CMFCRibbonCategory::RecalcLayout
Upraví rozložení všech ovládacích prvků v kategorii pásu karet.
virtual void RecalcLayout(CDC* pDC);
Parametry
pDC
[v] Ukazatel na kontext zařízení pro kategorii pásu karet
Poznámky
CMFCRibbonCategory::RemovePanel
Odebere panel pásu karet z kategorie pásu karet.
BOOL RemovePanel(
int nIndex,
BOOL bDelete = TRUE);
Parametry
nIndex
[v] Číslo indexu panelu, který chcete odebrat. Získáno voláním CMFCRibbonCategory::GetPanelIndex metoda.
bDelete
[v] TRUE pro odstranění objektu panelu z paměti; NEPRAVDA pro odebrání objektu panelu bez odstranění.
Návratová hodnota
TRUE, pokud byla metoda úspěšná; jinak NEPRAVDA.
CMFCRibbonCategory::ReposPanels
Upraví rozložení všech ovládacích prvků na panelech pásu karet, které jsou obsaženy v kategorii pásu karet.
virtual void ReposPanels(CDC* pDC);
Parametry
pDC
[v] Ukazatel na kontext zařízení pro panely pásu karet, které jsou obsaženy v kategorii pásu karet.
Poznámky
CMFCRibbonCategory::SetCollapseOrder
Definuje pořadí, ve kterém se sbalí panely pásu karet kategorie pásu karet.
void SetCollapseOrder(const CArray<int,int>& arCollapseOrder);
Parametry
arCollapseOrder
[v] Určuje pořadí sbalení. Pole obsahuje indexy na pásu karet založené na nule.
Poznámky
Knihovna definuje pořadí sbalení. Toto chování však můžete přizpůsobit tak, že kategorii poskytnete seznam indexů, které určují pořadí sbalení.
Když kategorie zjistí, že musí sbalit panel pásu karet, vyhledá další prvek v zadaném seznamu. Pokud je seznam prázdný nebo jste nezadáli dostatek prvků, použije kategorie interní algoritmus.
Kategorie má například tři panely pásu karet a lze je několikrát sbalit, dokud nebudou všechny panely v plně sbaleném stavu. Můžete nastavit následující pořadí sbalení: 0, 0, 2, 2. V tomto případě kategorie sbalí panel 0 dvakrát, panel 2 dvakrát. Panel, který má index 1, zůstane nezachycený.
Příklad
Následující příklad ukazuje, jak použít metodu SetCollapseOrder CMFCRibbonCategory ve třídě. Příklad ukazuje, jak vytvořit pole pro sbalovací pořadí a jak nastavit pořadí sbalení na kategorii pásu karet.
CArray<int, int> arCollapseOrder;
arCollapseOrder.Add(0);
arCollapseOrder.Add(1);
arCollapseOrder.Add(2);
// CMFCRibbonCategory* pCategoryHome
pCategoryHome->SetCollapseOrder(arCollapseOrder);
CMFCRibbonCategory::SetData
Nastaví uživatelem definovaná data, která se mají přidružit k kategorii pásu karet.
void SetData(DWORD_PTR dwData);
Parametry
dwData
[v] Uživatelsky definovaná data.
CMFCRibbonCategory::SetKeys
Přiřadí k kategorii pásu karet popisek.
void SetKeys(LPCTSTR lpszKeys);
Parametry
lpszKeys
[v] Text s popisem klávesy
Poznámky
Klávesové zkratky se zobrazí, když uživatel stiskne klávesu Alt nebo klávesu F10.
CMFCRibbonCategory::SetName
Přiřadí název a popis k kategorii pásu karet.
void SetName(LPCTSTR lpszName);
Parametry
lpszName
[v] Název a popisek kategorie pásu karet
Poznámky
Pokud chcete nastavit popis pro kategorii pásu karet, připojte řídicí sekvenci nového řádku následovanou znaky s popisem klávesy na lpszName.
CMFCRibbonCategory::SetTabColor
Nastaví barvu kategorie pásu karet.
void SetTabColor(AFX_RibbonCategoryColor color);
Parametry
barva
[v] Určuje novou barvu kategorie pásu karet.
Poznámky
Barva 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