Compartilhar via


Barra de rolagem (referência de elemento da interface do usuário do MSAA)

Nota

Este tópico descreve barra de rolagem objetos para fins de referência de elemento de interface do usuário do MSAA. Como criar Barra de Rolagem objetos em várias estruturas de interface do usuário não é descrito aqui. Consulte a documentação de referência da API para a estrutura de interface do usuário que você está usando.

 

As barras de rolagem permitem que um usuário escolha a direção e a distância para percorrer as informações em uma janela ou caixa de listagem relacionada. O nome da classe de janela para uma barra de rolagem é "SCROLLBAR".

O conteúdo das propriedades IAccessible depende se a barra de rolagem é vertical ou horizontal e em qual das seguintes partes da barra de rolagem está sendo consultada pelo cliente:

  • A própria barra de rolagem
  • O botão de seta para cima ou para a direita
  • O botão de seta para a parte inferior ou esquerda
  • A caixa de rolagem (polegar)
  • A página para cima ou a região direita da página
  • A página para baixo ou a região esquerda da página

Métodos IAccessible

Uma barra de rolagem dá suporte aos seguintes métodos deIAccessible:

  • accDoDefaultAction — o próprio objeto da barra de rolagem e o polegar de rolagem não dão suporte ao método accDoDefaultAction.

    Para as outras partes da barra de rolagem em uma barra de rolagem vertical, accDoDefaultAction chamadas postMessage com a mensagem WM_VSCROLL com wParam definidos para os valores a seguir.

    Botão/Região Vaule
    Botão de seta superior SB_LINEUP
    Botão de seta inferior SB_LINEDOWN
    Região de página para cima SB_PAGEUP
    Região de página para baixo SB_PAGEDOWN

     

    Para as outras partes da barra de rolagem em uma barra de rolagem horizontal, chamadas accDoDefaultAction PostMessage com a mensagem WM_HSCROLL com wParam definidos para os valores a seguir.

    Botão/Região Valor
    Botão de seta para a esquerda SB_LINELEFT
    Botão de seta para a direita SB_LINERIGHT
    Região esquerda da página SB_PAGELEFT
    Região direita da página SB_PAGERIGHT

     

  • accHitTest

  • accLocation

  • accNavigate

Propriedades IAccessible

Uma barra de rolagem dá suporte às seguintes propriedades deIAccessible:

  • get_accChildCount— A propriedade ChildCount para o objeto da barra de rolagem é cinco. Para as outras partes da barra de rolagem, a propriedade ChildCount é zero.

  • get_accDefaultAction— O objeto da barra de rolagem em si e o polegar de rolagem não dão suporte à propriedade DefaultAction. A propriedade DefaultAction para os botões de seta e as áreas sombreadas em ambos os lados do polegar de rolagem é "Pressionar".

  • get_accDescription— A propriedade Description depende da parte da barra de rolagem que é consultada.

    As partes de uma barra de rolagem vertical têm as descrições a seguir.

    Parte Descrição
    Barra de rolagem em si "Usado para alterar a área de exibição vertical"
    Botão de seta superior "Move a posição vertical para cima uma linha"
    Botão de seta inferior "Move a posição vertical para baixo em uma linha"
    Rolar o polegar "Indica a posição vertical atual e pode ser arrastada para alterá-la diretamente"
    Região de página para cima "Move a posição vertical para cima algumas linhas"
    Região de página para baixo "Indica a posição vertical atual e pode ser arrastada para alterá-la diretamente"

     

    As partes de uma barra de rolagem horizontal têm as descrições a seguir.

    Parte Descrição
    Barra de rolagem em si "Usado para alterar a área de exibição horizontal"
    Botão de seta para a esquerda "Move a posição horizontal à esquerda de uma coluna"
    Botão de seta para a direita "Move a posição horizontal direita uma coluna"
    Rolar o polegar "Indica a posição horizontal atual e pode ser arrastada para alterá-la diretamente"
    Região esquerda da página "Move a posição horizontal à esquerda de algumas colunas"
    Região direita da página "Indica a posição vertical atual e pode ser arrastada para alterá-la diretamente"

     

  • get_accHelp

  • get_accHelpTopic

  • get_accName— A propriedade Name depende da parte da barra de rolagem que é consultada.

    As partes de uma barra de rolagem vertical têm os nomes a seguir.

    Parte Nome
    Janela da barra de rolagem "Vertical"
    Botão de seta superior "Alinhar"
    Botão de seta inferior "Linha para baixo"
    Rolar o polegar "Posição"
    Região de página para cima "Página para cima"
    Região de página para baixo "Página para baixo"

     

    As partes de uma barra de rolagem horizontal têm os nomes a seguir.

    Parte Nome
    Janela da barra de rolagem "Horizontal"
    Botão de seta para a esquerda "Coluna à esquerda"
    Botão de seta para a direita "Coluna à direita"
    Rolar o polegar "Posição"
    Região direita da página "Página à direita"
    Região esquerda da página "Página à esquerda"

     

  • get_accParent— A propriedade Pai dos botões de seta, do polegar de rolagem e da área sombreada em ambos os lados do polegar é a janela da barra de rolagem. A propriedade Pai da janela da barra de rolagem é uma janela (ROLE_SYSTEM_WINDOW) que envolve o controle e tem o mesmo nome de nome e o nome da classe de janela.

  • get_accRole— A propriedade de Função depende da parte da barra de rolagem que é consultada. As partes de uma barra de rolagem têm as seguintes funções.

    Parte Papel
    Barra de rolagem em si ROLE_SYSTEM_SCROLLBAR
    Botões de seta para cima, para baixo, para a esquerda e para a direita ROLE_SYSTEM_PUSHBUTTON
    Rolar o polegar ROLE_SYSTEM_INDICATOR
    Página para cima, página para baixo, página esquerda e página direita regiões ROLE_SYSTEM_PUSHBUTTON

     

  • get_accState— A propriedade State de cada componente da barra de rolagem inclui uma combinação dos seguintes valores de .

    Estado Valor
    STATE_SYSTEM_INVISIBLE Para a própria barra de rolagem, isso indica que a barra de rolagem vertical ou horizontal especificada não existe. Para as regiões de página para cima ou página para baixo, isso indica que o polegar está posicionado de modo que a região não exista.
    STATE_SYSTEM_OFFSCREEN Para a própria barra de rolagem, isso indica que a janela é dimensionada de modo que a barra de rolagem vertical ou horizontal especificada não seja exibida no momento.
    STATE_SYSTEM_PRESSED O botão de seta ou a região da página é pressionado.
    STATE_SYSTEM_UNAVAILABLE O componente está desabilitado.

     

  • get_accValue— A propriedade Value para a janela da barra de rolagem indica a posição da barra de rolagem e é uma cadeia de caracteres que contém um inteiro de "0" a "100".

interface IAccessible