PlacementMode Enumeration

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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)

Syntax

'Declaration
Public Enumeration PlacementMode
public enum PlacementMode
<object property = "enumMemberName"/>

Members

Member name Description
Supported by Silverlight for Windows Phone Bottom Indicates that the preferred location of the tooltip is at the bottom of the target element.
Supported by Silverlight for Windows Phone Right Indicates that the preferred location of the tooltip is at the right of the target element.
Supported by Silverlight for Windows Phone Mouse Indicates that the preferred location of the tooltip is at the mouse pointer location.
Supported by Silverlight for Windows Phone Left Indicates that the preferred location of the tooltip is at the left of the target element.
Supported by Silverlight for Windows Phone 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 with the mouse.

If the tooltip does not fit within the bounds of the Silverlight plug-in 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 plug-in 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 browser, it is clipped.

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.