TeachingTip 类

定义

命名空间:

Microsoft.UI.Xaml.Controls

教学提示是用于提供上下文相关信息的通知浮出控件。 它支持丰富的内容 (包括标题、字幕、图标、图像和文本) ，并且可以针对显式或浅色消除进行配置。

本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class TeachingTip : ContentControl

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class TeachingTip : ContentControl

Public Class TeachingTip
Inherits ContentControl

继承

ContentControl

TeachingTip

属性

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

示例

提示

有关详细信息、设计指南和代码示例，请参阅 教学提示。

打开 WinUI 2 库应用，查看操作中的教学提示。

WinUI 2 库应用包括大多数 WinUI 2 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用，或在 GitHub 上获取源代码。

注解

教学提示通常用于通知、提醒和教用户有关可能增强其体验的新或重要功能。

控件样式和模板

可以修改默认 的 Style 和 ControlTemplate ，使控件具有唯一的外观。 有关修改控件的样式和模板的信息，请参阅 XAML 样式。 文件中包括 generic.xaml 定义控件外观的默认样式、模板和资源。 出于设计目的， generic.xaml 随 WinUI (Microsoft.UI.Xaml) NuGet 包一起安装。 默认情况下，此位置是 \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml。 来自不同版本的 WinUI 的样式和资源可能具有不同的值。

XAML 还包括可用于在不修改控件模板的情况下修改不同视觉状态中的控件颜色的资源。 修改这些资源是首选设置属性，如 Background 和 Foreground。 有关详细信息，请参阅 XAML 样式一文的轻量级样式部分。

构造函数

TeachingTip()

初始化 TeachingTip 类的新实例。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

属性

ActionButtonCommand	获取或设置在单击操作按钮时要调用的命令。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ActionButtonCommandParameter	获取或设置要传递给操作按钮的命令的参数。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ActionButtonCommandParameterProperty	标识 ActionButtonCommandParameter 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ActionButtonCommandProperty	标识 ActionButtonCommand 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ActionButtonContent	获取或设置教学提示的操作按钮的文本。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ActionButtonContentProperty	标识 ActionButtonContent 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ActionButtonStyle	获取或设置要应用于操作按钮的样式。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ActionButtonStyleProperty	标识 ActionButtonStyle 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
CloseButtonCommand	获取或设置在单击关闭按钮时要调用的命令。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
CloseButtonCommandParameter	获取或设置要传递给关闭按钮的命令的参数。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
CloseButtonCommandParameterProperty	标识 CloseButtonCommandParameter 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
CloseButtonCommandProperty	标识 CloseButtonCommand 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
CloseButtonContent	获取或设置教学提示的关闭按钮的内容。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
CloseButtonContentProperty	标识 CloseButtonContent 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
CloseButtonStyle	获取或设置要应用于教学提示的关闭按钮的样式。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
CloseButtonStyleProperty	标识 CloseButtonStyle 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
HeroContent	显示在教学提示的页眉或页脚中的边框到边框的图形内容。 除非另有设置，否则将在目标教学提示中与尾部相反。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
HeroContentPlacement	在教学提示中放置 hero 内容。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
HeroContentPlacementProperty	标识 HeroContentPlacement 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
HeroContentProperty	标识 HeroContent 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IconSource	获取或设置要与标题和副标题一起显示的图形内容。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IconSourceProperty	标识 IconSource 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsLightDismissEnabled	启用轻型消除功能，以便在用户滚动应用程序的其他元素或与应用程序的其他元素交互时消除教学提示。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsLightDismissEnabledProperty	标识 IsLightDismissEnabled 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsOpen	获取或设置一个值，该值指示教学提示是否打开。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsOpenProperty	标识 IsOpen 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
PlacementMargin	在目标教学提示与其目标之间或非目标教学提示与 xaml 根之间添加边距。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
PlacementMarginProperty	标识 PlacementMargin 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
PreferredPlacement	用于教学提示的首选位置。 如果没有足够的空间显示在首选位置，将自动选择新的位置。 如果 Target 不为 null，则放置相对于其目标;如果 Target 为 null，则放置位置相对于教学提示的父窗口。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
PreferredPlacementProperty	标识 PreferredPlacement 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ShouldConstrainToRootBounds	获取或设置一个值，该值指示教学提示是否将限制为其 xaml 根的边界。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ShouldConstrainToRootBoundsProperty	标识 ShouldConstrainToRootBounds 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
Subtitle	获取或设置教学提示的副标题。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
SubtitleProperty	标识 Subtitle 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
TailVisibility	切换教学提示尾部的折叠。 可用于替代自动行为，使尾部在非目标教学提示上可见，并在目标教学提示上隐藏。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
TailVisibilityProperty	标识 TailVisibility 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
Target	设置教学提示的目标，以相对于 其尾部定位自身并指向。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
TargetProperty	标识 Target 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
TemplateSettings	提供在为 TeachingTip 定义模板时可以作为 TemplatedParent 源引用的计算值。 不适用于一般用途。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
TemplateSettingsProperty	标识 TemplateSettings 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
Title	获取或设置教学提示的标题。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
TitleProperty	标识 Title 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

事件

ActionButtonClick	单击操作按钮后发生。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
CloseButtonClick	单击关闭按钮后发生。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
Closed	关闭提示后发生。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
Closing	在提示开始关闭之前发生。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

另请参阅

• TeachingTipClosedEventArgs
• TeachingTipCloseReason
• TeachingTipClosingEventArgs
• TeachingTipHeroContentPlacementMode
• TeachingTipPlacementMode
• TeachingTipTailVisibility
• TeachingTipTemplateSettings
• 教学提示概述