Compartir a través de

Patrón de control scroll

  • Artículo

Describe instrucciones y convenciones para implementar IScrollProvider, incluida información sobre las propiedades y los métodos. El patrón de control Scroll se usa para admitir un control que actúa como un contenedor desplazable para una colección de objetos secundarios.

El control no es necesario para usar barras de desplazamiento para admitir la funcionalidad de desplazamiento, aunque normalmente lo hace. En la imagen siguiente se muestra un control de desplazamiento que no usa barras de desplazamiento. Para obtener ejemplos de controles que implementan este patrón de control, vea tipos de control y sus patrones de control admitidos.

captura de pantalla que muestra un control de desplazamiento sin barras de desplazamiento

Este tema contiene las secciones siguientes.

Directrices y convenciones de implementación

Al implementar el patrón de control Scroll, tenga en cuenta las siguientes directrices y convenciones:

  • Los elementos secundarios de este control deben implementar IScrollItemProvider.
  • Las barras de desplazamiento de un control de contenedor no admiten el patrón de control de desplazamiento de. Deben admitir el patrón de control RangeValue en su lugar.
  • Cuando el desplazamiento se mide en porcentajes, todos los valores o cantidades relacionados con la graduación de desplazamiento deben normalizarse en un intervalo de 0 a 100.
  • La propiedad IScrollProvider::HorizontallyScrollable y la propiedad VerticallyScrollable son independientes de la propiedad IsEnabled.
  • Si la propiedad IScrollProvider::HorizontallyScrollable es FALSE, la propiedad HorizontalViewSize debe establecerse en 100 (100%) y propiedad HorizontalScrollPercent debe establecerse en UIA_ScrollPatternNoScroll (-1). Del mismo modo, si la propiedad VerticallyScrollable es FALSE, la propiedad VerticalViewSize debe establecerse en 100 (100%) y propiedad VerticalScrollPercent debe establecerse en UIA_ScrollPatternNoScroll (-1). Esto permite que un cliente de Automatización de la interfaz de usuario de Microsoft use estos valores de propiedad dentro del método SetScrollPercent mientras evita una condición de carrera si una dirección que el cliente no está interesada en desplazarse se activa.
  • La propiedad IScrollProvider::HorizontalScrollPercent es específica de la configuración regional. Establecer HorizontalScrollPercent en 100 debe establecer la ubicación de desplazamiento del control en el equivalente de su posición más derecha para idiomas como inglés que leen de izquierda a derecha. Como alternativa, para idiomas como árabe que leen de derecha a izquierda, establecer HorizontalScrollPercent en 100 debe establecer la ubicación de desplazamiento en la posición situada más a la izquierda.

Miembros necesarios para IScrollProvider

Se requieren las siguientes propiedades y métodos para implementar la interfaz IScrollProvider.

Miembros necesarios Tipo de miembro Notas
horizontalScrollPercent Propiedad Ninguno
verticalScrollPercent Propiedad Ninguno
HorizontalViewSize Propiedad Ninguno
VerticalViewSize Propiedad Ninguno
HorizontallyScrollable Propiedad Ninguno
VerticallyScrollable Propiedad Ninguno
de desplazamiento Método Ninguno
SetScrollPercent Método Ninguno

 

Este patrón de control no tiene eventos asociados.

tipos de control y sus patrones de control admitidos

Introducción a los patrones de control de automatización de la interfaz de usuario de

Información general del árbol de automatización de la interfaz de usuario de