Padrão de controle de rolagem

Descreve diretrizes e convenções para implementar IScrollProvider, incluindo informações sobre propriedades e métodos. O padrão de controle Scroll é usado para dar suporte a um controle que atua como um contêiner rolável para uma coleção de objetos filho.

O controle não é necessário para usar barras de rolagem para dar suporte à funcionalidade de rolagem, embora normalmente o faça. A imagem a seguir mostra um controle de rolagem que não usa barras de rolagem. Para obter exemplos de controles que implementam esse padrão de controle, consulte tipos de controle e seus padrões de controle com suporte.

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

• diretrizes e convenções de implementação
• membros necessários para IScrollProvider
• tópicos relacionados

Diretrizes e convenções de implementação

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

• Os filhos desse controle devem implementar IScrollItemProvider.
• As barras de rolagem de um controle de contêiner não dão suporte ao padrão de controle de rolagem. Eles devem dar suporte ao padrão de controle RangeValue.
• Quando a rolagem é medida em percentuais, todos os valores ou valores relacionados à graduação de rolagem devem ser normalizados para um intervalo de 0 a 100.
• A propriedadeIScrollProvider::HorizontallyScrollable e propriedade VerticallyScrollable são independentes da propriedade IsEnabled.
• Se a propriedade IScrollProvider::HorizontallyScrollable for FALSE, a propriedade HorizontalViewSize deverá ser definida como 100 (100%) e propriedade HorizontalScrollPercent deverá ser definida como UIA_ScrollPatternNoScroll (-1). Da mesma forma, se a propriedade VerticallyScrollable for FALSE, a propriedade VerticalViewSize deverá ser definida como 100 (100%) e propriedade VerticalScrollPercent deve ser definida como UIA_ScrollPatternNoScroll (-1). Isso permite que um cliente de Automação de Interface do Usuário da Microsoft use esses valores de propriedade dentro do métodoSetScrollPercent, evitando uma condição de corrida se uma direção que o cliente não estiver interessado em rolar for ativada.
• A propriedade IScrollProvider::HorizontalScrollPercent é específica da localidade. A configuração HorizontalScrollPercent como 100 deve definir o local de rolagem do controle como o equivalente à posição mais à direita para idiomas como inglês que leem da esquerda para a direita. Como alternativa, para idiomas como árabe que leem da direita para a esquerda, definir HorizontalScrollPercent como 100 deve definir o local de rolagem como a posição mais à esquerda.

Membros necessários para IScrollProvider

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

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

Tópicos relacionados

tipos de controle e seus padrões de controle com suporte

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

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