CMFCRibbonPanel – třída
Implementuje panel, který obsahuje sadu prvků pásu karet. Když je panel nakreslený, zobrazí co nejvíce prvků vzhledem k velikosti panelu.
Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.
Syntaxe
class CMFCRibbonPanel : public CObject
Členové
Chráněné konstruktory
| Název | Popis |
|---|---|
| CMFCRibbonPanel::CMFCRibbonPanel | Vytvoří a inicializuje CMFCRibbonPanel objekt. |
Veřejné metody
| Název | Popis |
|---|---|
| CMFCRibbonPanel::Přidat | Přidá na panel prvek pásu karet. |
| CMFCRibbonPanel::AddSeparator | Přidá oddělovač na panel pásu karet. |
| CMFCRibbonPanel::AddToolBar | Přidá panel nástrojů na panel pásu karet. |
| CMFCRibbonPanel::FindByData | |
| CMFCRibbonPanel::FindByID | Vrátí prvek identifikovaný zadaným ID příkazu. |
| CMFCRibbonPanel::GetCaptionHeight | |
| CMFCRibbonPanel::GetCount | Vrátí počet prvků na panelu pásu karet. |
| CMFCRibbonPanel::GetData | Vrátí uživatelem definovaná data přidružená k panelu. |
| CMFCRibbonPanel::GetDefaultButton | |
| CMFCRibbonPanel::GetDroppedDown | |
| CMFCRibbonPanel::GetElement | Vrátí prvek pásu karet umístěný v zadaném indexu. |
| CMFCRibbonPanel::GetElements | Načte všechny prvky obsažené v panelu pásu karet. |
| CMFCRibbonPanel::GetElementsByID | |
| CMFCRibbonPanel::GetFocused | Vrátí prioritní prvek. |
| CMFCRibbonPanel::GetGalleryRect | Vrátí ohraničující obdélník prvku Galerie. |
| CMFCRibbonPanel::GetHighlighted | |
| CMFCRibbonPanel::GetIndex | |
| CMFCRibbonPanel::GetItemIDsList | |
| CMFCRibbonPanel::GetName | |
| CMFCRibbonPanel::GetParentButton | |
| CMFCRibbonPanel::GetParentCategory | Vrátí nadřazenou kategorii panelu pásu karet. |
| CMFCRibbonPanel::GetParentMenuBar | |
| CMFCRibbonPanel::GetPreferedMenuLocation | |
| CMFCRibbonPanel::GetPressed | |
| CMFCRibbonPanel::GetRect | |
| CMFCRibbonPanel::GetVisibleElements | Získá pole viditelných prvků. |
| CMFCRibbonPanel::HasElement | |
| CMFCRibbonPanel::HitTest | |
| CMFCRibbonPanel::HitTestEx | |
| CMFCRibbonPanel::Insert | Vloží prvek pásu karet na danou pozici. |
| CMFCRibbonPanel::InsertSeparator | Vloží oddělovač na danou pozici. |
| CMFCRibbonPanel::IsCenterColumnVert | Určuje, zda mají být všechny prvky panelu svisle zarovnány na střed (zarovnané) po sloupci. |
| CMFCRibbonPanel::IsCollapsed | |
| CMFCRibbonPanel::IsHighlighted | |
| CMFCRibbonPanel::IsJustifyColumns | Určuje, jestli mají všechny sloupce panelu stejnou šířku. |
| CMFCRibbonPanel::IsMainPanel | |
| CMFCRibbonPanel::IsMenuMode | |
| CMFCRibbonPanel::MakeGalleryItemVisible | Posune galerii, aby byl zadaný prvek pásu karet viditelný. |
| CMFCRibbonPanel::OnKey | |
| CMFCRibbonPanel::PřepočítatWidths | |
| CMFCRibbonPanel::Remove | Odebere a volitelně odstraní prvek umístěný v zadaném indexu. |
| CMFCRibbonPanel::RemoveAll | Odebere všechny prvky z panelu pásu karet. |
| CMFCRibbonPanel::Replace | Nahradí jeden prvek jiným na základě příslušných hodnot indexu. |
| CMFCRibbonPanel::ReplaceByID | Nahradí jeden prvek jiným na základě zadaného ID příkazu. |
| CMFCRibbonPanel::SetCenterColumnVert | Objedná panel tak, aby zarovná prvky svisle podle sloupce. |
| CMFCRibbonPanel::SetData | Přidruží uživatelsky definovaná data k panelu pásu karet. |
| CMFCRibbonPanel::SetElementMenu | Přiřadí místní nabídku elementu, který má dané ID příkazu. |
| CMFCRibbonPanel::SetElementRTC | Přidá na panel pásu karet prvek určený informacemi o poskytnuté třídě modulu runtime. |
| CMFCRibbonPanel::SetElementRTCByID | Přidá na panel pásu karet prvek určený informacemi o poskytnuté třídě modulu runtime. |
| CMFCRibbonPanel::SetFocused | Nastaví fokus na zadaný prvek pásu karet. |
| CMFCRibbonPanel::SetJustifyColumns | Povolí nebo zakáže odůvodnění sloupce. |
| CMFCRibbonPanel::SetKeys | Nastaví klávesovou zkratku, která zobrazuje panel pásu karet. |
| CMFCRibbonPanel::ShowPopup |
Poznámky
Panely pásu karet jsou logické seskupení souvisejících úkolů, které vytvoříte v kategoriích pásu karet. Při změně velikosti pásu karet se rozložení panelu automaticky upraví tak, aby se zobrazilo co nejvíce prvků.
Panely pásu karet, které jsou obsaženy v kategorii pásu karet voláním CMFCRibbonCategory::GetPanel metoda.
Příklad
Následující příklad ukazuje, jak nakonfigurovat CMFCRibbonPanel objekt pomocí různých metod ve CMFCRibbonPanel třídě. Příklad ukazuje, jak nastavit klávesovou zkratku, která zobrazuje panel pásu karet, zarovnat prvky na panelu svisle podle sloupce a povolit odůvodnění sloupce. Tento fragment kódu je součástí ukázky MS Office 2007 Demo.
// CMFCRibbonCategory* pCategory
// CMFCToolBarImages m_PanelImages
CMFCRibbonPanel *pPanelClipboard = pCategory->AddPanel(_T("Clipboard"), m_PanelImages.ExtractIcon(1));
pPanelClipboard->SetKeys(_T("zc"));
pPanelClipboard->SetCenterColumnVert();
pPanelClipboard->SetJustifyColumns();
Hierarchie dědičnosti
Požadavky
Hlavička: afxRibbonPanel.h
CMFCRibbonPanel::Přidat
Připojí zadaný prvek pásu karet k poli prvků pásu karet, které jsou obsaženy na panelu pásu karet.
virtual void Add(CMFCRibbonBaseElement* pElem);
Parametry
pElem
[in, out] Ukazatel na prvek pásu karet
Poznámky
CMFCRibbonPanel::AddSeparator
Přidá oddělovač na panel pásu karet.
virtual void AddSeparator();
Poznámky
Voláním této metody přidáte oddělovač na panel pásu karet. Oddělovač se přidá vedle prvku pásu karet, který byl přidán předchozím voláním CMFCRibbonPanel::Add. Chcete-li vložit oddělovač na danou pozici, zavolejte CMFCRibbonPanel::InsertSeparator.
CMFCRibbonPanel::AddToolBar
Přidá panel nástrojů na panel pásu karet.
CMFCRibbonButtonsGroup* AddToolBar(
UINT uiToolbarResID,
UINT uiColdResID = 0,
UINT uiHotResID = 0,
UINT uiDisabledResID = 0);
Parametry
uiToolbarResID
[v] Určuje ID prostředku panelu nástrojů, který chcete přidat.
uiColdResID
[v] Určuje ID prostředku studených obrázků panelu nástrojů.
uiHotResID
[v] Určuje ID prostředku horkých obrázků panelu nástrojů.
uiDisabledResID
[v] Určuje ID prostředku zakázaných obrázků panelu nástrojů.
Návratová hodnota
Voláním této metody přidáte panel nástrojů na panel pásu karet. Panel nástrojů se přidá vedle prvku pásu karet přidaného předchozím voláním CMFCRibbonPanel::Add.
Poznámky
Další informace o panelech nástrojů, horkých obrázcích, studených obrázcích a zakázaných obrázcích naleznete v tématu CMFCToolBar – třída.
CMFCRibbonPanel::CMFCRibbonPanel
Vytvoří a inicializuje CMFCRibbonPanel objektu.
CMFCRibbonPanel(
LPCTSTR lpszName = NULL,
HICON hIcon = NULL);
CMFCRibbonPanel(CMFCRibbonGallery* pPaletteButton);
Parametry
lpszName
[v] Název panelu pásu karet
hIcon
[v] Úchyt na ikonu výchozího tlačítka panelu pásu karet
pPaletteButton
[v] Ukazatel na galerii pásu karet pro panel pásu karet
CMFCRibbonPanel::FindByData
Načte prvek pásu karet přidružený k zadaným datům.
CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData) const;
Parametry
dwData
[v] Data přidružená k prvku pásu karet.
Návratová hodnota
Ukazatel na prvek pásu karet, pokud byla metoda úspěšná; jinak NULL.
Poznámky
CMFCRibbonPanel::FindByID
Načte prvek pásu karet identifikovaný zadaným ID příkazu.
CMFCRibbonBaseElement* FindByID(UINT uiCmdID) const;
Parametry
uiCmdID
[v] ID příkazu prvku pásu karet.
Návratová hodnota
Prvek pásu karet, který je identifikován zadaným ID příkazu; v opačném případě null pokud není identifikován žádný prvek pásu karet se zadaným ID příkazu.
CMFCRibbonPanel::GetCaptionHeight
Načte výšku titulku panelu pásu karet.
int GetCaptionHeight() const;
Návratová hodnota
Výška v pixelech titulku panelu pásu karet.
Poznámky
CMFCRibbonPanel::GetCount
Načte počet prvků pásu karet, které jsou obsaženy na panelu pásu karet.
int GetCount() const;
Návratová hodnota
Počet prvků pásu karet, které jsou obsaženy na panelu pásu karet.
CMFCRibbonPanel::GetData
Vrátí uživatelem definovaná data přidružená k panelu.
DWORD_PTR GetData() const;
Návratová hodnota
Uživatelsky definovaná data přidružená k panelu.
CMFCRibbonPanel::GetDefaultButton
Načte výchozí tlačítko panelu pásu karet.
CMFCRibbonButton& GetDefaultButton();
Návratová hodnota
Výchozí tlačítko panelu pásu karet
Poznámky
Výchozí tlačítko se zobrazí, když panel pásu karet nemá dostatek místa k zobrazení jeho prvků pásu karet.
CMFCRibbonPanel::GetDroppedDown
Načte ukazatel na prvek pásu karet, pokud se místní nabídka rozbalí.
CMFCRibbonBaseElement* GetDroppedDown() const;
Návratová hodnota
Ukazatel myši na prvek pásu karet, který má rozevírací nabídku, která je mimo provoz; v opačném případě null pokud žádný prvek pásu karet nemá rozevírací nabídku.
Poznámky
Testují se pouze prvky pásu karet, které jsou obsaženy na panelu pásu karet.
CMFCRibbonPanel::GetElement
Vrátí prvek pásu karet umístěný v zadaném indexu.
CMFCRibbonBaseElement* GetElement(int nIndex) const;
Parametry
nIndex
[v] Určuje index založený na nule elementu, který se má načíst.
Návratová hodnota
Platný ukazatel na základní prvek pásu karet umístěný na pozici nIndex na panelu pásu karet nebo NULL, pokud v zadaném indexu není žádný prvek.
CMFCRibbonPanel::GetElements
Načte všechny prvky pásu karet obsažené v panelu pásu karet.
void GetElements(CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parametry
ArElements
[ven] Pole, které se má vyplnit všemi prvky pásu karet, které jsou obsaženy na panelu pásu karet.
Poznámky
CMFCRibbonPanel::GetElementsByID
Přidá prvky pásu karet, které mají zadané ID příkazu do zadaného pole.
void GetElementsByID(
UINT uiCmdID,
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parametry
uiCmdID
[v] ID příkazu pro prvek pásu karet
ArElements
[v] Pole prvků pásu karet
Poznámky
Testují se pouze prvky pásu karet, které jsou obsaženy na panelu pásu karet.
CMFCRibbonPanel::GetHighlighted
Načte prvek pásu karet, který je zvýrazněný na panelu pásu karet.
CMFCRibbonBaseElement* GetHighlighted() const;
Návratová hodnota
Ukazatel na prvek pásu karet, který je zvýrazněný na panelu pásu karet.
Poznámky
CMFCRibbonPanel::GetIndex
Načte index založený na nule zadaného prvku pásu karet z pole prvků pásu karet, které jsou obsaženy na panelu pásu karet.
virtual int GetIndex(CMFCRibbonBaseElement* pElem) const;
Parametry
pElem
[v] Ukazatel na prvek pásu karet
Návratová hodnota
Nulový index zadaného prvku pásu karet, pokud byla metoda úspěšná; jinak -1.
Poznámky
CMFCRibbonPanel::GetItemIDsList
Načte ID příkazů pro všechny prvky pásu karet na panelu pásu karet.
void GetItemIDsList(CList<UINT, UINT>& lstItems) const;
Parametry
lstItems
[ven] Seznam ID příkazů pro prvky pásu karet, které jsou obsaženy na panelu pásu karet.
Poznámky
CMFCRibbonPanel::GetName
Načte název panelu pásu karet.
LPCTSTR GetName() const;
Návratová hodnota
Název panelu pásu karet
Poznámky
CMFCRibbonPanel::GetParentButton
CMFCRibbonBaseElement* GetParentButton() const;
Návratová hodnota
Poznámky
CMFCRibbonPanel::GetParentCategory
Vrátí nadřazenou kategorii panelu pásu karet.
CMFCRibbonCategory* GetParentCategory() const;
Návratová hodnota
Ukazatel na kategorii pásu karet, která obsahuje tento panel pásu karet.
CMFCRibbonPanel::GetParentMenuBar
CMFCRibbonPanelMenuBar* GetParentMenuBar() const;
Návratová hodnota
Poznámky
CMFCRibbonPanel::GetPreferedMenuLocation
Načte upřednostňovaný obdélník zobrazení pro místní nabídku panelu pásu karet.
virtual BOOL GetPreferedMenuLocation(CRect& rect);
Parametry
Rect
[ven] Tento parametr se nepoužívá.
Návratová hodnota
Vždy vrátí hodnotu FALSE.
Poznámky
Tato metoda vždy vrátí hodnotu FALSE. Tuto metodu přepište, pokud chcete načíst upřednostňovaný obdélník zobrazení pro místní nabídku panelu pásu karet.
CMFCRibbonPanel::GetPressed
Načte ukazatel na prvek pásu karet na panelu pásu karet, pokud ho uživatel aktuálně stiskne.
CMFCRibbonBaseElement* GetPressed() const;
Návratová hodnota
Ukazatel na prvek pásu karet, pokud ho uživatel aktuálně stiskne; jinak NULL.
Poznámky
CMFCRibbonPanel::GetRect
Načte obdélník zobrazení panelu pásu karet.
const CRect& GetRect() const;
Návratová hodnota
Obdélník zobrazení panelu pásu karet.
Poznámky
CMFCRibbonPanel::HasElement
Určuje, zda panel pásu karet obsahuje zadaný prvek pásu karet.
BOOL HasElement(const CMFCRibbonBaseElement* pElem) const;
Parametry
pElem
[v] Ukazatel na prvek pásu karet
Návratová hodnota
TRUE, pokud panel pásu karet obsahuje zadaný prvek pásu karet; jinak NEPRAVDA.
Poznámky
CMFCRibbonPanel::Zvýraznění
Nastaví barvu zvýraznění pro vybraný panel pásu karet a pro prvek pásu karet určený bodem.
virtual void Highlight(
BOOL bHighlight,
CPoint point);
Parametry
bHighlight
[v] TRUE pro zvýraznění panelu pásu karet; NEPRAVDA, aby se panel pásu karet nezvýraznily.
bod
[v] Souřadnice x a y ukazatele vzhledem k levému hornímu rohu okna.
Poznámky
CMFCRibbonPanel::HitTest
Načte prvek pásu karet, pokud je v něm umístěný zadaný bod.
virtual CMFCRibbonBaseElement* HitTest(
CPoint point,
BOOL bCheckPanelCaption = FALSE);
Parametry
bod
[v] Souřadnice x a y ukazatele vzhledem k levému hornímu rohu okna.
bCheckPanelCaption
[v] TRUE pro otestování titulku panelu pásu karet; jinak NEPRAVDA.
Návratová hodnota
Ukazatel na prvek pásu karet, pokud je v něm umístěný zadaný bod; jinak NULL.
Poznámky
Testují se pouze prvky pásu karet, které jsou obsaženy na panelu pásu karet.
CMFCRibbonPanel::HitTestEx
Načte index založený na nule prvku pásu karet, který má zadaný bod umístěný v něm.
virtual int HitTestEx(CPoint point) const;
Parametry
bod
[v] Souřadnice x a y ukazatele vzhledem k levému hornímu rohu okna.
Návratová hodnota
Index na základě nuly prvku pásu karet, který má zadaný bod umístěný v něm; jinak -1.
Poznámky
Testují se pouze prvky pásu karet, které jsou obsaženy na panelu pásu karet.
CMFCRibbonPanel::Insert
Vloží zadaný prvek pásu karet na zadanou pozici v poli prvků pásu karet, které jsou obsaženy v panelu pásu karet.
virtual BOOL Insert(
CMFCRibbonBaseElement* pElem,
int nIndex);
Parametry
pElem
[in, out] Ukazatel na prvek pásu karet
nIndex
[v] Nulová hodnota v rozsahu -1 až po počet prvků pásu karet, které jsou obsaženy v poli.
Návratová hodnota
TRUE, pokud byl prvek pásu karet úspěšně vložen; jinak NEPRAVDA.
Poznámky
Pokud je hodnota nIndex -1 nebo pokud nIndex se rovná počtu prvků pásu karet v matici, zadaný prvek pásu karet se přidá na konec pole. Pokud je hodnota nIndex mimo rozsah, metoda selže.
CMFCRibbonPanel::InsertSeparator
Vloží oddělovač na danou pozici.
virtual BOOL InsertSeparator(int nIndex);
Parametry
nIndex
[v] Určuje index založený na nule, do kterého se vkládá oddělovač.
Návratová hodnota
TRUE, pokud byl oddělovač úspěšně vložen; jinak NEPRAVDA.
Poznámky
Voláním této metody vložíte oddělovač na pozici určenou parametrem nIndex. Pokud chcete vložit oddělovač vedle naposledy přidaného prvku pásu karet, zavolejte CMFCRibbonPanel::AddSeparator.
CMFCRibbonPanel::IsCenterColumnVert
Určuje, jestli jsou svislé pozice prvků pásu karet za středem v jejich obdélníku zobrazení.
BOOL IsCenterColumnVert() const;
Návratová hodnota
PRAVDA, pokud svislé pozice prvků pásu karet jsou zacentrovány v rámci jejich obdélníku zobrazení; jinak NEPRAVDA.
CMFCRibbonPanel::IsCollapsed
Určuje, jestli je velikost zobrazení panelu pásu karet minimalizovaná vodorovným směrem.
BOOL IsCollapsed() const;
Návratová hodnota
TRUE, pokud je velikost zobrazení panelu pásu karet minimalizovaná ve vodorovném směru; jinak NEPRAVDA.
Poznámky
Když je panel pásu karet sbalený, zobrazí se jenom výchozí tlačítko, jeho název a šipka rozevíracího seznamu.
CMFCRibbonPanel::IsHighlighted
Určuje, jestli je zvýrazněný zobrazení panelu pásu karet.
BOOL IsHighlighted() const;
Návratová hodnota
TRUE, pokud je zvýrazněno zobrazení panelu pásu karet; jinak NEPRAVDA.
Poznámky
Zobrazení panelu pásu karet se zvýrazní, když je ukazatel nad ním.
CMFCRibbonPanel::IsJustifyColumns
Určuje, zda jsou rozměry zobrazení prvků pásu karet, které jsou ve stejném sloupci na panelu pásu karet, nastaveny na stejnou šířku.
BOOL IsJustifyColumns() const;
Návratová hodnota
TRUE, pokud jsou rozměry zobrazení prvků pásu karet, které jsou ve stejném sloupci na panelu pásu karet jsou nastaveny na stejnou šířku; jinak NEPRAVDA.
CMFCRibbonPanel::IsMainPanel
Určuje, jestli je panel pásu karet hlavním panelem pásu karet.
virtual BOOL IsMainPanel() const;
Návratová hodnota
Vždy vrátí hodnotu FALSE.
Poznámky
Tato metoda vždy vrátí hodnotu FALSE. Přepište tuto metodu, aby bylo uvedeno, zda je panel pásu karet hlavním panelem pásu karet.
Hlavní panel pásu karet se zobrazí, když uživatel vybere tlačítko aplikace.
CMFCRibbonPanel::IsMenuMode
BOOL IsMenuMode() const;
Návratová hodnota
Poznámky
CMFCRibbonPanel::OnKey
virtual BOOL OnKey(UINT nChar);
Parametry
[v] nChar
Návratová hodnota
Poznámky
CMFCRibbonPanel::PřepočítatWidths
Přepočítá šířku každé konfigurace rozložení zobrazení pro panel pásu karet.
virtual void RecalcWidths(
CDC* pDC,
int nHeight);
Parametry
pDC
[v] Ukazatel na kontext zařízení pro panel pásu karet
nHeight
[v] Výška panelu pásu karet.
Poznámky
Panel pásu karet změní konfiguraci rozložení, protože se změní dostupná šířka.
CMFCRibbonPanel::Remove
Odebere a volitelně odstraní prvek umístěný v zadaném indexu.
BOOL Remove(
int nIndex,
BOOL bDelete = TRUE);
Parametry
nIndex
[v] Určuje nulový index prvku, který je odebrán z panelu pásu karet.
bDelete
[v] TRUE pro odstranění prvku, který je odebrán; jinak NEPRAVDA.
Návratová hodnota
TRUE, pokud byl prvek odebrán a odstraněn (pokud bDelete je TRUE); NEPRAVDA, pokud prvek nebyl odebrán nebo pokud neexistuje žádný prvek pásu karet umístěný v nIndex.
Poznámky
Voláním této metody odeberete prvek z panelu pásu karet.
CMFCRibbonPanel::RemoveAll
Odstraní všechny prvky pásu karet z panelu pásu karet.
void RemoveAll();
Poznámky
Všechny prvky pásu karet jsou odstraněny z panelu pásu karet a zničeny.
CMFCRibbonPanel::Replace
Nahradí jeden prvek jiným na základě hodnoty indexu.
BOOL Replace(
int nIndex,
CMFCRibbonBaseElement* pElem);
Parametry
nIndex
[v] Určuje index založený na nule elementu, který se má nahradit.
pElem
[in, out] Platný ukazatel na prvek, který nahrazuje původní prvek.
Návratová hodnota
TRUE, pokud byl původní prvek pásu karet úspěšně nahrazen novým prvkem pásu; NEPRAVDA, pokud nebyl prvek pásu karet nahrazen nebo pokud v zadaném indexu není žádný prvek.
Poznámky
Chcete-li nahradit prvek pásu karet id příkazu, zavolejte CMFCRibbonPanel::ReplaceByID.
CMFCRibbonPanel::ReplaceByID
Nahradí jeden prvek jiným na základě zadaného ID příkazu.
BOOL ReplaceByID(
UINT uiCmdID,
CMFCRibbonBaseElement* pElem);
Parametry
uiCmdID
[v] Určuje ID příkazu elementu, který se má nahradit.
pElem
[in, out] Platný ukazatel na prvek, který nahradí původní prvek.
Návratová hodnota
TRUE, pokud byl původní prvek pásu karet úspěšně nahrazen novým prvkem pásu; NEPRAVDA, pokud nebyl prvek pásu karet nahrazen nebo pokud žádný prvek se zadaným ID příkazu skutečně existuje.
Poznámky
Chcete-li nahradit prvek pásu karet na základě pozice, zavolejte CMFCRibbonPanel::Replace.
CMFCRibbonPanel::SetCenterColumnVert
Povolí nebo zakáže střed svislých pozic prvků pásu karet v jejich obdélníku zobrazení.
void SetCenterColumnVert(BOOL bSet = TRUE);
Parametry
bSet
[v] PRAVDA pro zarovnání svislých pozic prvků pásu karet v rámci jejich obdélníku zobrazení; NEPRAVDA, pokud chcete tuto funkci zakázat.
Poznámky
CMFCRibbonPanel::SetData
Přidruží uživatelsky definovaná data k panelu pásu karet.
void SetData(DWORD_PTR dwData);
Parametry
dwData
[v] Určuje uživatelem definovaná data, která se mají nastavit.
Poznámky
Voláním této metody přidružíte uživatelsky definovaná data k panelu pásu karet.
CMFCRibbonPanel::SetElementMenu
Přiřadí místní nabídku elementu, který má dané ID příkazu.
BOOL SetElementMenu(
UINT uiCmdID,
HMENU hMenu,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);
BOOL SetElementMenu(
UINT uiCmdID,
UINT uiMenuResID,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);
Parametry
uiCmdID
[v] Určuje ID příkazu prvku pásu karet, do kterého je nabídka přidána.
hMenu
[v] Určuje popisovač nabídky Windows, která se má přidat na panel pásu karet.
bIsDefautCommand
[v] Hodnota TRUE určuje, že příkaz přidružený k prvku pásu karet by měl být proveden, pokud je na pásu karet klikněte. V tomto případě se nabídka otevře, jenom když uživatel klikne na šipku vedle prvku pásu karet. NEPRAVDA, pokud chcete určit, že příkaz přidružený k prvku pásu karet by neměl být proveden, pokud je na prvek pásu karet klikaný. V tomto případě se místní nabídka zobrazí bez ohledu na to, kde uživatel klikne na prvek.
bRightAlign
[v] PRAVDA pro určení, že místní nabídka je zarovnaná doprava; jinak NEPRAVDA.
uiMenuResID
[v] Určuje ID prostředku nabídky, které se má přidat na panel pásu karet.
Návratová hodnota
TRUE, pokud byla nabídka přiřazena k prvku pásu karet; jinak NEPRAVDA.
Poznámky
Voláním této metody přiřadíte místní nabídku k prvku pásu karet, který má dané ID příkazu.
CMFCRibbonPanel::SetElementRTC
Přidá prvek pásu karet, který je určen poskytnuté informace třídy modulu runtime na panelu pásu karet.
CMFCRibbonBaseElement* SetElementRTC(
int nIndex,
CRuntimeClass* pRTC);
Parametry
nIndex
[v] Určuje index založený na nule prvku pásu karet, který chcete přidat.
pRTC
[in, out] Ukazatel na informace o třídě modulu runtime pro prvek pásu karet, který je přidán na panel pásu karet.
Návratová hodnota
Prvek pásu karet, který byl vytvořen pomocí zadané informace třídy modulu runtime.
Poznámky
Pokud chcete na panel pásu karet přidat vlastní prvek (například barevné tlačítko), musíte zadat informace o třídě modulu runtime vlastního elementu. Pás karet ukládá tyto informace, vytvoří vlastní prvek a nahradí existující prvek, který je umístěný (identifikovaný) zadaným ID příkazu. Pás karet pak vrátí ukazatel na nově vytvořený prvek.
CMFCRibbonPanel::SetElementRTCByID
Přidá do panelu pásu karet prvek, který je určen informacemi o poskytnuté třídě modulu runtime.
CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC);
Parametry
uiCmdID
[v] Určuje ID příkazu prvku pásu karet, který chcete přidat.
pRTC
[in, out] Ukazatel na informace o třídě modulu runtime přidružené k prvku pásu karet, který je přidán na panel pásu karet.
Návratová hodnota
Prvek pásu karet, který byl vytvořen pomocí zadané informace třídy modulu runtime.
Poznámky
Pokud chcete na panel pásu karet přidat vlastní prvek (například barevné tlačítko), musíte zadat informace o třídě modulu runtime vlastního elementu. Pás karet ukládá tyto informace, vytvoří vlastní prvek a nahradí existující prvek umístěný zadaným ID příkazu. Potom vrátí ukazatel na nově vytvořený prvek.
Příklad
Následující příklad ukazuje, jak použít metodu SetElementRTCByID :
// Load and add toolbar with standard buttons. This toolbar
// should display a custom color button with id ID_CHAR_COLOR:
pPanel->AddToolBar(IDR_MAINFRAME,
IDB_MAINFRAME256);
CMFCRibbonColorButton* pColorButton =
(CMFCRibbonColorButton*)pPanel->SetElementRTCByID(
ID_CHAR_COLOR,
RUNTIME_CLASS (CMFCRibbonColorButton));
// SetElementRTCByID sets runtime class and returns a pointer
// to the newly created custom button,
which can be set up immediately:
pColorButton->EnableAutomaticButton(_T("Automatic"),
RGB (0,
0,
0));
CMFCRibbonPanel::SetJustifyColumns
Povolí nebo zakáže nastavení šířky prvků pásu karet ve stejném sloupci.
void SetJustifyColumns(BOOL bSet = TRUE);
Parametry
bSet
[v] TRUE pro úpravu šířky prvků pásu karet ve stejném sloupci na šířku největšího prvku pásu karet ve sloupci; NEPRAVDA pro zakázání této úpravy šířky.
Poznámky
Pokud je tato funkce povolená na panelu pásu karet, šířky prvků pásu karet ve stejném sloupci se upraví na šířku největšího prvku pásu karet ve stejném sloupci.
CMFCRibbonPanel::SetKeys
Nastaví popis výchozího tlačítka panelu pásu karet.
void SetKeys(LPCTSTR lpszKeys);
Parametry
lpszKeys
[v] Popis výchozího tlačítka panelu pásu karet
Poznámky
Výchozí tlačítko se zobrazí, když panel pásu karet nemá dostatek místa k zobrazení jeho prvků pásu karet.
CMFCRibbonPanel::ShowPopup
Vytvoří a zobrazí místní nabídku panelu pásu karet.
CMFCRibbonPanelMenu* ShowPopup(CMFCRibbonDefaultPanelButton* pButton = NULL);
Parametry
pButton
[v] Ukazatel na výchozí tlačítko panelu pásu karet
Návratová hodnota
Ukazatel na místní nabídku panelu pásu karet, pokud byla metoda úspěšná; jinak NULL.
Poznámky
Místní nabídka panelu pásu karet je dostupná jenom v případě, že je zobrazení panelu pásu karet sbalené.
CMFCRibbonPanel::SetFocused
Nastaví fokus na zadaný prvek pásu karet.
void SetFocused(CMFCRibbonBaseElement* pNewFocus);
Parametry
pNewFocus
Ukazatel na prvek pásu karet, který přijímá fokus.
Poznámky
CMFCRibbonPanel::MakeGalleryItemVisible
Posune galerii, aby byl zadaný prvek pásu karet viditelný.
void MakeGalleryItemVisible(CMFCRibbonBaseElement* pItem);
Parametry
pItem
Ukazatel na prvek pásu karet, který se má zobrazit.
Poznámky
CMFCRibbonPanel::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
CMFCRibbonPanel::GetVisibleElements
Načte pole viditelných prvků.
void GetVisibleElements(
CArray<CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);
Parametry
ArElements
Když funkce vrátí, tento parametr obsahuje pole viditelných prvků.
Poznámky
CMFCRibbonPanel::GetGalleryRect
Vrátí ohraničující obdélník prvku Galerie.
CRect GetGalleryRect();
Návratová hodnota
Velikost a umístění prvku Galerie v rámci tohoto panelu
Poznámky
CMFCRibbonPanel::GetFocused
Vrátí prioritní prvek.
CMFCRibbonBaseElement* GetFocused() const;
Návratová hodnota
Ukazatel na prioritní prvek nebo hodnotu NULL.
Poznámky
Viz také
Graf hierarchie
Třídy
CObject – třída
CMFCRibbonCategory – třída
CMFCRibbonBaseElement – třída