ToolTip.Placement Property

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

Gets or sets how the ToolTip should be positioned in relation to the PlacementTarget.

Namespace:  System.Windows.Controls
Assembly:  System.Windows (in System.Windows.dll)

Syntax

'Declaration
Public Property Placement As PlacementMode
public PlacementMode Placement { get; set; }
<ToolTip Placement="placementModeValue"/>

XAML Values

  • placementModeValue
    A named constant of the PlacementMode enumeration, such as Top.

Property Value

Type: System.Windows.Controls.Primitives.PlacementMode
One of the PlacementMode values. The default is Mouse.

Remarks

The PlacementTarget and Placement properties are used together to determine which side of a visual element to place the ToolTip.

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.