ApplicationView Classe

Definizione

Rappresenta la visualizzazione applicazione attiva e gli stati e i comportamenti associati.

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
Ereditarietà
Object Platform::Object IInspectable ApplicationView
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Una finestra (chiamata anche visualizzazione app) è la parte visualizzata di un'app Windows Runtime. In Windows, la schermata di un utente può avere fino a 4 finestre di larghezza variabile visualizzate simultaneamente. Non si sovrappongono e i bordi superiore e inferiore toccano i bordi superiore e inferiore dello schermo. Potrebbero esserci aree non finestra tra finestre adiacenti.

La finestra non è la stessa della pagina corrente dell'applicazione. È meglio pensare a come contenitore delle pagine; è possibile usare il riferimento alla finestra nel programma per tutte le pagine dell'applicazione.

Ogni finestra ha un coreWindow corrispondente che rappresenta il thread di elaborazione dell'interfaccia utente (inclusi i gestori di input principali e il dispatcher eventi) per la finestra.

È possibile usare le proprietà (o i metodi, per JavaScript) della finestra nella configurazione delle pagine. Ad esempio, la proprietà Orientation indica se la finestra è verticale o orizzontale; per Windows la proprietà AdjacentToLeftDisplayEdge indica se il bordo sinistro dello schermo è il bordo sinistro della finestra; e il metodo isFullScreen indica se la finestra usa l'intera schermata. Per esempi di uso di questi metodi, vedere l'esempio di Visualizzazioni applicazione .

Per ottenere un oggetto di questo tipo, chiamare ApplicationView.GetForCurrentView.

Nota

Non usare il valore restituito nella proprietà ApplicationView.Value durante la creazione di un layout di pagina. Questo metodo è deprecato e potrebbe non essere disponibile nelle versioni future.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
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

Proprietà

AdjacentToLeftDisplayEdge

Ottiene un valore che indica se la finestra corrente è in prossimità del bordo sinistro dello schermo.

AdjacentToRightDisplayEdge

Ottiene un valore che indica se la finestra corrente è in prossimità del bordo destro dello schermo.

DesiredBoundsMode

Ottiene un valore che indica i limiti usati dal framework per definire il contenuto della finestra (visualizzazione app).

FullScreenSystemOverlayMode

Ottiene o imposta un valore che indica come un'app in modalità schermo intero risponde alle azioni di scorrimento rapido perimetrale.

Id

Ottiene l'ID della finestra (visualizzazione app).

IsFullScreen

Nota

IsFullScreen può essere modificato o non disponibile per le versioni dopo Windows 10. Usare invece IsFullScreenMode.

Ottiene un valore che indica se la finestra tocca sia i lati sinistro che destro dello schermo.

IsFullScreenMode

Ottiene un valore che indica se l'app è in esecuzione in modalità schermo intero.

IsOnLockScreen

Ottiene se la finestra (visualizzazione app) è nella schermata di blocco di Windows.

IsScreenCaptureEnabled

Ottiene o imposta se l'acquisizione dello schermo è abilitata per la finestra (visualizzazione app).

Orientation

Ottiene l'orientamento corrente (orizzontale o verticale) della finestra (visualizzazione app) rispetto alla visualizzazione.

PersistedStateId

Ottiene o imposta una stringa che identifica questa vista per il rilevamento e il salvataggio dello stato.

PreferredLaunchViewSize

Ottiene o imposta le dimensioni che l'app viene avviata quando la proprietà ApplicationView.PreferredLaunchWindowingMode è impostata su PreferredLaunchViewSize, tranne nei casi in cui il sistema gestisce direttamente le dimensioni della finestra.

PreferredLaunchWindowingMode

Ottiene o imposta un valore che indica la modalità di finestra con cui viene avviata l'app.

SuppressSystemOverlays

Nota

SuppressSystemOverlays può essere modificato o non disponibile per le versioni dopo Windows 10. Usare invece TryEnterFullScreenMode e FullScreenSystemOverlayMode.

Ottiene o imposta un valore che indica se le sovrapposizioni di sistema (ad esempio le applicazioni di sovrapposizione o il volante morbido) devono essere visualizzate.

