Editar tipo de controle
Este tópico fornece informações sobre o suporte à Automação da Interface do Usuário da Microsoft para o tipo de controle Editar.
Os controles de edição permitem que um usuário visualize e edite uma linha simples de texto sem suporte a formatação avançada.
As seções a seguir definem a estrutura da árvore de Automação da Interface do Usuário, propriedades, padrões de controle e eventos necessários para o tipo de controle de edição. Os requisitos de Automação da Interface do Usuário aplicam-se a todos os controles de edição em que a estrutura/plataforma da interface do usuário integra o suporte à Automação da Interface do Usuário para tipos de controle e padrões de controle.
Este tópico contém as seguintes seções.
- estrutura típica da árvore
- Propriedades relevantes
- padrões de controle necessários
- Eventos necessários
- Observações
- Tópicos relacionados
Estrutura típica da árvore
A tabela a seguir descreve um controle típico e uma exibição de conteúdo da árvore de Automação da Interface do Usuário que pertence à edição de controles e descreve o que pode ser contido em cada exibição. Para obter mais informações sobre a árvore de automação da interface do usuário, consulte Visão geral da árvore de automação da interface do usuário .
| Vista de Controlo | Visualização de conteúdo |
|---|---|
|
|
Os controles que implementam o tipo de controle Edit sempre terão zero barras de rolagem na exibição de controle da árvore de Automação da Interface do Usuário porque é um controle de linha única. A única linha de texto pode ser quebrada em alguns cenários de layout. O tipo de controle Edit destina-se apenas a pequenas quantidades de texto.
Propriedades relevantes
A tabela a seguir lista as propriedades de Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para os controles de edição. Para obter mais informações sobre as propriedades de automação da interface do usuário, consulte Recuperando propriedades de elementos de automação da interface do usuário.
| Propriedade de automação da interface do usuário | Valor | Observações |
|---|---|---|
| UIA_AutomationIdPropertyId | Ver notas. | O valor dessa propriedade deve ser exclusivo entre todos os elementos de mesmo nível na exibição bruta da árvore de Automação da Interface do Usuário. |
| UIA_BoundingRectanglePropertyId | Ver notas. | O retângulo mais externo que contém todo o controle. |
| UIA_ClickablePointPropertyId | Ver notas. | O controle de edição deve ter um ponto clicável que dê foco de entrada para a parte de edição do controle quando um usuário clica com o mouse lá. |
| UIA_ControlTypePropertyId | Editar | |
| UIA_IsContentElementPropertyId | VERDADEIRO | O controle de edição é sempre incluído na exibição de conteúdo da árvore de Automação da Interface do Usuário. |
| UIA_IsControlElementPropertyId | VERDADEIRO | O controle de edição é sempre incluído na visualização de controle da árvore de Automação da Interface do Usuário. |
| UIA_IsKeyboardFocusablePropertyId | Ver notas. | Se o controle pode receber foco do teclado, ele deve suportar essa propriedade. |
| UIA_IsPasswordPropertyId | Ver notas. | Deve ser definido como TRUE em controles de edição que contêm senhas. Se um controle de edição contiver conteúdo de senha, essa propriedade poderá ser usada por um leitor de tela para determinar se as teclas digitadas devem ser lidas à medida que o usuário as digita. |
| UIA_LabeledByPropertyId | Ver notas. | Se houver um rótulo de texto estático associado ao controle, essa propriedade deve expor uma referência a esse controle. Se o controle de texto for um subcomponente de outro controle, ele não terá um LabeledBy conjunto de propriedades. |
| UIA_LocalizedControlTypePropertyId | Ver notas. | Cadeia de caracteres localizada correspondente ao tipo de controle Edit. O valor padrão é "edit" para en-US ou inglês (Estados Unidos). |
| UIA_NamePropertyId | Ver notas. | O nome do controle de edição normalmente é gerado a partir de um rótulo de texto estático. Se não houver um rótulo de texto estático, um valor de propriedade para Name deverá ser atribuído pelo desenvolvedor do aplicativo. A propriedade Name nunca deve conter o conteúdo textual do controle de edição. |
Padrões de controle necessários
A tabela a seguir lista os padrões de controle de automação da interface do usuário necessários para serem suportados pelos controles de edição. Para obter mais informações sobre padrões de controle, consulte Visão geral padrões de controle de automação da interface do usuário.
| Propriedade Control Pattern/Pattern | Suporte/Valor | Observações |
|---|---|---|
| IRangeValueProvider | Depende | Todos os controles de edição que usam um intervalo numérico devem expor o RangeValue padrão de controle. |
| Mínimo | Ver notas. | Essa propriedade deve ser o menor valor para o qual o conteúdo do controle de edição pode ser definido. |
| Máximo | Ver notas. | Essa propriedade deve ser o maior valor para o qual o conteúdo do controle de edição pode ser definido. |
| SmallChange | Ver notas. | Esta propriedade deve indicar o número de casas decimais para as quais o valor pode ser definido. Se o controle de edição usar apenas números inteiros, o valor da propriedade SmallChange deverá ser 1. Se o controle edit tiver um intervalo de 1,0 a 2,0, o valor da propriedade SmallChange deverá ser 0,1. Se o controle edit tiver um intervalo de 1,00 a 2,00, o valor da propriedade SmallChange deverá ser 0,001. |
| LargeChange | NULL | Essa propriedade não precisa ser exposta em um controle de edição. |
| valor | Ver notas. | Esta propriedade indica o conteúdo numérico do controle de edição. Quando um valor mais preciso é definido por um cliente de automação da interface do usuário dentro dos intervalos especificados nas propriedades Minimum e Maximum, a propriedade Value é automaticamente arredondada para o valor aceito mais próximo. |
| ITextProvider | Necessário | Todos os controles de edição devem suportar o padrão de controle de de texto porque as informações detalhadas devem estar sempre disponíveis para clientes de tecnologia assistiva. |
| IValueProvider | Depende | Todos os controles de edição que usam uma cadeia de caracteres devem expor o valor padrão de controle. |
| IsReadOnly | Ver notas. | Essa propriedade deve ser definida para indicar se o controle pode ter um valor definido programaticamente ou que pode ser editado pelo usuário. |
| valor | Ver notas. | Esta propriedade contém o conteúdo textual do controle de edição. Se a propriedade UIA_IsPasswordPropertyId estiver definida como TRUE, consultar a propriedade Value deverá retornar um erro. |
Eventos necessários
A tabela a seguir lista os eventos de Automação da Interface do Usuário aos quais os controles de edição são necessários para dar suporte. Para obter mais informações sobre eventos, consulte Visão geral de eventos de automação da interface do usuário .
| Evento de automação da interface do usuário | Observações |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento de alteração de propriedade. | |
| UIA_IsEnabledPropertyId evento de alteração de propriedade. | Se o controle oferecer suporte à propriedadeIsEnabled, ele deverá oferecer suporte a esse evento. |
| UIA_IsOffscreenPropertyId evento de alteração de propriedade. | Se o controle oferecer suporte à propriedade IsOffscreen, ele deverá oferecer suporte a esse evento. |
| UIA_NamePropertyId evento de alteração de propriedade. | |
| UIA_RangeValueValuePropertyId evento de alteração de propriedade. | Se o controle oferecer suporte ao padrão de controle RangeValue, ele deverá oferecer suporte a esse evento. |
| UIA_ScrollHorizontallyScrollablePropertyId evento de alteração de propriedade. | Um controle de edição nunca suporta o padrão de controle Scroll. |
| UIA_ScrollHorizontalScrollPercentPropertyId evento de alteração de propriedade. | Um controle de edição nunca suporta o padrão de controle Scroll. |
| UIA_ScrollHorizontalViewSizePropertyId evento de alteração de propriedade. | Um controle de edição nunca suporta o padrão de controle Scroll. |
| UIA_ScrollVerticallyScrollablePropertyId evento de alteração de propriedade. | Um controle de edição nunca suporta o padrão de controle Scroll. |
| UIA_ScrollVerticalScrollPercentPropertyId evento de alteração de propriedade. | Um controle de edição nunca suporta o padrão de controle Scroll. |
| UIA_ScrollVerticalViewSizePropertyId evento de alteração de propriedade. | Um controle de edição nunca suporta o padrão de controle Scroll. |
| UIA_StructureChangedEventId | |
| UIA_Text_TextChangedEventId | Se o controle oferecer suporte ao padrão de controle texto, ele deverá oferecer suporte a esse evento. |
| UIA_Text_TextSelectionChangedEventId | Se o controle oferecer suporte ao padrão de controle texto, ele deverá oferecer suporte a esse evento. |
| UIA_ValueValuePropertyId evento de alteração de propriedade . | Se o controle oferecer suporte ao padrão de controle valor, ele deverá oferecer suporte a esse evento. |
Comentários
Um controle de edição pode ser usado como um campo de texto somente leitura que não suporta a seleção ou edição de texto. Esse controle de edição se comporta como um objeto de campo que tem um nome e um valor específicos.
Se um controle de edição contiver texto de espaço reservado (por exemplo, um banner de sinalização), o texto deverá ser usado como a propriedade HelpText, a menos que o texto possa ser editado pelo usuário e, em seguida, reutilizado como texto de espaço reservado. Por exemplo, a barra de endereços do Windows Internet Explorer contém o texto "about:Tabs" quando uma nova guia é aberta. Isso não é HelpText porque é um endereço programático que pode ser usado ou editado pelo usuário.
Tópicos relacionados
-
Conceptual
-
Visão geral dos tipos de controle de automação da interface do UI