Classe CMFCRibbonStatusBarPane

A classe CMFCRibbonStatusBarPane implementa um elemento de faixa de opções que você pode adicionar a uma barra de status da faixa de opções.

Sintaxe

class CMFCRibbonStatusBarPane : public CMFCRibbonButton

Membros

Construtores públicos

Métodos públicos

Métodos protegidos

Exemplo

O exemplo a seguir demonstra como usar os diversos métodos na classe CMFCRibbonStatusBarPane. O exemplo mostra como construir um objeto CMFCRibbonStatusBarPane, definir o alinhamento de texto do rótulo do painel da barra de status, definir o texto mais longo que pode ser exibido no painel da barra de status sem truncamento, anexar ao painel da barras de status uma lista de imagens que pode ser usada para animação e iniciar a animação.

CString strTitlePane1;
CString strTitlePane2;
strTitlePane1.LoadString(IDS_STATUS_PANE1);
strTitlePane2.LoadString(IDS_STATUS_PANE2);

CMFCRibbonStatusBarPane* rsbp = new CMFCRibbonStatusBarPane( ID_STATUSBAR_PANE1, strTitlePane1, TRUE );
rsbp->SetTextAlign( TA_CENTER );
rsbp->SetAlmostLargeText( _T( "Status bar" ) );
CBitmap bitmap;
bitmap.LoadBitmapW( IDB_FILESMALL );
rsbp->SetAnimationList( (HBITMAP)bitmap );
rsbp->StartAnimation();

Hierarquia de herança

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonStatusBarPane

Requisitos

Cabeçalho: afxribbonstatusbarpane.h

CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane

Constrói um objeto de painel na barra de status.

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    BOOL bIsStatic=FALSE,
    HICON hIcon=NULL,
    LPCTSTR lpszAlmostLargeText=NULL);

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    HBITMAP hBmpAnimationList,
    int cxAnimation=16,
    COLORREF clrTrnsp=RGB(192,192 1,192) 1,
    HICON hIcon=NULL,
    BOOL bIsStatic=FALSE);

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    UINT uiAnimationListResID,
    int cxAnimation=16,
    COLORREF clrTrnsp=RGB(192, 192 1, 192) 1,
    HICON hIcon=NULL,
    BOOL bIsStatic=FALSE);

Parâmetros

nCmdID
[in] Especifica a ID de comando do painel.

lpszTexto
[in] Especifica a cadeia de caracteres de texto a ser exibida no painel.

bIsStatic
[in] Se TRUE, o painel de status não poderá ser realçado ou selecionado quando se clica nele.

hIcon
[in] Especifica um identificador para um ícone a ser exibido no painel.

lpszAlmostLargeText
[in] Especifica a cadeia de caracteres de texto mais longa que pode ser exibida pelo painel.

hBmpAnimationList
[in] Especifica um identificador para uma lista de imagens usada para animação.

cxAnimation
[in] Especifica a largura, em pixels, do ícone na lista de imagens usada para animação.

clrTrnsp
[in] Especifica a cor transparente das imagens na lista de imagens usadas para animação.

uiAnimationListResID
[in] Especifica uma ID de recurso de uma lista de imagens usada para animação.

CMFCRibbonStatusBarPane::GetAlmostLargeText

Obtém a cadeia de caracteres de texto mais longa que o painel da barras de status pode exibir.

LPCTSTR GetAlmostLargeText() const;

Valor de retorno

A cadeia de caracteres de texto mais longa que o painel da barras de status pode exibir.

CMFCRibbonStatusBarPane::GetTextAlign

Obtém a configuração atual do alinhamento de texto do rótulo do painel da barra de status.

int GetTextAlign() const;

Valor de retorno

O alinhamento de texto atual, que pode ser um dos seguintes:

• TA_LEFT

• TA_CENTER

• TA_RIGHT.

CMFCRibbonStatusBarPane::IsAnimation

