Compartir a través de


Window Clase

Definición

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

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.IsBackgroundTransparentObtiene 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 .

Se aplica a

Consulte también