UI Automation Support for the DataItem Control Type

Este tópico fornece informações sobre Suporte para o DataItem Tipo de controle.Em Um tipo de Controlarar é um conjunto de condições que um Controlarar 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.

Uma entrada em uma lista de Contatos, por exemplo, é um contrle de ítem de dados.Um controle de ítem de dados contém informações que interessam ao usuário final.Este é mais complexo do que um ítem de lista simples, pois contém informações mais ricas.

As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de controle e eventos para o tipo de controle DataItem.O requisitos se aplicam a item de dados Tudo 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
• Trabalhando com Itens de Dados em Grandes Listas
• Eventos de Automação de IU Requeridos
• Exemple de Tipo de Controle DataItem
• 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 pertence ao item de dados Controles 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.

Exibir de controle - árvore	Árvore - exibir conteúdo
DataItem Varia	DataItem Varia

Propriedades de Automação de IU Requeridas

A seguinte tabela lista as propriedades cujos valores ou definição são especialmente relevantes para os controles de item de dados.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.
BoundingRectangleProperty	Veja anotações.	O retângulo mais externo que contém o controle inteiro.
ClickablePointProperty	Veja anotações.	Suportado se houver um retângulo de fronteiras.Se nem todo ponto dentro do retângulo de fronteira é clicável, e você realiza teste de hit especializado, então sobreponha e forneça um ponto clicável.
ControlTypeProperty	DataItem	Esse valor é o mesmo para todos os frameworks de IU.
IsContentElementProperty	True	O controle de item de dados deve sempre ser conteúdo.
IsControlElementProperty	True	O controle de item de dados deve sempre ser um controle.
IsKeyboardFocusableProperty	Veja anotações.	Se o controle pode receber o foco do teclado, deve suportar essa propriedade.
ItemStatusProperty	Veja anotações.	Se o controle contém um status que está sendo atualizado dinamicamente, ele deve oferecer suporte a esta propriedade para que tecnologias de apoio possam receber atualizações quando o status do elemento mudar.
ItemTypeProperty	Veja anotações.	Este é o valor da seqüência de caracteres que transmite ao usuário final o objeto subjacente representado por este item.Dois exemplos são "Arquivo de Mídia" ou "Contato".
LabeledByProperty	Null	Controles de item de dados não possuem um rótulo de texto estático.
LocalizedControlTypeProperty	"item de dados"	String localizada correspondente ao tipo de controle do DataItem.
NameProperty	Veja anotações.	O controle item de dados sempre contém um elemento de texto primário que está relacionado ao que o usuário associaria como o identificador mais semântico para o item.

Padrões de Controle de Automação de IU Requeridos

O seguinte tabela Listas o Controlar padrões necessárias para ser suportadas por todos os controles item de dados.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
IExpandCollapseProvedor	Depende	Se o item de dados pode ser expandido ou recolhido para exibir e esconder informações, o padrão Expandir Recolher deve ser suportado.
IGridItemProvedor	Depende	Itens de dados suportarão o padrão Item de Grid quando uma coleção de itens de dados estiver disponível dentro de um contêiner que pode ser navegado espacialmente item-a-item.
IScrollItemProvider	Depende	Todos os itens de dados suportam a abilidade de serem rolados para dentro da área visível com o padrão Item de Rolagem quando seu contêiner de dados contiver mais itens do que a tela comporta.
ISelectionItemProvider	Sim	Todos os itens de dados devem suportar o padrão Item de Seleção para indicar quando o item estiver selecionado.
ITableItemProvider	Depende	Se o item de dados estiver contido dentro de um tipo de controle Grade de Dados, ele suportará este padrão.
IToggleProvider	Depende	Se o item de dados contiver um estado que pode ser alterado ciclicamente.
IValueProvider	Depende	Se o texto primário do item de dados for editável, o padrão Valor deve ser suportado.

Trabalhando com Itens de Dados em Grandes Listas

Grandes listas são geralmente dados virtualizar dentro As estruturas para auxiliar no desempenho.Devido a isso, um Cliente de Automação interface do usuário Não é possível usar o Recurso de consulta para scrape o conteúdo da árvore do Completo da mesma forma que ele pode nos outros Contêineres de item.Um cliente deve rolar o item para dentro da área visível antes de acessar o conjunto completo de informações do item de dados.

Ao chamar SetFocus Sobre o Elemento para o item de dados, o Caso irá retornar com êxito e causar foco a ser definido para o Editar dentro da subárvore item de dados.

Eventos de Automação de IU Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles item de dados.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
AutomationFocusChangedEvent	Necessário	Nenhum
BoundingRectangleProperty Evento de propriedade alterado.	Necessário	Nenhum
IsEnabledProperty Evento de propriedade alterado.	Necessário	Nenhum
IsOffscreenProperty Evento de propriedade alterado.	Necessário	Nenhum
NameProperty Evento de propriedade alterado.	Necessário	Nenhum
StructureChangedEvent	Necessário	Nenhum
InvokedEvent	Depende	Nenhum
ExpandCollapseStateProperty Evento de propriedade alterado.	Depende	Nenhum
ElementAddedToSelectionEvent	Necessário	Nenhum
ElementRemovedFromSelectionEvent	Necessário	Nenhum
ElementSelectedEvent	Necessário	Nenhum
ToggleStateProperty Evento de propriedade alterado.	Depende	Nenhum
ValueProperty Evento de propriedade alterado.	Depende	Nenhum

Exemple de Tipo de Controle DataItem

A imagem a seguir ilustra um tipo de controle DataItem em um contole de Visualização de Lista.

O Visão de Controle e o Visão de Conteúdo do Árvore que pertence ao controle item de dados é exibida abaixo.Os padrões de controle para cada elemento de automação estão entre parênteses.

Exibir de controle - árvore	Árvore - exibir conteúdo
DataItem (Sort, Table, Selection, Grid) Edit "Accounts Receivable" (SelectionItem, Invoke) Image Text "11.0 KB" (GridItem, TableItem)	DataItem (Sort, Table, Selection, Grid) Edit "Accounts Receivable" (SelectionItem, Invoke) Image Text "11.0 KB" (GridItem, TableItem)

Consulte também

Conceitos

Visão Geral dos Tipos de Controle de Automação de Interface do Usuário

UI Automation Overview

Referência

DataItem()