UIElement.IsHitTestVisible プロパティ
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この要素が、表示される内容のある部分からのヒット テストの結果として返されるかどうかを宣言する値を取得または設定します。 これは依存関係プロパティです。
public:
property bool IsHitTestVisible { bool get(); void set(bool value); };
public bool IsHitTestVisible { get; set; }
member this.IsHitTestVisible : bool with get, set
Public Property IsHitTestVisible As Boolean
少なくとも 1 つの点からヒット テストの結果としてこの要素が返される場合は true
。それ以外の場合は false
。 既定値は true
です。
このプロパティの有効な値は、論理ツリー内のヒットテスト可能な要素の相対位置の影響を受けます。 たとえば、要素がヒット テストが表示されない要素の子要素である場合、その値をローカルで設定しようとしても、子のプロパティの有効な値は残ります false
。 このため、そのコントロールに対するfalse
入力テストやヒット テストが不要な場合を除き、複合コントロールに対して設定IsHitTestVisibleしないことが重要です。 ヒット テストについて詳しくは、「ビジュアル層でのヒット テスト」をご覧ください。
識別子フィールド | IsHitTestVisibleProperty |
に設定されたメタデータ プロパティ true |
なし |
製品 | バージョン |
---|---|
.NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
Windows Desktop | 3.0, 3.1, 5, 6, 7 |