CMFCRibbonStatusBar Class

A CMFCRibbonStatusBar classe implementa um controlo de barra de estado que pode mostrar elementos de fita.

Sintaxe

class CMFCRibbonStatusBar : public CMFCRibbonBar

Membros

Métodos Públicos

Métodos Protegidos

Observações

Os utilizadores podem alterar a visibilidade dos elementos da fita numa barra de estado da fita usando o menu contextual incorporado para a barra de estado da fita. Podes adicionar ou remover elementos dinamicamente.

Uma barra de estatuto de fita tem duas áreas: uma área principal e uma área alargada. A área estendida é exibida no lado direito da barra de estado da fita e aparece numa cor diferente da área principal.

Normalmente, a área principal da barra de estado mostra notificações de estado e a área estendida mostra os controlos de visualização. A área estendida permanece visível o máximo de tempo possível quando o utilizador redimensiona a barra de estado da fita.

Example

O exemplo seguinte demonstra como usar vários métodos na CMFCRibbonStatusBar aula. O exemplo mostra como adicionar um novo elemento de fita à barra de estado da fita, adicionar um elemento de fita à área estendida da barra de estado da fita, adicionar um separador e ativar o modo normal para a barra de estado da fita.

// 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);

Hierarquia de herança

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCRibbonBar

CMFCRibbonStatusBar

Requerimentos

Cabeçalho: afxribbonstatusbar.h

CMFCRibbonStatusBar::AddDynamicElement

Adiciona um elemento dinâmico à barra de estado da fita.

void AddDynamicElement(CMFCRibbonBaseElement* pElement);

Parâmetros

pElement
[dentro] Um apontador para um elemento dinâmico.

Observações

Ao contrário dos elementos normais, os elementos dinâmicos não são personalizáveis e o menu de personalização da barra de estado não os apresenta.

CMFCRibbonStatusBar::AddElement

Adiciona um novo elemento de fita à barra de estado da fita.

void AddElement(
    CMFCRibbonBaseElement* pElement,
    LPCTSTR lpszLabel,
    BOOL bIsVisible=TRUE);

Parâmetros

pElement
[dentro] Um apontador para o elemento adicional.

lpszLabel
[dentro] Um rótulo de texto do elemento.

bIsVisible
[dentro] TRUE se quiseres adicionar o elemento como visível, FALSE se quiseres adicionar o elemento como oculto.

CMFCRibbonStatusBar::AddExtendedElement

Adiciona um elemento de fita à área estendida da barra de estado da fita.

void AddExtendedElement(
    CMFCRibbonBaseElement* pElement,
    LPCTSTR lpszLabel,
    BOOL bIsVisible=TRUE);

Parâmetros

pElement
[dentro] Um apontador para o elemento adicional.

lpszLabel
[dentro] O rótulo de texto do elemento.

bIsVisible
[dentro] TRUE se quiseres adicionar o elemento como visível, FALSE se quiseres adicionar o elemento como oculto.

Observações

A área estendida está do lado direito do controlo da barra de estado.

CMFCRibbonStatusBar::AddSeparator

Adiciona um separador à barra de estado da fita.

void AddSeparator();

Observações

A estrutura adiciona um separador após o método CMFCRibbonStatusBar::AddElement. insere o último elemento.

CMFCRibbonStatusBar::Create

Cria uma barra de estado de fita.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
    UINT nID=AFX_IDW_STATUS_BAR);

Parâmetros

pParentWnd
[dentro] Um apontador para a janela principal.

dwStyle
[dentro] Uma combinação lógica de OR de estilos de controlo.

nID
[dentro] O ID de controlo da barra de estado.

Valor de retorno

TRUE se a barra de estado for criada com sucesso, FALSE caso contrário.

CMFCRibbonStatusBar::CreateEx

Cria uma barra de estado de fita com um estilo estendido.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=0,
    DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
    UINT nID=AFX_IDW_STATUS_BAR);

Parâmetros

pParentWnd
Um apontador para a janela principal.

dwCtrlStyle
Uma combinação lógica de OR de estilos adicionais para criar o objeto da barra de estado.

dwStyle
O estilo de controlo da barra de estado.

nID
O ID de controlo da barra de estado.

Valor de retorno

TRUE se a barra de estado for criada com sucesso, FALSE caso contrário.

CMFCRibbonStatusBar::FindByID

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

CMFCRibbonBaseElement* FindByID(UINT uiCmdID, BOOL = TRUE);

Parâmetros

[dentro] uiCmdID
[dentro] BOOL

Valor de retorno

Observações

CMFCRibbonStatusBar::FindElement

Devolve um ponteiro para o elemento que tem o ID de comando especificado.

