ToolTipService 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
public ref class ToolTipService sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ToolTipService final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ToolTipServicePublic NotInheritable Class ToolTipService- 继承
- 属性
Windows 要求
| 设备系列 |
Windows 10 (在 10.0.10240.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
|
示例
以下代码示例演示 工具提示的放置模式。
<StackPanel Margin="120" >
<TextBlock Text="ToolTip Control"/>
<TextBlock Text="Hover over an item to see its ToolTip: " Margin="0,10"/>
<ListBox Width="100" HorizontalAlignment="Left">
<ListBoxItem Content="Left"
ToolTipService.ToolTip="ToolTip to the left."
ToolTipService.Placement="Left" />
<ListBoxItem Content="Right"
ToolTipService.ToolTip="ToolTip to the right."
ToolTipService.Placement="Right" />
<ListBoxItem Content="Top"
ToolTipService.ToolTip="ToolTip at the top."
ToolTipService.Placement="Top" />
<ListBoxItem Content="Bottom"
ToolTipService.ToolTip="ToolTip at the bottom."
ToolTipService.Placement="Bottom"/>
<ListBoxItem Content="Mouse"
ToolTipService.ToolTip="ToolTip based on the cursor position."
ToolTipService.Placement="Mouse"/>
</ListBox>
</StackPanel>
注解
工具提示必须分配到其所有者的其他 UI 元素。 在可扩展应用程序标记语言 (XAML) 中，使用 ToolTipService.ToolTip 附加属性将 工具提示 分配给所有者。 在代码中，使用 ToolTipService.SetToolTip 方法将 工具提示 分配给所有者。
放置
默认情况下， 工具提示 显示在指针上方居中。 放置不受应用窗口限制，因此 工具提示 可能部分或完全显示在应用窗口边界之外。
如果 工具提示 遮挡了它所引用的内容，则可以调整其位置。 使用 ToolTipService.Placement 附加属性将 工具提示 放在指针的上方、下方、左侧或右侧。
如果没有显式 PlacementTarget，则工具提示的放置目标是为其 TooltipService.ToolTip 附加属性值指定值的元素。 任何 Placement 值 (作为附加属性或显式 ToolTip 元素上的属性) 应用于该目标。
以前版本的说明
Windows 8.x工具提示 仅适用于 Windows。 Windows Phone项目中提供了工具提示类型，以便与通用项目模板兼容，但工具提示未显示在Windows Phone UI 中。
工具提示 仅在应用窗口的边界内显示。 可以调整放置，使其保持在这些边界内。
XAML 附加属性
ToolTipService 是多个 XAML 附加属性的主机服务类。
为了支持 XAML 处理器对附加属性的访问，以及向代码公开等效 的 get 和 set 操作，每个 XAML 附加属性都有一对 Get 和 Set 访问器方法。 在代码中获取或设置值的另一种方法是使用依赖属性系统，调用 GetValue 或 SetValue ，并将标识符字段作为依赖属性标识符传递。
| 附加属性 | 说明 |
|---|---|
| 放置 | 获取或设置一个值，该值指示相对于放置目标的定位方式 ToolTip 。 |
| PlacementTarget | 获取或设置相对于 ToolTip 其定位的对象。 |
| ToolTip | 获取或设置元素 的 ToolTip的对象或字符串内容。 |
属性
| PlacementProperty |
标识 ToolTipService.Placement XAML 附加属性。 |
| PlacementTargetProperty |
标识 ToolTipService.PlacementTarget XAML 附加属性。 |
| ToolTipProperty |
标识 ToolTipService.ToolTip XAML 附加属性。 |
附加属性
| Placement |
获取或设置一个值，该值指示工具提示相对于放置目标的定位方式。 |
| PlacementTarget |
获取或设置相对于工具提示定位的对象。 |
| ToolTip |
获取或设置元素的工具提示的对象或字符串内容。 |
方法
| GetPlacement(DependencyObject) |
获取指定目标元素的 ToolTipService.Placement XAML 附加属性值。 |
| GetPlacementTarget(DependencyObject) |
获取指定目标元素的 ToolTipService.PlacementTarget XAML 附加属性值。 |
| GetToolTip(DependencyObject) |
获取对象的 ToolTipService.ToolTip XAML 附加属性的值。 |
| SetPlacement(DependencyObject, PlacementMode) |
设置指定目标元素的 ToolTipService.Placement XAML 附加属性值。 |
| SetPlacementTarget(DependencyObject, UIElement) |
设置指定目标元素的 ToolTipService.PlacementTarget XAML 附加属性值。 |
| SetToolTip(DependencyObject, Object) |
设置 ToolTipService.ToolTip XAML 附加属性的值。 |