樣式控制項模式
描述實作 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 | 屬性 | 無 |
此控制項模式沒有任何相關聯的方法或事件。
相關主題