UIElement.IsHitTestVisible プロパティ


この要素が、表示される内容のある部分からのヒット テストの結果として返されるかどうかを宣言する値を取得または設定します。Gets or sets a value that declares whether this element can possibly be returned as a hit test result from some portion of its rendered content. これは依存関係プロパティです。This is a dependency property.

 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。それ以外の場合は falsetrue if this element could be returned as a hit test result from at least one point; otherwise, false. 既定値は true です。The default value is true.


このプロパティの有効値は、論理ツリー内のヒットテスト可能な要素の相対位置によって影響を受けます。The effective value of this property is influenced by the relative positions of hit testable elements in the logical tree. たとえば、要素がヒットテストで表示されない要素の子要素である場合、 false その値をローカルに設定しようとしても、子のプロパティの有効値は維持されます。For instance, if an element is a child element of an element that is not hit test visible, the effective value of the property on the child will remain false, even if attempting to set that value locally. そのため、 IsHitTestVisible false そのコントロールに対して入力またはヒットテストを行わない場合は、複合コントロールでをに設定しないことが重要です。For this reason, it is important that you do not set IsHitTestVisible to false on a composited control unless you do not want any input or hit testing on that control. ヒット テストについて詳しくは、「ビジュアル層でのヒット テスト」をご覧ください。For more information on hit testing, see Hit Testing in the Visual Layer.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field IsHitTestVisibleProperty
メタデータプロパティがに設定される trueMetadata properties set to true なしNone