CMFCRibbonBaseElement* FindElement(UINT uiID);

Parâmetros

uiID
[dentro] O ID do elemento.

Valor de retorno

Um apontador para o elemento que tem o ID de comando especificado. NULL se não existir tal elemento.

CMFCRibbonStatusBar::GetCount

Devolve o número de elementos localizados na área principal da barra de estado da fita.

int GetCount() const;

Valor de retorno

O número de elementos localizados na área principal da barra de estado da fita.

CMFCRibbonStatusBar::GetElement

Devolve um ponteiro para o elemento que está localizado num índice especificado.

CMFCRibbonBaseElement* GetElement(int nIndex);

Parâmetros

nIndex
[dentro] Especifica um índice baseado em zero de um elemento localizado na área principal do controlo da barra de estado.

Valor de retorno

Um apontador para o elemento localizado no índice especificado. NULL se o índice for negativo ou exceder o número de elementos na barra de estado.

Observações

CMFCRibbonStatusBar::GetExCount

Devolve o número de elementos localizados na área estendida da barra de estado da fita.

int GetExCount() const;

Valor de retorno

O número de elementos localizados na área estendida da barra de estado da fita.

CMFCRibbonStatusBar::GetExElement

Devolve um ponteiro para o elemento que está localizado num índice especificado na área estendida da barra de estado da fita. A área estendida está do lado direito do controlo da barra de estado.

CMFCRibbonBaseElement* GetExElement(int nIndex);

Parâmetros

nIndex
[dentro] Especifica o índice baseado em zero de um elemento localizado na área estendida do controlo da barra de estado.

Valor de retorno

Um apontador para o elemento que está localizado num índice especificado na área estendida da barra de estado da fita. NULL se nIndex for negativo ou exceder o número de elementos na área estendida da barra de estado da fita.

Observações

CMFCRibbonStatusBar::GetExtendedArea

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

virtual BOOL GetExtendedArea(CRect& rect) const;

Parâmetros

[dentro] Rect

Valor de retorno

Observações

CMFCRibbonStatusBar::GetSpace

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

int GetSpace() const;

Valor de retorno

Observações

CMFCRibbonStatusBar::IsBottomFrame

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

BOOL IsBottomFrame() const;

Valor de retorno

Observações

CMFCRibbonStatusBar::IsExtendedElement

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;

Parâmetros

[dentro] pElement

Valor de retorno

Observações

CMFCRibbonStatusBar::IsInformationMode

Determina se o modo de informação está ativado para a barra de estado da fita.

BOOL IsInformationMode() const;

Valor de retorno

TRUE se a barra de estado puder funcionar em modo de informação; caso contrário, FALSO.

Observações

No modo de informação, a barra de estado esconde todos os painéis normais e apresenta uma cadeia de mensagens.

CMFCRibbonStatusBar::OnDrawInformation

Mostra a cadeia que aparece na barra de estado da fita quando o modo de informação está ativado.

virtual void OnDrawInformation(
    CDC* pDC,
    CString& strInfo,
    CRect rectInfo);

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

strInfo
[dentro] A cadeia de informação.

rectInfo
[dentro] O retângulo delimitador.

Observações

Substitua este método numa classe derivada se quiser personalizar a aparência da cadeia de informação na barra de estado. Use o método CMFCRibbonStatusBar::SetInformation para colocar a barra de estado em modo de informação. Neste modo, a barra de estado esconde todos os painéis e mostra a cadeia de informação especificada pelo strInfo.

CMFCRibbonStatusBar::RecalcLayout

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

virtual void RecalcLayout();

Observações

CMFCRibbonStatusBar::RemoveAll

Remove todos os elementos da barra de estado da fita.

void RemoveAll();

CMFCRibbonStatusBar::RemoveElement

Remove o elemento que tem um ID de comando especificado da barra de estado da fita.

BOOL RemoveElement(UINT uiID);

Parâmetros

uiID
[dentro] O ID do elemento a remover da barra de estado.

Valor de retorno

TRUE se um elemento com o uiID especificado for removido. FALSO, caso contrário.

CMFCRibbonStatusBar::SetInformation

Ativa ou desativa o modo de informação da barra de estado da fita.

void SetInformation(LPCTSTR lpszInfo);

Parâmetros

lpszInfo
[dentro] A cadeia de informação.

Observações

Use este método para colocar a barra de estado no modo de informação. Neste modo, a barra de estado esconde todos os painéis e apresenta a cadeia de informação especificada pelo lpszInfo.

Quando o lpszInfo está NULL, a barra de estado volta ao modo normal.

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCRibbonBar
Classe CMFCRibbonBaseElement
Classe CMFCRibbonBar