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

IUIAutomationSelectionItemPattern

COM
IIDa8efa66a-0fda-421a-9194-38021f3578ea継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IUIAutomationSelectionPattern をサポートするコンテナーコントロールの、選択可能な子項目へのアクセスを提供します。

メソッド 7

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

vtbl 3 HRESULT Select()

選択されている項目をすべて解除してから、現在の要素を選択します。

戻り値

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 4 HRESULT AddToSelection()

現在の要素を、選択されている項目のコレクションに追加します。(IUIAutomationSelectionItemPattern.AddToSelection)

戻り値

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 5 HRESULT RemoveFromSelection()

この要素を選択対象から削除します。

戻り値

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

この要素が選択対象の唯一の要素であり、かつ選択コンテナーが少なくとも 1 つの要素の選択を必要とする場合は、エラーコードが返されます。

vtbl 6 HRESULT get_CurrentIsSelected(BOOL* retVal)

この項目が選択されているかどうかを示します。

retValBOOL*outこの項目が現在選択されているかどうかを示す論理値を受け取るポインタである。
vtbl 7 HRESULT get_CurrentSelectionContainer(IUIAutomationElement** retVal)

IUIAutomationSelectionPattern をサポートし、この項目のコンテナーとして機能する要素を取得します。

retValIUIAutomationElement**outこの項目を含む選択コンテナの要素を受け取るインターフェイスポインタへのポインタである。
vtbl 8 HRESULT get_CachedIsSelected(BOOL* retVal)

この項目が選択されているかどうかを示す、キャッシュされた値です。

retValBOOL*outキャッシュされた、項目が選択されているかどうかを示す論理値を受け取るポインタである。
vtbl 9 HRESULT get_CachedSelectionContainer(IUIAutomationElement** retVal)

IUIAutomationSelectionPattern をサポートし、この項目のコンテナーとして機能する、キャッシュされた要素を取得します。

retValIUIAutomationElement**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_IUIAutomationSelectionItemPattern "{A8EFA66A-0FDA-421A-9194-38021F3578EA}"
#usecom global IUIAutomationSelectionItemPattern IID_IUIAutomationSelectionItemPattern "{}"
#comfunc global IUIAutomationSelectionItemPattern_Select                         3
#comfunc global IUIAutomationSelectionItemPattern_AddToSelection                 4
#comfunc global IUIAutomationSelectionItemPattern_RemoveFromSelection            5
#comfunc global IUIAutomationSelectionItemPattern_get_CurrentIsSelected          6 var
#comfunc global IUIAutomationSelectionItemPattern_get_CurrentSelectionContainer  7 sptr
#comfunc global IUIAutomationSelectionItemPattern_get_CachedIsSelected           8 var
#comfunc global IUIAutomationSelectionItemPattern_get_CachedSelectionContainer   9 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。