Manipulando o controle de progresso

Há três maneiras de alterar a posição atual de um controle de progresso (CProgressCtrl).

• A posição pode ser alterada por um valor de incremento predefinido.

• A posição pode ser alterada por um valor arbitrário.

• A posição pode ser alterada para um valor específico.

Para alterar a posição por um valor predefinido

1. Use a função membro SetStep para definir o valor do incremento. Por padrão, esse valor é 10. Normalmente, esse valor é definido como uma das configurações iniciais do controle. O valor da etapa pode ser negativo.

2. Use a função membro StepIt para incrementar a posição. Isso faz com que o controle se redesenhe.

   Observação

   StepIt fará com que a posição seja encapsulada. Por exemplo, dado um intervalo de 1 a 100, uma etapa de 20 e uma posição de 90, StepIt definirá a posição como 10.

Para alterar a posição por um valor arbitrário

1. Use a função membro OffsetPos para alterar a posição. OffsetPos aceitará valores negativos.

   Observação

   OffsetPos, diferente de StepIt, não encapsulará a posição. A nova posição é ajustada para permanecer dentro do intervalo.

Para alterar a posição para um valor específico

1. Use a função membro SetPos para definir a posição como um valor específico. Se necessário, a nova posição será ajustada para estar dentro do intervalo.

Normalmente, o controle de progresso é usado somente para saída. Para obter a posição atual sem especificar um novo valor, use GetPos.

Confira também

Usando CProgressCtrl
Controles