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

取得視窗 (檢視) 的標識碼。
IsFullScreen

注意

IsFullScreen 可能會在 Windows 10 之後變更或無法使用版本。 請改用 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.GetForCurrentView 來取得 ApplicationView 物件。

取得目前視窗的狀態， (應用程式檢視) 。
ViewMode

取得目前檢視的應用程式檢視模式。
VisibleBounds

取得視窗的可見區域， (應用程式檢視) 。 可見區域是由 Chrome 所遮蔽的區域，例如狀態列和應用程式行。
WindowingEnvironment

取得檢視的視窗化環境。

方法

ClearAllPersistedState()

清除系統針對指定應用程式儲存的任何檢視 PersistedStateId 的任何屬性。
ClearPersistedState(String)

清除系統針對具有指定應用程式之指定標識符的檢視所儲存的任何屬性。
ExitFullScreenMode()

讓應用程式退出全螢幕模式。
GetApplicationViewIdForWindow(ICoreWindow)

取得對應至應用程式所管理之特定 CoreWindow 的視窗識別碼。
GetDisplayRegions()

傳回檢視可用的顯示區域集合。
GetForCurrentView()

取得使用中應用程式的檢視狀態和行為設定。
IsViewModeSupported(ApplicationViewMode)

判斷目前裝置是否支援指定的檢視模式。
SetDesiredBoundsMode(ApplicationViewBoundsMode)

設定值，指出架構用來配置視窗內容 (應用程式檢視) 的界限。
SetPreferredMinSize(Size)

設定應用程式視窗允許的最小大小，以有效圖元為單位。
ShowStandardSystemOverlays()

在全螢幕應用程式上顯示系統 UI 元素，例如標題列。
TryConsolidateAsync()

嘗試隱藏目前的應用程式檢視。 這個方法相當於關閉應用程式的使用者。
TryEnterFullScreenMode()

嘗試以全螢幕模式放置應用程式。
TryEnterViewModeAsync(ApplicationViewMode)

嘗試將應用程式檢視變更為指定的檢視模式。
TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences)

嘗試使用指定的選項，將應用程式檢視變更為指定的檢視模式。
TryResizeView(Size)

嘗試將檢視的大小變更為有效圖元中的指定大小。
TryUnsnap()

注意

tryUnsnap 可能會在 Windows 8.1 之後變更或無法使用版本。 應用程式可以持續重設大小，但無法貼齊，從 Windows 8.1 開始。 此外，在 Windows 8.1 之後，可能會變更或無法使用ApplicationView靜態方法。 使用 ApplicationView.GetForCurrentView 取得 ApplicationView 物件。

嘗試取消卸除先前已貼齊的應用程式。 只有在應用程式在前景執行時，此呼叫才會成功。
TryUnsnapToFullscreen()

嘗試取消卸除先前已貼齊的應用程式。

事件

Consolidated

當視窗從最近使用的應用程式清單中移除時發生，或當使用者在視窗上執行關閉手勢時。
VisibleBoundsChanged

當 VisibleBounds 的值變更時，就會引發此事件，通常是顯示或隱藏狀態列、應用程式行或其他 Chrome 的結果。

適用於

另請參閱