CMFCRibbonStatusBar Class

Artigo
10/12/2023

A classe CMFCRibbonStatusBar implementa um controle de barra de status que pode exibir elementos da faixa de opções.

Sintaxe

class CMFCRibbonStatusBar : public CMFCRibbonBar

Membros

Métodos públicos

Nome	Descrição
CMFCRibbonStatusBar::AddDynamicElement	Adiciona um elemento dinâmico à barra de status da faixa de opções.
CMFCRibbonStatusBar::AddElement	Adiciona um novo elemento de faixa de opções à barra de status da faixa de opções.
CMFCRibbonStatusBar::AddExtendedElement	Adiciona um elemento de faixa de opções à área estendida da barra de status da faixa de opções.
CMFCRibbonStatusBar::AddSeparator	Adiciona um separador à barra de status da faixa de opções.
CMFCRibbonStatusBar::Create	Cria uma barra de status da faixa de opções.
CMFCRibbonStatusBar::CreateEx	Cria uma barra de status da faixa de opções com um estilo estendido.
CMFCRibbonStatusBar::FindByID
CMFCRibbonStatusBar::FindElement	Retorna um ponteiro para o elemento que tem a ID de comando especificada.
CMFCRibbonStatusBar::GetCount	Retorna o número de elementos localizados na área principal da barra de status da faixa de opções.
CMFCRibbonStatusBar::GetElement	Retorna um ponteiro para o elemento localizado em um índice especificado.
CMFCRibbonStatusBar::GetExCount	Retorna o número de elementos localizados na área estendida da barra de status da faixa de opções.
CMFCRibbonStatusBar::GetExElement	Retorna um ponteiro para o elemento que está localizado em um índice especificado na área estendida da barra de status da faixa de opções.
CMFCRibbonStatusBar::GetExtendedArea
CMFCRibbonStatusBar::GetSpace
CMFCRibbonStatusBar::IsBottomFrame
CMFCRibbonStatusBar::IsExtendedElement
CMFCRibbonStatusBar::IsInformationMode	Determina se o modo de informação está habilitado para a barra de status da faixa de opções.
CMFCRibbonStatusBar::RecalcLayout	(Substitui CMFCRibbonBar::RecalcLayout.)
CMFCRibbonStatusBar::RemoveAll	Remove todos os elementos da barra de status da faixa de opções.
CMFCRibbonStatusBar::RemoveElement	Remove o elemento que tem uma ID de comando especificada da barra de status da faixa de opções.
CMFCRibbonStatusBar::SetInformation	Habilita ou desabilita o modo de informações para a barra de status da faixa de opções.

Métodos protegidos

Nome	Descrição
CMFCRibbonStatusBar::OnDrawInformation	Exibe a cadeia de caracteres de informações que aparece na barra de status da faixa de opções quando o modo de informações está habilitado.

Comentários

Os usuários podem alterar a visibilidade dos elementos da faixa de opções em uma barra de status da faixa de opções usando o menu de contexto interno para a barra de status da faixa de opções. Você pode adicionar ou remover elementos dinamicamente.

Uma barra de status da faixa de opções tem duas áreas: uma principal e uma estendida. A área estendida é exibida ao lado direito da barra de status da faixa de opções e aparece em uma cor diferente da área principal.

Normalmente, a área principal da barra de status exibe notificações de status e a área estendida exibe controles de exibição. A área estendida permanece visível o maior tempo possível quando o usuário redimensiona a barra de status da faixa de opções.

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe CMFCRibbonStatusBar. O exemplo mostra como adicionar um novo elemento de faixa de opções à barra de status da faixa de opções, adicionar um elemento de faixa de opções à área estendida da barra de status da faixa de opções, adicionar um separador e habilitar o modo regular para a barra de status da faixa de opções.

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

Requisitos

Cabeçalho: afxribbonstatusbar.h

CMFCRibbonStatusBar::AddDynamicElement

Adiciona um elemento dinâmico à barra de status da faixa de opções.

void AddDynamicElement(CMFCRibbonBaseElement* pElement);

Parâmetros

pElement
[in] Um ponteiro para um elemento dinâmico.

Comentários

Ao contrário dos elementos regulares, os elementos dinâmicos não são personalizáveis e o menu personalizado da barra de status não os exibe.

CMFCRibbonStatusBar::AddElement

