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

IUIAutomationStylesPattern

COM
📘 Microsoft Learn (日本語) · English
IID85b5f0a2-bd79-484a-ad2b-388c9838d5fb継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Microsoft UI Automation クライアントが、ドキュメント内の要素に関連付けられた視覚スタイルを取得できるようにします。

メソッド 16

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

vtbl 3 HRESULT get_CurrentStyleId(UIA_STYLE_ID* retVal)

ドキュメント内の要素に関連付けられた視覚スタイルの識別子を取得します。

retValUIA_STYLE_ID*out要素に適用されている現在のスタイルを識別するスタイル ID を受け取るポインタである。
vtbl 4 HRESULT get_CurrentStyleName(LPWSTR* retVal)

ドキュメント内の要素に関連付けられた視覚スタイルの名前を取得します。

retValLPWSTR*out現在のスタイル名を受け取る文字列ポインタへのポインタである。

解説(Remarks)

スタイル名は通常、「Heading 1」のように、ドキュメント内における要素の役割を示します。

vtbl 5 HRESULT get_CurrentFillColor(INT* retVal)

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

retValINT*out要素の現在の塗りつぶし色(COLORREF 値)を受け取るポインタである。
vtbl 6 HRESULT get_CurrentFillPatternStyle(LPWSTR* retVal)
retValLPWSTR*out現在の塗りつぶしパターンのスタイル名を受け取る文字列ポインタへのポインタである。
vtbl 7 HRESULT get_CurrentShape(LPWSTR* retVal)

ドキュメント内の要素の形状を取得します。

retValLPWSTR*out要素の現在の図形名を受け取る文字列ポインタへのポインタである。
vtbl 8 HRESULT get_CurrentFillPatternColor(INT* retVal)

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

retValINT*out現在の塗りつぶしパターンの色(COLORREF 値)を受け取るポインタである。
vtbl 9 HRESULT get_CurrentExtendedProperties(LPWSTR* retVal)

ドキュメント内の要素の拡張プロパティの一覧を格納した、ローカライズされた文字列を取得します。

retValLPWSTR*out現在の拡張プロパティを名前と値の組で表す文字列を受け取る文字列ポインタへのポインタである。
vtbl 10 HRESULT GetCurrentExtendedPropertiesAsArray(ExtendedProperty** propertyArray, INT* propertyCount)
propertyArrayExtendedProperty**out現在の拡張プロパティを ExtendedProperty 構造体の配列として受け取るポインタへのポインタである。
propertyCountINT*out返された拡張プロパティ配列の要素数を受け取るポインタである。
vtbl 11 HRESULT get_CachedStyleId(UIA_STYLE_ID* retVal)

ドキュメント内の要素に関連付けられた視覚スタイルの、キャッシュされた識別子を取得します。

retValUIA_STYLE_ID*outキャッシュされたスタイル ID を受け取るポインタである。
vtbl 12 HRESULT get_CachedStyleName(LPWSTR* retVal)

ドキュメント内の要素に関連付けられた視覚スタイルの、キャッシュされた名前を取得します。

retValLPWSTR*outキャッシュされたスタイル名を受け取る文字列ポインタへのポインタである。

解説(Remarks)

スタイル名は通常、「Heading 1」のように、ドキュメント内における要素の役割を示します。

vtbl 13 HRESULT get_CachedFillColor(INT* retVal)

ドキュメント内の要素の、キャッシュされた塗りつぶし色を取得します。

retValINT*outキャッシュされた塗りつぶし色(COLORREF 値)を受け取るポインタである。
vtbl 14 HRESULT get_CachedFillPatternStyle(LPWSTR* retVal)
retValLPWSTR*outキャッシュされた塗りつぶしパターンのスタイル名を受け取る文字列ポインタへのポインタである。
vtbl 15 HRESULT get_CachedShape(LPWSTR* retVal)

ドキュメント内の要素の、キャッシュされた形状を取得します。

retValLPWSTR*outキャッシュされた図形名を受け取る文字列ポインタへのポインタである。
vtbl 16 HRESULT get_CachedFillPatternColor(INT* retVal)

ドキュメント内の要素の塗りつぶしに使用されるパターンの、キャッシュされた色を取得します。

retValINT*outキャッシュされた塗りつぶしパターンの色(COLORREF 値)を受け取るポインタである。
vtbl 17 HRESULT get_CachedExtendedProperties(LPWSTR* retVal)

ドキュメント内の要素の拡張プロパティの一覧を格納した、キャッシュされたローカライズ済み文字列を取得します。

retValLPWSTR*outキャッシュされた拡張プロパティを表す文字列を受け取る文字列ポインタへのポインタである。
vtbl 18 HRESULT GetCachedExtendedPropertiesAsArray(ExtendedProperty** propertyArray, INT* propertyCount)
propertyArrayExtendedProperty**outキャッシュされた拡張プロパティを ExtendedProperty 構造体の配列として受け取るポインタへのポインタである。
propertyCountINT*out返されたキャッシュ拡張プロパティ配列の要素数を受け取るポインタである。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IUIAutomationStylesPattern "{85B5F0A2-BD79-484A-AD2B-388C9838D5FB}"
#usecom global IUIAutomationStylesPattern IID_IUIAutomationStylesPattern "{}"
#comfunc global IUIAutomationStylesPattern_get_CurrentStyleId                   3 var
#comfunc global IUIAutomationStylesPattern_get_CurrentStyleName                 4 var
#comfunc global IUIAutomationStylesPattern_get_CurrentFillColor                 5 var
#comfunc global IUIAutomationStylesPattern_get_CurrentFillPatternStyle          6 var
#comfunc global IUIAutomationStylesPattern_get_CurrentShape                     7 var
#comfunc global IUIAutomationStylesPattern_get_CurrentFillPatternColor          8 var
#comfunc global IUIAutomationStylesPattern_get_CurrentExtendedProperties        9 var
#comfunc global IUIAutomationStylesPattern_GetCurrentExtendedPropertiesAsArray  10 var,var
#comfunc global IUIAutomationStylesPattern_get_CachedStyleId                    11 var
#comfunc global IUIAutomationStylesPattern_get_CachedStyleName                  12 var
#comfunc global IUIAutomationStylesPattern_get_CachedFillColor                  13 var
#comfunc global IUIAutomationStylesPattern_get_CachedFillPatternStyle           14 var
#comfunc global IUIAutomationStylesPattern_get_CachedShape                      15 var
#comfunc global IUIAutomationStylesPattern_get_CachedFillPatternColor           16 var
#comfunc global IUIAutomationStylesPattern_get_CachedExtendedProperties         17 var
#comfunc global IUIAutomationStylesPattern_GetCachedExtendedPropertiesAsArray   18 var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。