ApplicationView 类

  • 参考

定义

命名空间:
Windows.UI.ViewManagement
编辑

表示活动应用程序视图以及关联的状态和行为。

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 ApplicationView
Public NotInheritable Class ApplicationView
继承
Object Platform::Object IInspectable ApplicationView
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 的值发生更改时，通常会引发此事件，这通常是由于状态栏、应用栏或其他显示或隐藏的部件版式的结果。

适用于

另请参阅