Window Classe

Definizione

Spazio dei nomi:

Windows.UI.Xaml

Rappresenta una finestra dell'applicazione.

public ref class Window 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 Window 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 Window

Public NotInheritable Class Window

Ereditarietà

Object Platform::Object IInspectable Window

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)

Esempio

L'esempio di codice seguente mostra l'override del metodo OnLaunched generato per il modello di applicazione vuoto in Microsoft Visual Studio. Questo codice illustra i modelli di utilizzo tipici per le proprietà Current e Content e il metodo Activate .

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
    // Create a Frame to act navigation context and navigate to the first page
    var rootFrame = new Frame();
    rootFrame.Navigate(typeof(BlankPage));

    // Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame;
    Window.Current.Activate();
}

Protected Overrides Sub OnLaunched(args As 
    Windows.ApplicationModel.Activation.LaunchActivatedEventArgs)

    ' Create a Frame to act navigation context and navigate to the first page
    Dim rootFrame As New Frame()
    rootFrame.Navigate(GetType(BlankPage))

    ' Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame
    Window.Current.Activate()
End Sub

Commenti

Questa classe rappresenta la finestra dell'applicazione corrente. Analogamente alla proprietà static Application , la proprietà static Current restituirà l'oggetto finestra dell'app. Da questo oggetto, un'app può utilizzare dispatcher o determinare le dimensioni della finestra dalla proprietà Bounds . L'utilizzo più comune per Window è l'impostazione di un oggetto UIElement sul contenuto che rappresenta l'interfaccia utente dell'app. Questa operazione viene in genere eseguita come parte dell'attivazione dell'app (ad esempio nell'override OnLaunched ). È possibile modificare il contenuto di questa finestra per tutta la durata della finestra.

Non esiste alcuna rappresentazione XAML della classe Window perché non è un controllo .

Un oggetto Window visualizza solo le informazioni di CoreWindow, che a sua volta fa riferimento alla finestra creata dal sistema.

Assicurarsi di chiamare Activate in qualsiasi finestra usata per l'attivazione iniziale. Se usi i modelli di app predefiniti di Microsoft Visual Studio, la chiamata a Window.Activate fa parte del codice iniziale nel file code-behind app.xaml.

La classe LayoutAwarePage che fa parte di alcuni modelli di applicazione in Microsoft Visual Studio ha la gestione per l'evento SizeChanged , che viene usata per tenere traccia degli stati di visualizzazione che corrispondono ai valori di ApplicationViewState. LayoutAwarePage include anche codice che controlla Bounds e usa questo valore per influenzare la modalità di gestione degli eventi di input a livello di pagina.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1703	15063	Compositor
1903	18362	UIContext

Membri di interfaccia aggiuntivi

IXamlSourceTransparency.IsBackgroundTransparent

Ottiene o imposta un valore che specifica se lo sfondo di tutti gli oggetti DesktopWindowXamlSource nel thread corrente è trasparente.

Proprietà

Bounds	Ottiene un valore Rect che contiene l'origine, l'altezza e la larghezza dell'area client della finestra, in pixel indipendenti dal dispositivo (DIP).
Compositor	Ottiene il programma di composizione per questa finestra.
Content	Ottiene o imposta la radice visiva di una finestra dell'applicazione.
CoreWindow	Ottiene un oggetto core interno per la finestra dell'applicazione.
Current	Ottiene la finestra del thread corrente.
Dispatcher	Ottiene l'oggetto CoreDispatcher per Window, che è in genere CoreDispatcher per il thread dell'interfaccia utente.
UIContext	Ottiene l'identificatore di contesto per la finestra.
Visible	Ottiene un valore che indica se la finestra è visibile.

Metodi

Activate()	Tenta di attivare la finestra dell'applicazione portandola in primo piano e impostando lo stato attivo sull'input.
Close()	Chiude la finestra dell'applicazione.
SetTitleBar(UIElement)	Rende un elemento XAML che interagisce con il sistema come se fosse la barra del titolo.

Eventi

Activated	Si verifica quando la finestra è stata attivata correttamente.
Closed	Si verifica quando la finestra è chiusa.
SizeChanged	Si verifica quando il rendering della finestra dell'app è stato eseguito per la prima volta o ha modificato le dimensioni di rendering.
VisibilityChanged	Si verifica quando viene modificato il valore della proprietà Visible .

Vedi anche

• OnLaunched(LaunchActivatedEventArgs)
• CoreWindow
• Gestire l’attivazione dell’app