Window Classe

Definizione

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

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.IsBackgroundTransparentOttiene 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 .

Si applica a

Vedi anche