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
| Nome | Descrição |
|---|---|
| CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane | Constrói e inicializa um objeto CMFCRibbonStatusBarPane. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CMFCRibbonStatusBarPane::GetAlmostLargeText | Retorna a cadeia de caracteres que define a cadeia de caracteres de texto mais longa que pode ser exibida no painel sem truncamento. |
| CMFCRibbonStatusBarPane::GetTextAlign | Retorna a configuração atual de alinhamento do texto. |
| CMFCRibbonStatusBarPane::IsAnimation | Determina se a animação está em andamento. |
| CMFCRibbonStatusBarPane::IsExtended | Determina se o painel está localizado na área estendida da barra de status da faixa de opções. |
| CMFCRibbonStatusBarPane::OnDrawBorder | (Substitui CMFCRibbonButton::OnDrawBorder.) |
| CMFCRibbonStatusBarPane::OnFillBackground | (Substitui CMFCRibbonButton::OnFillBackground.) |
| CMFCRibbonStatusBarPane::SetAlmostLargeText | Define a cadeia de caracteres de texto mais longa que pode ser exibida no painel sem truncamento. |
| CMFCRibbonStatusBarPane::SetAnimationList | Atribui ao painel uma lista de imagens que pode ser usada para animação. |
| CMFCRibbonStatusBarPane::SetTextAlign | Define o alinhamento do texto. |
| CMFCRibbonStatusBarPane::StartAnimation | Inicia a animação atribuída ao painel. |
| CMFCRibbonStatusBarPane::StopAnimation | Interrompe a animação atribuída ao painel. . |
Métodos protegidos
| Nome | Descrição |
|---|---|
| CMFCRibbonStatusBarPane::OnFinishAnimation | Chamado pela estrutura quando a animação atribuída ao painel é interrompida. |
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
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários