PlacementMode Enumeration

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Specifies the preferred location for positioning a ToolTip relative to a visual element.

Namespace:  System.Windows.Controls.Primitives
Assembly:  System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.

Syntax

Public Enumeration PlacementMode
public enum PlacementMode
<objectproperty = "enumMemberName"/>

Members

Member name Description
Bottom Indicates that the preferred location of the tooltip is at the bottom of the target element.
Right Indicates that the preferred location of the tooltip is at the right of the target element.
Mouse Indicates that the preferred location of the tooltip is at the pointer location.
Left Indicates that the preferred location of the tooltip is at the left of the target element.
Top Indicates that the preferred location of the tooltip is at the top of the target element.

Remarks

Use members of PlacementMode to set the Placement property of ToolTip or ToolTipService. Setting the Placement property on ToolTipService takes precedence over the Placement value of ToolTip, when the tooltip is activated.

If the tooltip does not fit within the bounds of the page at the specified placement, it is automatically moved to a location where it fits. The tooltip is first moved to the opposite location of the specified placement, and then to the other locations in a top-to-bottom, left-to-right order. If the tooltip does not fit completely at the top, bottom, left, or right of the target element, the tooltip is positioned at the right and is clipped. For example, if you specify Top, and the tooltip does not fit within the bounds of the page at the top of the target element, the tooltip is moved to the bottom of the target. If it does not fit at the bottom, it is moved to the left, and if it does not fit at the left it is moved to the right of the target.

If the tooltip exceeds the width of the page, it is clipped.

If the tooltip is automatically moved, the Placement value for the ToolTip or ToolTipService is not changed.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

System.Windows.Controls.Primitives Namespace