Partilhar via


Controle ProgressBar

O controle ProgressBar exibe um grafo de barras que altera o comprimento à medida que recebe mensagens de progresso. Esse controle assina o SetProgress ControlEvent. Ele pode assinar um ControlEvent com o nome da ação que está sendo monitorada.

Para obter informações relacionadas, consulte Criar um controle ProgressBar e Adicionar ações personalizadas ao ProgressBar.

Atributos de controle

É possível usar os atributos a seguir com esse controle. Para alterar o valor de um atributo usando um evento, assine o controle em um ControlEvent na tabela EventMapping e liste o identificador do atributo na coluna Attribute. Insira o identificador do ControlEvent na coluna Event.

Identificador de atributo Bit hexadecimal Descrição
Posição Posição do controle na caixa de diálogo. Insira a largura, a altura e as coordenadas do controle do canto esquerdo do controle nas colunas Width, Height, X e Y da tabela Control. Use unidades do instalador para definir o comprimento e a distância.
Progresso   Esse atributo especifica quanto do ProgressBar é preenchido. O atributo é composto por dois inteiros e uma cadeia de caracteres. O primeiro campo inteiro é o número atual de tiques de progresso e o segundo campo inteiro é o número máximo padrão de tiques de progresso (1024). O terceiro campo é uma cadeia de caracteres que é o nome da ação em progresso. Se o número atual de tiques de progresso for maior que o máximo, o instalador o alterará para o máximo. Esse atributo é definido e alterado pelo SetProgress ControlEvent. Você deve assinar o controle para esse evento na tabela EventMapping inserindo SetProgress na coluna Event e Progress na coluna Attribute.
Texto Texto exibido pelo controle. Para definir a fonte e o estilo da fonte de uma cadeia de texto, acrescente à cadeia de caracteres exibidos o prefixo {\style} ou {&style}. Sendo que Style é um identificador listado na coluna TextStyle da tabela TextStyle. Caso nenhum deles esteja presente, mas a propriedade DefaultUIFont seja definida como um estilo de texto válido, essa fonte será usada.
Visível 0x00000000 0x00000001
Controle oculto. Controle visível.
Inclua esse bit na palavra de bit da coluna Attributes na tabela Control para tornar o controle visível ou oculto após a criação.
Você também pode ocultar ou mostrar um controle usando a tabela ControlCondition.
Sunken 0x00000000 0x00000004
Exibe o estilo visual padrão. Exibe o controle com uma aparência 3D em baixo-relevo.
Inclua esses bits na palavra de bit da coluna Attributes da tabela Control.
RTLRO 0x00000000 0x00000020
O texto no controle é exibido na ordem de leitura da esquerda para a direita. O texto no controle é exibido na ordem de leitura da direita para a esquerda.
Progress95 0x00000000 0x00010000
Barra de progresso desenhada como uma barra contínua. Barra de progresso desenhada como uma série de retângulos.
Inclua esses bits na palavra de bit da coluna Attributes da tabela Control.

 

Comentários

Esse controle pode ser criado a partir da classe PROGRESS_CLASS usando a função CreateWindowEx. Ele tem os estilos WS_CHILD e WS_GROUP.