MediaTransportControls 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示媒体播放器元素的播放控件。
/// [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 MediaTransportControls : Control[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 class MediaTransportControls : ControlPublic Class MediaTransportControls
Inherits Control<MediaTransportControls .../>
- 继承
- 属性
Windows 要求
| 设备系列 |
Windows 10 (在 10.0.10240.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
|
示例
注解
媒体传输控件允许用户通过提供由各种按钮（包括播放、暂停、隐藏字幕等）组成的默认播放体验来与其媒体进行交互。 它具有许多属性，以便轻松自定义 UI 和配置哪些按钮可见或已启用。
可以使用 MediaTransportControls 让用户轻松控制其音频和视频内容。 MediaTransportControls 类仅与 MediaElement 或 MediaPlayerElement 控件结合使用。 它不用作独立控件。 可以通过 MediaElement.TransportControls 或 MediaPlayerElement.TransportControls 属性访问 MediaTransportControls 的实例。
注意
还可以将 MediaElement 与系统媒体传输控件集成。 系统传输控件是按下硬件媒体键时弹出的控件，例如键盘上的媒体按钮。 如果用户按下键盘上的暂停键，并且你的应用支持 SystemMediaTransportControls，则你的应用会收到通知，你可以采取相应的操作。 有关详细信息，请参阅 系统媒体传输控件。
将基本传输控件添加到 MediaElement
若要将 MediaTransportControls 与 MediaElement 一起使用，请在 MediaElement 上将 AreTransportControlsEnabled 属性设置为 true。
下面介绍如何在 XAML 中为 MediaElement 启用传输控件。
<MediaElement x:Name="mediaElement1" Source="ms-appx:///Assets/video.mp4"
AreTransportControlsEnabled="True"/>
下面介绍如何在代码中执行相同操作。 为简单起见，代码放置在 构造函数中 MainPage 。 rootGrid 引用在 MainPage.xaml 中创建的 Grid 元素。 它已被命名，以便可以通过编程方式将 MediaElement 添加到 XAML 树。
public MainPage()
{
this.InitializeComponent();
//Create a MediaElement and enable transport controls.
MediaElement mediaElement1 = new MediaElement();
mediaElement1.Source = new Uri("ms-appx:///Assets/video.mp4");
mediaElement1.AreTransportControlsEnabled = true;
rootGrid.Children.Add(mediaElement1);
}
启用压缩模式
默认情况下，传输控件显示在 2 行中。 若要在单行中显示传输控件，请将 IsCompact 属性设置为 true。
当需要较少的传输控件时，单行布局可以提供更好的体验，例如在音频应用中。 当需要更多传输控件（例如在视频应用中）时，双行布局可以提供更好的体验。 在决定是否使用紧凑模式时，还应考虑目标设备的大小。 例如，在较小的设备（如手机）上，使用单行布局可能会使传输控件显得拥挤。
有关这两种布局差异的详细信息，请参阅本文档的 部分。
下面介绍如何在 XAML 中启用压缩模式。
<MediaElement x:Name="mediaElement1" Source="ms-appx:///Assets/audio.wma"
AreTransportControlsEnabled="True">
<MediaElement.TransportControls>
<MediaTransportControls IsCompact="True"/>
</MediaElement.TransportControls>
</MediaElement>
下面介绍如何在代码中执行相同操作。 为简单起见，代码放置在构造函数中 MainPage 。 rootGrid 引用在 MainPage.xaml 中创建的 Grid 元素。 它已被命名，以便可以通过编程方式将 MediaElement 添加到 XAML 树。
public MainPage()
{
this.InitializeComponent();
//Create a MediaElement and enable transport controls.
MediaElement mediaElement1 = new MediaElement();
mediaElement1.Source = new Uri("ms-appx:///Assets/audio.wma");
mediaElement1.AreTransportControlsEnabled = true;
//Enable compact mode for transport controls.
mediaElement1.TransportControls.IsCompact = true;
rootGrid.Children.Add(mediaElement1);
}
隐藏、显示、启用和禁用按钮
MediaTransportControls 包括用于常见功能的查找栏和按钮。 可以通过设置 Is*ButtonVisible 属性来控制是否显示按钮。 可以通过设置 Is*Enabled 属性来独立控制是否启用按钮。
此表显示了内置传输控件及其关联的属性和默认值。
| 元素 | Is*Visible | Is*Enabled |
|---|---|---|
| 查找条形图 | IsSeekBarVisible (true) | IsSeekEnabled (true) |
| 播放/暂停 | N/A | N/A |
| 快进 | IsFastForwardButtonVisible (false) | IsFastForwardEnabled (false) |
| 快速倒退 | IsFastRewindButtonVisible (false) | IsFastRewindEnabled (false) |
| 停止 | IsStopButtonVisible (false) | IsStopEnabled (false) |
| 数据量(Volume) | IsVolumeButtonVisible (true) | IsVolumeEnabled (true) |
| 全屏 | IsFullWindowButtonVisible (true) | IsFullWindowEnabled (true) |
| 播放速率 | IsPlaybackRateButtonVisible (false) | IsPlaybackRateEnabled (false) |
| 缩放) (纵横比 | IsZoomButtonVisible (true) | IsZoomEnabled (true) |
| 强制转换 | 不可用 | 不可用 |
| 隐藏式字幕 | 不适用 - 如果关闭的描述文字轨道可用，则显示。 | 不可用 |
| 音频曲目选择 | 不适用 - 如果有多个音频曲目可用，则显示。 | 不可用 |
没有任何属性可用于隐藏、显示、启用或禁用播放/暂停按钮、关闭描述文字按钮、音频曲目选择按钮或强制转换按钮。 播放/暂停和强制转换按钮始终可见且处于启用状态。 每当关闭描述文字轨道可用时，“关闭描述文字”按钮都可见;每当有多个音轨可用时，“音频轨道选择”按钮都可见。
若要删除这些按钮或添加自定义按钮，必须重新创建 MediaTransportControls 模板。 如果重新创建控件模板，还可以指定按钮在不同屏幕大小处的退出顺序。 有关详细信息，请参阅 创建自定义传输控件 和 媒体传输控件示例。
下面介绍如何在 XAML 中配置传输控件按钮。 在此示例中，纵横比按钮处于隐藏和禁用状态，并且显示并启用播放速率按钮。
<MediaElement x:Name="mediaElement1" Source="ms-appx:///Assets/audio.wma"
AreTransportControlsEnabled="True">
<MediaElement.TransportControls>
<MediaTransportControls IsZoomButtonVisible="False" IsZoomEnabled="False"
IsPlaybackRateButtonVisible="True" IsPlaybackRateEnabled="True"/>
</MediaElement.TransportControls>
</MediaElement>
可以从 Windows 10 版本 1607) 开始，以完全相同的方式在 MediaPlayerElement (中配置传输控件。 在下面的示例中，我们将从 Windows 10 版本 1803) 开始设置 IsCompactOverlayButtonVisible 属性 (可用。
<MediaPlayerElement x:Name="mediaElement1" Source="ms-appx:///Assets/audio.wma"
AreTransportControlsEnabled="True">
<MediaPlayerElement.TransportControls>
<MediaTransportControls IsCompactOverlayButtonVisible="True"/>
</MediaPlayerElement.TransportControls>
</MediaPlayerElement>
下面介绍如何在代码中执行相同操作。 为简单起见，代码放置在构造函数中 MainPage 。 rootGrid 引用在 MainPage.xaml 中创建的 Grid 元素。 它已被命名，以便可以通过编程方式将 MediaElement 添加到 XAML 树。
public MainPage()
{
this.InitializeComponent();
//Create a MediaElement and enable transport controls.
MediaElement mediaElement1 = new MediaElement();
mediaElement1.Source = new Uri("ms-appx:///Assets/audio.wma");
mediaElement1.AreTransportControlsEnabled = true;
//Configure transport control buttons.
mediaElement1.TransportControls.IsZoomButtonVisible = false;
mediaElement1.TransportControls.IsZoomEnabled = false;
mediaElement1.TransportControls.IsPlaybackRateButtonVisible = true;
mediaElement1.TransportControls.IsPlaybackRateEnabled = true;
rootGrid.Children.Add(mediaElement1);
}
结构
MediaTransportControls 是由多个其他 XAML 控件组成的复合控件，这些控件都包含在根 Grid 元素中。
在默认模式下， 网格 有 2 行。 第一行包含一个 滑块 (查找栏) 显示媒体文件进度，并允许用户通过媒体向前或向后查找。 滑块下方是两个 TextBlock s。 它们显示已用时间和剩余时间。 第二行包含具有 AppBarButton s 的 CommandBar。 AppBarButton允许用户执行播放和暂停媒体、更改音量以及使视频全屏等操作。
在紧凑模式下， Slider 和 CommandBar 显示在一行中。 已用和剩余时间的 TextBlock处于隐藏状态。
控件样式和模板
可以修改默认 的 Style 和 ControlTemplate ，为控件提供唯一的外观。 有关修改控件的样式和模板的信息，请参阅 设置控件样式。 文件中包含 generic.xaml 定义控件外观的默认样式、模板和资源。 出于设计目的， generic.xaml 可通过 SDK 或 NuGet 包安装在本地使用。
- 建议) (WinUI 样式 ： 有关 WinUI 中更新的样式，请参阅
\Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml。 - 非 WinUI 样式： 有关内置样式，请参阅
%ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml。
如果自定义安装，位置可能会有所不同。 不同版本的 SDK 的样式和资源可能具有不同的值。
XAML 还包括可用于在不修改控件模板的情况下修改不同视觉状态下控件颜色的资源。 修改这些资源优先于设置 背景 和 前台等属性。 有关详细信息，请参阅 XAML 样式一文的轻量级样式部分。 从 Windows 10 版本 1607 (SDK 14393) 开始提供轻量级样式资源。
版本历史记录
| Windows 版本 | SDK 版本 | 已添加值 |
|---|---|---|
| 1607 | 14393 | FastPlayFallbackBehaviour |
| 1607 | 14393 | IsNextTrackButtonVisible |
| 1607 | 14393 | IsPreviousTrackButtonVisible |
| 1607 | 14393 | IsSkipBackwardButtonVisible |
| 1607 | 14393 | IsSkipBackwardEnabled |
| 1607 | 14393 | IsSkipForwardButtonVisible |
| 1607 | 14393 | IsSkipForwardEnabled |
| 1607 | 14393 | ThumbnailRequested |
| 1709 | 16299 | 隐藏 |
| 1709 | 16299 | IsRepeatButtonVisible |
| 1709 | 16299 | IsRepeatEnabled |
| 1709 | 16299 | 显示 |
| 1709 | 16299 | ShowAndHideAutomatically |
| 1803 | 17134 | IsCompactOverlayButtonVisible |
| 1803 | 17134 | IsCompactOverlayEnabled |
构造函数
| MediaTransportControls() |
初始化 MediaTransportControls 类的新实例。 |
属性
| 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 |
获取或设置提供控件背景的画笔。 (继承自 Control) |
| BackgroundSizing |
获取或设置一个值，该值指示背景相对于此元素边框的延伸距离。 (继承自 Control) |
| BaseUri |
获取统一资源标识符 (URI) ，表示 XAML 加载时 XAML 构造对象的基本统一资源标识符 (URI) 。 此属性在运行时用于统一资源标识符 (URI) 解析。 (继承自 FrameworkElement) |
| BorderBrush |
获取或设置描述控件的边框填充的画笔。 (继承自 Control) |
| BorderThickness |
获取或设置控件的边框宽度。 (继承自 Control) |
| CacheMode |
获取或设置一个值，该值指示应尽可能将呈现的内容缓存为复合位图。 (继承自 UIElement) |
| CanBeScrollAnchor |
获取或设置一个值，该值指示 UIElement 是否可以成为滚动定位的候选项。 (继承自 UIElement) |
| CanDrag |
获取或设置一个值，该值指示是否可以在拖放操作中将元素作为数据拖动。 (继承自 UIElement) |
| CenterPoint |
获取或设置 元素的中心点，该中心点是关于发生旋转或缩放的点。 影响元素的呈现位置。 (继承自 UIElement) |
| CharacterSpacing |
获取或设置字符之间的统一间距，单位为 em 的 1/1000。 (继承自 Control) |
| Clip |
获取或设置用于定义 UIElement 内容的大纲的 RectangleGeometry。 (继承自 UIElement) |
| CompositeMode |
获取或设置一个属性，该属性声明元素在其父布局和窗口中的替代组合和混合模式。 这与混合 XAML/Microsoft DirectX UI 中涉及的元素相关。 (继承自 UIElement) |
| ContextFlyout |
获取或设置与此元素关联的浮出控件。 (继承自 UIElement) |
| CornerRadius |
获取或设置控件边框的角的半径。 (继承自 Control) |
| DataContext |
获取或设置 FrameworkElement 的数据上下文。 数据上下文的常见用途是 当 FrameworkElement 使用 {Binding} 标记扩展并参与数据绑定时。 (继承自 FrameworkElement) |
| DefaultStyleKey |
获取或设置引用控件的默认样式的键。 自定义控件的作者使用此属性更改其控件使用的样式的默认值。 (继承自 Control) |
| DefaultStyleResourceUri |
获取或设置包含控件的默认样式的资源文件的路径。 (继承自 Control) |
| DesiredSize |
获取此 UIElement 在布局过程的度量传递期间计算的大小。 (继承自 UIElement) |
| Dispatcher |
获取与此对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject) |
| ElementSoundMode |
获取或设置一个值，该值指定控件是否播放声音的首选项。 (继承自 Control) |
| ExitDisplayModeOnAccessKeyInvoked |
获取或设置一个值，该值指定在调用访问密钥时是否消除访问密钥显示。 (继承自 UIElement) |
| FastPlayFallbackBehaviour |
获取或设置一个值，该值指定快进/快退按钮的行为方式。 |
| FastPlayFallbackBehaviourProperty |
标识 FastPlayFallbackBehaviour 依赖属性。 |
| FlowDirection |
获取或设置文本和其他 UI 元素在控制其布局的任何父元素中的流动方向。 此属性可以设置为 LeftToRight 或 RightToLeft。 在任何元素上将 FlowDirection 设置为 RightToLeft 会将对齐方式设置为右对齐，将阅读顺序设置为从右到左，并将控件的布局设置为从右到左流动。 (继承自 FrameworkElement) |
| FocusState |
获取一个值，该值指定此控件是否具有焦点以及获取焦点的模式。 (继承自 Control) |
| FocusVisualMargin |
获取或设置 FrameworkElement 的焦点视觉对象的外部边距。 (继承自 FrameworkElement) |
| FocusVisualPrimaryBrush |
获取或设置用于为 FrameworkElement 绘制或 |
| FocusVisualPrimaryThickness |
获取或设置 FrameworkElement 或 |
| FocusVisualSecondaryBrush |
获取或设置用于为 FrameworkElement 绘制或 |
| FocusVisualSecondaryThickness |
获取或设置 FrameworkElement 或 |
| FontFamily |
获取或设置用于显示控件中的文本的字体。 (继承自 Control) |
| FontSize |
获取或设置此 控件中文本的大小。 (继承自 Control) |
| FontStretch |
获取或设置字体在屏幕上紧缩或加宽的程度。 (继承自 Control) |
| FontStyle |
获取或设置呈现文本的样式。 (继承自 Control) |
| FontWeight |
获取或设置指定字体的粗细。 (继承自 Control) |
| Foreground |
获取或设置一个用于描述前景色的画笔。 (继承自 Control) |
| Height |
获取或设置 FrameworkElement 的建议高度。 (继承自 FrameworkElement) |
| HighContrastAdjustment |
获取或设置一个值，该值指示框架是否在启用高对比度主题时自动调整元素的视觉属性。 (继承自 UIElement) |
| HorizontalAlignment |
获取或设置在布局父级（如面板或项控件）中组合时应用于 FrameworkElement 的水平对齐特征。 (继承自 FrameworkElement) |
| HorizontalContentAlignment |
获取或设置控件内容的水平对齐方式。 (继承自 Control) |
| IsAccessKeyScope |
获取或设置一个值，该值指示元素是否定义其自己的访问键范围。 (继承自 UIElement) |
| IsCompact |
获取或设置一个值，该值指示传输控件是否显示在一行而不是两行上。 |
| IsCompactOverlayButtonVisible |
获取或设置一个值，该值指示是否显示压缩覆盖按钮。 |
| IsCompactOverlayButtonVisibleProperty |
标识 IsCompactOverlayButtonVisible 依赖属性。 |
| IsCompactOverlayEnabled |
获取或设置一个值，该值指示用户是否可以进入压缩覆盖模式。 |
| IsCompactOverlayEnabledProperty |
标识 IsCompactOverlayEnabled 依赖属性。 |
| IsCompactProperty |
标识 IsCompact 依赖属性。 |
| IsDoubleTapEnabled |
获取或设置一个值，该值确定 DoubleTapped 事件是否可以源自该元素。 (继承自 UIElement) |
| IsEnabled |
获取或设置一个值，该值指示用户是否可以与 控件交互。 (继承自 Control) |
| IsFastForwardButtonVisible |
获取或设置一个值，该值指示是否显示快进按钮。 |
| IsFastForwardButtonVisibleProperty |
标识 IsFastForwardButtonVisible 依赖属性。 |
| IsFastForwardEnabled |
获取或设置一个值，该值指示用户是否可以快进媒体。 |
| IsFastForwardEnabledProperty |
标识 IsFastForwardEnabled 依赖属性。 |
| IsFastRewindButtonVisible |
获取或设置一个值，该值指示是否显示倒退按钮。 |
| IsFastRewindButtonVisibleProperty |
标识 IsFastRewindButtonVisible 依赖属性。 |
| IsFastRewindEnabled |
获取或设置一个值，该值指示用户是否可以倒带媒体。 |
| IsFastRewindEnabledProperty |
标识 IsFastRewindEnabled 依赖属性。 |
| IsFocusEngaged |
获取或设置一个值，该值指示焦点是否在游戏板/远程交互) (控件边界内受到限制。 (继承自 Control) |
| IsFocusEngagementEnabled |
获取或设置一个值，该值指示是否可以将焦点限制在控件边界内， (游戏板/远程交互) 。 (继承自 Control) |
| IsFullWindowButtonVisible |
获取或设置一个值，该值指示是否显示全屏按钮。 |
| IsFullWindowButtonVisibleProperty |
标识 IsFullWindowButtonVisible 依赖属性。 |
| IsFullWindowEnabled |
获取或设置一个值，该值指示用户是否可以在全屏模式下播放媒体。 |
| IsFullWindowEnabledProperty |
标识 IsFullWindowEnabled 依赖属性。 |
| IsHitTestVisible |
获取或设置此 UIElement 的包含区域是否可以为命中测试返回 true 值。 (继承自 UIElement) |
| IsHoldingEnabled |
获取或设置一个值，该值确定 Holding 事件是否可以源自该元素。 (继承自 UIElement) |
| IsLoaded |
获取一个值，该值指示元素是否已添加到元素树中并已准备好进行交互。 (继承自 FrameworkElement) |
| IsNextTrackButtonVisible |
获取或设置一个值，该值指示是否显示“下一曲目”按钮。 |
| IsNextTrackButtonVisibleProperty |
标识 IsNextTrackButtonVisible 依赖属性。 |
| IsPlaybackRateButtonVisible |
获取或设置一个值，该值指示是否显示播放速率按钮。 |
| IsPlaybackRateButtonVisibleProperty |
标识 IsPlaybackRateButtonVisible 依赖属性。 |
| IsPlaybackRateEnabled |
获取或设置一个值，该值指示用户是否可以调整媒体的播放速率。 |
| IsPlaybackRateEnabledProperty |
标识 IsPlaybackRateEnabled 依赖属性。 |
| IsPreviousTrackButtonVisible |
获取或设置一个值，该值指示是否显示上一曲目按钮。 |
| IsPreviousTrackButtonVisibleProperty |
标识 IsPreviousTrackButtonVisible 依赖属性。 |
| IsRepeatButtonVisible |
获取或设置一个值，该值指示是否显示重复按钮。 |
| IsRepeatButtonVisibleProperty |
标识 IsRepeatButtonVisible 依赖属性。 |
| IsRepeatEnabled |
获取或设置一个值，该值指示用户是否重复播放媒体。 |
| IsRepeatEnabledProperty |
标识 IsRepeatEnabled 依赖属性。 |
| IsRightTapEnabled |
获取或设置一个值，该值确定 RightTapped 事件是否可以源自该元素。 (继承自 UIElement) |
| IsSeekBarVisible |
获取或设置一个值，该值指示是否显示搜寻栏。 |
| IsSeekBarVisibleProperty |
标识 IsSeekBarVisible 依赖属性。 |
| IsSeekEnabled |
获取或设置一个值，该值指示用户是否可以使用查找栏在媒体中查找位置。 |
| IsSeekEnabledProperty |
标识 IsSeekEnabled 依赖属性。 |
| IsSkipBackwardButtonVisible |
获取或设置一个值，该值指示是否显示“跳过后退”按钮。 |
| IsSkipBackwardButtonVisibleProperty |
标识 IsSkipBackwardButtonVisible 依赖属性。 |
| IsSkipBackwardEnabled |
获取或设置一个值，该值指示用户是否可以在媒体中向后跳过。 |
| IsSkipBackwardEnabledProperty |
标识 IsSkipBackwardEnabled 依赖属性。 |
| IsSkipForwardButtonVisible |
获取或设置一个值，该值指示是否显示“向前跳过”按钮。 |
| IsSkipForwardButtonVisibleProperty |
标识 IsSkipForwardButtonVisible 依赖属性。 |
| IsSkipForwardEnabled |
获取或设置一个值，该值指示用户是否可以在媒体中向前跳过。 |
| IsSkipForwardEnabledProperty |
标识 IsSkipForwardEnabled 依赖属性。 |
| IsStopButtonVisible |
获取或设置一个值，该值指示是否显示停止按钮。 |
| IsStopButtonVisibleProperty |
标识 IsStopButtonVisible 依赖属性。 |
| IsStopEnabled |
获取或设置一个值，该值指示用户是否可以停止媒体播放。 |
| IsStopEnabledProperty |
标识 IsStopEnabled 依赖属性。 |
| IsTabStop |
获取或设置一个值，该值指示是否将某个控件包含在 Tab 导航中。 (继承自 Control) |
| IsTapEnabled |
获取或设置一个值，该值确定 点击 事件是否可以源自该元素。 (继承自 UIElement) |
| IsTextScaleFactorEnabled |
获取或设置是否启用自动文本放大，以反映系统文本大小设置。 (继承自 Control) |
| IsVolumeButtonVisible |
获取或设置一个值，该值指示是否显示音量按钮。 |
| IsVolumeButtonVisibleProperty |
标识 IsVolumeButtonVisible 依赖属性。 |
| IsVolumeEnabled |
获取或设置一个值，该值指示用户是否可以调整媒体的音量。 |
| IsVolumeEnabledProperty |
标识 IsVolumeEnabled 依赖属性。 |
| IsZoomButtonVisible |
获取或设置一个值，该值指示是否显示缩放按钮。 |
| IsZoomButtonVisibleProperty |
标识 IsZoomButtonVisible 依赖属性。 |
| IsZoomEnabled |
获取或设置一个值，该值指示用户是否可以缩放媒体。 |
| IsZoomEnabledProperty |
标识 IsZoomEnabled 依赖属性。 |
| 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 |
获取或设置控件内部的填充边距。 (继承自 Control) |
| Parent |
获取对象树中此 FrameworkElement 的父对象。 (继承自 FrameworkElement) |
| PointerCaptures |
获取所有捕获的指针的集合，表示为 Pointer 值。 (继承自 UIElement) |
| Projection |
获取或设置呈现此元素时要应用的透视投影 (三维效果) 。 (继承自 UIElement) |
| RenderSize |
获取 UIElement 的最终呈现大小。 不建议使用 ，请参阅备注。 (继承自 UIElement) |
| RenderTransform |
获取或设置影响 UIElement 呈现位置的转换信息。 (继承自 UIElement) |
| RenderTransformOrigin |
获取或设置 RenderTransform 声明的任何可能的呈现转换相对于 UIElement 边界的原点。 (继承自 UIElement) |
| RequestedTheme |
获取或设置 UIElement (使用的 UI 主题及其子元素) 用于资源确定。 使用 RequestedTheme 指定的 UI 主题可以替代应用级 RequestedTheme。 (继承自 FrameworkElement) |
| RequiresPointer |
获取或设置 UI 元素是否支持鼠标模式，该模式模拟非指针输入设备（如游戏板或遥控器）的指针交互体验。 (继承自 Control) |
| Resources |
获取本地定义的资源字典。 在 XAML 中，可以通过 XAML 隐式集合语法将资源项建立为属性元素的 |
| Rotation |
获取或设置顺时针旋转的角度（以度为单位）。 相对于 RotationAxis 和 CenterPoint 旋转。 影响元素的呈现位置。 (继承自 UIElement) |
| RotationAxis |
获取或设置要围绕元素旋转的轴。 (继承自 UIElement) |
| RotationTransition |
获取或设置对 Rotation 属性的更改进行动画处理的 ScalarTransition。 (继承自 UIElement) |
| Scale |
获取或设置元素的刻度。 相对于元素的 CenterPoint 缩放。 影响元素的呈现位置。 (继承自 UIElement) |
| ScaleTransition |
获取或设置对 Scale 属性的更改进行动画处理的 Vector3Transition。 (继承自 UIElement) |
| Shadow |
获取或设置元素投射的阴影效果。 (继承自 UIElement) |
| ShowAndHideAutomatically |
获取或设置一个值，该值指示控件是否自动显示和隐藏。 |
| ShowAndHideAutomaticallyProperty |
标识 ShowAndHideAutomatically 依赖属性。 |
| Style |
获取或设置在布局和呈现期间为此对象应用的实例 Style 。 (继承自 FrameworkElement) |
| TabFocusNavigation |
获取或设置一个值，该值修改 Tabbing 和 TabIndex 对此控件的工作方式。 (继承自 UIElement) |
| TabIndex |
获取或设置一个值，该值指示当用户使用 Tab 键在应用 UI 中导航时元素接收焦点的顺序。 (继承自 Control) |
| TabNavigation |
获取或设置一个值，该值修改 Tabbing 和 TabIndex 对此控件的工作方式。 注意 对于Windows 10 创意者更新 (内部版本 10.0.15063) 及更新版本，TabFocusNavigation 属性在 UIElement 基类上可用，以包括不使用 ControlTemplate 的选项卡序列中的对象。 |
| Tag |
获取或设置可用于存储有关此对象的自定义信息的任意对象值。 (继承自 FrameworkElement) |
| Template |
获取或设置控件模板。 控件模板在 UI 中定义控件的视觉外观，并在 XAML 标记中定义。 (继承自 Control) |
| Transform3D |
获取或设置呈现此元素时要应用的三维转换效果。 (继承自 UIElement) |
| TransformMatrix |
获取或设置要应用于元素的转换矩阵。 (继承自 UIElement) |
| Transitions |
获取或设置应用于 UIElement 的 Transition 样式元素的集合。 (继承自 UIElement) |
| Translation |
获取或设置元素的 x、y 和 z 呈现位置。 (继承自 UIElement) |
| TranslationTransition |
获取或设置对 Translation 属性的更改进行动画处理的 Vector3Transition。 (继承自 UIElement) |
| Triggers |
获取为 FrameworkElement 定义的动画触发器的集合。 不常用。 请参阅“备注”。 (继承自 FrameworkElement) |
| UIContext |
获取 元素的上下文标识符。 (继承自 UIElement) |
| UseLayoutRounding |
获取或设置一个值，该值确定对象及其可视子树的呈现是否应使用使呈现与整个像素对齐的舍入行为。 (继承自 UIElement) |
| UseSystemFocusVisuals |
获取或设置一个值，该值指示控件是使用由系统绘制的焦点视觉对象还是控件模板中定义的视觉对象。 (继承自 Control) |
| VerticalAlignment |
获取或设置在父对象（如面板或项控件）中组合时应用于 FrameworkElement 的垂直对齐特征。 (继承自 FrameworkElement) |
| VerticalContentAlignment |
获取或设置控件内容的垂直对齐方式。 (继承自 Control) |
| Visibility |
获取或设置 UIElement 的可见性。 不可见的 UIElement 不会呈现，也不会将其所需大小传达给布局。 (继承自 UIElement) |
| Width |
获取或设置 FrameworkElement 的宽度。 (继承自 FrameworkElement) |
| XamlRoot |
获取或设置 |
| XYFocusDown |
获取或设置当用户按下方向键 (方向键) 时获得焦点的对象。 (继承自 Control) |
| XYFocusDownNavigationStrategy |
获取或设置一个值，该值指定用于确定向下导航的目标元素的策略。 (继承自 UIElement) |
| XYFocusKeyboardNavigation |
获取或设置一个值，该值使用键盘方向箭头启用或禁用导航。 (继承自 UIElement) |
| XYFocusLeft |
获取或设置当用户向左按方向键 (方向键) 时获得焦点的对象。 (继承自 Control) |
| XYFocusLeftNavigationStrategy |
获取或设置一个值，该值指定用于确定左侧导航的目标元素的策略。 (继承自 UIElement) |
| XYFocusRight |
获取或设置当用户向右按方向键 (方向键时获得焦点的对象) 。 (继承自 Control) |
| XYFocusRightNavigationStrategy |
获取或设置一个值，该值指定用于确定右侧导航的目标元素的策略。 (继承自 UIElement) |
| XYFocusUp |
获取或设置当用户按下方向键 (方向键) 时获得焦点的对象。 (继承自 Control) |
| XYFocusUpNavigationStrategy |
获取或设置一个值，该值指定用于确定向上导航的目标元素的策略。 (继承自 UIElement) |
方法
事件
| 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 |
当焦点从游戏板/远程交互) 的控制边界释放 (时发生。 (继承自 Control) |
| FocusEngaged |
当焦点在游戏板/远程交互) (控件边界内受限时发生。 (继承自 Control) |
| GettingFocus |
在 UIElement 接收焦点之前发生。 此事件是同步引发的，以确保在事件冒泡时不会移动焦点。 (继承自 UIElement) |
| GotFocus |
在 UIElement 收到焦点时发生。 此事件是异步引发的，因此焦点可以在浮升完成之前再次移动。 (继承自 UIElement) |
| Holding |
当此元素的命中测试区域发生其他未处理的 保持 交互时发生。 (继承自 UIElement) |
| IsEnabledChanged |
在 IsEnabled 属性更改时发生。 (继承自 Control) |
| 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 |
在释放之前启动 按下 操作的指针设备时发生，同时在此元素中。 请注意， 不保证按下 操作的结尾会触发 PointerReleased 事件;可能会触发其他事件。 有关详细信息，请参阅备注。 (继承自 UIElement) |
| PointerWheelChanged |
在指针滚轮的增量值更改时发生。 (继承自 UIElement) |
| PreviewKeyDown |
当 UIElement 具有焦点时按下键盘键时发生。 (继承自 UIElement) |
| PreviewKeyUp |
在 UIElement 具有焦点时释放键盘键时发生。 (继承自 UIElement) |
| ProcessKeyboardAccelerators |
按下 键盘快捷方式 (或快捷键) 时发生。 (继承自 UIElement) |
| RightTapped |
当指针位于 元素上时发生右点击输入刺激时发生。 (继承自 UIElement) |
| SizeChanged |
当 ActualHeight 或 ActualWidth 属性更改 FrameworkElement 上的值时发生。 (继承自 FrameworkElement) |
| Tapped |
在此元素的命中测试区域上发生未经处理的 点击 交互时发生。 (继承自 UIElement) |
| ThumbnailRequested |
当用户执行查找操作时，每当应用需要显示与查找栏相邻的缩略图时发生。 |
| Unloaded |
当此对象不再连接到main对象树时发生。 (继承自 FrameworkElement) |
适用于
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