ApplicationView Klasse

Referenz

Definition

Namespace:: Windows.UI.ViewManagement

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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:

Freigeben über