Win32 API 日本語リファレンス
ホーム › UI.Accessibility › IStylesProvider

IStylesProvider

COM
📘 Microsoft Learn (日本語) · English
IID19b6b649-f5d7-4a6d-bdcb-129252be588a継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ドキュメントのコンテンツに関連付けられた視覚スタイルへのアクセスを提供します。

メソッド 7

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT get_StyleId(UIA_STYLE_ID* retVal)

ドキュメント内の要素の視覚スタイルを識別します。

retValUIA_STYLE_ID*out要素に適用されているスタイルを示す UIA_STYLE 識別子を受け取るポインタである。

解説(Remarks)

プロバイダーは、クライアントアプリケーションにとって有用なスタイル識別子を公開するために、このプロパティを使用する必要があります。たとえば、プロバイダーはプレゼンテーションのタイトルを表す要素に対して StyleId_Title 識別子を公開する場合があります。スクリーンリーダーは StyleId プロパティを取得し、その要素がプレゼンテーションのタイトルであることを認識して、ユーザーにタイトルを読み上げることができます。

リストスタイル

リストスタイル用の ID は Windows 8.1 以降でサポートされています。

これらのスタイルは段落レベルで適用する必要があります。リスト項目の一部であるすべてのテキストには、これらのスタイルのいずれかが適用されている必要があります。

リスト内で箇条書きスタイルが混在している場合は、範囲全体に BulletedList スタイルを適用し、BulletStyle 属性値(UIA_BulletStyleAttributeId によって識別されるプロパティ)は、範囲内のさまざまな箇条書きの種類の内訳に応じて混在させる必要があります。

ネストされたリストにも箇条書きが含まれている場合(メインのリストとは異なる種類である可能性があります)、BulletedList スタイルは範囲全体に適用され、BulletStyle 属性値は(ネストされたリストを含む範囲について)そのネストされた箇条書きスタイルの値になります。

vtbl 4 HRESULT get_StyleName(LPWSTR* retVal)

ドキュメント内の要素の視覚スタイルの名前を指定します。

retValLPWSTR*outスタイルのローカライズされた名前を文字列で受け取る LPWSTR へのポインタである。

解説(Remarks)

スタイル名は通常、「見出し 1」のような、ドキュメント内での要素の役割を示します。

vtbl 5 HRESULT get_FillColor(INT* retVal)

ドキュメント内の要素の塗りつぶしの色を指定します。

retValINT*out要素の塗りつぶし色を COLORREF 形式の整数で受け取る INT へのポインタである。
vtbl 6 HRESULT get_FillPatternStyle(LPWSTR* retVal)

ドキュメント内の要素の塗りつぶしパターンのスタイルを指定します。

retValLPWSTR*out塗りつぶしパターンのスタイル名を文字列で受け取る LPWSTR へのポインタである。
vtbl 7 HRESULT get_Shape(LPWSTR* retVal)

ドキュメント内の要素の図形を指定します。

retValLPWSTR*out要素の図形(シェイプ)を表す文字列を受け取る LPWSTR へのポインタである。
vtbl 8 HRESULT get_FillPatternColor(INT* retVal)

ドキュメント内の要素の塗りつぶしに使用されるパターンの色を指定します。

retValINT*out塗りつぶしパターンの色を COLORREF 形式の整数で受け取る INT へのポインタである。
vtbl 9 HRESULT get_ExtendedProperties(LPWSTR* retVal)

このコントロールパターンには含まれていないものの、ユーザーにとって有用となり得るドキュメントコンテンツに関する情報を提供する追加のプロパティが含まれます。

retValLPWSTR*out標準プロパティに含まれない拡張プロパティを名前と値の組で表す文字列を受け取る LPWSTR へのポインタである。

解説(Remarks)

拡張プロパティはユーザーによって利用されることを目的としているため、ローカライズする必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IStylesProvider "{19B6B649-F5D7-4A6D-BDCB-129252BE588A}"
#usecom global IStylesProvider IID_IStylesProvider "{}"
#comfunc global IStylesProvider_get_StyleId             3 var
#comfunc global IStylesProvider_get_StyleName           4 var
#comfunc global IStylesProvider_get_FillColor           5 var
#comfunc global IStylesProvider_get_FillPatternStyle    6 var
#comfunc global IStylesProvider_get_Shape               7 var
#comfunc global IStylesProvider_get_FillPatternColor    8 var
#comfunc global IStylesProvider_get_ExtendedProperties  9 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。