ApplicationView 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示活动应用程序视图以及关联的状态和行为。
public ref class ApplicationView 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 ApplicationView 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 ApplicationViewPublic NotInheritable Class ApplicationView- 继承
- 属性
Windows 要求
| 设备系列 |
Windows 10 (在 10.0.10240.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
|
注解
窗口 (也称为应用视图) 是Windows 运行时应用的显示部分。 在 Windows 上，用户屏幕最多可同时显示 4 个可变宽度窗口。 它们不重叠，并且它们的上边缘和下边缘会接触屏幕的顶部和下边缘。 相邻窗口之间可能存在非窗口区域。
窗口与应用程序的当前页不同。 最好将其视为页面的容器;可以对应用程序的所有页面使用程序中的窗口引用。
每个窗口都有一个对应的 CoreWindow ，表示 UI 处理线程 (包括该窗口的核心输入处理程序和事件调度程序) 。
对于在配置页面时窗口的 JavaScript) ，可以使用 (或方法的属性。 例如： Orientation 属性指示窗口是纵向窗口还是横向窗口;对于 Windows，AdjacentToLeftDisplayEdge 属性指示屏幕的左边缘是否为窗口的左边框;和 isFullScreen 方法指示窗口是否使用整个屏幕。 有关使用这些方法的示例，请参阅 应用程序视图 示例。
若要获取此类型的对象，请调用 ApplicationView.GetForCurrentView。
注意
创建页面布局时，请勿使用 ApplicationView.Value 属性中返回的值。 此方法已弃用，将来的版本可能不可用。
版本历史记录
| Windows 版本 | SDK 版本 | 已添加值 |
|---|---|---|
| 1703 | 15063 | IsViewModeSupported |
| 1703 | 15063 | TryConsolidateAsync |
| 1703 | 15063 | TryEnterViewModeAsync (ApplicationViewMode) |
| 1703 | 15063 | TryEnterViewModeAsync (ApplicationViewMode，ViewModePreferences) |
| 1703 | 15063 | ViewMode |
| 1903 | 18362 | ClearAllPersistedState |
| 1903 | 18362 | ClearPersistedState |
| 1903 | 18362 | GetDisplayRegions |
| 1903 | 18362 | PersistedStateId |
| 1903 | 18362 | UIContext |
| 1903 | 18362 | WindowingEnvironment |
属性
| AdjacentToLeftDisplayEdge |
获取一个值，该值指示当前窗口是否靠近屏幕的左边缘。 |
| AdjacentToRightDisplayEdge |
获取一个值，该值指示当前窗口是否靠近屏幕的右边缘。 |
| DesiredBoundsMode |
获取一个值，该值指示框架用于在应用视图) (布局窗口内容的边界。 |
| FullScreenSystemOverlayMode |
获取或设置一个值，该值指示全屏模式下的应用如何响应边缘轻扫操作。 |
| Id |
获取应用视图) (窗口的 ID。 |
| IsFullScreen |
注意 Windows 10后，IsFullScreen 可能会更改或不可用。 请改用 IsFullScreenMode。 获取一个值，该值指示窗口是否同时接触显示器的左侧和右侧。 |
| IsFullScreenMode |
获取一个值，该值指示应用是否在全屏模式下运行。 |
| IsOnLockScreen |
获取窗口 (应用视图) 是否位于 Windows 锁屏界面上。 |
| IsScreenCaptureEnabled |
获取或设置是否为窗口启用屏幕捕获 (应用视图) 。 |
| Orientation |
获取窗口的当前方向 (横向或纵向) ， (应用视图) 相对于显示。 |
| PersistedStateId |
获取或设置一个字符串，该字符串标识此视图以跟踪和保存状态。 |
| PreferredLaunchViewSize |
获取或设置 当 ApplicationView.PreferredLaunchWindowingMode 属性设置为 PreferredLaunchViewSize 时应用启动的大小，除非系统直接管理窗口大小。 |
| PreferredLaunchWindowingMode |
获取或设置一个值，该值指示应用启动时使用的窗口模式。 |
| SuppressSystemOverlays |
注意 SuppressSystemOverlays 可能会在Windows 10后更改或不可用。 请改用 TryEnterFullScreenMode 和 FullScreenSystemOverlayMode。 获取或设置一个值，该值指示是否应显示系统覆盖 (，例如覆盖应用程序或软方向盘) 。 |
| TerminateAppOnFinalViewClose |
指示应用是否在关闭最后一个窗口时终止。 |
| Title |
获取或设置窗口的显示标题。 |
| TitleBar |
获取应用的标题栏。 |
| UIContext |
获取视图的上下文标识符。 |
| Value |
注意 Windows 8.1后，ApplicationView 静态方法可能会更改或不可用。 请改用 ApplicationView.GetForCurrentView 获取 ApplicationView 对象。 获取当前窗口的状态 (应用视图) 。 |
| ViewMode |
获取当前视图的应用视图模式。 |
| VisibleBounds |
获取应用视图) (窗口的可见区域。 可见区域是不受部件（如状态栏和应用栏）遮挡的区域。 |
| WindowingEnvironment |
获取视图的窗口环境。 |
方法
| ClearAllPersistedState() |
清除系统为给定应用程序的任何视图 PersistedStateId 保存的任何属性。 |
| ClearPersistedState(String) |
清除系统使用给定应用程序的指定标识符为视图保存的任何属性。 |
| ExitFullScreenMode() |
将应用退出全屏模式。 |
| GetApplicationViewIdForWindow(ICoreWindow) |
获取与应用管理的特定 CoreWindow 对应的窗口 ID。 |
| GetDisplayRegions() |
返回可用于视图的显示区域的集合。 |
| GetForCurrentView() |
获取活动应用程序的视图状态和行为设置。 |
| IsViewModeSupported(ApplicationViewMode) |
确定当前设备上是否支持指定的视图模式。 |
| SetDesiredBoundsMode(ApplicationViewBoundsMode) |
设置一个值，该值指示框架用于在应用视图) (设置窗口内容布局的边界。 |
| SetPreferredMinSize(Size) |
设置应用窗口允许的最小大小（以有效像素为单位）。 |
| ShowStandardSystemOverlays() |
在全屏应用上显示系统 UI 元素（如标题栏）。 |
| TryConsolidateAsync() |
尝试隐藏当前应用视图。 此方法以编程方式等效于关闭应用的用户。 |
| TryEnterFullScreenMode() |
尝试将应用置于全屏模式。 |
| TryEnterViewModeAsync(ApplicationViewMode) |
尝试将应用视图更改为指定的视图模式。 |
| TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences) |
尝试使用指定的选项将应用视图更改为指定的视图模式。 |
| TryResizeView(Size) |
尝试将视图的大小更改为指定大小（以有效像素为单位）。 |
| TryUnsnap() |
注意 Windows 8.1后，TryUnsnap 可能会更改或不可用。 从Windows 8.1开始，应用可以持续调整大小，但不能贴靠。 此外，ApplicationView 静态方法可能会在Windows 8.1后更改或不可用。 使用 ApplicationView.GetForCurrentView 获取 ApplicationView 对象。 尝试取消贴靠以前贴靠的应用。 仅当应用在前台运行时，此调用才会成功。 |
| TryUnsnapToFullscreen() |
尝试取消贴靠以前贴靠的应用。 |
事件
| Consolidated |
从最近使用的应用列表中删除窗口时，或者用户对窗口执行关闭手势时发生。 |
| VisibleBoundsChanged |
当 VisibleBounds 的值发生更改时，通常会引发此事件，这通常是由于状态栏、应用栏或其他显示或隐藏的部件版式的结果。 |