Freigeben über


AccControl-Tag

Das AccControl-Tag verwendet die IAccessible-Benutzeroberfläche von Microsoft Active Accessibility (MSAA). Das AccControl-Tag verfügt über:

  • Name Eigenschaft, um den für den Benutzer zugänglichen (freundlichen) Anzeigenamen für ein Steuerelement zu definieren.

  • <Path>-Tag, um einen Suchpfad für das Steuerelement im IAccessibility-Baum der Anwendung zu definieren. Das <Path>-Tag beinhaltet Folgendes: FindWindow-Tag und Nächstes Tag.

Das folgende XML-Beispiel zeigt eine Steuerelementdefinition unter Verwendung des AccControl-Tags.

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

Notiz

Einige Elemente im Path-Tag besitzen ein <match>-Attribut, das Sie verwenden können, um der Suchbeschreibung einen Zähler hinzuzufügen. Beide der folgenden Beispiele geben das gleiche Suchergebnis zurück, das erste Beispiel implementiert jedoch das <match>-Tag:

Beispiel 1

<Caption match="2">Test Application</Caption>  

Beispiel 2

<Caption>Test Application</Caption>  
<Caption>Test Application</Caption>  

Wenn <match> nicht angegeben ist, ist der Standardwert 0.

Die String-Methode auf einem AccControl-Tag wird immer der get_accValue-Methode auf dem IAccessible-Betreff-Knoten zugeordnet, sofern der Knoten nicht role="radio button" oder role="check box" enthält. In solchen Fällen gibt die String)-Methode True oder False zurück, je nachdem, ob der Status des Knotens ausgewählt ist.

Die String)-Methode auf einem AccControl-Tag wird immer der set_accValue-Methode auf dem IAccessible-Betreff-Knoten zugeordnet, ausgenommen Knoten, die role="radio button" oder role="check box" enthalten. Im Falle eines Optionsfelds wird eine UnsupportedControlOperation -Ausnahme ausgelöst, weil ein Optionsfeld nicht einem True- oder False-Wert zugewiesen werden kann.

Im folgenden Beispiel wird der RELAX NG-XML-Code für das <Path>-Tag angezeigt.

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

Siehe auch

Win DDA
Verwenden von datengesteuerten Adaptern (DDAs)