UI Automation Support for the DataGrid Control Type

Este tópico fornece informações sobre Suporte para o DataGrid Tipo de controle.Em Um tipo de controle é um conjunto de condições que um controle deve atender em Ordem para usar o ControlType Propriedade.As condições incluem guia específico linhas para estrutura de árvore, valores de propriedade e Padrões de Controlarar.

O tipo de controle DataGrid permite que um usuário facilmente trabalhe com itens que contêm metadados representados em colunas.Controles de grade de dados têm linhas de itens e colunas de informações sobre esses itens.Um controle de exibição de lista no Microsoft Vista Explorer é um exemplo que suporta o tipo de controle DataGrid.

As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de controle e eventos para o tipo de controle DataGrid.O requisitos se aplicam a grade de dados todos os 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
• Exemplo tipo do controle de grade de dados
• 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 grade de dados controla e descreve o que pode estar contido em cada modo de exibição.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
DataGrid Header HeaderItem (filho do cabeçalho) DataItem	DataGrid DataItem

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 grade 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	DataGrid	Esse valor é o mesmo para todos os frameworks de IU.
IsContentElementProperty	True	O valor desta propriedade deve sempre ser True.Isso significa que o controle grade de dados deve sempre ser na exibição do conteúdo de árvore.
IsControlElementProperty	True	O valor desta propriedade deve sempre ser True.Isso significa que o controle grade de dados deve ser sempre na exibição do controle de árvore.
IsKeyboardFocusableProperty	Veja anotações.	Se o controle pode receber o foco do teclado, deve suportar essa propriedade.
LabeledByProperty	Veja anotações.	Se houver um rótulo texto estático então esta propriedade precisa expor uma referência para aquele controle.
LocalizedControlTypeProperty	"grade de dados"	String localizada correspondente ao tipo de controle do DataGrid.
NameProperty	Veja anotações.	O controle grade de dados normalmente obtém o valor de seu Name (Nome) propriedade de um rótulo de texto estático.Se houver um rótulo de texto estático não um desenvolvedor de aplicativos deve atribuir um valor para o Name (Nome) Propriedade.O valor da Name (Nome) Propriedade nunca deve ser o conteúdo textual de controle de edição.

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 grade 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.

Interface do padrão de controle	Suporte/Valor	Anotações
IGridProvider	Sim	O próprio controle de grade de dados sempre oferece suporte ao padrão de controle Grid porque os itens que ela contém têm metadados que são apresentados em uma grade.
IScrollProvider	Depende	A capacidade de rolar a grade de dados depende do conteúdo e da presença de barras de rolagem.
ISelectionProvedor	Sim	Todos os controles de grade de dados contêm itens dentro dela que são selecionáveis.
ITableProvider	Sim	O controle de grade de dados sempre tem um cabeçalho em sua subárvore então o padrão de controle Table deve ser suportado.

Controles de item de dados dentro dos contêineres de uma grade de dados suportarão, no mínimo, o seguinte:

• Padrão de controle Selection Item

• Padrão de controle Scroll Item (se o contêiner for rolável)

Os itens dentro de um contêiner de item de dados suportarão, no mínimo, o seguinte:

• Padrão de controle Grid Item

• Padrão de controle Table Item

Eventos de Automação de IU Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles grade 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/Valor	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
LayoutInvalidatedEvent	Depende	Nenhum
StructureChangedEvent	Necessário	Nenhum
CurrentViewProperty Evento de propriedade alterado.	Depende	Nenhum
HorizontallyScrollableProperty Evento de propriedade alterado.	Depende	Se o controle suportar o padrão de controle Scroll, ele deverá suportar este evento.
HorizontalScrollPercentProperty Evento de propriedade alterado.	Depende	Se o controle suportar o padrão de controle Scroll, ele deverá suportar este evento.
HorizontalViewSizeProperty Evento de propriedade alterado.	Depende	Se o controle suportar o padrão de controle Scroll, ele deverá suportar este evento.
VerticalScrollPercentProperty Evento de propriedade alterado.	Depende	Se o controle suportar o padrão de controle Scroll, ele deverá suportar este evento.
VerticallyScrollableProperty Evento de propriedade alterado.	Depende	Se o controle suportar o padrão de controle Scroll, ele deverá suportar este evento.
VerticalViewSizeProperty Evento de propriedade alterado.	Depende	Se o controle suportar o padrão de controle Scroll, ele deverá suportar este evento.
InvalidatedEvent	Necessário	Nenhum

Exemplo tipo do controle de grade de dados

A imagem a seguir ilustra um controle de List View que implementa o tipo de controle DataGrid.

O Modo de controle e o exibição de conteúdo do Árvore que pertence ao controle de exibição de lista é 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
DataGrid (Sort, Table, Selection, Grid) Header HeaderItem "Nome" (Invoke) HeaderItem "Data de modificação" (Invoke) HeaderItem "Tamanho" (Invoke) Group " Contoso " DataItem "Accounts Receivable.doc" (SelectionItem, Invoke) DataItem "Accounts Payable.doc" (SelectionItem, Invoke)	DataGrid (Sort, Table, Selection, Grid) Group " Contoso " DataItem "Accounts Receivable.doc" (SelectionItem, Invoke) DataItem "Accounts Payable.doc" (SelectionItem, Invoke)

O elemento de automação Data Item pode ter os seguintes filhos: Edit, Image, e Text.

Consulte também

Conceitos

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

UI Automation Overview

Referência

DataGrid