Partilhar via

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

Observação

Este tópico descreve objetos barra de rolagem para fins de referência de elemento da 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 da 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 propriedadesIAccessible dodepende se a barra de rolagem é vertical ou horizontal e em qual das seguintes partes da barra de rolagem está sendo consultada pelo cliente:

  • A barra de rolagem em si
  • O botão de seta para a frente ou para a direita
  • 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 da página para a esquerda

Métodos IAccessible

Uma barra de rolagem suporta os seguintes métodos IAccessible:

  • accDoDefaultAction—O próprio objeto da barra de rolagem e o polegar de rolagem não suportam o 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 definida para os seguintes valores.

    Botão/Região Vaule
    Botão de seta para cima SB_LINEUP
    Botão de seta para baixo SB_LINEDOWN
    Região acima da página 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 seguintes valores.

    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

  • accLocalização

  • accNavigate

Propriedades IAccessible

Uma barra de rolagem suporta as 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 próprio objeto da barra de rolagem e o polegar de rolagem não suportam a 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 consultada.

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

    Peça Descrição
    Barra de rolagem em si "Usado para alterar a área de visualização vertical"
    Botão de seta para cima "Move a posição vertical para cima uma linha"
    Botão de seta para baixo "Move a posição vertical para baixo uma linha"
    Polegar de rolagem "Indica a posição vertical atual e pode ser arrastado para alterá-la diretamente"
    Região acima da página "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 seguintes descrições.

    Peça Descrição
    Barra de rolagem em si "Usado para alterar a área de visualização horizontal"
    Botão de seta para a esquerda "Move a posição horizontal para a esquerda uma coluna"
    Botão de seta para a direita 'Move a posição horizontal para a direita uma coluna'
    Polegar de rolagem "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 um par de 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 Nome depende da parte da barra de rolagem consultada.

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

    Peça Designação
    Janela da barra de rolagem "Vertical"
    Botão de seta para cima "Alinhamento"
    Botão de seta para baixo "Linha para baixo"
    Polegar de rolagem "Posição"
    Região acima da página "Página para cima"
    Região de página para baixo "Página abaixo"

     

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

    Peça Designação
    Janela da barra de rolagem "Horizontal"
    Botão de seta para a esquerda "Coluna à esquerda"
    Botão de seta para a direita "Coluna direita"
    Polegar de rolagem "Posição"
    Região direita da página "Direita de página"
    Região esquerda da página "Página à esquerda"

     

  • get_accParent—A propriedade pai dos botões de seta, 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 window class name.

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

    Peça Funções
    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
    Polegar de rolagem ROLE_SYSTEM_INDICATOR
    Regiões de página para cima, página para baixo, página esquerda e página direita 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 barra de rolagem em si, 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 forma que a região não exista.
    STATE_SYSTEM_OFFSCREEN Para a barra de rolagem em si, isso indica que a janela é dimensionada de tal forma que a barra de rolagem vertical ou horizontal especificada não é exibida no momento.
    STATE_SYSTEM_PRESSED O botão de seta ou a região da página é pressionada.
    STATE_SYSTEM_UNAVAILABLE O componente está desativado.

     

  • 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

 

 

  • Last updated on