CMFCRibbonStatusBar – třída
Třída CMFCRibbonStatusBar implementuje ovládací prvek stavového řádku, který může zobrazit prvky pásu karet.
Syntaxe
class CMFCRibbonStatusBar : public CMFCRibbonBar
Členové
Veřejné metody
| Název | Popis |
|---|---|
| CMFCRibbonStatusBar::AddDynamicElement | Přidá dynamický prvek na stavový řádek pásu karet. |
| CMFCRibbonStatusBar::AddElement | Přidá nový prvek pásu karet na stavový řádek pásu karet. |
| CMFCRibbonStatusBar::AddExtendedElement | Přidá prvek pásu karet do rozšířené oblasti stavového řádku pásu karet. |
| CMFCRibbonStatusBar::AddSeparator | Přidá oddělovač na stavový řádek pásu karet. |
| CMFCRibbonStatusBar::Create | Vytvoří stavový řádek pásu karet. |
| CMFCRibbonStatusBar::CreateEx | Vytvoří stavový řádek pásu karet s rozšířeným stylem. |
| CMFCRibbonStatusBar::FindByID | |
| CMFCRibbonStatusBar::FindElement | Vrátí ukazatel na prvek, který má zadané ID příkazu. |
| CMFCRibbonStatusBar::GetCount | Vrátí počet prvků umístěných v hlavní oblasti stavového řádku pásu karet. |
| CMFCRibbonStatusBar::GetElement | Vrátí ukazatel na prvek umístěný v zadaném indexu. |
| CMFCRibbonStatusBar::GetExCount | Vrátí počet prvků umístěných v rozšířené oblasti stavového řádku pásu karet. |
| CMFCRibbonStatusBar::GetExElement | Vrátí ukazatel na prvek umístěný v zadaném indexu v rozšířené oblasti stavového řádku pásu karet. |
| CMFCRibbonStatusBar::GetExtendedArea | |
| CMFCRibbonStatusBar::GetSpace | |
| CMFCRibbonStatusBar::IsBottomFrame | |
| CMFCRibbonStatusBar::IsExtendedElement | |
| CMFCRibbonStatusBar::IsInformationMode | Určuje, zda je pro stavový řádek pásu karet povolený režim informací. |
| CMFCRibbonStatusBar::RecalcLayout | (Přepsání CMFCRibbonBar::RecalcLayout.) |
| CMFCRibbonStatusBar::RemoveAll | Odebere všechny prvky ze stavového řádku pásu karet. |
| CMFCRibbonStatusBar::RemoveElement | Odebere prvek, který má zadané ID příkazu na stavovém řádku pásu karet. |
| CMFCRibbonStatusBar::SetInformation | Povolí nebo zakáže režim informací pro stavový řádek pásu karet. |
Chráněné metody
| Název | Popis |
|---|---|
| CMFCRibbonStatusBar::OnDrawInformation | Zobrazí informační řetězec, který se zobrazí na stavovém řádku pásu karet, když je povolený informační režim. |
Poznámky
Uživatelé můžou změnit viditelnost prvků pásu karet na stavovém řádku pásu karet pomocí předdefinované místní nabídky stavového řádku pásu karet. Prvky můžete přidávat nebo odebírat dynamicky.
Stavový řádek pásu karet má dvě oblasti: hlavní oblast a rozšířenou oblast. Rozšířená oblast se zobrazí na pravé straně stavového řádku pásu karet a zobrazí se v jiné barvě než hlavní oblast.
Hlavní oblast stavového řádku obvykle zobrazuje oznámení o stavu a rozšířená oblast zobrazuje ovládací prvky zobrazení. Rozšířená oblast zůstane viditelná, pokud uživatel změní velikost stavového řádku pásu karet.
Příklad
Následující příklad ukazuje, jak používat různé metody ve CMFCRibbonStatusBar třídě. Příklad ukazuje, jak přidat nový prvek pásu karet na stavový řádek pásu karet, přidat prvek pásu karet do rozšířené oblasti stavového řádku pásu karet, přidat oddělovač a povolit běžný režim pro stavový řádek pásu karet.
// CMFCRibbonStatusBar m_wndStatusBar
m_wndStatusBar.AddElement(rsbp, strTitlePane1);
m_wndStatusBar.AddExtendedElement(new CMFCRibbonStatusBarPane(ID_STATUSBAR_PANE2, strTitlePane2, TRUE),
strTitlePane2);
m_wndStatusBar.AddSeparator();
m_wndStatusBar.SetInformation(NULL);
Hierarchie dědičnosti
Požadavky
Záhlaví: afxribbonstatusbar.h
CMFCRibbonStatusBar::AddDynamicElement
Přidá dynamický prvek na stavový řádek pásu karet.
void AddDynamicElement(CMFCRibbonBaseElement* pElement);
Parametry
pElement
[v] Ukazatel na dynamický prvek.
Poznámky
Na rozdíl od běžných prvků nejsou dynamické prvky přizpůsobitelné a nabídka přizpůsobení stavového řádku je nezobrazuje.
CMFCRibbonStatusBar::AddElement
Přidá nový prvek pásu karet na stavový řádek pásu karet.
void AddElement(
CMFCRibbonBaseElement* pElement,
LPCTSTR lpszLabel,
BOOL bIsVisible=TRUE);
Parametry
pElement
[v] Ukazatel na přidaný prvek.
lpszLabel
[v] Textový popisek prvku.
bIsVisible
[v] TRUE, pokud chcete přidat prvek jako viditelný, FALSE pokud chcete přidat element jako skrytý.
CMFCRibbonStatusBar::AddExtendedElement
Přidá prvek pásu karet do rozšířené oblasti stavového řádku pásu karet.
void AddExtendedElement(
CMFCRibbonBaseElement* pElement,
LPCTSTR lpszLabel,
BOOL bIsVisible=TRUE);
Parametry
pElement
[v] Ukazatel na přidaný prvek.
lpszLabel
[v] Textový popisek prvku.
bIsVisible
[v] TRUE, pokud chcete přidat prvek jako viditelný, FALSE pokud chcete přidat element jako skrytý.
Poznámky
Rozšířená oblast je na pravé straně ovládacího prvku stavového řádku.
CMFCRibbonStatusBar::AddSeparator
Přidá oddělovač na stavový řádek pásu karet.
void AddSeparator();
Poznámky
Architektura přidá oddělovač za metodu CMFCRibbonStatusBar::AddElement. vloží poslední prvek.
CMFCRibbonStatusBar::Create
Vytvoří stavový řádek pásu karet.
BOOL Create(
CWnd* pParentWnd,
DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
UINT nID=AFX_IDW_STATUS_BAR);
Parametry
pParentWnd
[v] Ukazatel na nadřazené okno.
dwStyle
[v] Logická kombinace nebo stylů ovládacích prvků.
Nid
[v] ID ovládacího prvku stavového řádku.
Návratová hodnota
TRUE, pokud je stavový řádek úspěšně vytvořen, v opačném případě NEPRAVDA.
CMFCRibbonStatusBar::CreateEx
Vytvoří stavový řádek pásu karet s rozšířeným stylem.
BOOL CreateEx(
CWnd* pParentWnd,
DWORD dwCtrlStyle=0,
DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
UINT nID=AFX_IDW_STATUS_BAR);
Parametry
pParentWnd
Ukazatel na nadřazené okno.
dwCtrlStyle
Logická kombinace NEBO dalších stylů pro vytvoření objektu stavového řádku.
dwStyle
Styl ovládacího prvku stavového řádku.
Nid
ID ovládacího prvku stavového řádku.
Návratová hodnota
TRUE, pokud je stavový řádek úspěšně vytvořen, v opačném případě NEPRAVDA.
CMFCRibbonStatusBar::FindByID
Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.
CMFCRibbonBaseElement* FindByID(UINT uiCmdID, BOOL = TRUE);
Parametry
[v] uiCmdID
[v] BOOL
Návratová hodnota
Poznámky
CMFCRibbonStatusBar::FindElement
Vrátí ukazatel na prvek, který má zadané ID příkazu.
CMFCRibbonBaseElement* FindElement(UINT uiID);
Parametry
UIID
[v] ID elementu.
Návratová hodnota
Ukazatel na prvek, který má zadané ID příkazu. NULL pokud neexistuje žádný takový prvek.
CMFCRibbonStatusBar::GetCount
Vrátí počet prvků umístěných v hlavní oblasti stavového řádku pásu karet.
int GetCount() const;
Návratová hodnota
Počet prvků umístěných v hlavní oblasti stavového řádku pásu karet
CMFCRibbonStatusBar::GetElement
Vrátí ukazatel na prvek umístěný v zadaném indexu.
CMFCRibbonBaseElement* GetElement(int nIndex);
Parametry
nIndex
[v] Určuje index založený na nule prvku, který se nachází v hlavní oblasti ovládacího prvku stavového řádku.
Návratová hodnota
Ukazatel na prvek umístěný v zadaném indexu. HODNOTA NULL, pokud je index záporný nebo překračuje počet prvků na stavovém řádku.
Poznámky
CMFCRibbonStatusBar::GetExCount
Vrátí počet prvků umístěných v rozšířené oblasti stavového řádku pásu karet.
int GetExCount() const;
Návratová hodnota
Počet prvků umístěných v rozšířené oblasti stavového řádku pásu karet.
CMFCRibbonStatusBar::GetExElement
Vrátí ukazatel na prvek umístěný v zadaném indexu v rozšířené oblasti stavového řádku pásu karet. Rozšířená oblast je na pravé straně ovládacího prvku stavového řádku.
CMFCRibbonBaseElement* GetExElement(int nIndex);
Parametry
nIndex
[v] Určuje index založený na nule prvku, který se nachází v rozšířené oblasti ovládacího prvku stavového řádku.
Návratová hodnota
Ukazatel na prvek umístěný v zadaném indexu v rozšířené oblasti stavového řádku pásu karet. HODNOTA NULL, pokud je hodnota nIndex záporná nebo překračuje počet prvků v rozšířené oblasti stavového řádku pásu karet.
Poznámky
CMFCRibbonStatusBar::GetExtendedArea
Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.
virtual BOOL GetExtendedArea(CRect& rect) const;
Parametry
[v] Rect
Návratová hodnota
Poznámky
CMFCRibbonStatusBar::GetSpace
Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.
int GetSpace() const;
Návratová hodnota
Poznámky
CMFCRibbonStatusBar::IsBottomFrame
Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.
BOOL IsBottomFrame() const;
Návratová hodnota
Poznámky
CMFCRibbonStatusBar::IsExtendedElement
Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.
BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;
Parametry
[v] pElement
Návratová hodnota
Poznámky
CMFCRibbonStatusBar::IsInformationMode
Určuje, zda je pro stavový řádek pásu karet povolený režim informací.
BOOL IsInformationMode() const;
Návratová hodnota
TRUE, pokud stavový řádek může pracovat v informačním režimu; jinak NEPRAVDA.
Poznámky
V informačním režimu stavový řádek skryje všechna běžná podokna a zobrazí řetězec zprávy.
CMFCRibbonStatusBar::OnDrawInformation
Zobrazí řetězec, který se zobrazí na stavovém řádku pásu karet, když je povolený informační režim.
virtual void OnDrawInformation(
CDC* pDC,
CString& strInfo,
CRect rectInfo);
Parametry
pDC
[v] Ukazatel na kontext zařízení.
strInfo
[v] Informační řetězec.
rectInfo
[v] Ohraničující obdélník.
Poznámky
Tuto metodu přepište v odvozené třídě, pokud chcete přizpůsobit vzhled informačního řetězce na stavovém řádku. Pomocí CMFCRibbonStatusBar::SetInformation metoda umístit stavový řádek do informačního režimu. V tomto režimu stavový řádek skryje všechna podokna a zobrazí informační řetězec určený strInfo.
CMFCRibbonStatusBar::RecalcLayout
Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.
virtual void RecalcLayout();
Poznámky
CMFCRibbonStatusBar::RemoveAll
Odebere všechny prvky ze stavového řádku pásu karet.
void RemoveAll();
CMFCRibbonStatusBar::RemoveElement
Odebere prvek, který má zadané ID příkazu na stavovém řádku pásu karet.
BOOL RemoveElement(UINT uiID);
Parametry
UIID
[v] ID prvku, který chcete odebrat ze stavového řádku.
Návratová hodnota
TRUE, pokud je odebrán prvek se zadaným identifikátorem uiID . JINAK NEPRAVDA.
CMFCRibbonStatusBar::SetInformation
Povolí nebo zakáže režim informací pro stavový řádek pásu karet.
void SetInformation(LPCTSTR lpszInfo);
Parametry
lpszInfo
[v] Informační řetězec.
Poznámky
Tuto metodu použijte k umístění stavového řádku do informačního režimu. V tomto režimu stavový řádek skryje všechna podokna a zobrazí informační řetězec určený lpszInfo.
Pokud je lpszInfo NULL, stavový řádek se vrátí do normálního režimu.
Viz také
Graf hierarchie
Třídy
CMFCRibbonBar – třída
CMFCRibbonBaseElement – třída
CMFCRibbonBar – třída