Control 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示使用 ControlTemplate 定义其外观的 UI 元素的基类。 ContentControl、UserControl、ItemsControl 和多个实用控件的父类。
public ref class Control : FrameworkElement/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Control : FrameworkElement[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Control : FrameworkElementPublic Class Control
Inherits FrameworkElement- 继承
- 派生
- 属性
注解
控件类是添加到应用及其 UI 的许多控件的基类。 Control 类定义很少的行为;你可以将实际 Control 元素添加到用于 UI 的 XAML，但通常会添加直接或间接继承自 Control 的内容，例如 Button 或 ListBox。 有关可以使用的控件列表，请参阅适用于Windows应用的Controls。
使用 ControlTemplate 类型的 Template 属性指定控件的视觉外观。 如果要更改控件的外观，但保留其功能，应考虑创建新的 ControlTemplate ，而不是定义基于控件的新类。 有关详细信息，请参阅 控件模板。
控件是 UserControl 的父级。 UserControl 是不需要视觉状态的轻型控件的预期基类。 尽管 UserControl 在技术上继承 了 Template 属性，但不能将模板应用于 UserControl。
控件的隐式样式
为 XAML 定义的每个实际控件都有一个默认样式，其中包含其默认控件模板。 控件可以具有隐式样式，这意味着未显式设置 FrameworkElement.Style 属性。 一旦该隐式样式可用，几乎可以使用该样式中的 Setter 元素设置控件的所有其他属性。 Style 可以独立于控件逻辑的其余部分初始化控件，并且可以设置不是每个属性基于代码的默认值的值。
隐式样式作为Windows Runtime的一部分的键控资源存在，在内部存储为 XAML 的二进制表示形式。 可以获取特定控件的样式或完整样式集的副本，以了解如何定义样式和控件模板。
默认使用的隐式样式的键/名称之间的关联由 DefaultStyleKey 属性的值建立。 DefaultStyleKey 属性受到保护，因此只有子类化控件类的人才能更改值。 如果只是创建控件实例，例如在 XAML UI 中声明控件，则默认样式是基于控件类型的隐式样式。 有关详细信息，请参阅 DefaultStyleKey 中的备注。 无需将 DefaultStyleKey 值更改为使用其他样式，只需定义与隐式样式查找匹配且作为 XAML 资源存在的同一 TargetType 的自己的 XAML 样式。 有关详细信息，请参阅 控件模板。
视觉状态模型
视觉状态模型是一种技术，只需修改控件模板中定义的几个属性。 你可以更改属性值，以便向用户提供视觉反馈，该反馈指示控件正在执行的操作，并提示可能进一步的 UI 交互。 通过向模板中的某些属性应用零持续时间或短持续时间情节提要动画来修改控件。 还可以定义适用于状态之间切换的短持续时间动画。
视觉状态本身定义为控件模板的一部分。 每个视觉状态都有一个名称，以便控件逻辑可以调用 GoToState 方法，以便在特定逻辑状态需要时加载每个视觉状态。 视觉状态在视觉状态组中声明，以便彼此独占的视觉状态可以确保一次只有一个此类状态处于活动状态。 加载同一组的另一个视觉状态后，将应用上一个状态的动画，但另一个组中的动画可能仍在运行并应用其更改和视觉行为。 例如，控件可能具有键盘焦点的可视指示器和指针悬停的视觉指示器。 由于这些是可以彼此独立调整并可以同时发生的 UI 模式，因此它们都是在不同的视觉状态组中定义的。
由于它在 XAML 中定义为控件模板的一部分，因此你可以更改在 UI 中使用的任何 XAML 控件的视觉状态行为。 但是，逻辑仍基于希望在其中查找某些视觉状态组和命名视觉状态的控件。 因此，你必须非常小心，你正在向用户提供正确命名和结构化的视觉状态，这些状态显示控件行为的各个方面。 控件 模板中简要介绍了视觉状态。
控件的默认视觉状态有时使用库动画。 替换控件模板或视觉状态时，应尝试保留库动画，因为这些动画是控件在 UI 中外观的重要组成部分。 有关详细信息，请参阅 动画概述。
控件和焦点
Control 类定义了几个影响 UI 键盘焦点行为的 API： FocusState 属性和 IsFocusEngaged、 IsEnabled 和 IsTabStop 属性。 启用键盘焦点是确保 UI 可访问的重要部分，因为每个可聚焦元素都成为 UI 的 Tab 键顺序的一部分。 通常仅启用交互的 UI 元素才能接收键盘焦点。 例如， TextBox 是交互式的，因为用户可以键入文本，而 TextBlock 不是交互式的，因为文本是只读的。 从 Control 派生的大多数类具有合法交互性，因此可以集中这些类，并且应该按 Tab 键顺序排列。
若要使焦点可聚焦，每个属性都必须为 true：
- 可见性 为 可见
- IsEnabled 为 true
- UIElement.IsTabStop 为 true
- 控件必须实例化其模板（加载 触发的控件连接到应用的根视觉对象）如果希望控件不可聚焦，可以将 UIElement.IsTabStop 设置为 false。 但是，如果不希望控件具有焦点的原因是它在 UI 中不是交互式的，则你可能希望将 IsEnabled 设置为 false ，以使每个人缺乏交互。 许多控件具有为 IsEnabled =false 调用的预定义视觉状态，例如标签中的“灰显”文本。
焦点更改可以触发 GotFocus 或 LostFocus 事件。 尽管“FocusedElement”值（通过 GetFocusedElement 方法公开）会立即更新，但 GotFocus 或 LostFocus 的更改通知以异步方式发生。 这种异步聚焦设计旨在避免在控件逻辑对焦点更改做出反应时对视觉状态转换闪烁。
Focus（Microsoft.Ui。Xaml.FocusState）方法允许以编程方式设置键盘焦点。 在调用此方法时，当用户不期望键盘焦点时移动键盘焦点可能会侵入性。 Focus（Microsoft）的主要方案。Ui。Xaml.FocusState）在加载整个 UI 页面时设置第一个键盘焦点点，或者在父控件容器收到顶级焦点后将焦点设置为控件的特定部分（例如将文本框放在组合框中）。 有关详细信息，请参阅 Focus（Microsoft。Ui。Xaml.FocusState）。 FocusState 跟踪焦点是编程还是用户驱动，这会使视觉状态有所作为，尤其是所有控件应具有的键盘焦点的视觉焦点指示器。
在事件处理程序上 重写
每个 OnEvent 方法表示对应 UIElement 事件的预连接事件处理程序。 派生自 Control 的实际控件可以替代 OnEvent 方法，并使用它为该输入事件提供特定于控件的处理和行为。 最常见的方案是使用事件处理程序将事件标记为事件数据中 已处理 。 在调用控制实例上有线的任何事件处理程序之前，控件代码首先有机会处理此事件。 当事件数据标记为 Handled 时，将不会调用其他处理程序（如控件实例上的处理程序）。 此外，事件不会冒泡。
当它直接在 Control 上实现时， OnEvent 方法具有空的实现。 但是，控件层次结构中的每个上级可能都提供了实现。 无法看到此实现，因为它是内部本机代码。 在某些情况下，控件已具有标记已处理事件的现有 On事件替代。 为控件提供初始 On事件 替代后，进一步派生自自己的控件类的任何控件也会继承定义的 OnEvent 替代。 使用的任何实例也具有该行为。
注意
应用代码仍可以处理可能已由控件的 OnEvent 方法逻辑标记为“处理”的事件，但它们需要使用 UIElement.AddHandler 方法的 handledEventsToo 参数。 有关详细信息，请参阅 UIElement.AddHandler 或 事件和路由事件概述。
Control 类定义了多个受保护的虚拟方法，每个方法都与框架级输入事件相关联。 这些方法旨在为输入事件提供预先有线事件处理程序，以便控件可以强制该控件及其所有实例使用某些输入行为。 例如，UIElement 定义了一个 PointerPressed 事件。 控件使用空定义定义 OnPointerPressed 方法。 在基本 控制 构造函数中，所有相关输入事件的事件连接包括 OnEvent 方法作为侦听器/处理程序，最初不执行任何操作。 但是，现在更改输入事件的行为的控件作者只需为 OnEvent 方法提供新的替代定义（此外，请确保构造函数调用基数）。 该行为将继承到所有实例或子类中，除非另一个子类程序再次重写它。 由于 OnEvent 事件先按顺序排列，因此在任何 UI 定义 XAML 之前，它们都可以调整事件数据，并可能会更改其他侦听器对事件看到的条件。
即使尚未自行重写任何 OnEvent 方法，特定控件类中的现有 OnEvent 定义也会影响作为控件使用者。 这是因为现有的 On事件 定义可能已为事件提供处理，该事件在某些事件的事件数据中将 Handled 属性值设置为 true 。 这会阻止基于实例的事件处理甚至看不到事件，并阻止调用处理程序。 此处发生的事情是，有一种有意的控件设计，强制某些事件对控件无关紧要，无论是因为它们是与控件逻辑冲突的低级别事件，还是因为控件具有替换逻辑。 下面是 ButtonBase 类的一个突出示例。 ButtonBase 类有两种行为，它通过对 OnPointerPressed 和 OnKeyDown 的本机重写强制执行。 它正在执行此操作，因为它将各种输入模式组合在一个低级别，并报告它们，而不是作为特定于控件的 Click 事件。 对于 PointerPressed 事件处理程序，如果尝试在 Button 实例上处理此处理程序，则不会调用处理程序。 这是因为本机 OnPointerPressed 将 Handled 设置为 true ，并阻止 PointerPressed 传播到实例和应用代码。 对于 OnKeyDown，逻辑只是查找某些键（Ctrl 和 Enter），因此实例处理程序仍可以调用，只要它不查找这些键。
注意
对于某些输入事件，实际上有一种方法可以绕过 对 OnEvent 方法的本机处理。 为此，需要使用具有 handledEventsToo 的 UIElement.AddHandler 方法连接处理程序。 有关详细信息，请参阅 事件和路由事件概述。
继承到文本元素部件的文本属性
控件定义与文本呈现相关的多个属性。 它们是：
显然，并不是每个控件都旨在显示其中的文本。 例如，在 AppBarSeparator 上设置 FontFamily 是合法的，但绝对无效。 控件在基类级别定义这些属性的原因是，使控件模板能够轻松地使用 {TemplateBinding} 标记扩展 将顶级文本属性应用于模板中存在的一个或多个文本元素部件。 例如，如果查看 DatePicker 的控件模板，你将看到根是容器，在该容器中更深入地是几个实际采用文本输入 的 ComboBox 部件。 每个语句都使用诸如FontWeight="{TemplateBinding FontWeight}"在 DatePicker 上设置的顶级 FontWeight 等语句，供内部的各个部分使用。
控件上的文本属性还会隐式继承，该控件中具有显示文本的 ContentPresenter 。 例如，如果在按钮上设置 FontSize，则其模板或 ContentPresenter 部件中没有显式 {TemplateBinding} 标记扩展，用于控制模板使用顶级 FontSize 值执行的操作。 但是，根据模板定义中的上下文，ContentPresenter.FontSize 隐式继承 Control.FontSize 值，因此按钮中的文本将使用设置的 Control.FontSize 呈现。
XAML 附加属性
控件是多个 XAML 附加属性的主机服务类。
为了支持对附加属性的 XAML 处理器访问，并且为了向代码公开等效 的 get 和 set 操作，每个 XAML 附加属性都有一对 Get 和 Set 访问器方法。 获取或设置代码中的值的另一种方法是使用依赖属性系统，调用 GetValue 或 SetValue 并将标识符字段作为依赖属性标识符传递。
| Attached 属性 | 说明 |
|---|---|
| IsTemplateFocusTarget | 获取或设置一个值，该值指示此元素是否是具有焦点视觉对象的控件模板的一部分。
|
| IsTemplateKeyTipTarget | 获取或设置一个值，该值指示此元素是否是放置 KeyTip 的控件模板的一部分。
|
构造函数
| 名称 | 说明 |
|---|---|
| Control() |
为 Control 派生类提供基类初始化行为。 |
属性
| 名称 | 说明 |
|---|---|
| AccessKey |
获取或设置此元素的访问键（助记）。 (继承自 UIElement) |
| AccessKeyScopeOwner |
获取或设置一个源元素，该元素提供此元素的访问键范围，即使它不在源元素的可视化树中也是如此。 (继承自 UIElement) |
| ActualHeight |
获取 FrameworkElement 的呈现高度。 请参阅“备注”。 (继承自 FrameworkElement) |
| ActualOffset |
获取此 UIElement 相对于其父级的位置，该位置是在布局过程的排列传递期间计算的。 (继承自 UIElement) |
| ActualSize |
获取此 UIElement 在布局过程的排列传递期间计算的大小。 (继承自 UIElement) |
| ActualTheme |
获取元素当前使用的 UI 主题，该主题可能与 RequestedTheme 不同。 (继承自 FrameworkElement) |
| ActualWidth |
获取 FrameworkElement 的呈现宽度。 请参阅“备注”。 (继承自 FrameworkElement) |
| AllowDrop |
获取或设置一个值，该值确定此 UIElement 是否可以作为拖放操作的放置目标。 (继承自 UIElement) |
| AllowFocusOnInteraction |
获取或设置一个值，该值指示当用户与其交互时元素是否自动获得焦点。 (继承自 FrameworkElement) |
| AllowFocusWhenDisabled |
获取或设置禁用的控件是否可以接收焦点。 (继承自 FrameworkElement) |
| Background |
获取或设置提供控件背景的画笔。 |
| BackgroundProperty |
标识 后台 依赖项属性。 |
| BackgroundSizing |
获取或设置一个值，该值指示背景相对于此元素边框的扩展距离。 |
| BackgroundSizingProperty |
标识 BackgroundSizing 依赖项属性。 |
| BaseUri |
获取一个统一资源标识符（URI），该标识符表示 XAML 加载时 XAML 构造对象的基 URI。 此属性适用于运行时的 URI 解析。 (继承自 FrameworkElement) |
| BorderBrush |
获取或设置描述控件边框填充的画笔。 |
| BorderBrushProperty |
标识 BorderBrush 依赖项属性。 |
| BorderThickness |
获取或设置控件的边框粗细。 |
| BorderThicknessProperty |
标识 BorderThickness 依赖项属性。 |
| CacheMode |
获取或设置一个值，该值指示应尽可能将呈现的内容缓存为复合位图。 (继承自 UIElement) |
| CanBeScrollAnchor |
获取或设置一个值，该值指示 UIElement 是否可以成为滚动定位的候选项。 (继承自 UIElement) |
| CanDrag |
获取或设置一个值，该值指示是否可以在拖放操作中将元素作为数据拖动。 (继承自 UIElement) |
| CenterPoint |
获取或设置元素的中心点，即发生旋转或缩放的点。 影响元素的呈现位置。 (继承自 UIElement) |
| CharacterSpacing |
获取或设置字符之间的统一间距，单位为 1/1000 em。 |
| CharacterSpacingProperty |
标识 CharacterSpacing 依赖属性。 |
| Clip |
获取或设置用于定义 UIElement 内容的轮廓的 RectangleGeometry。 (继承自 UIElement) |
| CompositeMode |
获取或设置一个属性，该属性在其父布局和窗口中声明元素的备用组合和混合模式。 这与混合 XAML/Microsoft DirectX UI 中涉及的元素相关。 (继承自 UIElement) |
| ContextFlyout |
获取或设置与此元素关联的浮出控件。 (继承自 UIElement) |
| CornerRadius |
获取或设置控件边框的角的半径。 |
| CornerRadiusProperty |
标识 CornerRadius 依赖项属性。 |
| DataContext |
获取或设置 FrameworkElement 的数据上下文。 数据上下文的常见用途是 |
| DefaultStyleKey |
获取或设置引用控件的默认样式的键。 自定义控件的作者使用此属性更改其控件使用的样式的默认值。 |
| DefaultStyleKeyProperty |
标识 DefaultStyleKey 依赖项属性。 |
| DefaultStyleResourceUri |
获取或设置包含控件的默认样式的资源文件的路径。 |
| DefaultStyleResourceUriProperty |
标识 DefaultStyleResourceUri 依赖项属性。 |
| DesiredSize |
获取此 UIElement 在布局过程的度量传递期间计算的大小。 (继承自 UIElement) |
| Dispatcher |
始终在 Windows 应用 SDK 应用中返回 |
| DispatcherQueue |
获取 |
| ElementSoundMode |
获取或设置一个值，该值指定控件是否播放声音的首选项。 |
| ElementSoundModeProperty |
标识 ElementSoundMode 依赖项属性。 |
| ExitDisplayModeOnAccessKeyInvoked |
获取或设置一个值，该值指定在调用访问密钥时是否消除访问密钥显示。 (继承自 UIElement) |
| FlowDirection |
获取或设置文本和其他 UI 元素在控制布局的任何父元素中流动的方向。 此属性可以设置为或 |
| FocusState |
获取一个值，该值指定此控件是否具有焦点，以及获取焦点的模式。 (继承自 UIElement) |
| FocusVisualMargin |
获取或设置 FrameworkElement 焦点视觉对象的外部边距。 (继承自 FrameworkElement) |
| FocusVisualPrimaryBrush |
获取或设置用于为 FrameworkElement 绘制或 |
| FocusVisualPrimaryThickness |
获取或设置 FrameworkElement 的外边框或 |
| FocusVisualSecondaryBrush |
获取或设置用于为 FrameworkElement 绘制或 |
| FocusVisualSecondaryThickness |
获取或设置 FrameworkElement 的框架视觉对象内边框的 |
| FontFamily |
获取或设置用于在控件中显示文本的字体。 |
| FontFamilyProperty |
标识 FontFamily 依赖属性。 |
| FontSize |
获取或设置此控件中文本的大小。 |
| FontSizeProperty |
标识 FontSize 依赖属性。 |
| FontStretch |
获取或设置字体在屏幕上凝结或展开的程度。 |
| FontStretchProperty |
标识 FontStretch 依赖项属性。 |
| FontStyle |
获取或设置呈现文本的样式。 |
| FontStyleProperty |
标识 FontStyle 依赖项属性。 |
| FontWeight |
获取或设置指定字体的粗细。 |
| FontWeightProperty |
标识 FontWeight 依赖项属性。 |
| Foreground |
获取或设置描述前景色的画笔。 |
| ForegroundProperty |
标识 Foreground 依赖项属性。 |
| Height |
获取或设置 FrameworkElement 的建议高度。 (继承自 FrameworkElement) |
| HighContrastAdjustment |
获取或设置一个值，该值指示在启用高对比度主题时框架是否自动调整元素的视觉属性。 (继承自 UIElement) |
| HorizontalAlignment |
获取或设置在布局父级（如面板或项控件）中组合时应用于 FrameworkElement 的水平对齐特征。 (继承自 FrameworkElement) |
| HorizontalContentAlignment |
获取或设置控件内容的水平对齐方式。 |
| HorizontalContentAlignmentProperty |
标识 HorizontalContentAlignment 依赖项属性。 |
| IsAccessKeyScope |
获取或设置一个值，该值指示元素是否定义其自己的访问密钥范围。 (继承自 UIElement) |
| IsDoubleTapEnabled |
获取或设置一个值，该值确定 DoubleTapped 事件是否可以源自该元素。 (继承自 UIElement) |
| IsEnabled |
获取或设置一个值，该值指示用户是否可以与控件交互。 |
| IsEnabledProperty |
标识 IsEnabled 依赖属性。 |
| IsFocusEngaged |
获取或设置一个值，该值指示当用户按下游戏控制器上的 A/Select 按钮时焦点是否受限于控件。 |
| IsFocusEngagedProperty |
标识 IsFocusEngaged 依赖属性。 |
| IsFocusEngagementEnabled |
获取或设置一个值，该值指示当用户按下游戏控制器上的 A/Select 按钮时是否可以将焦点限制为控件。 |
| IsFocusEngagementEnabledProperty |
标识 IsFocusEngagementEnabled 依赖属性。 |
| IsHitTestVisible |
获取或设置此 UIElement 的包含区域是否可以返回命中测试的真实值。 (继承自 UIElement) |
| IsHoldingEnabled |
获取或设置一个值，该值确定 Holding 事件是否可以源自该元素。 (继承自 UIElement) |
| IsLoaded |
获取一个值，该值指示是否已将元素添加到元素树中并已准备好进行交互。 (继承自 FrameworkElement) |
| IsRightTapEnabled |
获取或设置一个值，该值确定 RightTapped 事件是否可以源自该元素。 (继承自 UIElement) |
| IsTabStop |
获取或设置一个值，该值指示控件是否包含在选项卡导航中。 (继承自 UIElement) |
| IsTapEnabled |
获取或设置一个值，该值确定 点击 事件是否可以源自该元素。 (继承自 UIElement) |
| IsTemplateFocusTargetProperty |
标识 Control.IsTemplateFocusTarget XAML 附加属性。 |
| IsTemplateKeyTipTargetProperty |
标识 Control.IsTemplateKeyTipTarget XAML 附加属性。 |
| IsTextScaleFactorEnabled |
获取或设置是否启用自动文本放大，以反映系统文本大小设置。 |
| IsTextScaleFactorEnabledProperty |
标识 IsTextScaleFactorEnabled 依赖属性。 |
| KeyboardAcceleratorPlacementMode |
获取或设置一个值，该值指示控件 工具提示 是否显示其关联的键盘加速器的键组合。 (继承自 UIElement) |
| KeyboardAcceleratorPlacementTarget |
获取或设置一个值，该值指示显示快捷键组合的控件 工具提示 。 (继承自 UIElement) |
| KeyboardAccelerators |
获取使用键盘调用操作的键组合的集合。 加速器通常分配给按钮或菜单项。
|
| KeyTipHorizontalOffset |
获取或设置一个值，该值指示键提示相对于 UIElement 放置的距离。 (继承自 UIElement) |
| KeyTipPlacementMode |
获取或设置一个值，该值指示访问键提示相对于 UIElement 边界的位置。 (继承自 UIElement) |
| KeyTipTarget |
获取或设置一个值，该值指示访问键提示面向的元素。 (继承自 UIElement) |
| KeyTipVerticalOffset |
获取或设置一个值，该值指示键提示相对于 UI 元素的向上或向下放置距离。 (继承自 UIElement) |
| Language |
获取或设置适用于 FrameworkElement 的本地化/全球化语言信息，以及应用于对象表示形式和 UI 中当前 FrameworkElement 的所有子元素。 (继承自 FrameworkElement) |
| Lights |
获取附加到此元素的 XamlLight 对象的集合。 (继承自 UIElement) |
| ManipulationMode |
获取或设置用于 UIElement 行为和与手势交互的 ManipulationModes 值。 设置此值可在应用代码中处理此元素中的操作事件。 (继承自 UIElement) |
| Margin |
获取或设置 FrameworkElement 的外部边距。 (继承自 FrameworkElement) |
| MaxHeight |
获取或设置 FrameworkElement 的最大高度约束。 (继承自 FrameworkElement) |
| MaxWidth |
获取或设置 FrameworkElement 的最大宽度约束。 (继承自 FrameworkElement) |
| MinHeight |
获取或设置 FrameworkElement 的最小高度约束。 (继承自 FrameworkElement) |
| MinWidth |
获取或设置 FrameworkElement 的最小宽度约束。 (继承自 FrameworkElement) |
| Name |
获取或设置对象的标识名称。 当 XAML 处理器从 XAML 标记创建对象树时，运行时代码可以通过此名称引用 XAML 声明的对象。 (继承自 FrameworkElement) |
| Opacity |
获取或设置对象的不透明度程度。 (继承自 UIElement) |
| OpacityTransition |
获取或设置对 Opacity 属性的更改进行动画处理的 ScalarTransition。 (继承自 UIElement) |
| Padding |
获取或设置控件内的填充。 |
| PaddingProperty |
标识 Padding 依赖属性。 |
| Parent |
获取对象树中此 FrameworkElement 的父对象。 (继承自 FrameworkElement) |
| PointerCaptures |
获取所有捕获的指针集，这些指针表示为 指针 值。 (继承自 UIElement) |
| Projection |
获取或设置呈现此元素时要应用的透视投影（三维效果）。 (继承自 UIElement) |
| ProtectedCursor |
获取或设置指针位于此元素上时显示的游标。 默认值为 null，表示游标没有更改。 (继承自 UIElement) |
| RasterizationScale |
获取一个值，该值表示在呈现形状、图像、文本或媒体时要使用的额外比例因子，通常以比正常分辨率更高的分辨率呈现。 (继承自 UIElement) |
| RenderSize |
获取 UIElement 的最终呈现大小。 不建议使用，请参阅“备注”。 (继承自 UIElement) |
| RenderTransform |
获取或设置影响 UIElement 呈现位置的转换信息。 (继承自 UIElement) |
| RenderTransformOrigin |
获取或设置 RenderTransform 声明的任何可能的呈现转换的原点，相对于 UIElement 的边界。 (继承自 UIElement) |
| RequestedTheme |
获取或设置 UIElement （及其子元素）用于资源确定的 UI 主题。 你指定的 |
| RequiresPointer |
获取或设置 UI 元素是否支持鼠标模式，该模式模拟与非指针输入设备（如键盘或游戏控制器）的指针交互体验。 |
| RequiresPointerProperty |
标识 RequiresPointer 依赖项属性。 |
| Resources |
获取本地定义的资源字典。 在 XAML 中，可以通过 XAML 隐式集合语法将资源项作为属性元素的 |
| Rotation |
获取或设置顺时针旋转的角度（以度为单位）。 相对于 RotationAxis 和 CenterPoint 旋转。 影响元素的呈现位置。 (继承自 UIElement) |
| RotationAxis |
获取或设置要围绕元素旋转的轴。 (继承自 UIElement) |
| RotationTransition |
获取或设置对 Rotation 属性的更改进行动画处理的 ScalarTransition。 (继承自 UIElement) |
| Scale |
获取或设置元素的规模。 相对于元素的 CenterPoint 进行缩放。 影响元素的呈现位置。 (继承自 UIElement) |
| ScaleTransition |
获取或设置 Vector3Transition，该 Vector3Transition 对 Scale 属性的更改进行动画处理。 (继承自 UIElement) |
| Shadow |
获取或设置元素强制转换的阴影效果。 (继承自 UIElement) |
| Style |
获取或设置在布局和呈现期间应用于此对象的实例 样式 。 (继承自 FrameworkElement) |
| TabFocusNavigation |
获取或设置一个值，该值修改 Tabbing 和 TabIndex 对此控件的工作方式。 (继承自 UIElement) |
| TabIndex |
获取或设置一个值，该值确定当用户使用 Tab 键浏览控件时元素接收焦点的顺序。 (继承自 UIElement) |
| TabNavigation |
获取或设置一个值，该值修改 Tabbing 和 UIElement.TabIndex 对此控件的工作方式。 注意 对于Windows 10创意者更新（内部版本 10.0.15063）及更新版本， TabFocusNavigation 属性在 UIElement 基类上可用，以在不使用 ControlTemplate 的制表符序列中包含对象。 |
| TabNavigationProperty |
标识 TabNavigation 依赖项属性。 |
| Tag |
获取或设置可用于存储有关此对象的自定义信息的任意对象值。 (继承自 FrameworkElement) |
| Template |
获取或设置控件模板。 控件模板定义 UI 中控件的视觉外观，并在 XAML 标记中定义。 |
| TemplateProperty |
标识 模板 依赖项属性。 |
| Transform3D |
获取或设置呈现此元素时要应用的三维转换效果。 (继承自 UIElement) |
| TransformMatrix |
获取或设置要应用于元素的转换矩阵。 (继承自 UIElement) |
| Transitions |
获取或设置应用于 UIElement 的 Transition 样式元素的集合。 (继承自 UIElement) |
| Translation |
获取或设置元素的 x、y 和 z 呈现位置。 (继承自 UIElement) |
| TranslationTransition |
获取或设置 Vector3Transition，该 Vector3Transition 对翻译属性的更改进行动画处理。 (继承自 UIElement) |
| Triggers |
获取为 FrameworkElement 定义的动画的触发器集合。 不常用。 请参阅“备注”。 (继承自 FrameworkElement) |
| UseLayoutRounding |
获取或设置一个值，该值确定对象及其视觉子树的呈现是否应使用将呈现与整个像素对齐的舍入行为。 (继承自 UIElement) |
| UseSystemFocusVisuals |
获取或设置一个值，该值指示控件是使用由系统绘制的焦点视觉对象还是控件模板中定义的焦点视觉对象。 (继承自 UIElement) |
| VerticalAlignment |
获取或设置在父对象（如面板或项控件）中组合时应用于 FrameworkElement 的垂直对齐特征。 (继承自 FrameworkElement) |
| VerticalContentAlignment |
获取或设置控件内容的垂直对齐方式。 |
| VerticalContentAlignmentProperty |
标识 VerticalContentAlignment 依赖项属性。 |
| Visibility |
获取或设置 UIElement 的可见性。 不可见的元素 |
| Width |
获取或设置 FrameworkElement 的宽度。 (继承自 FrameworkElement) |
| XamlRoot |
获取或设置 |
| XYFocusDown |
获取或设置当用户按下游戏控制器方向盘（D 板）时获得焦点的对象。 (继承自 UIElement) |
| XYFocusDownNavigationStrategy |
获取或设置一个值，该值指定用于确定向下导航的目标元素的策略。 (继承自 UIElement) |
| XYFocusKeyboardNavigation |
获取或设置一个值，该值使用键盘方向箭头启用或禁用导航。 (继承自 UIElement) |
| XYFocusLeft |
获取或设置当用户向左按下游戏控制器方向盘（D 板）时获得焦点的对象。 (继承自 UIElement) |
| XYFocusLeftNavigationStrategy |
获取或设置一个值，该值指定用于确定左侧导航的目标元素的策略。 (继承自 UIElement) |
| XYFocusRight |
获取或设置当用户向右按下游戏控制器方向面板（D 板）时获取焦点的对象。 (继承自 UIElement) |
| XYFocusRightNavigationStrategy |
获取或设置一个值，该值指定用于确定右侧导航的目标元素的策略。 (继承自 UIElement) |
| XYFocusUp |
获取或设置当用户按下游戏控制器方向面板（D 板）时获得焦点的对象。 (继承自 UIElement) |
| XYFocusUpNavigationStrategy |
获取或设置一个值，该值指定用于确定向上导航的目标元素的策略。 (继承自 UIElement) |
附加属性
| 名称 | 说明 |
|---|---|
| IsTemplateFocusTarget |
获取或设置一个值，该值指示此元素是否是具有焦点视觉对象的控件模板的一部分。 |
| IsTemplateKeyTipTarget |
获取或设置一个值，该值指示此元素是否是放置键提示的控件模板的一部分。 |
方法
活动
| 名称 | 说明 |
|---|---|
| AccessKeyDisplayDismissed |
在不再显示访问密钥时发生。 (继承自 UIElement) |
| AccessKeyDisplayRequested |
当用户请求显示访问密钥时发生。 (继承自 UIElement) |
| AccessKeyInvoked |
当用户完成访问密钥序列时发生。 (继承自 UIElement) |
| ActualThemeChanged |
在 ActualTheme 属性值发生更改时发生。 (继承自 FrameworkElement) |
| BringIntoViewRequested |
在此元素或其子代之一上调用 StartBringIntoView 时发生。 (继承自 UIElement) |
| CharacterReceived |
当输入队列接收单个组合字符时发生。 (继承自 UIElement) |
| ContextCanceled |
当上下文输入手势继续进入操作手势时发生，以通知元素不应打开上下文浮出控件。 (继承自 UIElement) |
| ContextRequested |
当用户完成上下文输入手势（例如右键单击）时发生。 (继承自 UIElement) |
| DataContextChanged |
当 FrameworkElement.DataContext 属性的值更改时发生。 (继承自 FrameworkElement) |
| DoubleTapped |
在此元素的命中测试区域发生其他未经处理的 DoubleTap 交互时发生。 (继承自 UIElement) |
| DragEnter |
当输入系统报告具有此元素作为目标的基础拖动事件时发生。 (继承自 UIElement) |
| DragLeave |
当输入系统报告具有此元素作为源的基础拖动事件时发生。 (继承自 UIElement) |
| DragOver |
当输入系统将具有此元素的基础拖动事件报告为潜在放置目标时发生。 (继承自 UIElement) |
| DragStarting |
在启动拖动操作时发生。 (继承自 UIElement) |
| Drop |
当输入系统将此元素作为放置目标报告基础删除事件时发生。 (继承自 UIElement) |
| DropCompleted |
在结束源时使用此元素执行拖放操作时发生。 (继承自 UIElement) |
| EffectiveViewportChanged |
在 FrameworkElement的有效视区 更改时发生。 (继承自 FrameworkElement) |
| FocusDisengaged |
当用户按下游戏控制器上的 B/Back 按钮时，当焦点从控件中释放时发生。 |
| FocusEngaged |
当用户按下游戏控制器上的 A/选择按钮时，当焦点限制为控件时发生。 |
| GettingFocus |
在 UIElement 接收焦点之前发生。 此事件是同步引发的，以确保事件在冒泡时不会移动焦点。 (继承自 UIElement) |
| GotFocus |
当 UIElement 收到焦点时发生。 此事件是异步引发的，因此焦点可以在浮泡完成之前再次移动。 (继承自 UIElement) |
| Holding |
在此元素的命中测试区域发生其他未经处理的 保留 交互时发生。 (继承自 UIElement) |
| IsEnabledChanged |
在 IsEnabled 属性更改时发生。 |
| KeyDown |
当 UIElement 具有焦点时按下键盘键时发生。 (继承自 UIElement) |
| KeyUp |
当 UIElement 具有焦点时释放键盘键时发生。 (继承自 UIElement) |
| LayoutUpdated |
当可视化树的布局发生更改时，由于布局相关的属性更改值或刷新布局的其他操作。 (继承自 FrameworkElement) |
| Loaded |
在构造并添加到对象树并准备好交互时发生 FrameworkElement 。 (继承自 FrameworkElement) |
| Loading |
在 FrameworkElement 开始加载时发生。 (继承自 FrameworkElement) |
| LosingFocus |
在 UIElement 失去焦点之前发生。 此事件是同步引发的，以确保事件在冒泡时不会移动焦点。 (继承自 UIElement) |
| LostFocus |
当 UIElement 失去焦点时发生。 此事件是异步引发的，因此焦点可以在浮泡完成之前再次移动。 (继承自 UIElement) |
| ManipulationCompleted |
在 UIElement 上的操作完成时发生。 (继承自 UIElement) |
| ManipulationDelta |
输入设备在操作过程中更改位置时发生。 (继承自 UIElement) |
| ManipulationInertiaStarting |
当输入设备在操作和惯性开始时失去与 UIElement 对象的接触时发生。 (继承自 UIElement) |
| ManipulationStarted |
当输入设备在 UIElement 上开始操作时发生。 (继承自 UIElement) |
| ManipulationStarting |
首次创建操作处理器时发生。 (继承自 UIElement) |
| NoFocusCandidateFound |
当用户尝试移动焦点（通过制表符或方向箭头）时发生，但焦点不会移动，因为没有在移动方向找到候选焦点。 (继承自 UIElement) |
| PointerCanceled |
当使联系人异常失去联系人的指针时发生。 (继承自 UIElement) |
| PointerCaptureLost |
当此元素以前持有的指针捕获移动到另一个元素或其他地方时发生。 (继承自 UIElement) |
| PointerEntered |
当指针进入此元素的命中测试区域时发生。 (继承自 UIElement) |
| PointerExited |
当指针离开此元素的命中测试区域时发生。 (继承自 UIElement) |
| PointerMoved |
当指针在指针保留在此元素的命中测试区域中时发生。 (继承自 UIElement) |
| PointerPressed |
当指针设备在此元素中启动 Press 操作时发生。 (继承自 UIElement) |
| PointerReleased |
在此元素中释放之前启动 Press 操作的指针设备时发生。 请注意， 无法保证按下 操作的结束触发事件 |
| PointerWheelChanged |
当指针滚轮的增量值更改时发生。 (继承自 UIElement) |
| PreviewKeyDown |
当 UIElement 具有焦点时按下键盘键时发生。 (继承自 UIElement) |
| PreviewKeyUp |
当 UIElement 具有焦点时释放键盘键时发生。 (继承自 UIElement) |
| ProcessKeyboardAccelerators |
按下 键盘快捷方式（或快捷键） 时发生。 (继承自 UIElement) |
| RightTapped |
当指针位于元素上时发生右键输入刺激时发生。 (继承自 UIElement) |
| SizeChanged |
在 FrameworkElement 上的 ActualHeight 或 ActualWidth 属性值更改时发生。 (继承自 FrameworkElement) |
| Tapped |
在此元素的命中测试区域发生其他未经处理的 Tap 交互时发生。 (继承自 UIElement) |
| Unloaded |
当此对象不再连接到主对象树时发生。 (继承自 FrameworkElement) |