UIElement.IsHitTestVisible Property (System.Windows)

IsHitTestVisible Property

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

UIElement..::.IsHitTestVisible Property

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.

Namespace: System.Windows
Assembly: PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/xaml/presentation

Syntax

Visual Basic (Declaration)

Public Property IsHitTestVisible As Boolean

Visual Basic (Usage)

Dim instance As UIElement
Dim value As Boolean

value = instance.IsHitTestVisible

instance.IsHitTestVisible = value

public bool IsHitTestVisible { get; set; }

Visual C++

public:
property bool IsHitTestVisible {
    bool get ();
    void set (bool value);
}

JScript

public function get IsHitTestVisible () : boolean
public function set IsHitTestVisible (value : boolean)

XAML Attribute Usage

<object IsHitTestVisible="bool" .../>

Property Value

Type: System..::.Boolean
true if this element could be returned as a hit test result from at least one point; otherwise, false. The default value is true.

Dependency Property Information

Identifier field	IsHitTestVisibleProperty
Metadata properties set to true	None

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.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

UIElement Class

UIElement Members

System.Windows Namespace

IsHitTestVisibleChanged

Other Resources

Hit Testing in the Visual Layer