Padrão de controle de rolagem
Descreve diretrizes e convenções para implementar o 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 inclui 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 Scroll . Em vez disso, eles devem dar suporte ao padrão de controle RangeValue .
- Quando a rolagem é medida em percentuais, todos os valores ou quantias relacionadas à graduação de rolagem devem ser normalizados para um intervalo de 0 a 100.
- A propriedade IScrollProvider::HorizontallyScrollable e a 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 a 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 a propriedade VerticalScrollPercent deverá ser definida como UIA_ScrollPatternNoScroll (-1). Isso permite que um cliente do Microsoft Automação da Interface do Usuário use esses valores de propriedade dentro do método SetScrollPercent, evitando uma condição de corrida se uma direção em que o cliente não está interessado em rolar for ativada.
- A propriedade IScrollProvider::HorizontalScrollPercent é específica da localidade. Definir 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 para 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 IScrollProvider .
| Membros necessários | Tipo de membro | Observações |
|---|---|---|
| Horizontalscrollpercent | Propriedade | Nenhum |
| Verticalscrollpercent | Propriedade | Nenhum |
| HorizontalViewSize | Propriedade | Nenhum |
| VerticalViewSize | Propriedade | Nenhum |
| Horizontallyscrollable | Propriedade | Nenhum |
| Verticallyscrollable | Propriedade | Nenhum |
| Rolar | Método | Nenhum |
| SetScrollPercent | Método | Nenhum |
Esse padrão de controle não tem eventos associados.
Tópicos relacionados