Suporte a Automação de IU para o Tipo de Controle Edit
Este tópico fornece informações sobre Suporte para a edição Tipo de controle.Em Um tipo de controle é um conjunto de condições que um controle deve atender em Ordem para usar o ControlTypeProperty Propriedade.As condições incluem guia específico linhas para estrutura de árvore, valores de propriedade, e Padrões de Controlarar.
Controles Edit são um exemplo de controlres que implementam o tipo de controle Edit.Controles Edit permitem que um usuário visualize e edite uma única linha de texto.
As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de Controlarar e eventos para o tipo de Controlarar em Editar.O requisitos se aplicam a todos os Editar controles, se , Win32, ou .
Este tópico contém as seguintes seções.
- Estrutura de Árvore de Automação de IU Requerida
- Propriedades de Automação de IU Requeridas
- Padrões de Controle de Automação de IU Requeridos
- Eventos de Automação de IU Requeridos
- Tópicos relacionados
Estrutura de Árvore de Automação de IU Requerida
A tabela a seguir descreve o Modo de controle e o exibição de conteúdo do Árvore que diz respeito a controles de edição e descreve o que pode estar contido em cada Exibir.Para obter mais informações sobre o árvore, consulte Visão geral da árvore de automação de interface do usuário.
Visão de Controle |
Visão de Conteúdo |
|---|---|
|
|
Os controles que implementam o Editar tipo de controle sempre terão zero barras de rolagem na exibição do controle de árvore porque ele é um Simples - linha de controle.A única linha de texto pode rolar em alguns cenários de layout.O tipo de controle Edit serve para pequenos textos editáveis.
Propriedades de Automação de IU Requeridas
O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles de edição.Para obter mais informações propriedades, consulte UI Automation Properties for Clients.
Propriedade |
Value (Valor) |
Anotações |
|---|---|---|
AutomationIdProperty() |
Veja anotações. |
O valor desta propriedade precisa ser único em todos os controles de uma aplicação. |
Veja anotações. |
O retângulo mais externo que contém o controle inteiro. |
|
Veja anotações. |
O controle de edição deve ter um ponto clicável que dá foco de entrada para a porção de edição do controle quando o usuário clica o mouse ali. |
|
Veja anotações. |
Se o controle pode receber o foco do teclado, deve suportar essa propriedade. |
|
Veja anotações. |
O nome do controle de edição geralmente é gerado de um rótulo de texto estático.Se houver não um rótulo de texto estático, um valor da propriedade para. Name (Nome) Deve ser atribuído pelo desenvolvedor do aplicativo.O Name (Nome) Propriedade nunca deve conter o conteúdo textual de Editar de controle. |
|
Veja anotações. |
Se houver um rótulo de texto estático associado com o controle, então essa propriedade precisa expor uma referência ao controle.Se o controle de texto é um subcomponente de outro controle, ele não terá um LabeledBy Propriedade definida. |
|
Editar |
Esse valor é o mesmo para todos As estruturas. |
|
Edit (Edição) |
String localizado correspondente ao tipo de controle Edit |
|
True |
O controle de edição é sempre incluídos na exibição de conteúdo das árvore. |
|
True |
O controle de edição é sempre incluídos na exibição de controle das árvore. |
|
Veja anotações. |
Deve ser definido como verdadeiro em controles de edição que contenham senhas.Se um controle de edição contiver conteúdos de senha então essa propriedade pode ser utilizada por um leitor de tela para determinar se as teclas devem ser lidas na medida em que o usuário as digita. |
Padrões de Controle de Automação de IU Requeridos
O seguinte tabela Listas o controle padrãos necessárias para ser suportadas por todos os controles de edição.Para obter mais informações sobre padrões de controle, consulte Visão Geral de Padrões de Controle de Automação de Interface de Usuário.
Padrão de Controle/Propriedade de Padrão de Controle |
Suporte/Valor |
Anotações |
|---|---|---|
ITextProvedor |
Necessário |
Todos controles de edição devem suportar o padrão de controle Text porque informações detalhadas devem estar sempre disponíveis para clientes de tecnologia assistiva. |
Depende |
Todos controles de edição que pegam um string devem expor o padrão Valor. |
|
IsReadOnly() |
Veja anotações. |
Esta propriedade deve ser definida para indicar se o controle pode ter um valor definido programaticamente. |
Veja anotações. |
Esta propriedade deve retornar o conteúdo textual do controle de edição.Se a IsPasswordProperty é definido como verdadeiroEsta propriedade deve aumentar um InvalidOpertaionException Quando solicitado. |
|
Depende |
Todos controles de edição que levam uma faixa de números deve expor o padrão de controle Range Value. |
|
Veja anotações. |
Esta propriedade deve ser o menor valor com que o conteúdo do controle de edição pode ser definido. |
|
Veja anotações. |
Esta propriedade deve ser o maior valor com que o conteúdo do controle de edição pode ser definido. |
|
Veja anotações. |
Esta propriedade deve indicar o número de casas decimais com que o valor pode ser definido.Se a edição levar apenas números inteiros, o SmallChangeProperty deve ser 1.Se a edição levar um intervalo de 1.0 para 2.0, em seguida, o SmallChangeProperty deve ser 0,1.Se o controle de edição terá um intervalo de 1.00 para 2.00 e o SmallChangeProperty deve ser 0,001. |
|
Null |
Esta propriedade não precisa ser exposta em um controle de edição. |
|
Value() |
Veja anotações. |
Esta propriedade indicará o conteúdo numérico do controle de edição.Quando um valor mais preciso é definido por um Cliente nos intervalos especificados na Minimum e Maximum propriedades, a propriedade Value automaticamente serão arredondadas para o valor aceito mais próximo. |
Eventos de Automação de IU Requeridos
O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles de edição.Para obter mais informações sobre eventos, consulte Visão geral sobre eventos de automação de interface do usuário.
Evento |
Suporte |
Anotações |
|---|---|---|
Necessário |
Nenhum |
|
Necessário |
Nenhum |
|
Necessário |
Nenhum |
|
BoundingRectangleProperty Evento de propriedade alterado. |
Necessário |
Nenhum |
IsOffscreenProperty Evento de propriedade alterado. |
Necessário |
Nenhum |
IsEnabledProperty Evento de propriedade alterado. |
Necessário |
Nenhum |
NameProperty Evento de propriedade alterado. |
Necessário |
Nenhum |
ValueProperty Evento de propriedade alterado. |
Depende |
Nenhum |
HorizontallyScrollableProperty Evento de propriedade alterado. |
Nunca |
Nenhum |
HorizontalScrollPercentProperty Evento de propriedade alterado. |
Nunca |
Nenhum |
HorizontalViewSizeProperty Evento de propriedade alterado. |
Nunca |
Nenhum |
VerticalScrollPercentProperty Evento de propriedade alterado. |
Nunca |
Nenhum |
Evento de mudança de propriedade System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty |
Nunca |
Nenhum |
VerticalViewSizeProperty Evento de propriedade alterado. |
Nunca |
Nenhum |
ValueProperty Evento de propriedade alterado. |
Depende |
Se o controle suporte o padrão de controle de faixa de valores, deve suportar este evento. |
Necessário |
Nenhum |
|
Necessário |
Nenhum |
Consulte também
Conceitos
Visão Geral dos Tipos de Controle de Automação de Interface do Usuário
Referência
Edit()