Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Nota
Esta documentación está dirigida a los desarrolladores de .NET Framework que quieran usar las clases de automatización de la interfaz de usuario administradas definidas en el espacio de nombres System.Windows.Automation. Para ver la información más reciente acerca de la automatización de la interfaz de usuario, consulte Windows Automation API: automatización de la interfaz de usuario.
En este artículo se presentan las directrices y convenciones para implementar IScrollProvider, incluida la información sobre eventos y propiedades. Al final del tema se ofrecen vínculos a referencias adicionales.
El patrón de control ScrollPattern se usa para admitir un control que actúe como contenedor desplazable para una colección de objetos secundarios. No se requiere que el control use barras de desplazamiento para admitir la funcionalidad de desplazamiento, aunque comúnmente lo hace.
Ejemplo de un control de desplazamiento que no usa barras de desplazamiento
Para obtener ejemplos de controles que implementan este control, vea Control Pattern Mapping for UI Automation Clients.
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 ScrollPattern . Deben admitir el patrón de control RangeValuePattern en su lugar.
Cuando el desplazamiento se mide en porcentajes, todos los valores o cantidades relacionadas con la graduación del desplazamiento deben normalizarse a un intervalo de 0 a 100.
Las propiedadesHorizontallyScrollableProperty y VerticallyScrollableProperty son independientes de la propiedad IsEnabledProperty.
Si HorizontallyScrollableProperty =
false, HorizontalViewSizeProperty debe establecerse en el 100 % y HorizontalScrollPercentProperty debe establecerse en NoScroll. De igual modo, si VerticallyScrollableProperty =false, VerticalViewSizeProperty debe establecerse en el 100 por ciento y VerticalScrollPercentProperty debe establecerse en NoScroll. Esto permite que un cliente de la automatización de la interfaz de usuario utilice estos valores de propiedad dentro del método SetScrollPercent, evitando una condición de carrera si se activa involuntariamente una dirección de desplazamiento que no interesa al cliente.La configuración regional de HorizontalScrollPercent es específica. La configuración de HorizontalScrollPercent = 100.0 debe establecer la ubicación de desplazamiento del control en el equivalente a su posición más a la derecha para idiomas como el inglés, que se leen de izquierda a derecha. Alternativamente, para idiomas como el árabe que se leen de derecha a izquierda, establecer HorizontalScrollPercent = 100,0 debe ubicar el desplazamiento en la posición más a la izquierda.
Miembros requeridos para IScrollProvider
Para implementar IScrollProvider, se requieren las siguientes propiedades y métodos.
| Miembro requerido | Tipo de miembro | Notas |
|---|---|---|
| HorizontalScrollPercent | Propiedad | Ninguno |
| VerticalScrollPercent | Propiedad | Ninguno |
| HorizontalViewSize | Propiedad | Ninguno |
| VerticalViewSize | Propiedad | Ninguno |
| HorizontallyScrollable | Propiedad | Ninguno |
| VerticallyScrollable | Propiedad | Ninguno |
| Scroll | Método | Ninguno |
| SetScrollPercent | Método | Ninguno |
Este patrón de control no tiene eventos asociados.
Excepciones
Los proveedores deben lanzar las siguientes excepciones.
| Tipo de excepción | Condición |
|---|---|
| ArgumentException | Scroll genera esta excepción si un control admite valores SmallIncrement exclusivamente para el desplazamiento horizontal o vertical, pero se pasa un valor LargeIncrement . |
| ArgumentException | SetScrollPercent genera esta excepción cuando se pasa un valor que no se puede convertir a un tipo double. |
| ArgumentOutOfRangeException | SetScrollPercent genera esta excepción cuando se pasa un valor superior a 100 o menor de 0 (excepto -1, que equivale a NoScroll). |
| InvalidOperationException | Tanto Scroll como SetScrollPercent generan esta excepción cuando se intenta un desplazamiento en una dirección no admitida. |