Window.SetTitleBar(UIElement) Método

Definición

Espacio de nombres:

Windows.UI.Xaml

Hace que un elemento XAML interactúe con el sistema como si fuera la barra de título.

public:
 virtual void SetTitleBar(UIElement ^ value) = SetTitleBar;

void SetTitleBar(UIElement const& value);

public void SetTitleBar(UIElement value);

function setTitleBar(value)

Public Sub SetTitleBar (value As UIElement)

Parámetros

value

UIElement

Contenido XAML personalizado que debe actuar como barra de título. Para usar varios objetos, encapsularlos en un elemento contenedor, como uno derivado de Panel.

Comentarios

Este método te permite especificar un elemento XAML que interactúe con el sistema como si fuera la barra de título de la ventana de la aplicación. Cuando se usa este método, normalmente se establece la propiedad CoreApplicationViewTitleBar.ExtendViewIntoTitleBar en true para ocultar la barra de título del sistema predeterminada. Sin embargo, incluso cuando la barra de título del sistema predeterminada no está oculta, esto se puede usar para hacer que las regiones adicionales de la aplicación se comporten como la barra de título.

Use la propiedad CoreApplicationView.TitleBar para obtener la instancia de CoreApplicationViewTitleBar para la ventana de la aplicación, como esta.

// Requires using Windows.ApplicationModel.Core
CoreApplicationView coreView = CoreApplication.GetCurrentView();
CoreApplicationViewTitleBar coreTitleBar = coreView.TitleBar;
coreTitleBar.ExtendViewIntoTitleBar = true;

// -- OR --

CoreApplication.GetCurrentView().TitleBar.ExtendViewIntoTitleBar = true;

Nota

Este método no tiene ningún efecto cuando se ejecuta una aplicación en un dispositivo móvil, ya que las aplicaciones siempre son de pantalla completa en dispositivos móviles y no tienen una barra de título de ventana.

Entrada

Cuando se llama a este método para establecer un UIElement XAML como barra de título, permite a Windows controlar la entrada en la barra de título UIElement de la misma manera que controla la entrada en la barra de título del sistema predeterminada. Por ejemplo, un usuario puede mover la ventana arrastrando el UIElement XAML o invocando el menú contextual de la ventana haciendo clic con el botón derecho en ella.

Esto significa que la aplicación ya no recibe la entrada de puntero cuando el usuario interactúa con el UIElement de destino o sus elementos secundarios mediante la entrada táctil, el mouse o el lápiz. Sin embargo, debe controlar (o impedir) la entrada del teclado y determinar si el contenido de la barra de título puede recibir el foco mediante tabulación en él con el teclado.

Diseño y apariencia

Debe actualizar el contenido visual y el diseño de UIElement de destino en respuesta a los cambios de la barra de título, como la visibilidad y el tamaño.

Para que coincida con la visibilidad de la barra de título del sistema, controle el evento CoreApplicationViewTitleBar.IsVisibleChanged y respete la propiedad CoreApplicationViewTitleBar.IsVisible mostrando y ocultando la barra de título personalizada según corresponda. Esto garantiza que el contenido de la barra de título personalizada esté oculto correctamente cuando la barra de título del sistema esté oculta; por ejemplo, cuando el usuario elige mostrar la aplicación en modo de pantalla completa.

Para asegurarse de que la barra de título coincide con el tamaño de otros elementos de barra de título, como los botones Minimizar, Maximizar y Cerrar del sistema siempre presente, controle el evento CoreApplicationViewTitleBar.LayoutMetricsChanged y respete las propiedades CoreApplicationViewTitleBar.Height, SystemOverlayLeftInset y SystemOverlayRightInset .

El sistema siempre muestra los botones de barra de título predeterminados, como Minimizar, Maximizar y Cerrar, por lo que es posible que también quiera modificar su color para que coincida con el contenido de la barra de título XAML personalizada. Para ello, use la propiedad Windows.UI.ViewManagement.ApplicationView.TitleBar para obtener la instancia de ApplicationViewTitleBar para la ventana de la aplicación. A continuación, puede establecer las distintas propiedades de color en ApplicationViewTitleBar para modificar los botones predeterminados.