Freigeben über


ApplicationView Klasse

Definition

Stellt die aktive Anwendungsansicht und zugeordnete Zustände und Verhaltensweisen dar.

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
Vererbung
Object Platform::Object IInspectable ApplicationView
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Ein Fenster (auch als App-Ansicht bezeichnet) ist der angezeigte Teil einer Windows-Runtime-App. Unter Windows können auf dem Bildschirm eines Benutzers bis zu 4 Fenster mit variabler Breite gleichzeitig angezeigt werden. Sie überlappen sich nicht, und ihre oberen und unteren Kanten berühren den oberen und unteren Rand des Bildschirms. Zwischen angrenzenden Fenstern können Bereiche ohne Fenster vorhanden sein.

Das Fenster entspricht nicht der aktuellen Seite der Anwendung. Es ist besser als container der Seiten; Sie können die Fensterreferenz in Ihrem Programm für alle Seiten der Anwendung verwenden.

Jedes Fenster verfügt über einen entsprechenden CoreWindow , der den Ui-Verarbeitungsthread (einschließlich der Kerneingabehandler und des Ereignisverteilers) für das Fenster darstellt.

Sie können die Eigenschaften (oder Methoden, für JavaScript) des Fensters verwenden, um Ihre Seiten zu konfigurieren. Beispiel: Die Orientation-Eigenschaft gibt an, ob das Fenster hoch- oder querformatiert ist. Für Windows gibt die AdjacentToLeftDisplayEdge-Eigenschaft an, ob der linke Bildschirmrand der linke Rand des Fensters ist. und die isFullScreen-Methode informiert Sie, ob das Fenster den gesamten Bildschirm verwendet. Beispiele für die Verwendung dieser Methoden finden Sie im Anwendungsaufrufbeispiel .

Um ein Objekt dieses Typs abzurufen, rufen Sie ApplicationView.GetForCurrentView auf.

Hinweis

Verwenden Sie beim Erstellen eines Seitenlayouts nicht den wert, der in der ApplicationView.Value-Eigenschaft zurückgegeben wird. Diese Methode ist veraltet und in zukünftigen Releases möglicherweise nicht verfügbar.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
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

Eigenschaften

AdjacentToLeftDisplayEdge

Ruft einen Wert ab, der angibt, ob sich das aktuelle Fenster in unmittelbarer Nähe zum linken Bildschirmrand befindet.

AdjacentToRightDisplayEdge

Ruft einen Wert ab, der angibt, ob sich das aktuelle Fenster in unmittelbarer Nähe zum rechten Bildschirmrand befindet.

DesiredBoundsMode

Ruft einen Wert ab, der die Grenzen angibt, die vom Framework verwendet werden, um den Inhalt des Fensters (App-Ansicht) zu gestalten.

FullScreenSystemOverlayMode

Ruft einen Wert ab, der angibt, wie eine App im Vollbildmodus auf Edge wischaktionen reagiert, oder legt diesen fest.

Id

Ruft die ID des Fensters (App-Ansicht) ab.

IsFullScreen

Hinweis

IsFullScreen kann für Releases nach Windows 10 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen IsFullScreenMode.

Ruft einen Wert ab, der angibt, ob das Fenster sowohl die linke als auch die rechte Seite der Anzeige berührt.

IsFullScreenMode

Ruft einen Wert ab, der angibt, ob die App im Vollbildmodus ausgeführt wird.

IsOnLockScreen

Ruft ab, ob sich das Fenster (App-Ansicht) auf dem Windows-Sperrbildschirm befindet.

IsScreenCaptureEnabled

Ruft ab oder legt fest, ob die Bildschirmaufnahme für das Fenster (App-Ansicht) aktiviert ist.

Orientation

Ruft die aktuelle Ausrichtung (Quer- oder Hochformat) des Fensters (App-Ansicht) in Bezug auf die Anzeige ab.

PersistedStateId

Ruft eine Zeichenfolge ab, die diese Ansicht zum Nachverfolgen und Speichern des Zustands identifiziert, oder legt diese fest.

PreferredLaunchViewSize

Ruft die Größe ab, mit der die App gestartet wird, wenn die ApplicationView.PreferredLaunchWindowingMode-Eigenschaft auf PreferredLaunchViewSize festgelegt ist, außer in Fällen, in denen das System die Fenstergröße direkt verwaltet.

PreferredLaunchWindowingMode

Ruft einen Wert ab, der den Fenstermodus angibt, mit dem die App gestartet wird, oder legt diesen fest.

SuppressSystemOverlays

Hinweis

SuppressSystemOverlays können für Releases nach Windows 10 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen TryEnterFullScreenMode und FullScreenSystemOverlayMode.

