次の方法で共有

スタイル コントロール パターン

  • [アーティクル]

プロパティとメソッドに関する情報を含む、IStylesProviderを実装するためのガイドラインと規則について説明します。 コントロール パターン スタイルは、特定のスタイル、塗りつぶしの色、塗りつぶしパターン、または図形を持つ UI 要素を記述するために使用されます。

スタイル コントロール パターンは、このようなスタイルが頻繁に含まれるドキュメント内の要素を記述する場合に特に便利です。 スタイルは、通常、障のあるお客様に役立つ情報を伝達します。たとえば、スタイルでは、特定の文字列を文書のタイトルとして記述したり、特定のフローチャート オブジェクトをひし形や円として記述したりできます。 このコントロール パターンを実装するコントロールの例については、「コントロールの種類とサポートされるコントロール パターンの」を参照してください。

このトピックには、次のセクションが含まれています。

実装のガイドラインと規則

コントロール パターン スタイルを実装する場合は、次のガイドラインと規則に注意してください。

  • UIAutomationClient.h ヘッダー ファイルは、いくつかの一般的なスタイルを識別するために使用される名前付き定数値のセットを定義します。 詳細については、「スタイル識別子の」を参照してください。
  • StyleId_Customを使用する場合は、IStylesProvider::StyleName プロパティを実装して、クライアントがスタイルの名前を検出できるようにする必要があります。 Microsoft UI オートメーションでは既定の名前が提供されるため、標準スタイルの StyleName プロパティを実装する必要はありませんが、既定の名前をオーバーライドする必要がある場合は実装できます。
  • スタイル パターンのその他のプロパティは省略可能です。プロバイダーは、サポートされていないプロパティの UIA_E_NOTSUPPORTED を返すことができます。
  • テキスト範囲内のスタイルは、次のテキスト属性を使用して表すことができます。
    • StyleId テキスト属性の要求に応答する場合、テキスト範囲は、スタイル識別子で説明されているスタイル識別子のいずれかを返す必要があります。
    • StyleId_Custom を使用する場合、クライアントがスタイル名を検出できるようにするには、テキスト範囲から StyleName テキスト属性の文字列値が返されます。
    • 見出しと通常のテキストの両方など、複数のスタイルを持つテキスト範囲は、StyleId プロパティと StyleName プロパティの両方に対して、ReservedMixedAttributeValueプロパティ特別な UI オートメーション プロパティを返す必要があります。 この応答を受け取るクライアントは、テキスト範囲を分割して、スタイルの開始位置と終了位置を見つけることができます。
  • アプリケーションではさまざまなスタイルを使用してオブジェクトを記述できますが、UI オートメーションは最も一般的なスタイルのみを表します。 罫線の色などの追加のスタイル属性を表すために、プロバイダーは、ExtendedProperties プロパティ内の追加の属性の一覧を返すことができます。 これは基本的に、"BorderColor=0xFF0000; など、一連の拡張プロパティを含むプロパティ バッグです。BorderStyle=dotted"。 拡張プロパティの値は、アプリケーション固有にすることができます。

IStylesProvider に必要なメンバー

IStylesProvider インターフェイスを実装する場合は、次のプロパティが必要です。

必須メンバー メンバーの種類 筆記
ExtendedPropertiesの 財産 何一つ
FillColorの 財産 何一つ
FillPatternColorをする 財産 何一つ
FillPatternStyle 財産 何一つ
図形 財産 何一つ
StyleId 財産 何一つ
StyleName 財産 何一つ

 

このコントロール パターンには、関連付けられたメソッドやイベントはありません。

コントロールの種類とサポートされているコントロール パターン

UI オートメーション コントロール パターンの概要

UI オートメーション ツリーの概要