ToolTipService 类

定义

表示一项服务,该服务提供用于控制工具提示的显示和行为的属性和事件。

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.ToolTipFrameworkElement.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 ,并且由所有工具提示使用:

有关如何处理打开或关闭工具提示时发生的事件的信息,请参阅 ToolTipOpeningEventToolTipClosingEvent 字段。

PlacementPlacementRectanglePlacementTargetHorizontalOffsetVerticalOffset 的行为与 类中 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

获取或设置由 PlacementRectanglePlacementTarget 属性为工具提示指定的区域的左侧偏移量。

InitialShowDelay

获取或设置工具提示打开之前的时间长度。

IsEnabled

获取或设置是否显示工具提示。

IsOpen

获取工具提示当前是否可见。

Placement

获取或设置工具提示在打开时的方向,并指定工具提示在与屏幕边界重叠时的行为方式。

PlacementRectangle

获取或设置相对于其来放置工具提示的矩形区域。

PlacementTarget

获取或设置相对于其来放置工具提示的对象。

ShowDuration

获取或设置工具提示保持可见的时间。

ShowOnDisabled

获取或设置是否为未启用的对象显示工具提示。

ShowsToolTipOnKeyboardFocus

表示一项服务,该服务提供用于控制工具提示的显示和行为的属性和事件。

ToolTip

获取或设置工具提示的内容。

VerticalOffset

获取或设置由 PlacementRectanglePlacementTarget 属性为工具提示指定的区域的顶部距离。

方法

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

ToolTipClosing 附加事件添加处理程序。

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

ToolTipOpening 附加事件添加处理程序。

GetBetweenShowDelay(DependencyObject)

获取对象的 BetweenShowDelay 附加属性的值。

GetHasDropShadow(DependencyObject)

获取对象的 HasDropShadow 附加属性的值。

GetHorizontalOffset(DependencyObject)

获取对象的 HorizontalOffset 附加属性的值。

GetInitialShowDelay(DependencyObject)

获取对象的 InitialShowDelay 附加属性的值。

GetIsEnabled(DependencyObject)

获取对象的 IsEnabled 附加属性的值。

GetIsOpen(DependencyObject)

获取对象的 IsOpen 附加属性的值。

GetPlacement(DependencyObject)

获取对象的 Placement 附加属性的值。

GetPlacementRectangle(DependencyObject)

获取对象的 PlacementRectangle 附加属性的值。

GetPlacementTarget(DependencyObject)

获取对象的 PlacementTarget 附加属性的值。

GetShowDuration(DependencyObject)

获取对象的 ShowDuration 附加属性的值。

GetShowOnDisabled(DependencyObject)

获取对象的 ShowOnDisabled 附加属性的值。

GetShowsToolTipOnKeyboardFocus(DependencyObject)

表示一项服务,该服务提供用于控制工具提示的显示和行为的属性和事件。

GetToolTip(DependencyObject)

获取对象的 ToolTip 附加属性的值。

GetVerticalOffset(DependencyObject)

获取对象的 VerticalOffset 附加属性的值。

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

移除 ToolTipClosing 附加事件的处理程序。

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

移除 ToolTipOpening 附加事件的处理程序。

SetBetweenShowDelay(DependencyObject, Int32)

设置对象的 BetweenShowDelay 附加属性的值。

SetHasDropShadow(DependencyObject, Boolean)

设置对象的 HasDropShadow 附加属性的值。

SetHorizontalOffset(DependencyObject, Double)

设置对象的 HorizontalOffset 附加属性的值。

SetInitialShowDelay(DependencyObject, Int32)

设置对象的 InitialShowDelay 附加属性的值。

SetIsEnabled(DependencyObject, Boolean)

设置对象的 IsEnabled 附加属性的值。

SetPlacement(DependencyObject, PlacementMode)

设置对象的 Placement 附加属性的值。

SetPlacementRectangle(DependencyObject, Rect)

设置对象的 PlacementRectangle 附加属性的值。

SetPlacementTarget(DependencyObject, UIElement)

设置对象的 PlacementTarget 附加属性的值。

SetShowDuration(DependencyObject, Int32)

设置对象的 ShowDuration 附加属性的值。

SetShowOnDisabled(DependencyObject, Boolean)

设置对象的 ShowOnDisabled 附加属性的值。

SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>)

表示一项服务,该服务提供用于控制工具提示的显示和行为的属性和事件。

SetToolTip(DependencyObject, Object)

设置对象的 ToolTip 附加属性的值。

SetVerticalOffset(DependencyObject, Double)

设置对象的 VerticalOffset 附加属性的值。

附加活动

ToolTipClosing

ToolTip 关闭时发生。

ToolTipOpening

ToolTip 打开时发生。

适用于

另请参阅