Window Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml

Representa la ventana de la aplicación actual.

/// [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

Herencia

Object IInspectable Window

Atributos

ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Ejemplos

OnLaunched

En el ejemplo de código siguiente se muestra la invalidación del método OnLaunched generada para winUI en la plantilla de escritorio en Microsoft Visual Studio. Este código muestra el uso típico del método Activate en Window.

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

private Window m_window;

Crear una nueva ventana

En las aplicaciones, puede crear cada ventana explícitamente. La creación de más de una ventana requiere la actualización 1.0.1 a WindowsAppSDK y se limita a un único subproceso.

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

También puede definir una nueva ventana en el marcado:

<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 el código subyacente correspondiente:

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

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

Comentarios

Puede crear más de una Window por subproceso en las aplicaciones. Consulte Crear una nueva ventana en ejemplos.

Window implementa IWindowNative para habilitar la interoperabilidad a través del HWND de la ventana (WindowHandle).

Normalmente, Window se usa para establecer un uiElement en el contenido que representa la interfaz de usuario de la aplicación. Esto suele hacerse como parte de la activación de la aplicación (por ejemplo, en la invalidación OnLaunched ) y permite cambiar el contenido de la ventana durante toda la vigencia de la ventana.

Asegúrese de llamar a Activate en cualquier Window usado en la activación inicial. Si usas las plantillas de aplicación predeterminadas de Microsoft Visual Studio, Window.Activate se incluye en el archivo de código subyacente App.xaml.

Constructores

Window()

Inicializa una nueva instancia de la clase Window .

Propiedades

AppWindow	Obtiene el AppWindow objeto asociado a este XAML Window.
Bounds	Obtiene un valor rect que contiene el alto y el ancho de la ventana de la aplicación en unidades de píxeles efectivos (vista).
Compositor	Obtiene el compositor de esta ventana.
Content	Obtiene o establece la raíz visual de una ventana de aplicación.
CoreWindow	Las aplicaciones de escritorio siempre devuelven null para esta propiedad.
Current	Las aplicaciones de escritorio siempre devuelven null para esta propiedad.
Dispatcher	Siempre devuelve null en una aplicación de SDK de Aplicaciones para Windows. Nota Window.Dispatcher puede modificarse o no estar disponible en futuras versiones. Use Window.DispatcherQueue en su lugar.
DispatcherQueue	Obtiene el DispatcherQueue objeto de la ventana.
ExtendsContentIntoTitleBar	Obtiene o establece un valor que especifica si la barra de título predeterminada de la ventana debe ocultarse para crear espacio para el contenido de la aplicación.
SystemBackdrop	Obtiene o establece el fondo del sistema que se va a aplicar a este Windowobjeto . El fondo se representa detrás del Window contenido.
Title	Obtiene o establece una cadena usada para el título de la ventana.
Visible	Obtiene un valor que informa de si la ventana está visible.

Métodos

Activate()	Intenta activar la ventana de la aplicación llevándola al primer plano y estableciendo el foco de entrada en ella.
Close()	Cierra la ventana de la aplicación.
SetTitleBar(UIElement)	Habilita el comportamiento de la barra de título en un elemento XAML cuando ExtendsContentIntoTitleBar es true.

Eventos

Activated	Se produce cuando la ventana se ha activado correctamente.
Closed	Se produce cuando la ventana se ha cerrado.
SizeChanged	Se produce cuando la ventana de la aplicación se ha representado por primera vez o ha cambiado su tamaño de representación.
VisibilityChanged	Se produce cuando cambia el valor de la propiedad Visible .

Consulte también

• IWindowNative
• Controlar la activación de aplicaciones
• CoreWindow
• CoreApplicationView
• ApplicationView