Compartilhar via


Implementando o padrão de controle RangeValue de interface de usuário

Observação

Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de Automação de Interface do Usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre Automação de Interface do Usuário, consulte API de Automação do Windows: Automação de Interface do Usuário.

Este tópico apresenta diretrizes e convenções para a implementação de IRangeValueProvider, incluindo informações sobre eventos e propriedades. Links para referências adicionais são listados no final do tópico.

O RangeValuePattern padrão de controle é usado para dar suporte a controles que podem ser definidos como um valor dentro de um intervalo. Para obter exemplos de controles que implementam esse padrão de controle, consulte mapeamento de padrões de controle para clientes de automação de 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.

Barra de progresso. 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 necessários para IRangeValueProvider

Membro obrigatório Tipo de membro Anotaçõ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 que é maior que MaximumProperty ou menor que MinimumProperty.

Consulte também