IXamlDiagnostics2::HitTestForXamlRoot メソッド (xamlom.winui.h)

指定した四角形内にあるビジュアル ツリー内のすべての要素を取得します。

構文

HRESULT HitTestForXamlRoot(
  InstanceHandle instanceHandle,
  RECT           rect,
  unsigned int   *pCount,
  InstanceHandle **ppInstanceHandles
);

パラメーター

instanceHandle

XamlRoot インスタンスへのハンドル。

rect

ヒット テストの対象領域。

pCount

検出された要素の数。

ppInstanceHandles

見つかったすべての要素を含む配列。

戻り値

このメソッドは、成功すると S_OK を返します。 成功しなかった場合は、HRESULT エラー コードを返します。

解説

このメソッドは、 の境界内で として instanceHandle渡された XamlRoot のヒット テストを実行します rect。 にヒットした要素の数と、 内 pCount の要素自体 ppInstanceHandlesを返します。 このメソッドは IXamlDiagnostics::HitTest を置き換えます。これは、メイン ウィンドウが 1 つだけであり、その中でヒット テストのみを実行することを前提としています。

要件