Adiciona um novo elemento de faixa de opções à barra de status da faixa de opções.

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

Parâmetros

pElement
[in] Um ponteiro para o elemento adicionado.

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

bIsVisible
[in] TRUE se você desejar adicionar o elemento como visível, FALSE se desejar adicionar o elemento como oculto.

CMFCRibbonStatusBar::AddExtendedElement

Adiciona um elemento de faixa de opções à área estendida da barra de status da faixa de opções.

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

Parâmetros

pElement
[in] Um ponteiro para o elemento adicionado.

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

bIsVisible
[in] TRUE se você desejar adicionar o elemento como visível, FALSE se desejar adicionar o elemento como oculto.

Comentários

A área estendida está do lado direito do controle da barra de status.

CMFCRibbonStatusBar::AddSeparator

Adiciona um separador à barra de status da faixa de opções.

void AddSeparator();

Comentários

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

CMFCRibbonStatusBar::Create

Cria uma barra de status da faixa de opções.

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

Parâmetros

pParentWnd
[in] Um ponteiro para a janela pai.

dwStyle
[in] Uma combinação ou lógica de estilos de controle.

Nid
[in] A ID de controle da barra de status.

Valor de retorno

TRUE se a barra de status for criada com êxito. Caso contrário, FALSE.

CMFCRibbonStatusBar::CreateEx

Cria uma barra de status da faixa de opções que tem 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 ponteiro para a janela pai.

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

dwStyle
O estilo de controle da barra de status.

Nid
A ID de controle da barra de status.

Valor de retorno

TRUE se a barra de status for criada com êxito. Caso contrário, FALSE.

CMFCRibbonStatusBar::FindByID

Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

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

Parâmetros

[in] uiCmdID
[in] BOOL

Valor de retorno

Comentários

CMFCRibbonStatusBar::FindElement

Retorna um ponteiro para o elemento que tem a ID de comando especificada.

CMFCRibbonBaseElement* FindElement(UINT uiID);

Parâmetros

uiID
[in] A ID do elemento.

Valor de retorno

Um ponteiro para o elemento que tem a ID de comando especificada. NULL se não houver esse elemento.

CMFCRibbonStatusBar::GetCount

Retorna o número de elementos localizados na área principal da barra de status da faixa de opções.

int GetCount() const;

Valor de retorno

O número de elementos localizados na área principal da barra de status da faixa de opções.

CMFCRibbonStatusBar::GetElement

Retorna um ponteiro para o elemento localizado em um índice especificado.

CMFCRibbonBaseElement* GetElement(int nIndex);

Parâmetros

nIndex
[in] Especifica um índice baseado em zero de um elemento que está localizado na área principal do controle da barra de status.

Valor de retorno

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

Comentários

CMFCRibbonStatusBar::GetExCount

Retorna o número de elementos localizados na área estendida da barra de status da faixa de opções.

int GetExCount() const;

Valor de retorno

O número de elementos localizados na área estendida da barra de status da faixa de opções.

CMFCRibbonStatusBar::GetExElement

Retorna um ponteiro para o elemento que está localizado em um índice especificado na área estendida da barra de status da faixa de opções. A área estendida está do lado direito do controle da barra de status.

CMFCRibbonBaseElement* GetExElement(int nIndex);

Parâmetros

nIndex
[in] Especifica o índice baseado em zero de um elemento que está localizado na área estendida do controle da barra de status.

Valor de retorno

Um ponteiro para o elemento que está localizado em um índice especificado na área estendida da barra de status da faixa de opções. NULL se nIndex for negativo ou exceder o número de elementos na área estendida da barra de status da faixa de opções.

Comentários

CMFCRibbonStatusBar::GetExtendedArea

Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

virtual BOOL GetExtendedArea(CRect& rect) const;

Parâmetros

[in] rect

Valor de retorno

Comentários

CMFCRibbonStatusBar::GetSpace

Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

int GetSpace() const;

Valor de retorno

Comentários

CMFCRibbonStatusBar::IsBottomFrame

Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

BOOL IsBottomFrame() const;

Valor de retorno

Comentários

CMFCRibbonStatusBar::IsExtendedElement

Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;

Parâmetros

[in] pElement

Valor de retorno

Comentários

CMFCRibbonStatusBar::IsInformationMode

