Tipo de controle DataItem

Este tópico fornece informações sobre o suporte de automação da interface do usuário da Microsoft para o tipo de controle DataItem.

Uma entrada em uma lista de contatos é um exemplo de um controle de item de dados. Um controle de item de dados contém informações que são de interesse para um usuário final. É mais complicado do que o simples item de lista porque contém informações mais ricas.

As seções a seguir definem a estrutura da árvore de Automação da Interface do Usuário, propriedades, padrões de controle e eventos necessários para o tipo de controle DataItem. Os requisitos de Automação da Interface do Usuário se aplicam a todos os controles de itens de dados em que a estrutura/plataforma da interface do usuário integra o suporte à Automação da Interface do Usuário para tipos de controle e padrões de controle.

Este tópico contém as seguintes seções.

• estrutura típica da árvore
• Propriedades relevantes
• padrões de controle necessários
• Trabalhando com DataItems em listas grandes
• Eventos necessários
• Exemplo de tipo de controle DataItem
• Tópicos relacionados

Estrutura típica da árvore

A tabela a seguir descreve um controle típico e uma exibição de conteúdo da árvore de Automação da Interface do Usuário que pertence aos controles de item de dados 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, consulte Visão geral da árvore de automação da interface do usuário .

Um elemento de item de dados em uma grade de dados pode hospedar uma variedade de objetos, incluindo outra camada de itens de dados ou elementos de grade específicos, como texto, imagens ou controles de edição. Se o elemento de item de dados tiver uma função de objeto específica, o elemento deve ser exposto como um tipo de controle específico; por exemplo, um ListItem tipo de controle para um item de dados selecionável na grade.

Propriedades relevantes

A tabela a seguir lista as propriedades de Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para o tipo de controle DataItem. Para obter mais informações sobre as propriedades de automação da interface do usuário, consulte Recuperando propriedades de elementos de automação da interface do usuário.

Padrões de controle necessários

A tabela a seguir lista os padrões de controle de automação da interface do usuário necessários para serem suportados por todos os controles de item de dados. Para obter mais informações sobre padrões de controle, consulte Visão geral padrões de controle de automação da interface do usuário.

Trabalhando com DataItems em listas grandes

Como listas grandes geralmente são virtualizadas dentro de estruturas de interface do usuário para ajudar no desempenho, um cliente de Automação da Interface do Usuário não pode usar o recurso de consulta Automação da Interface do Usuário para pesquisar o conteúdo da árvore completa da mesma forma que em outros contêineres de itens. Um cliente deve rolar o item para a exibição (ou expandir o controle para mostrar todas as opções disponíveis) antes de acessar o conjunto completo de informações do item de dados.

Ao chamar SetFocus no elemento Automação da Interface do Usuário para o item de dados, o Microsoft Windows Explorer retorna com êxito e faz com que o foco seja definido para o controle Edit dentro da subárvore do item de dados.

Eventos necessários

A tabela a seguir lista os eventos de Automação da Interface do Usuário aos quais os controles de item de dados são necessários para dar suporte. Para obter mais informações sobre eventos, consulte Visão geral de eventos de automação da interface do usuário .

Exemplo de tipo de controle DataItem

A imagem a seguir ilustra um tipo de controle DataItem em um controle de exibição de lista.

A exibição de controle e a exibição de conteúdo da árvore de Automação da Interface do Usuário que pertence ao controle de item de dados são exibidas abaixo. Os padrões de controle para cada elemento de automação são mostrados entre parênteses. O Grupo "Contoso" também faz parte da grade do controle de host da grade de dados. Para obter um exemplo de uma estrutura de grade de nível superior, consulte DataGrid Control Type.

Se uma grade representa uma lista de itens selecionáveis, os elementos selecionáveis correspondentes da interface do usuário podem ser expostos com o tipo de controle ListItem em vez do tipo de controle DataItem. No exemplo anterior, os elementos DataItem ("Accounts Receivable.doc" e "Accounts Payable.doc") em Group ("Contoso") podem ser melhorados expondo-os como tipos de controle ListItem porque esse tipo já oferece suporte ao padrão de controle SelectionItem.

Tópicos relacionados

Conceptual

Visão geral dos tipos de controle de automação da interface do UI

Visão geral da automação da interface do usuário do