Window Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.UI.Xaml

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.

Modifica

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: 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 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 `Window`oggetto . 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