樣式控制項模式

描述實作 IStylesProvider的指導方針和慣例,包括屬性和方法的相關資訊。 樣式控制項模式是用來描述具有特定樣式、填滿色彩、填滿圖樣或圖案的 UI 元素。

樣式控制項模式特別適用于描述檔中經常有這類樣式的專案。 樣式通常會攜帶適用于殘障客戶的資訊;例如,樣式可以將特定字串描述為檔的標題,或將特定流程圖物件描述為菱形或圓形。 如需實作此控制項模式的控制項範例,請參閱 控制項類型及其支援的控制項模式

本主題包含下列各節。

實作方針和慣例

實作 樣式 控制項模式時,請注意下列指導方針和慣例:

  • UIAutomationClient.h 標頭檔會定義一組具名常數值,用來識別數個常見的樣式。 如需詳細資訊,請參閱 樣式識別碼
  • 如果您使用 StyleId_Custom,您必須實作 IStylesProvider::StyleName 屬性,讓用戶端能夠探索樣式的名稱。 您不需要實作標準樣式的StyleName屬性,因為 Microsoft 消費者介面自動化提供預設名稱,但如果您需要覆寫預設名稱,您可以實作它。
  • 樣式模式中的其他屬性是選擇性的;提供者可以針對不支援的屬性傳回UIA_E_NOTSUPPORTED
  • 文字範圍中的樣式可以透過下列文字屬性來表示:
    • 回應 StyleId 文字屬性的要求時,文字範圍應該會傳回 樣式識別碼中所述的其中一個樣式識別碼。
    • 如果使用 StyleId_Custom ,文字範圍應該會傳回 StyleName 文字屬性的字串值,讓用戶端能夠探索樣式名稱。
    • 具有多個樣式的文字範圍,例如標題和一般文字,都應該針對StyleIdStyleName屬性傳回特殊消費者介面自動化ReservedMixedAttributeValue屬性。 接收此回應的用戶端可以細分文字範圍,以尋找樣式的開始和結束位置。
  • 應用程式可以使用各種不同的樣式來描述物件,但消費者介面自動化只代表最常見的樣式。 若要代表其他樣式屬性,例如框線色彩,提供者可以傳回 ExtendedProperties 屬性中的其他屬性清單。 這基本上是具有一組擴充屬性的屬性包,例如 「BorderColor=0xFF0000;BorderStyle=dotted「。 擴充屬性的值可以是應用程式特定的值。

IStylesProvider的必要成員

實作 IStylesProvider 介面需要下列屬性。

必要成員 成員類型 備註
ExtendedProperties 屬性
FillColor 屬性
FillPatternColor 屬性
FillPatternStyle 屬性
圖形 屬性
StyleId 屬性
StyleName 屬性

 

此控制項模式沒有任何相關聯的方法或事件。

控制項類型及其支援的控制項模式

UI 自動化控制項模式概觀

UI 自動化樹狀目錄概觀