AccControl 標記

發行項
03/06/2017

發行︰ 2016年11月

適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2013、Dynamics CRM 2015、Dynamics CRM 2016

AccControl 標記使用 Microsoft Active Accessibility (MSAA) 的 IAccessible 介面。 AccControl 標記有：

Name 屬性，定義控制項的使用者可以存取 (易記) 名稱。
Path 標記，定義應用程式的 IAccessibility 樹狀結構中控制項的搜尋路徑。<Path> 標記包含下列：FindWindow 標記和 Next 標記。

下列 XML 範例顯示使用 AccControl 標記的控制項定義。

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

注意

Path 標記的部分元素有 <match> 屬性，可用來新增計數器至搜尋描述。下列兩個範例傳回相同的搜尋結果，但是第一個範例實作 <match> 標記：

範例 1

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

範例 2：

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

如果 <match> 未指定，預設值為 0。

AccControl 標記上的 GetControlValue 方法一律對應至主旨 IAccessible 節點上的 get_accValue 方法，除非節點包含 role="radio button" 或 role="check box"。在這些情況下，GetControlValue 方法會傳回 True 或 False，視節點的狀態是否選取而定。

AccControl 標記上的 SetControlValue 方法一律對應至主旨 IAccessible 節點上的 set_accValue 方法，但擁有 role="radio button" 或 role="check box" 的節點例外。如果是選項按鈕，因為選項按鈕不得指派 True 或 False 值，會引發 UnsupportedControlOperation 例外。

下列範例顯示 <Path> 標記的 RELAX NG XML 程式碼。

# 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? }* 
   }
}

另請參閱

WinDDA
使用資料驅動型配接器 (DDA)

Unified Service Desk 2.0

共用方式為

AccControl 標記

另請參閱

其他資源