This documentation is archived and is not being maintained.

FrameworkContentElement.Cursor Property

Gets or sets the cursor that displays when the mouse pointer is over this element.

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

member Cursor : Cursor with get, set

<object Cursor="Cursor" .../>

Property Value

Type: System.Windows.Input.Cursor
The cursor to display. The default value is defined as a null reference (Nothing in Visual Basic) per this dependency property. However, the practical default at run time will come from a variety of factors.

Identifier field

CursorProperty

Metadata properties set to true

None

When setting this property in XAML, the XAML processor relies on type conversion for the Cursor class to evaluate the string. The provided string should evaluate to a CursorType value. See Cursor for details.

Whether the cursor as established by this property will or will not display when the mouse pointer is over this element is also dependent on the value of the ForceCursor property. Also, event-related considerations such as an active drag, mouse capture, text editing modes within controls, and so on, will also affect the cursor with higher priority than the value you specify in this property.

To revert the behavior of setting this property to the eventual default, set it to a null reference (Nothing in Visual Basic) again.

The a null reference (Nothing in Visual Basic) default really means that determination of the practical cursor value is deferred here and should be obtained from elsewhere. If presented with no programmatic values from any source, the default cursor over a Windows Presentation Foundation (WPF) application will be an arrow.

Each movement of the mouse over a WPF application raises a QueryCursor event. The event bubbles, and any element along the route has the opportunity to handle the event and to set the value of the cursor via the arguments of this event. If that happens, the fact that the event is handled and has a changed value in the arguments takes precedence over the value of the Cursor property at any level, unless ForceCursor is set.

If not creating a custom cursor, typically you set this property to a static property value of the Cursors class.

Setting the Cursor to a custom value is not enabled in partial trust. For more information on custom cursors, see Input Overview.

The following example sets the cursor to a custom value.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: