Classe CMFCRibbonProgressBar
Implementa um controle que indica visualmente o progresso de uma operação demorada.
Sintaxe
class CMFCRibbonProgressBar : public CMFCRibbonBaseElement
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CMFCRibbonProgressBar::CMFCRibbonProgressBar | Constrói e inicializa um objeto CMFCRibbonProgressBar. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CMFCRibbonProgressBar::GetPos | Retorna o progresso atual. |
| CMFCRibbonProgressBar::GetRangeMax | Retorna o valor máximo do intervalo atual. |
| CMFCRibbonProgressBar::GetRangeMin | Retorna o valor mínimo do intervalo atual. |
| CMFCRibbonProgressBar::GetRegularSize | Retorna o tamanho regular do elemento da faixa de opções. (Substitui CMFCRibbonBaseElement::GetRegularSize.) |
| CMFCRibbonProgressBar::IsInfiniteMode | Especifica se a barra de progresso está funcionando no modo infinito. |
| CMFCRibbonProgressBar::OnDraw | Chamado pela estrutura para desenhar o elemento da faixa de opções. (Substitui CMFCRibbonBaseElement::OnDraw.) |
| CMFCRibbonProgressBar::SetInfiniteMode | Define a barra de progresso para funcionar no modo infinito. |
| CMFCRibbonProgressBar::SetPos | Define o progresso atual. |
| CMFCRibbonProgressBar::SetRange | Define os valores mínimo e máximo. |
Comentários
Uma CMFCRibbonProgressBar pode operar em dois modos: regular e infinito. No modo regular, a barra de progresso é preenchida da esquerda para a direita e para quando atinge o valor máximo. No modo infinito, a barra de progresso é preenchida repetidamente do valor mínimo para o valor máximo. Você pode usar o modo infinito para indicar que uma operação está em andamento, mas que o tempo de conclusão é desconhecido.
Exemplo
O exemplo a seguir demonstra como usar vários métodos na classe CMFCRibbonProgressBar. O exemplo mostra como definir a barra de progresso para funcionar no modo infinito (em que o tempo de conclusão de uma operação é desconhecido), os valores mínimo e máximo para a barra de progresso e a posição atual da barra de progresso. Este snippet de código faz parte do exemplo de Demonstração do MS Office 2007.
// int cxProgress
// BOOL m_bInfiniteProgressMode
CMFCRibbonProgressBar *pProgressBar = new CMFCRibbonProgressBar(ID_STATUSBAR_PROGRESS, cxProgress);
pProgressBar->SetInfiniteMode(m_bInfiniteProgressMode);
pProgressBar->SetRange(0, 200);
pProgressBar->SetPos(200, true);
Hierarquia de herança
Requisitos
Cabeçalho: afxRibbonProgressBar.h
CMFCRibbonProgressBar::CMFCRibbonProgressBar
Constrói e inicializa um objeto CMFCRibbonProgressBar.
CMFCRibbonProgressBar();
CMFCRibbonProgressBar(
UINT nID,
int nWidth = 90,
int nHeight = 22);
Parâmetros
Nid
[in] Especifica a ID de comando para a barra de progresso da faixa de opções.
nWidth
[in] Especifica a largura, em pixels, da barra de progresso da faixa de opções.
nHeight
[in] Especifica a altura, em pixels, da barra de progresso da faixa de opções.
CMFCRibbonProgressBar::GetPos
Retorna a posição atual da barra de progresso.
int GetPos () const;
Valor de retorno
Um valor que representa a posição atual da barra de progresso.
Comentários
O intervalo que está sendo definido deve estar dentro do intervalo especificado pelo método CMFCRibbonProgressBar::SetRange.
CMFCRibbonProgressBar::GetRangeMax
Retorna o valor máximo atual da barra de progresso.
int GetRangeMax() const;
Valor de retorno
O valor máximo do intervalo atual.
Comentários
CMFCRibbonProgressBar::GetRangeMin
Retorna o valor de intervalo mínimo atual da barra de progresso.
int GetRangeMin() const;
Valor de retorno
O valor mínimo do intervalo atual.
CMFCRibbonProgressBar::GetRegularSize
Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.
virtual CSize GetRegularSize(CDC* pDC);
Parâmetros
[in] pDC
Valor de retorno
Comentários
CMFCRibbonProgressBar::IsInfiniteMode
Especifica se a barra de progresso está funcionando no modo infinito.
BOOL IsInfiniteMode() const;
Valor de retorno
TRUE se a barra de progresso estiver no modo infinito; caso contrário, FALSE.
Comentários
No modo infinito, a barra de progresso é preenchida repetidamente do valor mínimo para o valor máximo. Você pode usar o modo infinito para indicar que uma operação está em andamento, mas que o tempo de conclusão é desconhecido.
CMFCRibbonProgressBar::OnDraw
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 OnDraw(CDC* pDC);
Parâmetros
[in] pDC
Comentários
CMFCRibbonProgressBar::SetInfiniteMode
Define a barra de progresso para funcionar no modo infinito.
void SetInfiniteMode(BOOL bSet = TRUE);
Parâmetros
bSet
[in] TRUE para especificar que a barra de progresso está no modo infinito; caso contrário, FALSE.
Comentários
Normalmente, se a barra de progresso estiver no modo infinito, ela estará informando ao usuário que uma operação está em andamento, mas que o tempo de conclusão é desconhecido. Dessa forma, a barra de progresso é preenchida repetidamente do valor mínimo para o valor máximo.
CMFCRibbonProgressBar::SetPos
Define a posição atual da barra de progresso.
void SetPos(
int nPos,
BOOL bRedraw = TRUE);
Parâmetros
nPos
[in] Especifica a posição para a qual a barra de progresso está definida.
bRedraw
[in] Especifica se a barra de progresso deve ser redesenhada.
Comentários
O intervalo que está sendo definido deve estar dentro do intervalo especificado pelo método CMFCRibbonProgressBar::SetRange.
CMFCRibbonProgressBar::SetRange
Define os valores mínimo e máximo da barra de progresso.
void SetRange(
int nMin,
int nMax);
Parâmetros
nMin
[in] Especifica o valor mínimo do intervalo.
nMax
[in] Especifica o valor máximo do intervalo.
Comentários
Use esse método para definir o intervalo da barra de progresso configurando valores mínimo e máximo.
Confira também
Gráfico da hierarquia
Classes
Classe CMFCRibbonBaseElement
Classe CMFCRibbonBar