樣式控制項模式

  • 發行項

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

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

本主題包含下列各節。

實作方針和慣例

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

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

IStylesProvider的必要成員

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

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

 

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

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

UI 自動化控制項模式概觀

UI 自動化樹狀目錄概觀