Tool Service Tip
Tool Service Tip
Tool Service Tip
Represents a service that provides properties and events to control the display and behavior of tooltips.
public ref class ToolTipService abstract sealed
public static class ToolTipService
type ToolTipService = class
Public Class ToolTipService
The following example shows how the use the ToolTipService class to specify the behavior of a tooltip. You set the properties of the ToolTipService class by attaching them directly to the element that exposes the tooltip.
<Ellipse Height="25" Width="50" Fill="Gray" HorizontalAlignment="Left" ToolTipService.InitialShowDelay="1000" ToolTipService.ShowDuration="7000" ToolTipService.BetweenShowDelay="2000" ToolTipService.Placement="Right" ToolTipService.PlacementRectangle="50,0,0,0" ToolTipService.HorizontalOffset="10" ToolTipService.VerticalOffset="20" ToolTipService.HasDropShadow="false" ToolTipService.ShowOnDisabled="true" ToolTipService.IsEnabled="true" ToolTipOpening="whenToolTipOpens" ToolTipClosing="whenToolTipCloses" > <Ellipse.ToolTip> <BulletDecorator> <BulletDecorator.Bullet> <Ellipse Height="10" Width="20" Fill="Blue"/> </BulletDecorator.Bullet> <TextBlock>Uses the ToolTipService class</TextBlock> </BulletDecorator> </Ellipse.ToolTip> </Ellipse>
You define a tooltip for an element by setting the FrameworkContentElement.ToolTip or FrameworkElement.ToolTip property. The ToolTip property takes one child. The content of the child can vary from a simple text string to more complex content such as a StackPanel that has embedded text and Image elements.
You can define tooltip content as a ToolTip object, but this is not required. When you do not define the tooltip content as a ToolTip object, you can use the ToolTipService properties to position and customize the tooltip content. Attached properties of the ToolTipService class are used to determine the placement, behavior, and appearance of a tooltip. These properties are set on the element that defines the tooltip.
The ToolTip class and the ToolTipService class share many of the same properties that are used to customize a tooltip. If equivalent ToolTip and ToolTipService properties are both set, the ToolTipService property takes precedence. For example, if both the ToolTip.Placement property and the ToolTipService.Placement property are set for a System.Windows.Controls.ToolTip object, the value of the ToolTipService.Placement property is used.
Placement, PlacementRectangle, PlacementTarget, HorizontalOffset, and VerticalOffset behave similarly to the properties of the same name in the Popup class. For more information, see Popup Placement Behavior.
|BetweenShowDelay BetweenShowDelay BetweenShowDelay BetweenShowDelay||
Gets or sets the maximum time between the display of two tooltips where the second tooltip appears without a delay.
|HasDropShadow HasDropShadow HasDropShadow HasDropShadow||
Gets or sets whether the tooltip displays a drop shadow effect.
|HorizontalOffset HorizontalOffset HorizontalOffset HorizontalOffset|
|InitialShowDelay InitialShowDelay InitialShowDelay InitialShowDelay||
Gets or sets the length of time before a tooltip opens.
|IsEnabled IsEnabled IsEnabled IsEnabled||
Gets or sets whether a tooltip appears.
|IsOpen IsOpen IsOpen IsOpen||
Gets whether a tooltip is currently visible.
|Placement Placement Placement Placement||
Gets or sets the orientation of the tooltip when it opens, and specifies how the tooltip behaves when it overlaps screen boundaries.
|PlacementRectangle PlacementRectangle PlacementRectangle PlacementRectangle||
Gets or sets the rectangular area relative to which the tooltip is positioned.
|PlacementTarget PlacementTarget PlacementTarget PlacementTarget||
Gets or sets the object relative to which the tooltip is positioned.
|ShowDuration ShowDuration ShowDuration ShowDuration||
Gets or sets the amount of time that a tooltip remains visible.
|ShowOnDisabled ShowOnDisabled ShowOnDisabled ShowOnDisabled||
Gets or sets whether a tooltip appears for an object that is not enabled.
|ToolTip ToolTip ToolTip ToolTip||
Gets or sets the content of a tooltip.
|VerticalOffset VerticalOffset VerticalOffset VerticalOffset|
|ToolTipClosing ToolTipClosing ToolTipClosing ToolTipClosing||
Occurs when the ToolTip closes.
|ToolTipOpening ToolTipOpening ToolTipOpening ToolTipOpening||
Occurs when the ToolTip opens.
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.