Window Clase

  • Referencia

Definición

Espacio de nombres:
Microsoft.UI.Xaml
Editar

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 .

Se aplica a

Consulte también