Partilhar via


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

Observação

Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de 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 de utilizador, consulte API de automação do Windows: Automação da Interface de Utilizador.

Este tópico apresenta diretrizes e convenções para implementar o IScrollItemProvider, incluindo informações sobre propriedades, métodos e eventos. Links para referências adicionais estão listados no final do tópico.

O padrão de controlo ScrollItemPattern é usado para dar suporte a controlos filho individuais de contentores que implementam IScrollProvider. Esse padrão de controle atua como um canal de comunicação entre um controle filho e seu contêiner para garantir que o contêiner possa alterar o conteúdo (ou região) atualmente visível dentro de seu visor para exibir o controle filho. Para obter exemplos de controles que implementam esse padrão de controle, consulte Control Pattern Mapping for UI Automation Clients.

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

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

  • Itens contidos em um controle Window ou Canvas não são necessários para implementar a interface IScrollItemProvider. Como alternativa, no entanto, eles devem indicar um local válido para o BoundingRectangleProperty. Isso permitirá que um aplicativo cliente de Automação da Interface do Usuário use os ScrollPattern métodos de padrão de controle no contêiner para exibir o item filho.

Membros necessários para IScrollItemProvider

O método a seguir é necessário para implementar a interface IScrollProvider.

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

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

Exceções

Os provedores devem lançar as seguintes exceções.

Tipo de Exceção Condição
InvalidOperationException Se um item não puder ser rolado para a exibição:

- ScrollIntoView

Ver também