Determina se a animação está em andamento.

BOOL IsAnimation() const;

Valor de retorno

TRUE se a animação estiver em andamento; caso contrário, FALSE.

CMFCRibbonStatusBarPane::IsExtended

Determina se o painel está localizado na área estendida da barra de status da faixa de opções.

BOOL IsExtended() const;

Valor de retorno

TRUE se o painel estiver na área estendida da barra de status. Caso contrário, FALSE.

CMFCRibbonStatusBarPane::OnDrawBorder

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 OnDrawBorder(CDC*);

Parâmetros

[in] CDC*

Comentários

CMFCRibbonStatusBarPane::OnFillBackground

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

virtual COLORREF OnFillBackground(CDC* pDC);

Parâmetros

[in] pDC

Valor de retorno

Comentários

CMFCRibbonStatusBarPane::OnFinishAnimation

A estrutura chama esse método quando a animação atribuída ao painel termina.

virtual void OnFinishAnimation();

Comentários

O método StopAnimation chama o método OnFinishAnimation, que você pode usar para limpar dados quando a animação termina.

CMFCRibbonStatusBarPane::SetAlmostLargeText

Define o texto mais longo que pode ser exibido no painel da barra de status sem truncamento.

void SetAlmostLargeText(LPCTSTR lpszAlmostLargeText);

Parâmetros

lpszAlmostLargeText
[in] Especifica a cadeia de caracteres mais longa que pode ser exibida no painel da barra de status sem truncamento.

Comentários

A biblioteca calcula o tamanho do texto que lpszAlmostLargeText especifica e redimensiona o painel de forma adequada. O texto será truncado se ainda não couber no painel.

CMFCRibbonStatusBarPane::SetAnimationList

Anexa ao painel da barras de status uma lista de imagens que pode ser usada para animação.

void SetAnimationList(
    HBITMAP hBmpAnimationList,
    int cxAnimation=16,
    COLORREF clrTransp=RGB(192, 192 1, 192) 1);

BOOL SetAnimationList(
    UINT uiAnimationListResID,
    int cxAnimation=16,
    COLORREF clrTransp=RGB(192, 192 1, 192) 1);

Parâmetros

hBmpAnimationList
[in] Especifica um identificador para uma lista de imagens.

cxAnimation
[in] Especifica a largura, em pixels, do quadro na lista de imagens.

clrTransp
[in] Especifica a cor transparente da lista de imagens.

uiAnimationListResID
[in] Especifica a ID do recurso da lista de imagens.

Valor de retorno

TRUE se a lista de imagens for anexada com êxito ao painel da barra de status; caso contrário, FALSE.

CMFCRibbonStatusBarPane::SetTextAlign

Define o alinhamento de texto do rótulo do painel da barras de status.

void SetTextAlign(int nAlign);

Parâmetros

nAlign
[in] Especifica o alinhamento do texto.

Comentários

O nAlign pode ter um dos seguintes valores:

• TA_LEFT: alinhamento à esquerda

• TA_CENTER: alinhamento ao centro

• TA_RIGHT: alinhamento à direita

CMFCRibbonStatusBarPane::StartAnimation

Inicia a animação que você atribui ao painel.

void StartAnimation(
    UINT nFrameDelay=500,
    UINT nDuration=-1);

Parâmetros

nFrameDelay
[in] Especifica a taxa de quadros de animação, em milissegundos.

nDuration
[in] Especifica por quanto tempo executar a animação, em milissegundos. Use -1 para um loop infinito.

Comentários

Você deve especificar um identificador para uma lista de imagens antes de chamar StartAnimation usando SetAnimationList.

CMFCRibbonStatusBarPane::StopAnimation

Interrompe a animação atribuída ao painel da barras de status.

void StopAnimation();

Confira também

Gráfico da hierarquia
Classes
Classe CMFCRibbonButton
Classe CMFCRibbonStatusBar