Exportar (0) Imprimir
Expandir todo

Window (Clase)

Actualización: Julio de 2008

Permite crear, configurar, mostrar y administrar la duración de las ventanas y los cuadros de diálogo.

Espacio de nombres:  System.Windows
Ensamblado:  PresentationFramework (en PresentationFramework.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/xaml/presentation

[LocalizabilityAttribute(LocalizationCategory.Ignore)]
[UIPermissionAttribute(SecurityAction.InheritanceDemand, Window = UIPermissionWindow.AllWindows)]
public class Window : ContentControl
/** @attribute LocalizabilityAttribute(LocalizationCategory.Ignore) */
/** @attribute UIPermissionAttribute(SecurityAction.InheritanceDemand, Window = UIPermissionWindow.AllWindows) */
public class Window extends ContentControl
public class Window extends ContentControl
<Window>
  Content
</Window>

El punto de interacción entre el usuario y una aplicación independiente es una ventana. Una ventana de Windows Presentation Foundation (WPF) se compone de dos áreas distintas:

  • Un área no cliente, que hospeda los elementos gráficos de las ventanas, incluidos un icono, título, menú del sistema, botón para minimizar, botón para maximizar, botón para restablecer, botón para cerrar y un borde.

  • Un área cliente, que hospeda el contenido específico de la aplicación.

En la siguiente figura se muestra una ventana estándar:

Elementos de ventana

Window permite crear, configurar, mostrar y administrar la duración de las ventanas y los cuadros de diálogo, además de proporcionar los siguientes servicios clave:

Administración de la duración: Activate, Activated, Close, Closed, Closing, Deactivated, Hide, IsActive, Show, SourceInitialized.

Administración de ventanas: GetWindow, OwnedWindows, Owner.

Apariencia y comportamiento: AllowsTransparency, ContentRendered, DragMove, Icon, Left, LocationChanged, ResizeMode, RestoreBounds, ShowActivated, ShowInTaskbar, SizeToContent, StateChanged, Title, Top, Topmost, WindowStartupLocation, WindowState, WindowStyle

Cuadros de diálogo: DialogResult, ShowDialog.

Además, Application expone una compatibilidad especial para administrar todas las ventanas de una aplicación:

  • La aplicación mantiene una lista de todas las ventanas con instancias en la aplicación. La propiedad Windows expone esta lista.

  • De forma predeterminada, MainWindow se establece automáticamente con una referencia al primer objeto Window del que se crean instancias en una aplicación. De este modo, convierte la ventana en la ventana principal de la aplicación.

Se puede implementar un objeto Window mediante marcado, una combinación de marcado y código subyacente, o bien, código.

Window se utiliza principalmente para mostrar las ventanas y los cuadros de diálogo de aplicaciones independientes. Sin embargo, para las aplicaciones que requieren navegación en el nivel de ventana, como los asistentes, se puede utilizar NavigationWindow; NavigationWindow deriva del objeto Window y lo extiende con compatibilidad para la navegación basada en el explorador.

ms590112.alert_note(es-es,VS.90).gifNota:

Se pueden incorporar islas de contenido navegable en otro contenido y contenedores de contenido mediante Frame.

Window necesita el permiso de seguridad UnmanagedCode para que se pueden crear instancias. Esto tiene las siguientes consecuencias:

  • Las aplicaciones independientes implementadas mediante ClickOnce solicitarán que se eleve el nivel de permisos cuando se inicien desde zonas de Internet o de la intranet local.

  • Las XBAPs que solicitan menos permisos que el conjunto completo de permisos no podrán crear instancias de ventanas o cuadros de diálogo.

Vea Estrategia de seguridad de Windows Presentation Foundation: Seguridad de la plataforma para obtener una descripción de la implementación de aplicaciones independientes y consideraciones de seguridad.

Modelo de contenido: Window es un control ContentControl, lo que significa que Window puede incluir contenido como texto, imágenes o paneles. Asimismo, Window es un elemento raíz, por lo que no puede formar parte del contenido de otro elemento. Para obtener más información sobre el modelo de contenido de Window, vea Modelos de contenido.

En el ejemplo siguiente se muestra cómo se define una ventana estándar sólo mediante marcado:

<Window 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    Title="Main Window in Markup Only" 
    Height="300" 
    Width="300" />


En el ejemplo siguiente se muestra cómo se define una ventana estándar sólo mediante código:

using System;
using System.Windows;

namespace CSharp
{
    public partial class CodeOnlyWindow : Window
    {
        public CodeOnlyWindow()
        {
            this.Title = "Main Window in Code Only";
            this.Width = 300;
            this.Height = 300;
        }
    }
}


En el ejemplo siguiente se muestra cómo se define una ventana estándar mediante una combinación de marcado y código subyacente.

<Window 
    x:Class="MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    Title="Main Window" 
    Height="300" 
    Width="300" />


using System;
using System.Windows;
public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
    }
}


System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Media.Visual
        System.Windows.UIElement
          System.Windows.FrameworkElement
            System.Windows.Controls.Control
              System.Windows.Controls.ContentControl
                System.Windows.Window
                  System.Windows.Navigation.NavigationWindow

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0

Fecha

Historial

Motivo

Julio de 2008

Se han agregado nuevos miembros: la propiedad ShowActivated y el campo ShowActivatedProperty.

Cambio de características de SP1.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft