Compartilhar via


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 de membro SetStep para definir a quantidade de incremento. Por padrão, esse valor é 10. Esse valor normalmente é definido como uma das configurações iniciais para o 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, ao contrário 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 de 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.

Consulte também

Usando CProgressCtrl
Controles