UIElement.IsHitTestVisible Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.
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
Property Value
true
if this element could be returned as a hit test result from at least one point; otherwise, false
. The default value is true
.
Remarks
The effective value of this property is influenced by the relative positions of hit testable elements in the logical tree. 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. 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
Item | Value |
---|---|
Identifier field | IsHitTestVisibleProperty |
Metadata properties set to true |
None |
Applies to
See also
.NET