TerminateAppOnFinalViewClose

Indica se l'app termina quando l'ultima finestra viene chiusa.

Title

Ottiene o imposta il titolo visualizzato della finestra.

TitleBar

Ottiene la barra del titolo dell'app.

UIContext

Ottiene l'identificatore di contesto per la visualizzazione.

Value

Nota

I metodi statici di ApplicationView possono essere modificati o non disponibili per le versioni dopo Windows 8.1. Usare invece ApplicationView.GetForCurrentView per ottenere un oggetto ApplicationView .

Ottiene lo stato della finestra corrente (visualizzazione app).

ViewMode

Ottiene la modalità di visualizzazione dell'app per la visualizzazione corrente.

VisibleBounds

Ottiene l'area visibile della finestra (visualizzazione app). L'area visibile è l'area non occlusa da chrome, ad esempio la barra di stato e la barra delle app.

WindowingEnvironment

Ottiene l'ambiente di finestra per la visualizzazione.

Metodi

ClearAllPersistedState()

Cancella le proprietà salvate dal sistema per qualsiasi visualizzazione PersistentedStateId per l'applicazione specificata.

ClearPersistedState(String)

Cancella le proprietà salvate dal sistema per la visualizzazione con l'identificatore specificato per l'applicazione specificata.

ExitFullScreenMode()

Consente all'app di uscire dalla modalità schermo intero.

GetApplicationViewIdForWindow(ICoreWindow)

Ottiene l'ID finestra corrispondente a un coreWindow specifico gestito dall'app.

GetDisplayRegions()

Restituisce la raccolta di aree di visualizzazione disponibili per la visualizzazione.

GetForCurrentView()

Ottiene le impostazioni dello stato e del comportamento di visualizzazione dell'applicazione attiva.

IsViewModeSupported(ApplicationViewMode)

Determina se la modalità di visualizzazione specificata è supportata nel dispositivo corrente.

SetDesiredBoundsMode(ApplicationViewBoundsMode)

Imposta un valore che indica i limiti usati dal framework per definire il contenuto della finestra (visualizzazione app).

SetPreferredMinSize(Size)

Imposta le dimensioni più piccole, in pixel effettivi, consentite per la finestra dell'app.

ShowStandardSystemOverlays()

Mostra gli elementi dell'interfaccia utente di sistema, ad esempio la barra del titolo, su un'app a schermo intero.

TryConsolidateAsync()

Tenta di nascondere la visualizzazione dell'app corrente. Questo metodo è un equivalente a livello di codice a un utente che chiude l'app.

TryEnterFullScreenMode()

Tenta di posizionare l'app in modalità schermo intero.

TryEnterViewModeAsync(ApplicationViewMode)

Tenta di modificare la visualizzazione dell'app nella modalità di visualizzazione specificata.

TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences)

Tenta di modificare la visualizzazione dell'app nella modalità di visualizzazione specificata usando le opzioni specificate.

TryResizeView(Size)

Tenta di modificare le dimensioni della visualizzazione in pixel effettivi.

TryUnsnap()

Nota

TryUnsnap può essere modificato o non disponibile per le versioni dopo Windows 8.1. Le app possono essere ridimensionate in modo continuo, ma non possono essere rimosse, a partire da Windows 8.1. Inoltre, i metodi statici di ApplicationView possono essere modificati o non disponibili per le versioni dopo Windows 8.1. Usare ApplicationView.GetForCurrentView per ottenere un oggetto ApplicationView .

Tenta di annullare un'app precedentemente creata. Questa chiamata avrà esito positivo solo quando l'app è in esecuzione in primo piano.

TryUnsnapToFullscreen()

Tenta di annullare un'app precedentemente creata.

Eventi

Consolidated

Si verifica quando la finestra viene rimossa dall'elenco di app usate di recente o se l'utente esegue un gesto di chiusura.

VisibleBoundsChanged

Questo evento viene generato quando il valore di VisibleBounds viene modificato, in genere come risultato della barra di stato, della barra dell'app o di un altro chrome visualizzato o nascosto.

Si applica a

Vedi anche