ApplicationView Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 ApplicationViewPublic NotInheritable Class ApplicationView- Ereditarietà
- 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
- 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)