Compartir a través de

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

  • Artículo

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".

IAccessible (interfaz)