Implementar o padrão de controlo de rolagem da Automação da Interface de Utilizador

Nota

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 System.Windows.Automation namespace. Para obter as informações mais recentes sobre a automação da interface do usuário, consulte API de automação do Windows: automação da interface do usuário.

Este artigo apresenta diretrizes e convenções para a implementação de IScrollProvider, incluindo informações sobre eventos e propriedades. Links para referências adicionais estão listados no final do tópico.

O ScrollPattern padrão de controle é usado para dar suporte a um controle que atua como um contêiner rolável para uma coleção de objetos filho. O controlo não precisa de barras de deslocamento para permitir a funcionalidade de deslocamento, embora frequentemente as utilize.

Exemplo de um controle de rolagem que não usa barras de rolagem

Para obter exemplos de controles que implementam esse controle, consulte Mapeamento de padrão de controle para clientes de automação da interface do usuário.

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

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

• Os filhos deste controle devem implementar IScrollItemProvider.

• As barras de rolagem de um controle de contêiner não suportam o ScrollPattern padrão de controle. Em vez disso, devem apoiar o RangeValuePattern padrão de controlo.

• Quando a rolagem é medida em porcentagens, todos os valores ou quantias relacionados à graduação da rolagem devem ser normalizados para um intervalo de 0 a 100.

• HorizontallyScrollableProperty e VerticallyScrollableProperty são independentes do IsEnabledProperty.

• Se HorizontallyScrollableProperty = false então HorizontalViewSizeProperty deve ser definido como 100% e HorizontalScrollPercentProperty deve ser definido como NoScroll. Da mesma forma, se VerticallyScrollableProperty = false então VerticalViewSizeProperty deve ser definido como 100 por cento e VerticalScrollPercentProperty deve ser definido como .NoScroll Isso permite que um cliente de automação da interface do utilizador utilize esses valores de propriedade no método SetScrollPercent, evitando uma condição de corrida caso uma direção em que o cliente não esteja interessado em fazer scroll seja ativada.

• HorizontalScrollPercent é específico da localidade. Definir HorizontalScrollPercent = 100.0 deve definir o local de rolagem do controle para o equivalente à sua posição mais à direita para idiomas como inglês que leem da esquerda para a direita. Como alternativa, para idiomas como o árabe que leem da direita para a esquerda, a configuração HorizontalScrollPercent = 100.0 deve definir o local de rolagem para a posição mais à esquerda.

Membros necessários para IScrollProvider

As seguintes propriedades e métodos são necessários para a implementação do IScrollProvider.

Membro obrigatório	Tipo de membro	Notas
HorizontalScrollPercent	Propriedade	Nenhuma
VerticalScrollPercent	Propriedade	Nenhuma
HorizontalViewSize	Propriedade	Nenhuma
VerticalViewSize	Propriedade	Nenhuma
HorizontallyScrollable	Propriedade	Nenhuma
VerticallyScrollable	Propriedade	Nenhuma
Scroll	Método	Nenhuma
SetScrollPercent	Método	Nenhuma

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

Exceções

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

Tipo de Exceção	Condição
ArgumentException	Scroll lança esta exceção se um controle suporta SmallIncrement valores exclusivamente para rolagem horizontal ou vertical, mas um LargeIncrement valor for passado.
ArgumentException	SetScrollPercent lança essa exceção quando um valor que não pode ser convertido em duplo é passado.
ArgumentOutOfRangeException	SetScrollPercent lança essa exceção quando um valor maior que 100 ou menor que 0 é passado (exceto -1, que é equivalente a NoScroll).
InvalidOperationException	Ambos Scroll e SetScrollPercent lançam esta exceção quando é feita uma tentativa de deslocar em uma direção não suportada.

Consulte também

• Visão geral dos padrões de controle de automação da interface do usuário
• Suporte a padrões de controle em um provedor de automação de interface do usuário
• Padrões de controle de automação da interface do usuário para clientes
• Visão geral da árvore de automação da interface do usuário
• Usar cache na automação da interface do usuário