ApplicationView Classe

Definizione

Spazio dei nomi:

Windows.UI.ViewManagement

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

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Vedi anche

• Disabilitazione dell'esempio di acquisizione dello schermo (Windows 10)
• Esempio di modalità di interazione utente (Windows 10)
• Esempio di più visualizzazioni (Windows 10)
• Esempio di modalità schermo intero (Windows 10)
• Esempio di ridimensionamento delle finestre (Windows 10)
• Esempio di barra del titolo (Windows 10)