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
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_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".
Tópicos relacionados