Barra de desplazamiento (referencia de elemento de interfaz de usuario de MSAA)

Nota

En este tema se describen los objetos de barra de desplazamiento con fines de referencia de elementos de interfaz de usuario de MSAA. No se describe cómo crear objetos de barra de desplazamiento en varios marcos de interfaz de usuario. Consulte la documentación de referencia de API para el marco de interfaz de usuario que usa.

 

Las barras de desplazamiento permiten a un usuario elegir la dirección y la distancia para desplazarse por la información en un cuadro de lista o ventana relacionado. El nombre de la clase de ventana de una barra de desplazamiento es "SCROLLBAR".

El contenido de las propiedades IAccessible depende de si la barra de desplazamiento es vertical u horizontal y cuál de las siguientes partes de la barra de desplazamiento se consulta mediante el cliente:

• Barra de desplazamiento propiamente dicha
• Botón de flecha superior o derecha
• Botón de flecha inferior o izquierda
• Cuadro de desplazamiento (pulgar)
• La región derecha de la página o la página arriba
• La región izquierda de la página o la página abajo

Métodos IAccessible

Una barra de desplazamiento admite los siguientes métodos IAccessible :

• accDoDefaultAction: el propio objeto de barra de desplazamiento y el pulgar de desplazamiento no admiten el método accDoDefaultAction .

  Para los demás elementos de la barra de desplazamiento de una barra de desplazamiento vertical, accDoDefaultAction llama a PostMessage con el mensaje WM_VSCROLL con wParam establecido en los valores siguientes.

  Botón o región	Vaule
  Botón de flecha superior	SB_LINEUP
  Botón de flecha inferior	SB_LINEDOWN
  Región de páginas ascendentes	SB_PAGEUP
  Región hacia abajo de la página	SB_PAGEDOWN

   

  Para los demás elementos de barra de desplazamiento de una barra de desplazamiento horizontal, accDoDefaultAction llama a PostMessage con el mensaje de WM_HSCROLL con wParam establecido en los valores siguientes.

  Botón o región	Valor
  Botón de flecha izquierda	SB_LINELEFT
  Botón de flecha a la derecha	SB_LINERIGHT
  Región izquierda de la página	SB_PAGELEFT
  Región derecha de la página	SB_PAGERIGHT

   

• accHitTest

• accLocation

• accNavigate

Propiedades IAccessible

Una barra de desplazamiento admite las siguientes propiedades IAccessible :

• get_accChildCount: la propiedad ChildCount del objeto de barra de desplazamiento es cinco. Para las demás partes de la barra de desplazamiento, la propiedad ChildCount es cero.

• get_accDefaultAction: el propio objeto de barra de desplazamiento y el pulgar de desplazamiento no admiten la propiedad DefaultAction . La propiedad DefaultAction para los botones de flecha y las áreas sombreadas en cualquiera de los lados del pulgar de desplazamiento es "Presionar".

• get_accDescription: la propiedad Description depende de la parte de la barra de desplazamiento que se consulta.

  Las partes de una barra de desplazamiento vertical tienen las descripciones siguientes.

  Parte	Descripción
  Barra de desplazamiento propiamente dicha	"Se usa para cambiar el área de visualización vertical"
  Botón de flecha superior	"Mueve la posición vertical hacia arriba una línea"
  Botón de flecha inferior	"Mueve la posición vertical hacia abajo una línea"
  Pulgar de desplazamiento	"Indica la posición vertical actual y se puede arrastrar para cambiarla directamente"
  Región de páginas ascendentes	"Mueve la posición vertical hacia arriba un par de líneas"
  Región hacia abajo de la página	"Indica la posición vertical actual y se puede arrastrar para cambiarla directamente"

   

  Las partes de una barra de desplazamiento horizontal tienen las descripciones siguientes.

  Parte	Descripción
  Barra de desplazamiento propiamente dicha	"Se usa para cambiar el área de visualización horizontal"
  Botón de flecha izquierda	"Mueve la posición horizontal izquierda de una columna"
  Botón de flecha a la derecha	'Mueve la posición horizontal derecha de una columna"
  Pulgar de desplazamiento	"Indica la posición horizontal actual y se puede arrastrar para cambiarla directamente"
  Región izquierda de la página	"Mueve la posición horizontal a la izquierda un par de columnas"
  Región derecha de la página	"Indica la posición vertical actual y se puede arrastrar para cambiarla directamente"

   

• get_accHelp

• get_accHelpTopic

• get_accName: la propiedad Name depende de la parte de la barra de desplazamiento que se consulta.

  Las partes de una barra de desplazamiento vertical tienen los nombres siguientes.

  Parte	Nombre
  Ventana de barra de desplazamiento	"Vertical"
  Botón de flecha superior	"Alinear"
  Botón de flecha inferior	"Línea abajo"
  Pulgar de desplazamiento	"Posición"
  Región de páginas ascendentes	"Subir página"
  Región hacia abajo de la página	"Página abajo"

   

  Las partes de una barra de desplazamiento horizontal tienen los nombres siguientes.

  Parte	Nombre
  Ventana de barra de desplazamiento	"Horizontal"
  Botón de flecha izquierda	"Columna izquierda"
  Botón de flecha a la derecha	"Columna derecha"
  Pulgar de desplazamiento	"Posición"
  Región derecha de la página	"Página derecha"
  Región izquierda de la página	"Página izquierda"

   

• get_accParent: la propiedad Parent de los botones de flecha, el pulgar de desplazamiento y el área sombreada en cualquiera de los lados del pulgar es la ventana de la barra de desplazamiento. La propiedad Parent de la ventana de barra de desplazamiento es una ventana (ROLE_SYSTEM_WINDOW) que rodea el control y tiene la misma propiedad Name y el mismo nombre de clase de ventana.

• get_accRole: la propiedad Role depende de la parte de la barra de desplazamiento que se consulta. Las partes de una barra de desplazamiento tienen los siguientes roles.

  Parte	Role
  Barra de desplazamiento propiamente dicha	ROLE_SYSTEM_SCROLLBAR
  Botones de flecha superior, abajo, izquierda y derecha	ROLE_SYSTEM_PUSHBUTTON
  Pulgar de desplazamiento	ROLE_SYSTEM_INDICATOR
  Página arriba, página abajo, página izquierda y regiones derechas de página	ROLE_SYSTEM_PUSHBUTTON

   

• get_accState: la propiedad State de cada componente de barra de desplazamiento incluye una combinación de los siguientes valores.

  Estado	Value
  STATE_SYSTEM_INVISIBLE	Para la propia barra de desplazamiento, esto indica que la barra de desplazamiento vertical u horizontal especificada no existe. Para las regiones de la página arriba o abajo de la página, esto indica que el pulgar está colocado de modo que la región no existe.
  STATE_SYSTEM_OFFSCREEN	Para la propia barra de desplazamiento, esto indica que la ventana tiene un tamaño de modo que la barra de desplazamiento vertical u horizontal especificada no se muestra actualmente.
  STATE_SYSTEM_PRESSED	Se presiona el botón de flecha o la región de la página.
  STATE_SYSTEM_UNAVAILABLE	El componente está deshabilitado.

   

• get_accValue: la propiedad Value de la ventana de barra de desplazamiento indica la posición de la barra de desplazamiento y es una cadena que contiene un entero de "0" a "100".

Temas relacionados

IAccessible (interfaz)