Klasa CMFCRibbonStatusBar
Klasa CMFCRibbonStatusBar implementuje kontrolkę paska stanu, która może wyświetlać elementy wstążki.
Składnia
class CMFCRibbonStatusBar : public CMFCRibbonBar
Elementy członkowskie
Metody publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CMFCRibbonStatusBar::AddDynamicElement | Dodaje element dynamiczny na pasku stanu wstążki. |
| CMFCRibbonStatusBar::AddElement | Dodaje nowy element wstążki na pasku stanu wstążki. |
| CMFCRibbonStatusBar::AddExtendedElement | Dodaje element wstążki do rozszerzonego obszaru paska stanu wstążki. |
| CMFCRibbonStatusBar::AddSeparator | Dodaje separator na pasku stanu wstążki. |
| CMFCRibbonStatusBar::Create | Tworzy pasek stanu wstążki. |
| CMFCRibbonStatusBar::CreateEx | Tworzy pasek stanu wstążki z rozszerzonym stylem. |
| CMFCRibbonStatusBar::FindByID | |
| CMFCRibbonStatusBar::FindElement | Zwraca wskaźnik do elementu, który ma określony identyfikator polecenia. |
| CMFCRibbonStatusBar::GetCount | Zwraca liczbę elementów znajdujących się w głównym obszarze paska stanu wstążki. |
| CMFCRibbonStatusBar::GetElement | Zwraca wskaźnik do elementu, który znajduje się w określonym indeksie. |
| CMFCRibbonStatusBar::GetExCount | Zwraca liczbę elementów znajdujących się w rozszerzonym obszarze paska stanu wstążki. |
| CMFCRibbonStatusBar::GetExElement | Zwraca wskaźnik do elementu znajdującego się w określonym indeksie w rozszerzonym obszarze paska stanu wstążki. |
| CMFCRibbonStatusBar::GetExtendedArea | |
| CMFCRibbonStatusBar::GetSpace | |
| CMFCRibbonStatusBar::IsBottomFrame | |
| CMFCRibbonStatusBar::IsExtendedElement | |
| CMFCRibbonStatusBar::IsInformationMode | Określa, czy tryb informacji jest włączony dla paska stanu wstążki. |
| CMFCRibbonStatusBar::RecalcLayout | (Przesłonięcia) CMFCRibbonBar::RecalcLayout). |
| CMFCRibbonStatusBar::RemoveAll | Usuwa wszystkie elementy z paska stanu wstążki. |
| CMFCRibbonStatusBar::RemoveElement | Usuwa element, który ma określony identyfikator polecenia z paska stanu wstążki. |
| CMFCRibbonStatusBar::SetInformation | Włącza lub wyłącza tryb informacji dla paska stanu wstążki. |
Metody chronione
| Nazwa/nazwisko | opis |
|---|---|
| CMFCRibbonStatusBar::OnDrawInformation | Wyświetla ciąg informacji wyświetlany na pasku stanu wstążki po włączeniu trybu informacji. |
Uwagi
Użytkownicy mogą zmieniać widoczność elementów wstążki na pasku stanu wstążki przy użyciu wbudowanego menu kontekstowego paska stanu wstążki. Elementy można dodawać lub usuwać dynamicznie.
Pasek stanu wstążki ma dwa obszary: obszar główny i obszar rozszerzony. Obszar rozszerzony jest wyświetlany po prawej stronie paska stanu wstążki i jest wyświetlany w innym kolorze niż obszar główny.
Zazwyczaj główny obszar paska stanu wyświetla powiadomienia o stanie, a obszar rozszerzony wyświetla kontrolki widoku. Obszar rozszerzony pozostaje widoczny tak długo, jak to możliwe, gdy użytkownik zmienia rozmiar paska stanu wstążki.
Przykład
W poniższym przykładzie pokazano, jak używać różnych metod w CMFCRibbonStatusBar klasie . W przykładzie pokazano, jak dodać nowy element wstążki na pasku stanu wstążki, dodać element wstążki do rozszerzonego obszaru paska stanu wstążki, dodać separator i włączyć tryb zwykły dla paska stanu wstążki.
// 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);
Hierarchia dziedziczenia
Wymagania
Nagłówek: afxribbonstatusbar.h
CMFCRibbonStatusBar::AddDynamicElement
Dodaje element dynamiczny na pasku stanu wstążki.
void AddDynamicElement(CMFCRibbonBaseElement* pElement);
Parametry
pElement
[in] Wskaźnik do elementu dynamicznego.
Uwagi
W przeciwieństwie do zwykłych elementów elementy dynamiczne nie są dostosowywalne, a menu dostosowywania paska stanu nie wyświetla ich.
CMFCRibbonStatusBar::AddElement
Dodaje nowy element wstążki na pasku stanu wstążki.
void AddElement(
CMFCRibbonBaseElement* pElement,
LPCTSTR lpszLabel,
BOOL bIsVisible=TRUE);
Parametry
pElement
[in] Wskaźnik do dodanego elementu.
lpszLabel
[in] Etykieta tekstowa elementu.
bIsVisible
[in] TRUE, jeśli chcesz dodać element jako widoczny, FALSE, jeśli chcesz dodać element jako ukryty.
CMFCRibbonStatusBar::AddExtendedElement
Dodaje element wstążki do rozszerzonego obszaru paska stanu wstążki.
void AddExtendedElement(
CMFCRibbonBaseElement* pElement,
LPCTSTR lpszLabel,
BOOL bIsVisible=TRUE);
Parametry
pElement
[in] Wskaźnik do dodanego elementu.
lpszLabel
[in] Etykieta tekstowa elementu.
bIsVisible
[in] TRUE, jeśli chcesz dodać element jako widoczny, FALSE, jeśli chcesz dodać element jako ukryty.
Uwagi
Obszar rozszerzony znajduje się po prawej stronie kontrolki paska stanu.
CMFCRibbonStatusBar::AddSeparator
Dodaje separator na pasku stanu wstążki.
void AddSeparator();
Uwagi
Struktura dodaje separator po metodzie CMFCRibbonStatusBar::AddElement. Wstawia ostatni element.
CMFCRibbonStatusBar::Create
Tworzy pasek stanu wstążki.
BOOL Create(
CWnd* pParentWnd,
DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
UINT nID=AFX_IDW_STATUS_BAR);
Parametry
pParentWnd
[in] Wskaźnik do okna nadrzędnego.
dwStyle
[in] Logiczna kombinacja stylów kontrolek LUB.
Nid
[in] Identyfikator kontrolki paska stanu.
Wartość zwracana
Wartość TRUE, jeśli pasek stanu został pomyślnie utworzony, w przeciwnym razie fałsz.
CMFCRibbonStatusBar::CreateEx
Tworzy pasek stanu wstążki o rozszerzonym stylu.
BOOL CreateEx(
CWnd* pParentWnd,
DWORD dwCtrlStyle=0,
DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
UINT nID=AFX_IDW_STATUS_BAR);
Parametry
pParentWnd
Wskaźnik do okna nadrzędnego.
dwCtrlStyle
Logiczna kombinacja lub dodatkowych stylów do tworzenia obiektu paska stanu.
dwStyle
Styl kontrolki paska stanu.
Nid
Identyfikator kontrolki paska stanu.
Wartość zwracana
Wartość TRUE, jeśli pasek stanu został pomyślnie utworzony, w przeciwnym razie fałsz.
CMFCRibbonStatusBar::FindByID
Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.
CMFCRibbonBaseElement* FindByID(UINT uiCmdID, BOOL = TRUE);
Parametry
[in] uiCmdID
[in] BOOL
Wartość zwracana
Uwagi
CMFCRibbonStatusBar::FindElement
Zwraca wskaźnik do elementu, który ma określony identyfikator polecenia.
CMFCRibbonBaseElement* FindElement(UINT uiID);
Parametry
identyfikator uiID
[in] Identyfikator elementu.
Wartość zwracana
Wskaźnik do elementu, który ma określony identyfikator polecenia. Wartość NULL, jeśli nie ma takiego elementu.
CMFCRibbonStatusBar::GetCount
Zwraca liczbę elementów znajdujących się w głównym obszarze paska stanu wstążki.
int GetCount() const;
Wartość zwracana
Liczba elementów znajdujących się w głównym obszarze paska stanu wstążki.
CMFCRibbonStatusBar::GetElement
Zwraca wskaźnik do elementu, który znajduje się w określonym indeksie.
CMFCRibbonBaseElement* GetElement(int nIndex);
Parametry
nIndex
[in] Określa indeks zerowy elementu, który znajduje się w głównym obszarze kontrolki paska stanu.
Wartość zwracana
Wskaźnik do elementu, który znajduje się w określonym indeksie. WARTOŚĆ NULL, jeśli indeks jest ujemny lub przekracza liczbę elementów na pasku stanu.
Uwagi
CMFCRibbonStatusBar::GetExCount
Zwraca liczbę elementów znajdujących się w rozszerzonym obszarze paska stanu wstążki.
int GetExCount() const;
Wartość zwracana
Liczba elementów znajdujących się w rozszerzonym obszarze paska stanu wstążki.
CMFCRibbonStatusBar::GetExElement
Zwraca wskaźnik do elementu znajdującego się w określonym indeksie w rozszerzonym obszarze paska stanu wstążki. Obszar rozszerzony znajduje się po prawej stronie kontrolki paska stanu.
CMFCRibbonBaseElement* GetExElement(int nIndex);
Parametry
nIndex
[in] Określa indeks zerowy elementu, który znajduje się w rozszerzonym obszarze kontrolki paska stanu.
Wartość zwracana
Wskaźnik do elementu znajdującego się w określonym indeksie w rozszerzonym obszarze paska stanu wstążki. Wartość NULL, jeśli nIndex jest ujemna lub przekracza liczbę elementów w rozszerzonym obszarze paska stanu wstążki.
Uwagi
CMFCRibbonStatusBar::GetExtendedArea
Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.
virtual BOOL GetExtendedArea(CRect& rect) const;
Parametry
[in] Rect
Wartość zwracana
Uwagi
CMFCRibbonStatusBar::GetSpace
Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.
int GetSpace() const;
Wartość zwracana
Uwagi
CMFCRibbonStatusBar::IsBottomFrame
Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.
BOOL IsBottomFrame() const;
Wartość zwracana
Uwagi
CMFCRibbonStatusBar::IsExtendedElement
Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.
BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;
Parametry
[in] pElement
Wartość zwracana
Uwagi
CMFCRibbonStatusBar::IsInformationMode
Określa, czy tryb informacji jest włączony dla paska stanu wstążki.
BOOL IsInformationMode() const;
Wartość zwracana
WARTOŚĆ TRUE, jeśli pasek stanu może działać w trybie informacyjnym; w przeciwnym razie FAŁSZ.
Uwagi
W trybie informacji pasek stanu ukrywa wszystkie zwykłe okienka i wyświetla ciąg komunikatu.
CMFCRibbonStatusBar::OnDrawInformation
Wyświetla ciąg wyświetlany na pasku stanu wstążki po włączeniu trybu informacji.
virtual void OnDrawInformation(
CDC* pDC,
CString& strInfo,
CRect rectInfo);
Parametry
PDC
[in] Wskaźnik do kontekstu urządzenia.
strInfo
[in] Ciąg informacyjny.
rectInfo
[in] Prostokąt ograniczenia.
Uwagi
Zastąp tę metodę w klasie pochodnej, jeśli chcesz dostosować wygląd ciągu informacyjnego na pasku stanu. Użyj metody CMFCRibbonStatusBar::SetInformation, aby umieścić pasek stanu w trybie informacji. W tym trybie pasek stanu ukrywa wszystkie okienka i wyświetla ciąg informacji określony przez strInfo.
CMFCRibbonStatusBar::RecalcLayout
Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.
virtual void RecalcLayout();
Uwagi
CMFCRibbonStatusBar::RemoveAll
Usuwa wszystkie elementy z paska stanu wstążki.
void RemoveAll();
CMFCRibbonStatusBar::RemoveElement
Usuwa element, który ma określony identyfikator polecenia z paska stanu wstążki.
BOOL RemoveElement(UINT uiID);
Parametry
identyfikator uiID
[in] Identyfikator elementu do usunięcia z paska stanu.
Wartość zwracana
WARTOŚĆ TRUE, jeśli element z określonym identyfikatorem uiID zostanie usunięty. FAŁSZ w przeciwnym razie.
CMFCRibbonStatusBar::SetInformation
Włącza lub wyłącza tryb informacji dla paska stanu wstążki.
void SetInformation(LPCTSTR lpszInfo);
Parametry
lpszInfo
[in] Ciąg informacyjny.
Uwagi
Użyj tej metody, aby umieścić pasek stanu w trybie informacji. W tym trybie pasek stanu ukrywa wszystkie okienka i wyświetla ciąg informacji określony przez lpszInfo.
Gdy wartość lpszInfo ma wartość NULL, pasek stanu zostanie przywrócony do trybu regularnego.
Zobacz też
Wykres hierarchii
Klasy
Klasa CMFCRibbonBar
Klasa CMFCRibbonBaseElement
Klasa CMFCRibbonBar