Condividi tramite


Window Classe

Definizione

Rappresenta la 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

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 tue app puoi creare ogni finestra in modo esplicito. La creazione di più finestre richiede l'aggiornamento 1.0.1 a WindowsAppSDK 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();
  }
}

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

Commenti

È possibile creare più di un Window thread nelle app. Vedere Creare una nuova finestra in Esempi.

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

In genere, Window viene usato per impostare 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 ) 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 è incluso nel file code-behind App.xaml.

Costruttori

Window()

Inizializza una nuova istanza della classe Window .

Proprietà

AppWindow

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

Bounds

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

Compositor

Ottiene il programma di composizione per questa finestra.

Content

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

CoreWindow

Le app desktop restituiscono null sempre per questa proprietà.

Current

Le app desktop restituiscono null sempre per questa proprietà.

Dispatcher

Restituisce null sempre in un'app SDK per app di Windows.

Nota

Window.Dispatcher potrebbe essere modificato o non disponibile nelle versioni future. Usare invece Window.DispatcherQueue .

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.

SystemBackdrop

Ottiene o imposta lo sfondo del sistema da applicare a questo Windowoggetto . 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.

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)

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

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