Suporte de automação de interface de usuário para o Tipo de Controle Edit
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 fornece informações sobre suporte da Automação da Interface do Usuário para o tipo de controle de edição. Na Automação da Interface do Usuário, um tipo de controle é um conjunto de condições que um controle precisa atender para usar a propriedade ControlTypeProperty. As condições incluem as diretrizes específicas para estrutura de árvore de automação da IU, os valores da propriedade da Automação da Interface do Usuário e os padrões de controle.
Os controles de edição permitem que um usuário exiba e edite uma linha de texto simples sem suporte a formatação avançada.
As seções a seguir definem a estrutura de árvore da Automação da Interface do Usuário, as propriedades, os padrões de controle e os eventos obrigatórios para o tipo de controle de edição. Os requisitos da Automação da Interface do Usuário se aplicam a todos os controles de edição do WPF (Windows Presentation Foundation), Win32 ou Windows Forms.
Estrutura de árvore obrigatória da Automação da Interface do Usuário
A tabela a seguir descreve a exibição de controle e a exibição de conteúdo de árvore da Automação da Interface do Usuário que pertence aos controles de edição e descreve o que pode conter em cada exibição. Para obter mais informações sobre a árvore de automação da IU, confira Visão geral de árvore da Automação da Interface do Usuário.
| Exibição de controle | Exibição de conteúdo |
|---|---|
| Editar | Editar |
Os controles que implementam o tipo de controle de edição não terão barras de rolagem na exibição de controle de árvore da Automação da Interface do Usuário, pois é um controle de uma única linha. A única linha de texto pode ser encapsulada em alguns cenários de layout. O tipo de controle de edição é mais adequado para manter pequenas quantidades de texto editável ou selecionável.
Propriedades obrigatórias da Automação da Interface do Usuário
A tabela a seguir lista as propriedades da Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para controles de edição. Para obter mais informações sobre as propriedades da Automação da Interface do Usuário, confira Propriedades da Automação da Interface do Usuário para clientes.
| Propriedade de Automação da Interface do Usuário | Valor | Observações |
|---|---|---|
| AutomationIdProperty | Veja as observações. | O valor dessa propriedade precisa ser exclusivo em todos os controles de um aplicativo. |
| BoundingRectangleProperty | Veja as observações. | O retângulo mais externo que contém todo o controle. |
| ClickablePointProperty | Veja as observações. | O controle de edição deve ter um ponto clicável que dê foco de entrada à parte de edição do controle quando um usuário clicar o mouse lá. |
| IsKeyboardFocusableProperty | Veja as observações. | Se o controle puder receber o foco do teclado, ele deverá dar suporte a essa propriedade. |
| NameProperty | Veja as observações. | O nome do controle de edição normalmente é gerado por 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 ter o conteúdo textual do controle de edição. |
| LabeledByProperty | Veja as observações. | Se houver um rótulo de texto estático associado ao controle, essa propriedade precisará expor uma referência a esse controle. Se o controle de texto for um subcomponente de outro controle, ele não terá uma propriedade LabeledBy definida. |
| ControlTypeProperty | Editar | Esse valor é o mesmo para todas as estruturas da IU. |
| LocalizedControlTypeProperty | "editar" | Cadeia de caracteres localizada correspondente ao tipo de controle de edição. |
| IsContentElementProperty | True | O controle de edição sempre está incluído na exibição de conteúdo da árvore da Automação da Interface do Usuário. |
| IsControlElementProperty | True | O controle de edição sempre está incluído na exibição de controle da árvore da Automação da Interface do Usuário. |
| IsPasswordProperty | Veja as observações. | Deve ser definido como True em controles de edição que contenham senhas. Se um controle de edição tiver conteúdo de senha, essa propriedade poderá ser usada por um leitor de tela para determinar se os pressionamentos de tecla devem ser lidos conforme o usuário os digita. |
Padrões de controle e propriedades obrigatórios da Automação da Interface do Usuário
A tabela a seguir lista os padrões de controle obrigatórios para ter suporte de todos os controles de edição. Para saber mais sobre padrões de controle, confira Visão geral dos padrões de controle da Automação da Interface do Usuário.
| Padrão de controle/propriedade do padrão de controle | Suporte/valor | Observações |
|---|---|---|
| ITextProvider | Depende | Os controles de edição devem dar suporte ao padrão de controle de texto, pois as informações de texto detalhadas devem estar sempre disponíveis para os clientes. |
| IValueProvider | Depende | Todos os controles de edição que levam uma cadeia de caracteres devem expor o padrão Valor. |
| IsReadOnly | Veja as observações. | Essa propriedade deve ser definida para indicar se o controle pode ter um valor definido programaticamente ou editado pelo usuário. |
| Value | Veja as observações. | Essa propriedade retornará o conteúdo textual do controle de edição. Se a propriedade IsPasswordProperty estiver definida como true, essa propriedade deverá gerar uma InvalidOperationException quando solicitada. |
| IRangeValueProvider | Depende | Todos os controles de edição com um intervalo numérico devem expor o padrão de controle Valor de Intervalo. |
| Minimum | Veja as observações. | Essa propriedade deve ser o menor valor para o qual o conteúdo do controle de edição pode ser definido. |
| Maximum | Veja as observações. | Essa propriedade deve ser o maior valor para o qual o conteúdo do controle de edição pode ser definido. |
| SmallChange | Veja as observações. | Essa propriedade deve indicar o número de casas decimais com as quais o valor pode ser definido. Se a edição levar apenas inteiros, o valor de SmallChangeProperty deverá ser 1. Se a edição levar um intervalo de 1.0 a 2.0, SmallChangeProperty deverá ser 0.1. Se o controle de edição levar um intervalo de 1.00 a 2.00, SmallChangeProperty deverá ser 0.001. |
| LargeChange | Null |
Essa propriedade não precisa ser exposta em um controle de edição. |
| Value | Veja as observações. | Essa propriedade indicará o conteúdo numérico do controle de edição. Quando um valor mais preciso é definido por um cliente da Automação da Interface do Usuário nos intervalos especificados nas propriedades Minimum e Maximum, a propriedade Value é arredondada automaticamente para o valor aceito mais próximo. |
Eventos obrigatórios da Automação da Interface do Usuário
A tabela a seguir lista os eventos da Automação da Interface do Usuário obrigatórios para ter suporte de todos os controles de edição. Para obter mais informações sobre eventos, confira Visão geral de eventos de Automação da Interface do Usuário.
| Evento de Automação da Interface do Usuário | Suporte | Observações |
|---|---|---|
| InvalidatedEvent | Obrigatório | Nenhum |
| TextSelectionChangedEvent | Obrigatório | Nenhum |
| TextChangedEvent | Obrigatório | Nenhum |
| Evento de alteração da propriedade BoundingRectangleProperty. | Obrigatório | Nenhum |
| Evento de alteração da propriedade IsOffscreenProperty. | Obrigatório | Nenhum |
| Evento de alteração da propriedade IsEnabledProperty. | Obrigatório | Nenhum |
| Evento de alteração da propriedade NameProperty. | Obrigatório | Nenhum |
| Evento de alteração da propriedade ValueProperty. | Depende | Nenhum |
| Evento de alteração da propriedade HorizontallyScrollableProperty. | Nunca | Nenhum |
| Evento de alteração da propriedade HorizontalScrollPercentProperty. | Nunca | Nenhum |
| Evento de alteração da propriedade HorizontalViewSizeProperty. | Nunca | Nenhum |
| Evento de alteração da propriedade VerticalScrollPercentProperty. | Nunca | Nenhum |
| Evento de alteração da propriedade VerticallyScrollableProperty. | Nunca | Nenhum |
| Evento de alteração da propriedade VerticalViewSizeProperty. | Nunca | Nenhum |
| Evento de alteração da propriedade ValueProperty. | Depende | Se o controle der suporte ao padrão de controle Value do intervalo, ele precisará dar suporte a esse evento. |
| AutomationFocusChangedEvent | Obrigatório | Nenhum |
| StructureChangedEvent | Obrigatório | Nenhum |