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

IUIAutomationDockPattern

COM
📘 Microsoft Learn (日本語) · English
IIDfde5ef97-1464-48f6-90bf-43d0948e86ec継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

子要素を相互に対して水平方向および垂直方向に配置できるようにするコントロールへのアクセスを提供します。

解説(Remarks)

Microsoft UI Automation クライアントアプリケーションは、このインターフェイスを使用して、ドッキングコンテナー内でコントロールとして機能する UI Automation 要素のドッキングプロパティにアクセスします。ドッキングコンテナーとは、ドッキングコンテナーの境界やコンテナー内の他の要素を基準として、子要素を水平方向および垂直方向の両方に配置できるコントロールです。コントロールは現在の z オーダーに基づいて相互にドッキングされ、z オーダーの配置が上位であるほど、ドッキングコンテナーの指定された端から遠くに配置されます。

メソッド 3

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

vtbl 3 HRESULT SetDockPosition(DockPosition dockPos)

この要素のドッキング位置を設定します。

dockPosDockPositionin新しいドッキング位置。

戻り値

型: HRESULT

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

vtbl 4 HRESULT get_CurrentDockPosition(DockPosition* retVal)

ドッキングコンテナー内におけるこの要素のドッキング位置を取得します。

retValDockPosition*out現在のドッキング位置を示す DockPosition 値を受け取るポインタである。
vtbl 5 HRESULT get_CachedDockPosition(DockPosition* retVal)

ドッキングコンテナー内におけるこの要素のキャッシュされたドッキング位置を取得します。

retValDockPosition*outキャッシュされたドッキング位置を示す DockPosition 値を受け取るポインタである。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IUIAutomationDockPattern "{FDE5EF97-1464-48F6-90BF-43D0948E86EC}"
#usecom global IUIAutomationDockPattern IID_IUIAutomationDockPattern "{}"
#comfunc global IUIAutomationDockPattern_SetDockPosition          3 int
#comfunc global IUIAutomationDockPattern_get_CurrentDockPosition  4 var
#comfunc global IUIAutomationDockPattern_get_CachedDockPosition   5 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。