Classe CMFCRibbonStatusBar
La CMFCRibbonStatusBar classe implementa un controllo barra di stato in grado di visualizzare gli elementi della barra multifunzione.
Sintassi
class CMFCRibbonStatusBar : public CMFCRibbonBar
Membri
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCRibbonStatusBar::AddDynamicElement | Aggiunge un elemento dinamico alla barra di stato della barra multifunzione. |
| CMFCRibbonStatusBar::AddElement | Aggiunge un nuovo elemento della barra multifunzione alla barra di stato della barra multifunzione. |
| CMFCRibbonStatusBar::AddExtendedElement | Aggiunge un elemento della barra multifunzione all'area estesa della barra di stato della barra multifunzione. |
| CMFCRibbonStatusBar::AddSeparator | Aggiunge un separatore alla barra di stato della barra multifunzione. |
| CMFCRibbonStatusBar::Create | Crea una barra di stato della barra multifunzione. |
| CMFCRibbonStatusBar::CreateEx | Crea una barra di stato della barra multifunzione con uno stile esteso. |
| CMFCRibbonStatusBar::FindByID | |
| CMFCRibbonStatusBar::FindElement | Restituisce un puntatore all'elemento con l'ID comando specificato. |
| CMFCRibbonStatusBar::GetCount | Restituisce il numero di elementi che si trovano nell'area principale della barra di stato della barra multifunzione. |
| CMFCRibbonStatusBar::GetElement | Restituisce un puntatore all'elemento che si trova in corrispondenza di un indice specificato. |
| CMFCRibbonStatusBar::GetExCount | Restituisce il numero di elementi che si trovano nell'area estesa della barra di stato della barra multifunzione. |
| CMFCRibbonStatusBar::GetExElement | Restituisce un puntatore all'elemento situato in corrispondenza dell'indice specificato nell'area estesa della barra di stato multifunzione. |
| CMFCRibbonStatusBar::GetExtendedArea | |
| CMFCRibbonStatusBar::GetSpace | |
| CMFCRibbonStatusBar::IsBottomFrame | |
| CMFCRibbonStatusBar::IsExtendedElement | |
| CMFCRibbonStatusBar::IsInformationMode | Determina se la modalità informazioni è abilitata per la barra di stato della barra multifunzione. |
| CMFCRibbonStatusBar::RecalcLayout | (sostituzioni )CMFCRibbonBar::RecalcLayout. |
| CMFCRibbonStatusBar::RemoveAll | Rimuove tutti gli elementi dalla barra di stato della barra multifunzione. |
| CMFCRibbonStatusBar::RemoveElement | Rimuove l'elemento con un ID comando specificato dalla barra di stato della barra multifunzione. |
| CMFCRibbonStatusBar::SetInformation | Abilita o disabilita la modalità informazioni per la barra di stato della barra multifunzione. |
Metodi protetti
| Nome | Descrizione |
|---|---|
| CMFCRibbonStatusBar::OnDrawInformation | Visualizza la stringa di informazioni visualizzata sulla barra di stato della barra multifunzione quando la modalità informazioni è abilitata. |
Osservazioni:
Gli utenti possono modificare la visibilità degli elementi della barra multifunzione su una barra di stato della barra multifunzione usando il menu di scelta rapida predefinito per la barra di stato della barra multifunzione. È possibile aggiungere o rimuovere elementi in modo dinamico.
Una barra di stato della barra multifunzione ha due aree: un'area principale e un'area estesa. L'area estesa viene visualizzata sul lato destro della barra di stato della barra multifunzione e viene visualizzata in un colore diverso rispetto all'area principale.
In genere, l'area principale della barra di stato visualizza le notifiche di stato e l'area estesa visualizza i controlli di visualizzazione. L'area estesa rimane visibile il più a lungo possibile quando l'utente ridimensiona la barra di stato della barra multifunzione.
Esempio
L'esempio seguente illustra come usare i vari metodi nella classe CMFCRibbonStatusBar . L'esempio mostra come aggiungere un nuovo elemento della barra multifunzione alla barra di stato della barra multifunzione, aggiungere un elemento della barra multifunzione all'area estesa della barra di stato della barra multifunzione, aggiungere un separatore e abilitare la modalità regolare per la barra di stato della barra multifunzione.
// 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);
Gerarchia di ereditarietà
Requisiti
Intestazione: afxribbonstatusbar.h
CMFCRibbonStatusBar::AddDynamicElement
Aggiunge un elemento dinamico alla barra di stato della barra multifunzione.
void AddDynamicElement(CMFCRibbonBaseElement* pElement);
Parametri
pElement
[in] Puntatore a un elemento dinamico.
Osservazioni:
A differenza degli elementi regolari, gli elementi dinamici non sono personalizzabili e il menu di personalizzazione della barra di stato non li visualizza.
CMFCRibbonStatusBar::AddElement
Aggiunge un nuovo elemento della barra multifunzione alla barra di stato della barra multifunzione.
void AddElement(
CMFCRibbonBaseElement* pElement,
LPCTSTR lpszLabel,
BOOL bIsVisible=TRUE);
Parametri
pElement
[in] Puntatore all'elemento aggiunto.
lpszLabel
[in] Etichetta di testo dell'elemento.
bIsVisible
[in] TRUE se si desidera aggiungere l'elemento come visibile, FALSE se si desidera aggiungere l'elemento come nascosto.
CMFCRibbonStatusBar::AddExtendedElement
Aggiunge un elemento della barra multifunzione all'area estesa della barra di stato della barra multifunzione.
void AddExtendedElement(
CMFCRibbonBaseElement* pElement,
LPCTSTR lpszLabel,
BOOL bIsVisible=TRUE);
Parametri
pElement
[in] Puntatore all'elemento aggiunto.
lpszLabel
[in] Etichetta di testo dell'elemento.
bIsVisible
[in] TRUE se si desidera aggiungere l'elemento come visibile, FALSE se si desidera aggiungere l'elemento come nascosto.
Osservazioni:
L'area estesa si trova a destra della barra di stato.
CMFCRibbonStatusBar::AddSeparator
Aggiunge un separatore alla barra di stato della barra multifunzione.
void AddSeparator();
Osservazioni:
Il framework aggiunge un separatore dopo il metodo CMFCRibbonStatusBar::AddElement. inserisce l'ultimo elemento.
CMFCRibbonStatusBar::Create
Crea una barra di stato della barra multifunzione.
BOOL Create(
CWnd* pParentWnd,
DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
UINT nID=AFX_IDW_STATUS_BAR);
Parametri
pParentWnd
[in] Puntatore alla finestra padre.
dwStyle
[in] Combinazione or logica di stili di controllo.
nID
[in] ID del controllo della barra di stato.
Valore restituito
TRUE se la barra di stato viene creata correttamente, FALSE in caso contrario.
CMFCRibbonStatusBar::CreateEx
Crea una barra di stato della barra multifunzione con uno stile esteso.
BOOL CreateEx(
CWnd* pParentWnd,
DWORD dwCtrlStyle=0,
DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
UINT nID=AFX_IDW_STATUS_BAR);
Parametri
pParentWnd
Puntatore alla finestra padre.
dwCtrlStyle
Combinazione or logica di stili aggiuntivi per la creazione dell'oggetto barra di stato.
dwStyle
Stile del controllo della barra di stato.
nID
ID del controllo della barra di stato.
Valore restituito
TRUE se la barra di stato viene creata correttamente, FALSE in caso contrario.
CMFCRibbonStatusBar::FindByID
Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.
CMFCRibbonBaseElement* FindByID(UINT uiCmdID, BOOL = TRUE);
Parametri
[in] uiCmdID
[in] BOOL
Valore restituito
Osservazioni:
CMFCRibbonStatusBar::FindElement
Restituisce un puntatore all'elemento con l'ID comando specificato.
CMFCRibbonBaseElement* FindElement(UINT uiID);
Parametri
uiID
[in] ID dell'elemento.
Valore restituito
Puntatore all'elemento con l'ID comando specificato. NULL se non è presente alcun elemento di questo tipo.
CMFCRibbonStatusBar::GetCount
Restituisce il numero di elementi che si trovano nell'area principale della barra di stato della barra multifunzione.
int GetCount() const;
Valore restituito
Numero di elementi che si trovano nell'area principale della barra di stato della barra multifunzione.
CMFCRibbonStatusBar::GetElement
Restituisce un puntatore all'elemento che si trova in corrispondenza di un indice specificato.
CMFCRibbonBaseElement* GetElement(int nIndex);
Parametri
nIndex
[in] Specifica un indice in base zero di un elemento che si trova nell'area principale del controllo barra di stato.
Valore restituito
Puntatore all'elemento che si trova in corrispondenza dell'indice specificato. NULL se l'indice è negativo o supera il numero di elementi nella barra di stato.
Osservazioni:
CMFCRibbonStatusBar::GetExCount
Restituisce il numero di elementi che si trovano nell'area estesa della barra di stato della barra multifunzione.
int GetExCount() const;
Valore restituito
Numero di elementi che si trovano nell'area estesa della barra di stato della barra multifunzione.
CMFCRibbonStatusBar::GetExElement
Restituisce un puntatore all'elemento situato in corrispondenza dell'indice specificato nell'area estesa della barra di stato multifunzione. L'area estesa si trova a destra della barra di stato.
CMFCRibbonBaseElement* GetExElement(int nIndex);
Parametri
nIndex
[in] Specifica l'indice in base zero di un elemento che si trova nell'area estesa del controllo barra di stato.
Valore restituito
Puntatore all'elemento situato in corrispondenza dell'indice specificato nell'area estesa della barra di stato multifunzione. NULL se nIndex è negativo o supera il numero di elementi nell'area estesa della barra di stato della barra multifunzione.
Osservazioni:
CMFCRibbonStatusBar::GetExtendedArea
Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.
virtual BOOL GetExtendedArea(CRect& rect) const;
Parametri
[in] rect
Valore restituito
Osservazioni:
CMFCRibbonStatusBar::GetSpace
Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.
int GetSpace() const;
Valore restituito
Osservazioni:
CMFCRibbonStatusBar::IsBottomFrame
Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.
BOOL IsBottomFrame() const;
Valore restituito
Osservazioni:
CMFCRibbonStatusBar::IsExtendedElement
Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.
BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;
Parametri
[in] pElement
Valore restituito
Osservazioni:
CMFCRibbonStatusBar::IsInformationMode
Determina se la modalità informazioni è abilitata per la barra di stato della barra multifunzione.
BOOL IsInformationMode() const;
Valore restituito
TRUE se la barra di stato può funzionare in modalità informazioni; in caso contrario FALSE.
Osservazioni:
In modalità informazioni, la barra di stato nasconde tutti i riquadri normali e visualizza una stringa di messaggio.
CMFCRibbonStatusBar::OnDrawInformation
Visualizza la stringa visualizzata sulla barra di stato della barra multifunzione quando la modalità informazioni è abilitata.
virtual void OnDrawInformation(
CDC* pDC,
CString& strInfo,
CRect rectInfo);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo.
strInfo
[in] Stringa di informazioni.
rectInfo
[in] Rettangolo di delimitazione.
Osservazioni:
Eseguire l'override di questo metodo in una classe derivata se si desidera personalizzare l'aspetto della stringa di informazioni sulla barra di stato. Usa il metodo CMFCRibbonStatusBar::SetInformation per inserire la barra di stato in modalità informazioni. In questa modalità, la barra di stato nasconde tutti i riquadri e visualizza la stringa di informazioni specificata da strInfo.
CMFCRibbonStatusBar::RecalcLayout
Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.
virtual void RecalcLayout();
Osservazioni:
CMFCRibbonStatusBar::RemoveAll
Rimuove tutti gli elementi dalla barra di stato della barra multifunzione.
void RemoveAll();
CMFCRibbonStatusBar::RemoveElement
Rimuove l'elemento con un ID comando specificato dalla barra di stato della barra multifunzione.
BOOL RemoveElement(UINT uiID);
Parametri
uiID
[in] ID dell'elemento da rimuovere dalla barra di stato.
Valore restituito
TRUE se viene rimosso un elemento con l'UIID specificato. FALSE in caso contrario.
CMFCRibbonStatusBar::SetInformation
Abilita o disabilita la modalità informazioni per la barra di stato della barra multifunzione.
void SetInformation(LPCTSTR lpszInfo);
Parametri
lpszInfo
[in] Stringa di informazioni.
Osservazioni:
Utilizzare questo metodo per inserire la barra di stato nella modalità informazioni. In questa modalità, la barra di stato nasconde tutti i riquadri e visualizza la stringa di informazioni specificata da lpszInfo.
Quando lpszInfo è NULL, la barra di stato torna alla modalità normale.
Vedi anche
Grafico della gerarchia
Classi
Classe CMFCRibbonBar
Classe CMFCRibbonBaseElement
Classe CMFCRibbonBar