ToolTipService 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示一项服务,该服务提供用于控制工具提示的显示和行为的属性和事件。
public ref class ToolTipService abstract sealed
public static class ToolTipService
type ToolTipService = class
Public Class ToolTipService
- 继承
-
ToolTipService
示例
以下示例演示如何使用 ToolTipService 类指定工具提示的行为。 通过将类的属性 ToolTipService 直接附加到公开工具提示的 元素来设置这些属性。
<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>
注解
可以通过设置 FrameworkContentElement.ToolTip 或 FrameworkElement.ToolTip 属性来定义元素的工具提示。 ToolTip 属性采用一个子级。 子级的内容可以从简单的文本字符串到更复杂的内容(例如 StackPanel ,包含嵌入文本和 Image 元素的 )。
可以将工具提示内容定义为 ToolTip 对象,但这不是必需的。 如果未将工具提示内容定义为 ToolTip 对象,则可以使用 ToolTipService 属性来定位和自定义工具提示内容。 类的 ToolTipService 附加属性用于确定工具提示的位置、行为和外观。 这些属性在定义工具提示的 元素上设置。
类 ToolTip 和 类 ToolTipService 共享许多用于自定义工具提示的相同属性。 如果同时设置了等效 ToolTip 属性和 ToolTipService 属性,则 ToolTipService 属性优先。 例如,如果ToolTip.Placement同时为 System.Windows.Controls.ToolTip 对象设置了 属性和 ToolTipService.Placement 属性,则使用 属性的值ToolTipService.Placement。
以下 ToolTipService 计时属性仅为 类定义 ToolTipService ,并且由所有工具提示使用:
有关如何处理打开或关闭工具提示时发生的事件的信息,请参阅 ToolTipOpeningEvent 和 ToolTipClosingEvent 字段。
Placement、 PlacementRectangle、 PlacementTarget、 HorizontalOffset和 VerticalOffset 的行为与 类中 Popup 同名的属性类似。 有关详细信息,请参阅 Popup 放置行为。
字段
BetweenShowDelayProperty |
标识 BetweenShowDelay 附加属性。 |
HasDropShadowProperty |
标识 HasDropShadow 附加属性。 |
HorizontalOffsetProperty |
标识 HorizontalOffset 附加属性。 |
InitialShowDelayProperty |
标识 InitialShowDelay 附加属性。 |
IsEnabledProperty |
标识 IsEnabled 附加属性。 |
IsOpenProperty |
标识 IsOpen 附加属性。 |
PlacementProperty |
标识 Placement 附加属性。 |
PlacementRectangleProperty |
标识 PlacementRectangle 附加属性。 |
PlacementTargetProperty |
标识 PlacementTarget 附加属性。 |
ShowDurationProperty |
标识 ShowDuration 附加属性。 |
ShowOnDisabledProperty |
标识 ShowOnDisabled 附加属性。 |
ShowsToolTipOnKeyboardFocusProperty |
表示一项服务,该服务提供用于控制工具提示的显示和行为的属性和事件。 |
ToolTipClosingEvent |
标识由使用 ToolTipClosing 服务显示工具提示的对象公开的 ToolTipService 事件。 |
ToolTipOpeningEvent |
标识由使用 ToolTipOpening 服务显示工具提示的对象公开的 ToolTipService 事件。 |
ToolTipProperty |
标识 ToolTip 附加属性。 |
VerticalOffsetProperty |
标识 VerticalOffset 附加属性。 |
附加属性
BetweenShowDelay |
获取或设置当第二个工具提示在没有延迟的情况下显示时,两个工具提示的显示之间的最大时间。 |
HasDropShadow |
获取或设置工具提示是否显示投影效果。 |
HorizontalOffset |
获取或设置由 PlacementRectangle 和 PlacementTarget 属性为工具提示指定的区域的左侧偏移量。 |
InitialShowDelay |
获取或设置工具提示打开之前的时间长度。 |
IsEnabled |
获取或设置是否显示工具提示。 |
IsOpen |
获取工具提示当前是否可见。 |
Placement |
获取或设置工具提示在打开时的方向,并指定工具提示在与屏幕边界重叠时的行为方式。 |
PlacementRectangle |
获取或设置相对于其来放置工具提示的矩形区域。 |
PlacementTarget |
获取或设置相对于其来放置工具提示的对象。 |
ShowDuration |
获取或设置工具提示保持可见的时间。 |
ShowOnDisabled |
获取或设置是否为未启用的对象显示工具提示。 |
ShowsToolTipOnKeyboardFocus |
表示一项服务,该服务提供用于控制工具提示的显示和行为的属性和事件。 |
ToolTip |
获取或设置工具提示的内容。 |
VerticalOffset |
获取或设置由 PlacementRectangle 和 PlacementTarget 属性为工具提示指定的区域的顶部距离。 |
方法
附加活动
ToolTipClosing |
当 ToolTip 关闭时发生。 |
ToolTipOpening |
在 ToolTip 打开时发生。 |