Implementando o padrão de controle RangeValue de interface de usuárioImplementing the UI Automation RangeValue Control Pattern

Observação

Esta documentação destina-se a desenvolvedores do .NET Framework que querem usar as classes da Automação da interface do usuárioUI Automation gerenciadas definidas no namespace System.Windows.Automation.This documentation is intended for .NET Framework developers who want to use the managed Automação da interface do usuárioUI Automation classes defined in the System.Windows.Automation namespace. Para obter as informações mais recentes sobre a Automação da interface do usuárioUI Automation, consulte Windows Automation API: UI Automation (API de Automação do Windows: Automação da Interface do Usuário).For the latest information about Automação da interface do usuárioUI Automation, see Windows Automation API: UI Automation.

Este tópico introduz diretrizes e IRangeValueProviderconvenções para a implementação, incluindo informações sobre eventos e propriedades.This topic introduces guidelines and conventions for implementing IRangeValueProvider, including information about events and properties. Links para referências adicionais são listados no final do tópico.Links to additional references are listed at the end of the topic.

O RangeValuePattern padrão de controle é usado para suportar controles que podem ser definidos como um valor dentro de um intervalo.The RangeValuePattern control pattern is used to support controls that can be set to a value within a range. Para exemplos de controles que implementam esse padrão de controle, consulte Mapping de padrão de controle para clientes de automação de interface do usuário.For examples of controls that implement this control pattern, see Control Pattern Mapping for UI Automation Clients.

Diretrizes e Convenções de ImplementaçãoImplementation Guidelines and Conventions

Ao implementar o padrão de controle de valor de intervalo, observe as seguintes diretrizes e convenções:When implementing the Range Value control pattern, note the following guidelines and conventions:

  • Os controles permitem a recalibração de suas propriedades suportadas com base na localização ou preferência do usuário.Controls allow recalibration of their supported properties based upon locale or user preference. Um exemplo disso é um controle de termômetro que pode ser definido para exibir a temperatura em Fahrenheit ou Celsius.An example of this is a thermometer control that can be set to display the temperature in Fahrenheit or Celsius.

  • Controles que tenham valores de alcance ambíguos, como barras de progresso ou controles deslizantes, devem ter esses valores normalizados.Controls that have ambiguous range values, such as progress bars or sliders, should have those values normalized.

Barra de progresso.Progress bar.
Exemplo de barra de progresso onde o valor é do tipo inteiro e os valores mínimos e máximos da propriedade são normalizados em 0 e 100, respectivamenteExample of a Progress Bar Where Value Is of Type Integer and Minimum and Maximum Property Values Are Normalized to 0 and 100, Respectively

Membros obrigatórios para IRangeValueProviderRequired Members for IRangeValueProvider

Membro obrigatórioRequired member Tipo de membroMember type ObservaçõesNotes
IsReadOnlyProperty PropriedadeProperty NenhumNone
ValueProperty PropriedadeProperty NenhumNone
LargeChangeProperty PropriedadeProperty NenhumNone
SmallChangeProperty PropriedadeProperty NenhumNone
MaximumProperty PropriedadeProperty NenhumNone
MinimumProperty PropriedadeProperty NenhumNone
SetValue MétodosMethods NenhumNone

Este padrão de controle não tem eventos associados.This control pattern has no associated events.

ExceçõesExceptions

Os provedores devem lançar as seguintes exceções.Providers must throw the following exceptions.

Tipo de exceçãoException type CondiçãoCondition
ArgumentOutOfRangeException SetValueé chamado com um valor MaximumProperty que é MinimumPropertymaior ou menor do que .SetValue is called with a value that is either greater than MaximumProperty or less than MinimumProperty.

Confira tambémSee also