Window Clase

Definición

Espacio de nombres:

Windows.UI.Xaml

Representa una ventana de aplicación.

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

Herencia

Object Platform::Object IInspectable Window

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el ejemplo de código siguiente se muestra la invalidación del método OnLaunched generada para la plantilla de aplicación en blanco en Microsoft Visual Studio. En este código se muestran patrones de uso típicos para las propiedades Current y Content y el método 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

Comentarios

Esta clase representa la ventana de la aplicación actual. De la misma manera que la propiedad Application estática, la propiedad static Current devolverá el objeto de ventana de la aplicación. Desde este objeto, una aplicación puede utilizar dispatcher o determinar el tamaño de la ventana de la propiedad Bounds . El uso más común para Window es 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 ). Puede cambiar este contenido de ventana durante toda la vigencia de la ventana.

No hay ninguna representación XAML de la clase Window porque no es un control .

Un objeto Window simplemente muestra información de CoreWindow, que a su vez hace referencia a la ventana creada por el sistema.

Asegúrese de llamar a Activate en cualquier ventana que use en la activación inicial. Si usa las plantillas de aplicación predeterminadas de Microsoft Visual Studio, llamar a Window.Activate forma parte del código inicial en el archivo de código subyacente app.xaml.

La clase LayoutAwarePage que forma parte de algunas plantillas de aplicación de Microsoft Visual Studio tiene control para el evento SizeChanged , que se usa para realizar un seguimiento de los estados visuales que coinciden con los valores de ApplicationViewState. LayoutAwarePage también tiene código que comprueba Bounds y usa este valor para influir en cómo se controlan los eventos de entrada en toda la página.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1703	15063	Compositor
1903	18362	UIContext

Miembros de interfaz adicionales

IXamlSourceTransparency.IsBackgroundTransparent

Obtiene o establece un valor que especifica si el fondo de todos los objetos DesktopWindowXamlSource del subproceso actual es transparente.

Propiedades

Bounds	Obtiene un valor rect que contiene el origen, el alto y el ancho del área cliente de la ventana, en píxeles independientes del dispositivo (DIP).
Compositor	Obtiene el compositor de esta ventana.
Content	Obtiene o establece la raíz visual de una ventana de aplicación.
CoreWindow	Obtiene un objeto principal interno para la ventana de la aplicación.
Current	Obtiene la ventana del subproceso actual.
Dispatcher	Obtiene el objeto CoreDispatcher de la ventana, que suele ser CoreDispatcher para el subproceso de la interfaz de usuario.
UIContext	Obtiene el identificador de contexto 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 poniéndola en primer plano y estableciendo el foco de entrada en ella.
Close()	Cierra la ventana de la aplicación.
SetTitleBar(UIElement)	Hace que un elemento XAML interactúe con el sistema como si fuera la barra de título.

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

• OnLaunched(LaunchActivatedEventArgs)
• CoreWindow
• Controlar la activación de aplicaciones