Implementando o padrão de controle RangeValue de interface de usuário
Observação
Esta documentação destina-se a desenvolvedores de .NET Framework que querem usar as classes da Automação da Interface do Usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre a Automação da Interface do Usuário, confira API de Automação do Windows: Automação da Interface do Usuário.
Este tópico apresenta diretrizes e convenções para implementar IRangeValueProvider, incluindo informações sobre eventos e propriedades. Links para referências adicionais são listados no final do tópico.
O padrão de controle RangeValuePattern é usado para dar suporte a controles que podem ser definidos como um valor dentro de um intervalo. Para ver exemplos de controles que implementam esse padrão de controle, confira Mapeamento de padrões de controle para clientes da Automação da Interface do Usuário.
Diretrizes e convenções de implementação
Ao implementar o padrão de controle Valor de Intervalo, observe as seguintes diretrizes e convenções:
Os controles permitem a recalibração de suas propriedades com suporte com base na localidade ou preferência do usuário. Um exemplo disso é um controle de termômetro que pode ser definido para exibir a temperatura em Fahrenheit ou Celsius.
Os controles que têm valores de intervalo ambíguos, como barras de progresso ou controles deslizantes, devem ter esses valores normalizados.
Exemplo de uma barra de progresso em que o valor é de tipo inteiro e valores mínimos e máximos de propriedade são normalizados para 0 e 100, respectivamente
Membros obrigatórios para IRangeValueProvider
| Membro obrigatório | Tipo de membro | Observações |
|---|---|---|
| IsReadOnlyProperty | Propriedade | Nenhum |
| ValueProperty | Propriedade | Nenhum |
| LargeChangeProperty | Propriedade | Nenhum |
| SmallChangeProperty | Propriedade | Nenhum |
| MaximumProperty | Propriedade | Nenhum |
| MinimumProperty | Propriedade | Nenhum |
| SetValue | Métodos | Nenhum |
Esse padrão de controle não tem eventos associados.
Exceções
Os provedores devem gerar as exceções a seguir.
| Tipo de exceção | Condição |
|---|---|
| ArgumentOutOfRangeException | SetValue é chamado com um valor maior que MaximumProperty ou menor que MinimumProperty. |
Confira também
- Visão Geral de Padrões de Controle de Automação de Interface de Usuário
- Padrões de controle de suporte em um provedor de automação da interface do usuário
- Padrões de Controle para Clientes de Automação de IU
- Visão geral da árvore de automação de interface do usuário
- Usar armazenamento em cache em automação de interface do usuário