Determina se o modo de informação está habilitado para a barra de status da faixa de opções.

BOOL IsInformationMode() const;

Valor de retorno

TRUE se a barra de status pode funcionar no modo de informação. Caso contrário, FALSE.

Comentários

No modo de informação, a barra de status oculta todos os painéis regulares e exibe uma cadeia de caracteres de mensagem.

CMFCRibbonStatusBar::OnDrawInformation

Exibe a cadeia de caracteres que aparece na barra de status da faixa de opções quando o modo de informações está habilitado.

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

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

strInfo
[in] A cadeia de caracteres de informações.

rectInfo
[in] O retângulo delimitador.

Comentários

Substitua esse método em uma classe derivada se você quiser personalizar a aparência da cadeia de caracteres de informações na barra de status. Use o método CMFCRibbonStatusBar::SetInformation para colocar a barra de status no modo de informação. Nesse modo, a barra de status oculta todos os painéis e exibe a cadeia de caracteres de informações especificada por strInfo.

CMFCRibbonStatusBar::RecalcLayout

Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

virtual void RecalcLayout();

Comentários

CMFCRibbonStatusBar::RemoveAll

Remove todos os elementos da barra de status da faixa de opções.

void RemoveAll();

CMFCRibbonStatusBar::RemoveElement

Remove o elemento que tem uma ID de comando especificada da barra de status da faixa de opções.

BOOL RemoveElement(UINT uiID);

Parâmetros

uiID
[in] A ID do elemento a ser removido da barra de status.

Valor de retorno

TRUE se um elemento com a uiID especificada for removido. Caso contrário, FALSE.

CMFCRibbonStatusBar::SetInformation

Habilita ou desabilita o modo de informações para a barra de status da faixa de opções.

void SetInformation(LPCTSTR lpszInfo);

Parâmetros

lpszInfo
[in] A cadeia de caracteres de informações.

Comentários

Use esse método para colocar a barra de status no modo de informações. Nesse modo, a barra de status oculta todos os painéis e exibe a cadeia de caracteres de informações especificada por lpszInfo.

Quando lpszInfo for NULL, a barra de status será revertida para o modo regular.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCRibbonBar
Classe CMFCRibbonBaseElement
Classe CMFCRibbonBar

Compartilhar via

CMFCRibbonStatusBar Class

Sintaxe

Membros

Métodos públicos

Métodos protegidos

Comentários

Exemplo

Hierarquia de herança

Requisitos

CMFCRibbonStatusBar::AddDynamicElement

Parâmetros

Comentários

CMFCRibbonStatusBar::AddElement

Parâmetros

CMFCRibbonStatusBar::AddExtendedElement

Parâmetros

Comentários

CMFCRibbonStatusBar::AddSeparator

Comentários

CMFCRibbonStatusBar::Create

Parâmetros

Valor de retorno

CMFCRibbonStatusBar::CreateEx

Parâmetros

Valor de retorno

CMFCRibbonStatusBar::FindByID

Parâmetros

Valor de retorno

Comentários

CMFCRibbonStatusBar::FindElement

Parâmetros

Valor de retorno

CMFCRibbonStatusBar::GetCount

Valor de retorno

CMFCRibbonStatusBar::GetElement

Parâmetros

Valor de retorno

Comentários

CMFCRibbonStatusBar::GetExCount

Valor de retorno

CMFCRibbonStatusBar::GetExElement

Parâmetros

Valor de retorno

Comentários

CMFCRibbonStatusBar::GetExtendedArea

Parâmetros

Valor de retorno

Comentários

CMFCRibbonStatusBar::GetSpace

Valor de retorno

Comentários

CMFCRibbonStatusBar::IsBottomFrame

Valor de retorno

Comentários

CMFCRibbonStatusBar::IsExtendedElement

Parâmetros

Valor de retorno

Comentários

CMFCRibbonStatusBar::IsInformationMode

Valor de retorno

Comentários

CMFCRibbonStatusBar::OnDrawInformation

Parâmetros

Comentários

CMFCRibbonStatusBar::RecalcLayout

Comentários

CMFCRibbonStatusBar::RemoveAll

CMFCRibbonStatusBar::RemoveElement

Parâmetros

Valor de retorno

CMFCRibbonStatusBar::SetInformation

Parâmetros

Comentários

Confira também

Comentários

Recursos adicionais