Window Classe

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

Rappresenta una finestra dell'applicazione corrente.

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Window
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Window
Public Class Window
Ereditarietà
Object IInspectable Window
Attributi
ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Esempio

Onlaunched

L'esempio di codice seguente mostra l'override del metodo OnLaunched generato per il modello WinUI in Desktop in Microsoft Visual Studio. Questo codice illustra l'utilizzo tipico del metodo Activate in Window.

protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
{
    m_window = new MainWindow();
    m_window.Activate();
}

private Window m_window;

Creare una nuova finestra

Nelle app è possibile creare ogni finestra in modo esplicito. La creazione di più finestre richiede l'aggiornamento 1.0.1 per SDK per app di Windows ed è limitata a un singolo thread.

var window = new Window();
window.Content = new TextBlock() { Text = "Hello" };
window.Activate();

È anche possibile definire una nuova finestra nel markup:

<Window 
    x:Class="MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <TextBlock>Hello</TextBlock>
</Window>

con code-behind corrispondente:

public partial class MainWindow : Window
{
  public MainWindow()
  {
    InitializeComponent();
  }
}

...
MainWindow window = new MainWindow();
window.Activate();

Commenti

Per altre informazioni ed esempi, vedere Panoramica delle finestre per WinUI e SDK per app di Windows.

In genere, Window viene usato per impostare un 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 ) e consente di modificare il contenuto della finestra per tutta la durata della finestra.

Assicurarsi di chiamare Activate per qualsiasi Window usata durante l'attivazione iniziale. Se usi i modelli di app predefiniti di Microsoft Visual Studio, Window.Activate viene incluso nel App.xaml file code-behind.

È possibile creare più di un Window thread nelle app. Vedi Mostra più finestre per la tua app.

Window implementa IWindowNative per abilitare l'interoperabilità tramite HWND (WindowHandle) di Window.

Costruttori

Nome Descrizione
Window()

Inizializza una nuova istanza della classe Window .

Proprietà

Nome Descrizione
AppWindow

Ottiene l'oggetto AppWindow associato a questo codice XAML Window.
Bounds

Ottiene un valore Rect che contiene l'altezza e la larghezza della finestra dell'applicazione in unità di pixel effettivi (visualizzazione).
Compositor

Ottiene il compositore per questa finestra.
Content

Ottiene o imposta la radice visiva di una finestra dell'applicazione.
CoreWindow

[Deprecato] Restituisce nullsempre .
Current

Restituisce sempre null.
Dispatcher

[Deprecato] Restituisce nullsempre .
DispatcherQueue

Ottiene l'oggetto DispatcherQueue per la finestra.
ExtendsContentIntoTitleBar

Ottiene o imposta un valore che specifica se la barra del titolo predefinita della finestra deve essere nascosta per creare spazio per il contenuto dell'app.
Height

Rappresenta una finestra dell'applicazione corrente.
MaxHeight

Rappresenta una finestra dell'applicazione corrente.
MaxWidth

Rappresenta una finestra dell'applicazione corrente.
MinHeight

Rappresenta una finestra dell'applicazione corrente.
MinWidth

Rappresenta una finestra dell'applicazione corrente.
SystemBackdrop

Ottiene o imposta lo sfondo del sistema da applicare all'oggetto Window. Il rendering dello sfondo viene eseguito dietro il Window contenuto.
Title

Ottiene o imposta una stringa utilizzata per il titolo della finestra.
Visible

Ottiene un valore che indica se la finestra è visibile.
Width

Rappresenta una finestra dell'applicazione corrente.

Metodi

Nome Descrizione
Activate()

Tenta di attivare la finestra dell'applicazione portandola in primo piano e impostando lo stato attivo sull'input.
Close()

Chiude (elimina) la finestra dell'applicazione.
SetTitleBar(UIElement)

Abilita il comportamento della barra del titolo in un elemento XAML quando ExtendsContentIntoTitleBar è true.

Eventi

Nome Descrizione
Activated

Si verifica quando la finestra è stata attivata o disattivata correttamente.
Closed

Si verifica quando la finestra è chiusa.
SizeChanged

Si verifica quando la dimensione di rendering della finestra è cambiata.
VisibilityChanged

Si verifica quando cambia il valore della proprietà Visible .

Si applica a

Vedi anche