将 Windows 运行时 8.x XAML 和 UI 移植到 UWP
上一主题是疑难解答。
以声明性 XAML 标记的形式定义 UI 的做法非常好地将通用 8.1 应用转换为通用 Windows 平台 (UWP) 应用。 你会发现，你的大多数标记是兼容的，尽管你可能需要针对正在使用的系统资源键或自定义模板作相应调整。 视图模型中的强制性代码只需稍作更改或无需更改。 操纵 UI 元素的表示层中的许多强制性代码（甚至是大部分代码）也应易于移植。
强制性代码
如果你只是希望转到项目构建阶段，你可以注释或去掉任何非必要的代码。 然后一次一个问题进行迭代，并参考本部分中的以下主题（和上一个主题：疑难解答），直到消除所有构建和运行时问题并且完成移植。
自适应/响应式 UI
由于你的应用可以在种类可能很广泛的设备上运行（每种设备都具有自己的屏幕大小和分辨率），你不仅需要完成移植应用的最少步骤，而且还需要定制你的 UI 以使其在这些设备上具有最佳的外观。 你可以使用自适应视觉状态管理器功能来动态检测窗口大小并更改布局作为响应，还可以使用 Bookstore2 案例研究主题中的自适应 UI 部分中所示的有关如何执行此操作的示例。
后退按钮处理
对于通用 8.1 应用、Windows 运行时 8.x 应用和 Windows Phone Store 应用，创建要显示的 UI 和为后退按钮处理事件的方式均不同。 但对于 Windows 10 应用，你可以在你的应用中使用单一的方法。 在移动设备上，该按钮作为设备上的电容性按钮或外壳中的按钮向你提供。 在桌面设备上，只要应用内可进行后退导航，就可以向应用的镶边添加一个按钮，它将显示在窗口化应用的标题栏中或平板模式（仅 Windows 10）下的任务栏中。 后退按钮事件是所有设备系列的通用概念，并且硬件或软件中实现的按钮会引发相同的 BackRequested 事件。
以下示例适用于所有设备系列，并且对将相同的处理操作应用于所有页面的情形以及不需要确认导航的情形（例如，就未保存的更改发出警告）十分有用。
// app.xaml.cs
protected override void OnLaunched(LaunchActivatedEventArgs e)
{
[...]
Windows.UI.Core.SystemNavigationManager.GetForCurrentView().BackRequested += App_BackRequested;
rootFrame.Navigated += RootFrame_Navigated;
}
private void RootFrame_Navigated(object sender, NavigationEventArgs e)
{
Frame rootFrame = Window.Current.Content as Frame;
// Note: On device families that have no title bar, setting AppViewBackButtonVisibility can safely execute
// but it will have no effect. Such device families provide back button UI for you.
if (rootFrame.CanGoBack)
{
Windows.UI.Core.SystemNavigationManager.GetForCurrentView().AppViewBackButtonVisibility =
Windows.UI.Core.AppViewBackButtonVisibility.Visible;
}
else
{
Windows.UI.Core.SystemNavigationManager.GetForCurrentView().AppViewBackButtonVisibility =
Windows.UI.Core.AppViewBackButtonVisibility.Collapsed;
}
}
private void App_BackRequested(object sender, Windows.UI.Core.BackRequestedEventArgs e)
{
Frame rootFrame = Window.Current.Content as Frame;
if (rootFrame.CanGoBack)
{
rootFrame.GoBack();
}
}
还有一个适用于所有设备系列的以编程方式退出应用的方法。
Windows.UI.Xaml.Application.Current.Exit();
超级按钮
你无需更改任何与超级按钮集成的代码，但是你需要将某些 UI 添加到应用，以替换不属于 Windows 10 外壳的超级按钮栏。 在 Windows 10 上运行的通用 8.1 应用将具有其自己的替换 UI，该 UI 由应用标题栏中的系统呈现的镶边提供。
控件、控件样式和模板
对于控件，在 Windows 10 上运行的通用 8.1 应用将保留 8.1 的外观和行为。 但当你将该应用移植为 Windows 10 应用时，请注意其外观和行为的一些差异。 Windows 10 应用的控件的体系结构和设计实质上保持不变，因此更改主要围绕设计语言、简化和可用性改进。
注意：PointerOver 视觉状态与 Windows 10 应用和 Windows 运行时 8.x 应用（而非 Windows Phone Store 应用）中的自定义样式/模板相关。 鉴于此原因（以及由于 Windows 10 应用支持的系统资源键），我们建议在将应用移植到 Windows 10 时，重复使用 Windows 运行时 8.x 应用中的自定义样式/模板。 如果你需要确定你的自定义样式/模板使用的是否是最新的视觉状态集，以及是否受益于对默认样式/模板所做的性能改进，则可编辑新 Windows10 默认模板的副本，并将你的自定义重新应用于其中。 性能改进的一个示例是，以前包含 ContentPresenter 或面板的任何 Border 已被删除，而子元素现在可呈现边框。
下面是对控件所做的更改的一些更具体的示例。
| 控件名称 | 更改 |
|---|---|
| AppBar | 如果你使用的是 AppBar 控件（建议改用 CommandBar），则默认情况下，它不会在 Windows 10 应用中处于隐藏状态。 你可以使用 AppBar.ClosedDisplayMode 属性对其进行控制。 |
| AppBar、CommandBar | 在 Windows 10 应用中，AppBar 和 CommandBar 都具有一个“查看详细信息”按钮（省略号）。 |
| CommandBar | 在 Windows 运行时 8.x 应用中，CommandBar 的辅助命令始终可见。 在 Windows Phone 应用商店应用和 Windows 10 应用中，它们仅在命令栏打开后才显示。 |
| CommandBar | 对于 Windows Phone 应用商店应用，CommandBar.IsSticky 的值不影响该栏是否可通过轻触消除。 对于 Windows 10 应用，如果 IsSticky 设置为 True，则 CommandBar 将忽略轻触消除手势。 |
| CommandBar | 在 Windows 10 应用中，CommandBar 不处理 EdgeGesture.Completed 事件，也不处理 UIElement.RightTapped 事件。 同时也不会响应点击或向上轻扫操作。 你仍可以选择处理这些事件并设置 IsOpen。 |
| DatePicker、TimePicker | 通过从视觉上更改 DatePicker 和 TimePicker，查看你的应用的外观。 对于在移动设备上运行的 Windows 10 应用，这些控件不会再导航到选择页面，但会改为使用轻触消除弹出窗口。 |
| DatePicker、TimePicker | 在 Windows 10 应用中，你无法将 DatePicker 或 TimePicker 放入浮出控件中。如果你希望这些控件显示在弹出式控件中，则可以使用 DatePickerFlyout 和 TimePickerFlyout。 |
| GridView、ListView | 有关 GridView/ListView，请参阅 GridView 和 ListView 更改。 |
| 集线器 | 在 Windows Phone 应用商店应用中，Hub 控件从最后一部分环绕到第一部分。 在 Windows 运行时 8.x 应用和 Windows 10 应用中，中心区域不会环绕。 |
| 集线器 | 在 Windows Phone 应用商店应用中，Hub 控件的背景图像相对于中心区域在视差中移动。 在 Windows 运行时 8.x 应用和 Windows 10 应用中，中心区域不使用视差。 |
| 集线器 | 在通用 8.1 应用中，HubSection.IsHeaderInteractive 属性会导致区域标头（和呈现在它旁边的 V 型字型）变得具有交互性。 在 Windows 10 应用中，在该标头旁提供可交互的“查看详细信息”，但该标头本身不可交互。 IsHeaderInteractive 仍用于确定交互是否引发 Hub.SectionHeaderClick 事件。 |
| MessageDialog | 如果你使用的是 MessageDialog，请考虑改用更加灵活的 ContentDialog。 另请参阅 XAML UI 基础知识示例。 |
| ListPickerFlyout、PickerFlyout | Windows 10 应用中已弃用 ListPickerFlyout 和 PickerFlyout。 对于单选浮出控件，请使用 MenuFlyout；对于更复杂的体验，请使用 Flyout。 |
| PasswordBox | PasswordBox.IsPasswordRevealButtonEnabled 属性在 Windows 10 应用中已弃用，设置它已没有任何作用。 应改用 PasswordBox.PasswordRevealMode，其默认值为 Peek（其中显示眼睛标志，就像在 Windows 运行时 8.x 应用中一样）。 另请参阅密码框指南。 |
| Pivot | Pivot 控件现在是通用控件，它的使用不再限于移动设备。 |
| SearchBox | 尽管已在通用设备系列中实现了 SearchBox，但它无法在移动设备上正常运行。 请参阅弃用 SearchBox 以支持 AutoSuggestBox。 |
| SemanticZoom | 有关 SemanticZoom，请参阅 SemanticZoom 更改。 |
| ScrollViewer | ScrollViewer 的某些默认属性已更改。 HorizontalScrollMode 已更改为 Auto，VerticalScrollMode 已更改为 Auto，而 ZoomMode 已更改为 Disabled。 如果新的默认值不适合你的应用，你可以使用样式更改它们，或对控件本身的本地值进行更改。 |
| TextBox | 在 Windows 运行时 8.x 应用中，TextBox 的拼写检查默认处于禁用状态。 在 Windows Phone 应用商店应用和 Windows 10 应用中，它默认处于启用状态。 |
| TextBox | TextBox 的默认字体大小已从 11 更改为 15。 |
| TextBox | TextBox.TextReadingOrder 的默认值已从 Default 更改为 DetectFromContent。 如果不适用，则使用 UseFlowDirection。 Default 已弃用。 |
| 各种 | 主题色适用于 Windows Phone Store 应用和 Windows 10 应用，但不适用于 Windows 运行时 8.x 应用。 |
有关 UWP 应用控件的详细信息，请参阅按功能列出的控件、控件列表和控件指南。
Windows 10 设计语言
Universal 8.1 应用和 Windows 10 应用之间存在一些细小但很重要的设计语言差异。 有关所有详细信息，请参阅设计。 不考虑设计语言更改，我们的设计原则始终保持一致：关注细节却又力求简洁（专注于内容而不是外观），显著减少视觉元素，始终忠实于数字领域；使用可视化层次结构（尤其是版式）；基于网格进行设计；通过流畅的动画带给你生动的体验。
有效像素、观看距离和比例因子
以前，视图像素是从设备的实际物理大小和分辨率抽象表示 UI 元素的大小和布局的方法。 视图像素现在已发展为有效像素，下面是对该术语、该术语的意义以及它所提供的额外价值的说明。
术语“分辨率”是指像素密度的度量，而不是通常认为的像素计数。 “有效分辨率”是构成图像或字形的物理像素对肉眼解析的方法，因为设备的观看距离和物理像素大小之间有差异（像素密度是物理像素大小的倒数）。 有效分辨率是构建周围体验的良好指标，因为它是以用户为中心的。 通过了解所有因素并控制 UI 元素的大小，你可以优化用户的体验。
不同设备的宽度的有效像素是不同的，范围从最小设备的 320 像素到中等大小监视器的 1024 像素，甚至更高宽度的有效像素。 你只需像往常那样继续使用可自动调整大小的元素和动态布局面板。 在某些情况下，你还需要将 XAML 标记中的 UI 元素的相关属性设置为固定大小。 根据应用运行所在的设备和用户所设置的显示设置，比例因子将自动应用于应用。 并且，该比例因子可使具有固定大小的任何 UI 元素在各种尺寸的屏幕上都能向用户显示一些大小恒定的触摸（和阅读）目标。 通过与动态布局结合使用，你的 UI 不仅仅在不同设备上进行视觉上的缩放。 它还会执行任何必要的操作来将相应的内容量纳入到可用空间中。
这样，应用便可在所有屏幕上提供最佳体验。我们建议你针对各种屏幕大小创建每个位图资源，其中每个资源均适用于特定的比例因子。 在大多数情况下，提供 100% 缩放、200% 缩放和 400% 缩放的资源（按优先级顺序）能在采用所有中间比例系数时均可提供极佳效果。
注意 如果出于任何原因无法使用多种大小创建资源，则创建 100% 缩放的资源。 在 Microsoft Visual Studio 中，UWP 应用的默认项目模板仅使用一个大小提供品牌标识资源（磁贴图像和徽标），但这些资源并非 100% 缩放。 为自己的应用编写资源时，请按照本部分中的指南进行编写、提供 100%、200% 和 400% 尺寸，并使用资源包。
如果具有繁复的图案，则可能希望在更多尺寸中提供资源。 如果要从矢量图像开始，则生成采用任意比例系数的高质量资源相对容易。
但我们不建议你尝试支持所有比例系数，因为 Windows 10 应用的比例系数的完整列表为 100%、125%、150%、200%、250%、300%和 400%。 如果你支持这些比例系数，应用商店将针对每台设备选取大小适合的资源，然后将仅下载这些资源。 应用商店将根据设备的 DPI 选择要下载的资源。 你可以重复使用 Windows 运行时 8.x 应用中诸如 140% 和 220% 等比例因子的资产，但你的应用会按照某一新比例因子运行，从而使得某些位图缩放无法避免。 在各种设备上测试你的应用，以查看你是否满意相应的结果。
你可能重复使用 Windows 运行时 8.x 应用中的 XAML 标记，该标记中使用了文本维度值（可能用于大小形状或其他元素，也可能用于版式）。 但在某些情况下，在某一设备上针对 Windows 10 应用所使用的比例系数大于针对通用 8.1 应用所使用的比例系数（例如，之前使用的比例系数为 140% 而现在使用的为 150%，之前使用的比例系数为 180% 而现在使用的为 200%）。 因此如果你发现这些文本值现在在 Windows 10 中过大，则尝试将它们乘以 0.8。 有关详细信息，请参阅适用于 UWP 应用的响应式设计基础知识。
GridView 和 ListView 更改
已对 GridView 默认样式资源库进行多个更改，以使控件垂直滚动（而不是像之前默认的那样水平滚动）。 如果你编辑过你的项目中的默认样式副本，则副本将不会具有这些更改，因此你将需要手动进行更改。 下面是这些更改的列表。
- ScrollViewer.HorizontalScrollBarVisibility 的资源库已从 Auto 更改为 Disabled。
- ScrollViewer.VerticalScrollBarVisibility 的资源库已从 Disabled 更改为 Auto。
- ScrollViewer.HorizontalScrollMode 的资源库已从 Enabled 更改为 Disabled。
- ScrollViewer.VerticalScrollMode 的资源库已从 Disabled 更改为 Enabled。
- 在 ItemsPanel 的资源库中，ItemsWrapGrid.Orientation 的值已从 Vertical 更改为 Horizontal。
如果上一个更改（对 Orientation 的更改）看起来矛盾，请记住我们讨论的是包围式网格。 水平方向的包围式网格（新值）与文本水平流动的写入系统类似，并且在页面末尾中断到下一行。 这样的文本页面会垂直滚动。 相反，垂直方向的包围式网格（上一个值）与文本垂直流动的写入系统类似，因而水平滚动。
下面是 Windows 10 中已发生更改或不受支持的 GridView 和 ListView 方面。
- Windows 10 应用不支持 IsSwipeEnabled 属性（仅限 Windows 运行时 8.x 应用）。 API 仍存在，但设置它不起任何作用。 以前的所有选择手势都受支持，向下轻扫（它不受支持是因为数据显示其不容易被发现）和右键单击（为显示上下文菜单而保留）除外。
- Windows 10 应用不支持 ReorderMode 属性（仅限 Windows Phone 应用商店应用）。 API 仍存在，但设置它不起任何作用。 请改为将你的 GridView 或 ListView 的 AllowDrop 和 CanReorderItems 设置为 true，以便用户能够使用长按（或单击并拖动）手势重新排序。
- 在针对 Windows 10 进行开发时，在你的项容器样式中针对 ListView 和 GridView 使用 ListViewItemPresenter 而不是 GridViewItemPresenter。 如果你编辑了默认项容器样式的副本，你将获得正确的类型。
- 对于 Windows 10 应用，选择视觉效果已发生更改。 如果你将 SelectionMode 设置为 Multiple，则在默认情况下，将为每个项都呈现一个复选框。 ListView 项的默认设置意味着复选框在项旁边以内联方式布局，因此，该项的其余部分所占用的空间将稍微减少并进行移动。 对于 GridView 项，复选框默认叠加在该项上方。 但是，在任何一种情况下，你都可以通过项容器样式内的 ListViewItemPresenter 元素，控制复选框的布局方式（内联或叠加，通过 CheckMode 属性控制）以及是否完整显示它们（通过 SelectionCheckMarkVisualEnabled 属性），如以下示例所示。
- 在 Windows 10 中，ContainerContentChanging 事件在 UI 虚拟化期间针对每个项引发两次：一次用于回收，一次用于重复使用。 如果 InRecycleQueue 的值是 true，并且没有特定回收工作要执行，可立即退出事件处理程序，并可确保在重复使用该相同项时（此时 InRecycleQueue 将会是 false），将重新进入事件处理程序。
<Style x:Key="CustomItemContainerStyle" TargetType="ListViewItem|GridViewItem">
...
<Setter.Value>
<ControlTemplate TargetType="ListViewItem|GridViewItem">
<ListViewItemPresenter CheckMode="Inline|Overlay" ... />
</ControlTemplate>
</Setter.Value>
...
</Style>
带有内联复选框的 ListViewItemPresenter
带有叠加复选框的 ListViewItemPresenter
- 在删除用于选择的向下轻扫和右键单击手势时（由于上述原因），交互模型已更改，其结果之一是，ItemClick 和 SelectionChanged 事件将不再互相排斥。 对于你的 Windows 10 应用，请查看你的方案并确定是采用“选择”交互模型，还是采用“调用”交互模型。 有关详细信息，请参阅如何更改交互模式。
- 用于设置 ListViewItemPresenter 样式的属性进行了一些更改。 新属性包括：CheckBoxBrush、PressedBackground、SelectedPressedBackground 和 FocusSecondaryBorderBrush。 Windows 10 应用忽略的属性包括：Padding（改用 ContentMargin）、CheckHintBrush、CheckSelectingBrush、PointerOverBackgroundMargin、ReorderHintOffset、SelectedBorderThickness 和 SelectedPointerOverBorderBrush。
下表描述了对 ListViewItem 和 GridViewItem 控件模板中的视觉状态和视觉状态组的更改。
| 8.1 | 功能状态 | Windows 10/11 | 功能状态 |
|---|---|---|---|
| CommonStates | CommonStates | ||
| 一般 | 一般 | ||
| PointerOver | PointerOver | ||
| 已按下 | 已按下 | ||
| PointerOverPressed | [不可用] | ||
| 已禁用 | [不可用] | ||
| [不可用] | PointerOverSelected | ||
| [不可用] | 选定 | ||
| [不可用] | PressedSelected | ||
| [不可用] | DisabledStates | ||
| [不可用] | 已禁用 | ||
| [不可用] | 已启用 | ||
| SelectionHintStates | [不可用] | ||
| VerticalSelectionHint | [不可用] | ||
| HorizontalSelectionHint | [不可用] | ||
| NoSelectionHint | [不可用] | ||
| [不可用] | MultiSelectStates | ||
| [不可用] | MultiSelectDisabled | ||
| [不可用] | MultiSelectEnabled | ||
| SelectionStates | [不可用] | ||
| Unselecting | [不可用] | ||
| 未选定 | [不可用] | ||
| UnselectedPointerOver | [不可用] | ||
| UnselectedSwiping | [不可用] | ||
| 选择 | [不可用] | ||
| 选定 | [不可用] | ||
| SelectedSwiping | [不可用] | ||
| SelectedUnfocused | [不可用] |
如果你有一个自定义 ListViewItem 或 GridViewItem 控件模板，请按照上述更改查看它。 我们建议你通过编辑新默认模板的副本并向其重新应用你的自定义来重新开始。 如果出于任何原因而无法执行此操作，并且你需要编辑现有模板，下面是有关可以如何执行此操作的一些常规指南。
- 添加新的 MultiSelectStates 视觉状态组。
- 添加新的 MultiSelectDisabled 视觉状态。
- 添加新的 MultiSelectEnabled 视觉状态。
- 添加新的 DisabledStates 视觉状态组。
- 添加新的 Enabled 视觉状态。
- 在 CommonStates 视觉状态组中，删除 PointerOverPressed 视觉状态。
- 将 Disabled 视觉状态移动到 DisabledStates 视觉状态组中。
- 添加新的 PointerOverSelected 视觉状态。
- 添加新的 PressedSelected 视觉状态。
- 删除 SelectedHintStates 视觉状态组。
- 在 SelectionStates 视觉状态组中，将 Selected 视觉状态移动到 CommonStates 视觉状态组中。
- 删除整个 SelectionStates 视觉状态组。
本地化和全球化
在 UWP App 项目中，你可以重新使用通用 8.1 项目中的 Resources.resw 文件。 复制完该文件后，将其添加到项目，然后将“生成操作”设置为PRIResource，并将“复制到输出目录”设置为“不复制”。 ResourceContext.QualifierValues 主题介绍了如何基于设备系列资源选择规格加载特定于设备系列的资源。
播放到
在 Windows 10 应用中，Windows.Media.PlayTo 命名空间的 API 已弃用，而改为支持 Windows.Media.Casting API。
资源键和 TextBlock 样式大小
设计语言已针对 Windows 10 进行开展，因此某些系统样式已更改。 在某些情况下，你需要重新访问视图的视觉设计，以查看它们是否能与已更改的样式属性协调运行。
在其他情况下，资源键将不再受支持。 Visual Studio 中的 XAML 标记编辑器突出显示对无法解析的资源键的引用。 例如，XAML 标记编辑器将使用红色波形曲线为对样式键 ListViewItemTextBlockStyle 的引用加下划线。 如果未更正该错误，则应用将在你尝试将其部署到模拟器或设备时立即终止。 因此，请务必留意 XAML 标记的正确性。 而且你将发现 Visual Studio 是捕获此类问题的绝佳工具。
对于仍受支持的键，设计语言的更改意味着由某些样式设置的属性已更改。 例如，TitleTextBlockStyle在 Windows 运行时 8.x 应用中将 FontSize 设置为 14.667px，在 Windows Phone 应用商店应用中将 FontSize 设置为 18.14px。 但在 Windows 10 应用中，相同的样式将 FontSize 设置为大于 24px 。 查看你的设计和布局，并在合适的位置上使用适当的样式。 有关详细信息，请参阅字体指南和设计 UWP 应用。
下面是不再受支持的键的完整列表。
- CheckBoxAndRadioButtonMinWidthSize
- CheckBoxAndRadioButtonTextPaddingThickness
- ComboBoxFlyoutListPlaceholderTextOpacity
- ComboBoxFlyoutListPlaceholderTextThemeMargin
- ComboBoxHighlightedBackgroundThemeBrush
- ComboBoxHighlightedBorderThemeBrush
- ComboBoxHighlightedForegroundThemeBrush
- ComboBoxInlinePlaceholderTextForegroundThemeBrush
- ComboBoxInlinePlaceholderTextThemeFontWeight
- ComboBoxItemDisabledThemeOpacity
- ComboBoxItemHighContrastBackgroundThemeMargin
- ComboBoxItemMinHeightThemeSize
- ComboBoxPlaceholderTextBlockStyle
- ComboBoxPlaceholderTextThemeMargin
- CommandBarBackgroundThemeBrush
- CommandBarForegroundThemeBrush
- ContentDialogButton1HostPadding
- ContentDialogButton2HostPadding
- ContentDialogButtonsMinHeight
- ContentDialogContentLandscapeWidth
- ContentDialogContentMinHeight
- ContentDialogDimmingColor
- ContentDialogTitleMinHeight
- ControlContextualInfoTextBlockStyle
- ControlHeaderContentPresenterStyle
- ControlHeaderTextBlockStyle
- FlyoutContentPanelLandscapeThemeMargin
- FlyoutContentPanelPortraitThemeMargin
- GrabberMargin
- GridViewItemMargin
- GridViewItemPlaceholderBackgroundThemeBrush
- GroupHeaderTextBlockStyle
- HeaderContentPresenterStyle
- HighContrastBlack
- HighContrastWhite
- HubHeaderCharacterSpacing
- HubHeaderFontSize
- HubHeaderMarginThickness
- HubSectionHeaderCharacterSpacing
- HubSectionHeaderFontSize
- HubSectionHeaderMarginThickness
- HubSectionMarginThickness
- InlineWindowPlayPauseMargin
- ItemTemplate
- LeftFullWindowMargin
- LeftMargin
- ListViewEmptyStaticTextBlockStyle
- ListViewItemContentTextBlockStyle
- ListViewItemContentTranslateX
- ListViewItemMargin
- ListViewItemMultiselectCheckBoxMargin
- ListViewItemSubheaderTextBlockStyle
- ListViewItemTextBlockStyle
- MediaControlPanelAudioThemeBrush
- MediaControlPanelPhoneVideoThemeBrush
- MediaControlPanelVideoThemeBrush
- MediaControlPanelVideoThemeColor
- MediaControlPlayPauseThemeBrush
- MediaControlTimeRowThemeBrush
- MediaControlTimeRowThemeColor
- MediaDownloadProgressIndicatorThemeBrush
- MediaErrorBackgroundThemeBrush
- MediaTextThemeBrush
- MenuFlyoutBackgroundThemeBrush
- MenuFlyoutBorderThemeBrush
- MenuFlyoutLandscapeThemePadding
- MenuFlyoutLeftLandscapeBorderThemeThickness
- MenuFlyoutPortraitBorderThemeThickness
- MenuFlyoutPortraitThemePadding
- MenuFlyoutRightLandscapeBorderThemeThickness
- MessageDialogContentStyle
- MessageDialogTitleStyle
- MinimalWindowMargin
- PasswordBoxCheckBoxThemeMargin
- PhoneAccentBrush
- PhoneBackgroundBrush
- PhoneBackgroundColor
- PhoneBaseBlackColor
- PhoneBaseHighColor
- PhoneBaseLowColor
- PhoneBaseLowSolidColor
- PhoneBaseMediumHighColor
- PhoneBaseMediumMidColor
- PhoneBaseMediumMidSolidColor
- PhoneBaseMidColor
- PhoneBaseWhiteColor
- PhoneBorderThickness
- PhoneButtonBasePressedForegroundBrush
- PhoneButtonContentPadding
- PhoneButtonFontWeight
- PhoneButtonMinHeight
- PhoneButtonMinWidth
- PhoneChromeBrush
- PhoneChromeColor
- PhoneControlBackgroundColor
- PhoneControlDisabledColor
- PhoneControlForegroundColor
- PhoneDisabledBrush
- PhoneDisabledColor
- PhoneFontFamilyLight
- PhoneFontFamilySemiBold
- PhoneForegroundBrush
- PhoneForegroundColor
- PhoneHighContrastSelectedBackgroundThemeBrush
- PhoneHighContrastSelectedForegroundThemeBrush
- PhoneImagePlaceholderColor
- PhoneLowBrush
- PhoneMidBrush
- PhonePageBackgroundColor
- PhonePivotLockedTranslation
- PhonePivotUnselectedItemOpacity
- PhoneRadioCheckBoxBorderBrush
- PhoneRadioCheckBoxBrush
- PhoneRadioCheckBoxCheckBrush
- PhoneRadioCheckBoxPressedBrush
- PhoneStrokeThickness
- PhoneTextHighColor
- PhoneTextLowColor
- PhoneTextMidColor
- PhoneTextOverAccentColor
- PhoneTouchTargetLargeOverhang
- PhoneTouchTargetOverhang
- PivotHeaderItemPadding
- PlaceholderContentPresenterStyle
- ProgressBarHighContrastAccentBarThemeBrush
- ProgressBarIndeterminateRectagleThemeSize
- ProgressBarRectangleStyle
- ProgressRingActiveBackgroundOpacity
- ProgressRingElipseThemeMargin
- ProgressRingElipseThemeSize
- ProgressRingTextForegroundThemeBrush
- ProgressRingTextThemeMargin
- ProgressRingThemeSize
- RichEditBoxTextThemeMargin
- RightFullWindowMargin
- RightMargin
- ScrollBarMinThemeHeight
- ScrollBarMinThemeWidth
- ScrollBarPanningThumbThemeHeight
- ScrollBarPanningThumbThemeWidth
- SliderThumbDisabledBorderThemeBrush
- SliderTrackBorderThemeBrush
- SliderTrackDisabledBorderThemeBrush
- TextBoxBackgroundColor
- TextBoxBorderColor
- TextBoxDisabledHeaderForegroundThemeBrush
- TextBoxFocusedBackgroundThemeBrush
- TextBoxForegroundColor
- TextBoxPlaceholderColor
- TextControlHeaderMarginThemeThickness
- TextControlHeaderMinHeightSize
- TextStyleExtraExtraLargeFontSize
- TextStyleExtraLargePlusFontSize
- TextStyleMediumFontSize
- TextStyleSmallFontSize
- TimeRemainingElementMargin
弃用搜索框以支持 AutoSuggestBox
尽管已在通用设备系列中实现了 SearchBox，但它无法在移动设备上正常运行。 将 AutoSuggestBox 用于通用搜索体验。 下面介绍通常如何使用 AutoSuggestBox 实现搜索体验。
用户开始键入后，将引发 TextChanged 事件，描述为 UserInput。 然后填充建议列表，并设置 AutoSuggestBox 的 ItemsSource。 在用户导航列表时，将引发 SuggestionChosen 事件（并且若已设置 TextMemberDisplayPath，文本框将自动填充指定的属性）。 当用户使用 Enter 键提交选择时，将引发 QuerySubmitted 事件，此时可对该建议执行相应操作（在此情况下，最有可能是导航至具有有关指定内容的更多详细信息的另一个页面）。 请注意，SearchBoxQuerySubmittedEventArgs 的 LinguisticDetails 和 Language 属性不再受支持（有支持该功能的等效 API）。 并且 KeyModifiers 也不再受支持。
AutoSuggestBox 还支持输入法编辑器 (IME)。 如果希望显示“查找”图标，也可以那样做（与图标交互将引发 QuerySubmitted 事件）。
<AutoSuggestBox ... >
<AutoSuggestBox.QueryIcon>
<SymbolIcon Symbol="Find"/>
</AutoSuggestBox.QueryIcon>
</AutoSuggestBox>
另请参阅 AutoSuggestBox 移植示例。
SemanticZoom 更改
SemanticZoom 的缩小手势已在 Windows Phone 模型上进行了融合，该手势是点击或单击组标题（因此，在桌面计算机上，不再显示提供的用于缩小的减号按钮）。 现在，我们可以随意在所有设备上获取相同且一致的行为。 与 Windows Phone 模型相比的一个外观区别是缩小视图（跳转列表）替换放大视图，而不是覆盖它。 出于此原因，你可以从缩小视图中删除任何半透明背景。
在 Windows Phone 应用商店应用中，缩小视图将扩展为屏幕大小。 在 Windows 运行时 8.x 应用和 Windows 10 应用中，缩小视图的大小限制在 SemanticZoom 控件的边界内。
在 Windows Phone 应用商店应用中，如果缩小视图的背景中有任何透明度，则缩小视图后面的内容将（采用 z 顺序）显示出来。 在 Windows 运行时 8.x 应用和 Windows 10 应用中，缩小视图后面的所有内容均不可见。
在 Windows 运行时 8.x 应用中，当停用并重新激活应用时，缩小视图将消失（如果它正处于显示状态），而放大视图将显示。 在 Windows Phone 应用商店应用和 Windows 10 应用中，缩小视图将保持显示状态（如果它正处于显示状态）。
在 Windows Phone 应用商店应用和 Windows 10 应用中，在按下后退按钮后，缩小视图将消失。 在 Windows 运行时 8.x 应用中，不存在任何内置后退按钮的处理，因此不会遇到此类问题。
设置
Windows 运行时 8.x SettingsPane 类不适用于 Windows 10。 除了生成“设置”页面，还应为用户提供从应用内访问它的方式。 我们建议你在最高级别公开此应用“设置”页面来作为导航窗格上的最后一个固定项，但下面依然提供完整的选项集。
- 导航窗格。 “设置”应为选项的导航列表中最后一个项，并固定到底部。
- 应用栏/工具栏（在选项卡视图或透视布局内）。 “设置”应为应用栏或工具栏菜单浮出控件中的最后一个项。 不建议将“设置”作为导航内的顶级项之一。
- 中心。 “设置”应位于菜单浮出控件内部（可以在应用栏菜单或中心布局的工具栏菜单内）
同样不建议将“设置”隐藏在大纲细节窗格内。
“设置”页面应填充整个应用窗口，并且“设置”页面也是“关于”和“反馈”所在的位置。 有关“设置”页面的设计指南，请参阅应用设置指南。
文本
文本（或版式）是 UWP 应用的重要方面，并且在移植时，你可能希望回顾你的视图的视觉设计，以便它们与新设计语言相协调。 使用这些图示查找可用的通用 Windows 平台 (UWP) TextBlock 系统样式。 查找对应于你所使用的 Windows Phone Silverlight 样式的样式。 或者，你可以创建自己的通用样式并将 Windows Phone Silverlight 系统样式中的属性复制到这些样式中。
适用于 Windows 10 应用的 TextBlock 系统样式
在 Windows 运行时 8.x 应用和 Windows Phone Store 应用中，默认字体系列是 Global User Interface。 在 Windows 10 应用中，默认字体系列是 Segoe UI。 因此，你的应用中的字体指标可能看起来不同。 如果你希望重新生成 8.1 文本的外观，可以使用 LineHeight 和 LineStackingStrategy 等属性来设置你自己的指标。
在 Windows 运行时 8.x 应用和 Windows Phone Store 应用中，文本的默认语言将设置为版本语言或 en-us。 在 Windows 10 应用中，默认语言将设置为最常使用的应用语言（字体回退）。 你可以显式设置 FrameworkElement.Language，不过如果你未设置该属性的值，你将能够体验到更好的字体回退行为。
有关详细信息，请参阅字体指南和设计 UWP 应用。 有关对文本控件更改的信息，另请参阅上面的控件部分。
主题更改
对于通用 8.1 应用，默认主题为深色。 对于 Windows 10 设备，默认主题已更改，但是你可以通过在 App.xaml 中声明所请求的主题来控制所使用的主题。 例如，若要在所有设备上都使用深色主题，请将 RequestedTheme="Dark" 添加到根 Application 元素。
磁贴和 Toast
对于磁贴和 Toast，当前使用的模板将继续适用于你的 Windows 10 应用。 但有新的自适应模板可供你使用，它们在通知、磁贴、Toast 和锁屏提醒中有相关说明。
以前在台式机上，Toast 通知是暂时的消息。 一旦丢失或被忽略，它将消失且无法再检索。 在 Windows Phone 上，如果 Toast 通知被忽略或暂时消除，它将转到操作中心。 现在，操作中心不再局限于移动设备系列。
若要发送 Toast 通知，不再需要声明一个功能。
窗口大小
对于 Universal 8.1 应用，将使用 ApplicationView 应用清单元素声明最小窗口宽度。 在 UWP 应用中，你可以使用命令式代码指定最小大小（宽度以及高度）。 默认的最小大小为 500x320 epx，这也是可接受的最小大小的最小值。 可接受的最小大小的最大值为 500x500epx。
Windows.UI.ViewManagement.ApplicationView.GetForCurrentView().SetPreferredMinSize
(new Size { Width = 500, Height = 500 });
下一主题是针对 I/O、设备和应用模型进行移植。
反馈
即将推出：在整个 2024 年，我们将逐步取消以“GitHub 问题”作为内容的反馈机制，并将其替换为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