ToolTip.PlacementTarget Property (System.Windows.Controls)

.NET Framework Class Library

ToolTip..::.PlacementTarget Property

Gets or sets the UIElement relative to which the ToolTip is positioned when it opens. This is a dependency property.

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

Syntax

Visual Basic (Declaration)

<BindableAttribute(True)> _
Public Property PlacementTarget As UIElement

Visual Basic (Usage)

Dim instance As ToolTip
Dim value As UIElement

value = instance.PlacementTarget

instance.PlacementTarget = value

[BindableAttribute(true)]
public UIElement PlacementTarget { get; set; }

Visual C++

[BindableAttribute(true)]
public:
property UIElement^ PlacementTarget {
    UIElement^ get ();
    void set (UIElement^ value);
}

JScript

public function get PlacementTarget () : UIElement
public function set PlacementTarget (value : UIElement)

XAML Property Element Usage

<object>
  <object.PlacementTarget>
    <UIElement .../>
  </object.PlacementTarget>
</object>

Property Value

Type: System.Windows..::.UIElement
The UIElement that is the logical parent of the ToolTip control. The default is nullNothingnullptra null reference (Nothing in Visual Basic).

Dependency Property Information

Identifier field	PlacementTargetProperty
Metadata properties set to true	None

Remarks

You can position a ToolTip by setting the PlacementTarget, PlacementRectangle, Placement, HorizontalOffset, and VerticalOffsetProperty properties. These properties behave the same as they do for a Popup. For more information, see Popup Placement Behavior.

Examples

The following example shows how to create and position a ToolTip.

XAML

<Ellipse Height="25" Width="50" 
         Fill="Gray" 
         HorizontalAlignment="Left"
         ToolTipService.InitialShowDelay="1000"
         ToolTipService.ShowDuration="7000"
         ToolTipService.BetweenShowDelay="2000">
  <Ellipse.ToolTip>
    <ToolTip Placement="Right" 
             PlacementRectangle="50,0,0,0"
             HorizontalOffset="10" 
             VerticalOffset="20"
             HasDropShadow="false"
             Opened="whenToolTipOpens"
             Closed="whenToolTipCloses"
             >
      <BulletDecorator>
        <BulletDecorator.Bullet>
          <Ellipse Height="10" Width="20" Fill="Blue"/>
        </BulletDecorator.Bullet>
        <TextBlock>Uses the ToolTip Class</TextBlock>
      </BulletDecorator>
    </ToolTip>
  </Ellipse.ToolTip>
</Ellipse>

//Create an ellipse that will have a 
//ToolTip control. 
Ellipse ellipse1 = new Ellipse();
ellipse1.Height = 25;
ellipse1.Width = 50;
ellipse1.Fill = Brushes.Gray;
ellipse1.HorizontalAlignment = HorizontalAlignment.Left;

//Create a tooltip and set its position.
ToolTip tooltip = new ToolTip();
tooltip.Placement = PlacementMode.Right;
tooltip.PlacementRectangle = new Rect(50, 0, 0, 0);
tooltip.HorizontalOffset = 10;
tooltip.VerticalOffset = 20;

//Create BulletDecorator and set it
//as the tooltip content.
BulletDecorator bdec = new BulletDecorator();
Ellipse littleEllipse = new Ellipse();
littleEllipse.Height = 10;
littleEllipse.Width = 20;
littleEllipse.Fill = Brushes.Blue;
bdec.Bullet = littleEllipse;
TextBlock tipText = new TextBlock();
tipText.Text = "Uses the ToolTip class";
bdec.Child = tipText;
tooltip.Content = bdec;

//set tooltip on ellipse
ellipse1.ToolTip = tooltip;

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

ToolTip Class

ToolTip Members

System.Windows.Controls Namespace

Other Resources

Popup Overview