Ler em inglês

Compartilhar via


Barra de Rolagem (Referência de elemento de interface do usuário do MSAA)

Observação

Este tópico descreve objetos da Barra de Rolagem para fins de Referência de Elemento de Interface do Usuário do MSAA. Como criar objetos da Barra de Rolagem 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 a direita ou superior
  • O botão de seta para baixo ou para a 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 IAccessible :

  • accDoDefaultAction — o próprio objeto de 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 chama PostMessage com a mensagem WM_VSCROLL com wParam definido 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 page up 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, accDoDefaultAction chama PostMessage com a mensagem WM_HSCROLL com wParam definido para os valores a seguir.

    Botão/Região Valor
    Botão de seta para a esquerda SB_LINELEFT
    Botão de seta para 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 IAccessible :

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

  • get_accDefaultAction — o próprio objeto de barra de rolagem 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 uma linha"
    Rolar o polegar "Indica a posição vertical atual e pode ser arrastado para alterá-la diretamente"
    Região de page up "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 arrastado 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 para a esquerda de uma coluna"
    Botão de seta para direita "Move a posição horizontal para a direita uma coluna"
    Rolar o polegar "Indica a posição horizontal atual e pode ser arrastado para alterá-la diretamente"
    Região esquerda da página "Move a posição horizontal para a esquerda de algumas colunas"
    Região à direita da página "Indica a posição vertical atual e pode ser arrastado 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 page up "Página para cima"
    Região de página para baixo "Page down"

     

    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 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 Parent dos botões de seta, o polegar de rolagem e a área sombreada em ambos os lados do polegar é a janela da barra de rolagem. A propriedade Parent da janela da barra de rolagem é uma janela (ROLE_SYSTEM_WINDOW) que envolve o controle e tem a mesma propriedade Name e o nome da classe de janela.

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

    Parte Função
    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 regiões à direita da página ROLE_SYSTEM_PUSHBUTTON

     

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

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

IAccessible Interface