CMFCRibbonStatusBarPane Class

A CMFCRibbonStatusBarPane classe implementa um elemento de fita que podes adicionar à barra de estado da fita.

Sintaxe

class CMFCRibbonStatusBarPane : public CMFCRibbonButton

Membros

Construtores Públicos

Métodos Públicos

Métodos Protegidos

Example

O exemplo seguinte demonstra como usar os vários métodos na CMFCRibbonStatusBarPane aula. O exemplo mostra como construir um CMFCRibbonStatusBarPane objeto, definir o alinhamento do texto do rótulo do painel da barra de estado, definir o texto mais longo que pode ser exibido no painel da barra de estado sem truncamento, anexar ao painel da barra de estado 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

Requerimentos

Cabeçalho: afxribbonstatusbarpane.h

CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane

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

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
[dentro] Especifica o ID do comando do painel.

lpszText
[dentro] Especifica que a cadeia de texto deve ser exibida no painel.

bIsStatic
[dentro] Se TRUE, o painel de estado não pode ser destacado nem selecionado clicando nele.

hIcon
[dentro] Especifica um handle para um ícone a ser exibido no painel.

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

hBmpAnimationList
[dentro] Especifica um handle para uma lista de imagens que é usada para animação.

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

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

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

CMFCRibbonStatusBarPane::GetAlmostLargeText

Obtém a cadeia de texto mais longa que o painel da barra de estado pode mostrar.

LPCTSTR GetAlmostLargeText() const;

Valor de retorno

A cadeia de texto mais longa que o painel da barra de estado pode mostrar.

CMFCRibbonStatusBarPane::GetTextAlign

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

int GetTextAlign() const;

Valor de retorno

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

• TA_LEFT

• TA_CENTER

• TA_RIGHT.

CMFCRibbonStatusBarPane::ÉAnimação

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

BOOL IsAnimation() const;

Valor de retorno

VERDADE se a animação estiver em progresso; FALSO, caso contrário.

CMFCRibbonStatusBarPane::IsExtended

Determine se o painel está localizado na área estendida da barra de estado da fita.

BOOL IsExtended() const;

Valor de retorno

VERDADE se o painel estiver na área estendida da barra de estado. FALSO, caso contrário.

CMFCRibbonStatusBarPane::OnDrawBorder

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

virtual void OnDrawBorder(CDC*);

Parâmetros

[dentro] CDC*

Observações

CMFCRibbonStatusBarPane::OnFillBackground

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

virtual COLORREF OnFillBackground(CDC* pDC);

Parâmetros

[dentro] pDC

Valor de retorno

Observações

CMFCRibbonStatusBarPane::OnFinishAnimation

Framework chama este método quando a animação atribuída ao painel termina.

virtual void OnFinishAnimation();

Observações

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

CMFCRibbonStatusBarPane::SetAlmostLargeText

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

void SetAlmostLargeText(LPCTSTR lpszAlmostLargeText);

Parâmetros

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

Observações

A biblioteca calcula o tamanho do texto que lpszAlmostLargeText especifica e redimensiona o painel em conformidade. O texto será truncado se ainda não caber no painel.

CMFCRibbonStatusBarPane::SetAnimationList

Anexa ao painel da barra de estado 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
[dentro] Especifica um handle para uma lista de imagens.

cxAnimation
[dentro] Especifica a largura, em pixels, do enquadramento na lista de imagens.

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

uiAnimationListResID
[dentro] Especifica o ID de recurso da lista de imagens.

Valor de retorno

TRUE se a lista de imagens estiver com sucesso anexada ao painel da barra de estado; FALSO, caso contrário.

CMFCRibbonStatusBarPane::SetTextAlign

Define o alinhamento do texto da etiqueta do painel da barra de estado.

void SetTextAlign(int nAlign);

Parâmetros

nAlign
[dentro] Especifica o alinhamento do texto.

Observações

O nAlign pode ter um dos seguintes valores:

• TA_LEFT: alinhamento à esquerda

• TA_CENTER: alinhamento central

• TA_RIGHT: alinhamento à direita

CMFCRibbonStatusBarPane::StartAnimation

Inicia a animação que atribuis ao painel.

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

Parâmetros

nFrameDelay
[dentro] Especifica a taxa de fotogramas da animação, em milissegundos.

nDuração
[dentro] Especifica quanto tempo se deve reproduzir a animação, em milissegundos. Usa -1 para um loop infinito.

Observações

Deve especificar um handle para uma lista de imagens antes de chamar StartAnimation usando SetAnimationList.

CMFCRibbonStatusBarPane::StopAnimation

Para a animação que atribuíste ao painel da barra de estado.

void StopAnimation();

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCRibbonButton
CMFCRibbonStatusBar Class