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 |
取得視窗 (檢視) 的標識碼。 |
| 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 的結果。 |