Window Clase

Definición

Espacio de nombres:
Microsoft.UI.Xaml
Editar

Representa una 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 para SDK de Aplicaciones para Windows 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();
  }
}

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

Comentarios

Para obtener más información y ejemplos, consulte Introducción a ventanas para WinUI y SDK de Aplicaciones para Windows.

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 usa las plantillas de aplicación predeterminadas de Microsoft Visual Studio, Window.Activate se incluye en el App.xaml archivo de código subyacente.

Puede crear más de uno Window por subproceso en las aplicaciones. Consulta Mostrar varias ventanas para la aplicación.

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

Constructores

Nombre Description
Window()

Inicializa una nueva instancia de la clase Window .

Propiedades

Nombre Description
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

[En desuso] Siempre devuelve null.
Current

Siempre devuelve null.
Dispatcher

[En desuso] Siempre devuelve null.
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.
Height

Representa una ventana de la aplicación actual.
MaxHeight

Representa una ventana de la aplicación actual.
MaxWidth

Representa una ventana de la aplicación actual.
MinHeight

Representa una ventana de la aplicación actual.
MinWidth

Representa una ventana de la aplicación actual.
SystemBackdrop

Obtiene o establece el telón de fondo del sistema que se va a aplicar a este Window. El telón de 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.
Width

Representa una ventana de la aplicación actual.

Métodos

Nombre Description
Activate()

Intenta activar la ventana de la aplicación al traerla al primer plano y establecer el foco de entrada en ella.
Close()

Cierra (destruye) 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

Nombre Description
Activated

Se produce cuando la ventana se ha activado o desactivado correctamente.
Closed

Se produce cuando la ventana se ha cerrado.
SizeChanged

Se produce cuando el tamaño de representación de la ventana ha cambiado.
VisibilityChanged

Se produce cuando cambia el valor de la propiedad Visible .

Se aplica a

Consulte también