Suporte da automação de interface do usuário para o tipo de controle Text
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 Texto. 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 a estrutura de árvore da Automação da Interface do Usuário, os valores de propriedade da Automação da Interface do Usuário e os padrões de controle.
Os controles de texto são o item básico da interface do usuário que representa um trecho de texto na tela.
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 necessários para o tipo de controle Texto. Os requisitos da Automação da Interface do Usuário se aplicam a todos os controles de texto, seja o WPF (Windows Presentation Foundation), o Win32 ou o Windows Forms.
Estrutura da árvore de Automação da Interface do Usuário necessária
A tabela a seguir ilustra a exibição de controle e a exibição de conteúdo da árvore da Automação da Interface do Usuário que se refere aos controles de texto 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, confira Visão geral da árvore de Automação da Interface do Usuário.
| Exibição de controle | Exibição de conteúdo |
|---|---|
| Texto | Texto (no caso de conteúdo) |
Um controle de texto pode ser usado sozinho como um rótulo ou como texto estático em um formulário. Ele também pode estar contido na estrutura de um:
ListItem
TreeItem
DataItem
Os controles de texto podem não estar na exibição de conteúdo da árvore da Automação da Interface do Usuário porque o texto geralmente é exibido por meio da NameProperty de outro controle. Por exemplo, o texto usado para rotular um controle Caixa de Combinação é exposto por meio do valor NameProperty do controle. Como o controle Caixa de Combinação está na exibição de conteúdo da árvore da Automação da Interface do Usuário, não é necessário que o controle de texto esteja nele. Os controles de texto sempre não têm nenhum filho na exibição de conteúdo
Propriedades de Automação da Interface do Usuário necessárias
A tabela a seguir lista as propriedades da Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para os controles de texto. 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. | Com suporte se houver um retângulo delimitador. Se nem todos os pontos dentro do retângulo delimitador forem clicáveis e você executar um teste de clique especializado, substitua e forneça um ponto clicável. |
| 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 da barra de texto é sempre o .txt que ele exibe. |
| LabeledByProperty | Null |
Os controles de texto não têm um rótulo de texto estático. |
| ControlTypeProperty | Texto | Esse valor é o mesmo para todas as estruturas da interface do usuário. |
| LocalizedControlTypeProperty | "texto" | Cadeia de caracteres localizada correspondente ao tipo de controle de texto. |
| IsContentElementProperty | Depende | O controle de texto será o conteúdo se ele contiver informações não expostas na NameProperty de outro controle. |
| IsControlElementProperty | True | O controle de texto precisa ser sempre um controle. |
Padrões de controle de Automação da Interface do Usuário necessários
A tabela a seguir lista os padrões de controle da Automação da Interface do Usuário necessários para terem o suporte de controles de texto. Para obter mais informações 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 | Suporte | Observações |
|---|---|---|
| IValueProvider | Nunca | O texto nunca dá suporte ao ValuePattern. Se o texto for editável, esse será o tipo de controle Editar. |
| ITextProvider | Depende | O texto deve dar suporte ao padrão de controle Texto para melhor acessibilidade. No entanto, isso não é necessário. O padrão de controle Texto é útil quando o texto tem estilo e atributos avançados (por exemplo, cor, negrito e itálico). Isso depende da estrutura. |
| ITableItemProvider | Depende | Se o elemento de texto estiver contido em um controle Tabela, isso precisará ter suporte. |
| IRangeValueProvider | Depende | Se o elemento de texto estiver contido em um controle de tabela, isso precisará ter suporte. |
Eventos de Automação da Interface do Usuário necessários
A tabela a seguir lista os eventos da Automação da Interface do Usuário necessários para terem o suporte de todos os controles de texto. Para obter mais informações sobre eventos, confira Visão geral de eventos da Automação da Interface do Usuário.
| Evento de Automação da Interface do Usuário | Suporte | Observações |
|---|---|---|
| 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. | Nunca | Nenhum |
| AutomationFocusChangedEvent | Obrigatório | Nenhum |
| StructureChangedEvent | Obrigatório | Nenhum |