Ruft einen Wert ab, der angibt, ob Systemüberlagerungen (z. B. Überlagerungsanwendungen oder das weiche Lenkrad) angezeigt werden sollen, oder legt diesen fest.

TerminateAppOnFinalViewClose

Gibt an, ob die App beendet wird, wenn das letzte Fenster geschlossen wird.

Title

Ruft den angezeigten Titel des Fensters ab oder legt diese fest.

TitleBar

Ruft die Titelleiste der App ab.

UIContext

Ruft den Kontextbezeichner für die Ansicht ab.

Value

Hinweis

Statische ApplicationView-Methoden können für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen ApplicationView.GetForCurrentView , um ein ApplicationView-Objekt abzurufen.

Ruft den Status des aktuellen Fensters (App-Ansicht) ab.

ViewMode

Ruft den App-Ansichtsmodus für die aktuelle Ansicht ab.

VisibleBounds

Ruft den sichtbaren Bereich des Fensters (App-Ansicht) ab. Der sichtbare Bereich ist die Region, die nicht von Chrom wie der status leiste und der App-Leiste verdeckt wird.

WindowingEnvironment

Ruft die Fensterumgebung für die Ansicht ab.

Methoden

ClearAllPersistedState()

Löscht alle Eigenschaften, die das System für eine beliebige PersistedStateId-Ansicht für die angegebene Anwendung gespeichert hat.

ClearPersistedState(String)

Löscht alle Eigenschaften, die das System für die Ansicht mit dem angegebenen Bezeichner für die angegebene Anwendung gespeichert hat.

ExitFullScreenMode()

Hebt die App aus dem Vollbildmodus aus.

GetApplicationViewIdForWindow(ICoreWindow)

Ruft die Fenster-ID ab, die einem bestimmten CoreWindow entspricht, der von der App verwaltet wird.

GetDisplayRegions()

Gibt die Auflistung der Anzeigebereiche zurück, die für die Ansicht verfügbar sind.

GetForCurrentView()

Ruft die Ansichtsstatus- und Verhaltenseinstellungen der aktiven Anwendung ab.

IsViewModeSupported(ApplicationViewMode)

Bestimmt, ob der angegebene Ansichtsmodus auf dem aktuellen Gerät unterstützt wird.

SetDesiredBoundsMode(ApplicationViewBoundsMode)

Legt einen Wert fest, der die Grenzen angibt, die vom Framework zum Anordnen des Inhalts des Fensters (App-Ansicht) verwendet werden.

SetPreferredMinSize(Size)

Legt die kleinste Größe in effektiven Pixeln fest, die für das App-Fenster zulässig ist.

ShowStandardSystemOverlays()

Zeigt Systembenutzeroberflächenelemente wie die Titelleiste über einer Vollbild-App an.

TryConsolidateAsync()

Versucht, die aktuelle App-Ansicht auszublenden. Diese Methode ist ein programmgesteuertes Äquivalent zu einem Benutzer, der die App schließt.

TryEnterFullScreenMode()

Versucht, die App im Vollbildmodus zu platzieren.

TryEnterViewModeAsync(ApplicationViewMode)

Versucht, die App-Ansicht in den angegebenen Ansichtsmodus zu ändern.

TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences)

Versucht, die App-Ansicht mithilfe der angegebenen Optionen in den angegebenen Ansichtsmodus zu ändern.

TryResizeView(Size)

Versucht, die Größe der Ansicht in die angegebene Größe in effektiven Pixeln zu ändern.

TryUnsnap()

Hinweis

TryUnsnap kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Die Größe von Apps kann kontinuierlich geändert werden, kann aber ab Windows 8.1 nicht angedockt werden. Außerdem können statische ApplicationView-Methoden für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie ApplicationView.GetForCurrentView , um ein ApplicationView-Objekt abzurufen.

Versucht, eine zuvor angesprungene App zu entnapieren. Dieser Aufruf ist nur erfolgreich, wenn die App im Vordergrund ausgeführt wird.

TryUnsnapToFullscreen()

Versucht, eine zuvor angesprungene App zu entnapieren.

Ereignisse

Consolidated

Tritt auf, wenn das Fenster aus der Liste der zuletzt verwendeten Apps entfernt wird oder wenn der Benutzer eine Schließen-Geste darauf ausführt.

VisibleBoundsChanged

Dieses Ereignis wird ausgelöst, wenn sich der Wert von VisibleBounds ändert, in der Regel dadurch, dass die status leiste, die App-Leiste oder ein anderes Chrom angezeigt oder ausgeblendet wird.

Gilt für:

Weitere Informationen