Partilhar via


Etiqueta AccControl

A etiqueta AccControl utiliza a interface IAccessible do Microsoft Active Accessibility (MSAA). A etiqueta AccControl tem:

  • A propriedade Name para definir o nome acessível pelo utilizador (amigável) de um controlo.

  • A etiqueta Path para definir um caminho de pesquisa para o controlo na árvore IAccessibility da aplicação. A eitqueta <Path> contém o seguinte: Etiqueta FindWindow e Etiqueta Seguinte.

O exemplo XML seguinte mostra a definição de controlo utilizando a etiqueta AccControl.

<AccControl name="Control Name">
   <Path> 
      <FindWindow>
         <CaptionStartsWith>Customer App</CaptionStartsWith>
      </FindWindow>
      <Next/>
      <Next match="2">Customer Name:</Next>
   </Path>
</AccControl>

Nota

Alguns elementos da etiqueta Path têm um atributo <match> que pode utilizar para adicionar um contados à descrição da pesquisa. Ambos os seguintes exemplos devolvem o mesmo resultado, mas o primeiro implementa a etiqueta <match>:

  • Exemplo 1

    <Caption match="2">Test Application</Caption>
  • Exemplo 2:

    <Caption>Test Application</Caption> <Caption>Test Application</Caption>
Se <match> não for especificado, o valor predefinido é 0.

O método GetControlValue numa etiqueta AccControl está sempre mapeado para o método get_accValue no nó IAccessible do assunto, a menos que o nó contenha role="radio button" ou role="check box". Nestes casos, o método GetControlValue devolve True ou False, consoante o estado do nó está selecionado.

O método SetControlValue numa etiqueta AccControl está sempre mapeado para o método set_accValue no nó IAccessible do assunto, com a exceção dos nós que têm o role="radio button" ou role="check box". No caso de um botão de opção, uma exceção UnsupportedControlOperation é emitida porque não é possível atribuir um valor True ou False a um botão de opção.

O seguinte exemplo apresenta código XML RELAX NG para a etiqueta <Path>.

# RELAX NG XML grammar for Path
# http://relaxng.org/compact-tutorial-20030326.html
grammar 
{
   start = Path
   Path = element Path 
   { 
      FindWindow* & element Next 
      { attribute match { xsd:integer }?
      ,attribute offset { xsd:integer  }?,text? }* 
   }
}

Consulte Também

Conceitos

WinDDA
Utilizar adaptadores orientados por dados (DDAs)

Unified Service Desk
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.