Partilhar via

Classe CMFCRibbonProgressBar

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Implementa um controlo que indica visualmente o progresso de uma operação longa.

Sintaxe

class CMFCRibbonProgressBar : public CMFCRibbonBaseElement

Membros

Construtores Públicos

Nome Description
CMFCRibbonProgressBar::CMFCRibbonProgressBar Constrói e inicializa um CMFCRibbonProgressBar objeto.

Métodos Públicos

Nome Description
CMFCRibbonProgressBar::GetPos Devolve o progresso atual.
CMFCRibbonProgressBar::GetRangeMax Devolve o valor máximo do intervalo atual.
CMFCRibbonProgressBar::GetRangeMin Devolve o valor mínimo do intervalo atual.
CMFCRibbonProgressBar::GetRegularSize Devolve o tamanho normal do elemento fita. (Sobrepõe CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonProgressBar::IsInfiniteMode Especifica se a barra de progresso está a funcionar em modo infinito.
CMFCRibbonProgressBar::OnDraw Chamado pelo framework para desenhar o elemento fita. (Sobrepõe o CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonProgressBar::SetInfiniteMode Define a barra de progresso para funcionar em modo infinito.
CMFCRibbonProgressBar::SetPos Define o progresso atual.
CMFCRibbonProgressBar::SetRange Define os valores mínimo e máximo.

Observações

A CMFCRibbonProgressBar pode operar em dois modos: regular e infinito. No modo normal, 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 é repetidamente preenchida do valor mínimo ao valor máximo. Pode usar o modo infinito para indicar que uma operação está em curso, mas que o tempo de conclusão é desconhecido.

Example

O exemplo seguinte demonstra como usar vários métodos na CMFCRibbonProgressBar aula. O exemplo mostra como definir a barra de progresso para funcionar em modo infinito (onde o tempo de conclusão de uma operação é desconhecido), definir os valores mínimos e máximos para a barra de progresso, e definir a posição atual da barra de progresso. Este excerto 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

CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

Requerimentos

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
[dentro] Especifica o ID do comando para a barra de progresso da fita.

nLargura
[dentro] Especifica a largura, em pixels, da barra de progresso da fita.

nAltura
[dentro] Especifica a altura, em pixels, da barra de progresso da fita.

CMFCRibbonProgressBar::GetPos

Devolve 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.

Observações

O intervalo definido deve estar dentro do intervalo especificado pelo método CMFCRibbonProgressBar::SetRange .

CMFCRibbonProgressBar::GetRangeMax

Devolve o valor máximo atual da barra de progresso.

int GetRangeMax() const;

Valor de retorno

O valor máximo do intervalo de corrente.

Observações

CMFCRibbonProgressBar::GetRangeMin

Devolve o valor mínimo atual da barra de progresso.

int GetRangeMin() const;

Valor de retorno

O valor mínimo do intervalo atual.

CMFCRibbonProgressBar::GetRegularSize

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

virtual CSize GetRegularSize(CDC* pDC);

Parâmetros

[dentro] pDC

Valor de retorno

Observações

CMFCRibbonProgressBar::IsInfiniteMode

Especifica se a barra de progresso está a funcionar em modo infinito.

BOOL IsInfiniteMode() const;

Valor de retorno

TRUE se a barra de progresso estiver em modo infinito; caso contrário, FALSO.

Observações

No modo infinito, a barra de progresso enche-se repetidamente do valor mínimo ao valor máximo. Pode usar o modo infinito para indicar que uma operação está em curso, mas que o tempo de conclusão é desconhecido.

CMFCRibbonProgressBar::OnDraw

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

virtual void OnDraw(CDC* pDC);

Parâmetros

[dentro] pDC

Observações

CMFCRibbonProgressBar::SetInfiniteMode

Define a barra de progresso para funcionar em modo infinito.

void SetInfiniteMode(BOOL bSet = TRUE);

Parâmetros

bSet
[dentro] TRUE para especificar que a barra de progresso está em modo infinito; caso contrário, FALSO.

Observações

Normalmente, se a barra de progresso estiver em modo infinito, está a informar o utilizador de que uma operação está em curso, mas que o tempo de conclusão é desconhecido. Assim, a barra de progresso enche-se repetidamente do valor mínimo ao valor máximo.

CMFCRibbonProgressBar::SetPos

Define a posição atual da barra de progresso.

void SetPos(
    int nPos,
    BOOL bRedraw = TRUE);

Parâmetros

nPos
[dentro] Especifica a posição para a qual a barra de progresso está definida.

bRedraw
[dentro] Especifica se a barra de progresso deve ser redesenhada.

Observações

O intervalo definido deve estar dentro do intervalo especificado pelo método CMFCRibbonProgressBar::SetRange .

CMFCRibbonProgressBar::SetRange

Define os valores mínimos e máximos para a barra de progresso.

void SetRange(
    int nMin,
    int nMax);

Parâmetros

nMin
[dentro] Especifica o valor mínimo do intervalo.

nMax
[dentro] Especifica o valor máximo do intervalo.

Observações

Use este método para definir o intervalo da barra de progresso, definindo valores mínimos e máximos.

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCRibbonBaseElement
Classe CMFCRibbonBar

  • Last updated on