Partilhar via


Padrão de controle VirtualizedItem

Descreve diretrizes e convenções para implementar IVirtualizedItemProvider, incluindo informações sobre propriedades e métodos. O padrão de controle VirtualizedItem é usado para dar suporte a itens virtualizados, que são itens representados por elementos de automação de espaço reservado na árvore de automação da interface do usuário da Microsoft.

Os itens virtualizados podem incluir itens recuperados de um controle que suporta o padrão de controle ItemContainer ou um objeto incorporado virtualizado recuperado de um controle que suporta o padrão de controle Texto. O espaço reservado para um item virtualizado pode não ter carregado dados para todas as propriedades de Automação da Interface do Usuário e pode retornar UIA_E_ELEMENTNOTAVAILABLE em resposta a consultas de propriedades que não estão disponíveis. O padrão de controle VirtualizedItem fornece um método para realizar um item virtual para que informações completas sejam disponibilizadas para o item e um elemento de automação completo possa ser criado para o item na árvore de Automação da Interface do Usuário.

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

Orientações e convenções de aplicação

Ao implementar o padrão de controle VirtualizedItem, observe as seguintes diretrizes e convenções:

  • Qualquer elemento de espaço reservado de Automação da Interface do Usuário que possa ser virtualizado deve oferecer suporte ao padrão de controle VirtualizedItem expondo a interfaceIVirtualizedItemProvider.
  • Quando IVirtualizedItemProvider::Realize é chamado, o objeto de espaço reservado deve ser atualizado com implementações completas de suas propriedades e padrões de controle.
  • Quando IVirtualizedItemProvider::Realize é chamado, o provedor pode alterar o visor para que o item virtualizado entre em exibição. Não é necessário trazer o item à vista; no entanto, itens não virtualizados fora da tela devem suportar o métodoIScrollItemProvider::ScrollIntoView.

Membros necessários para IVirtualizedItemProvider

As propriedades e métodos a seguir são necessários para implementar o interface IVirtualizedItemProvider.

Membros obrigatórios Tipo de membro Observações
Perceba Método Nenhum

 

Esse padrão de controle não tem eventos associados.

Implementando o padrão de controle ItemContainer de automação da interface do usuário

Visão geral dos padrões de controle de automação da interface do do usuário

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

Trabalhando com itens virtualizados