TabView Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

El control TabView es una manera de mostrar un conjunto de pestañas y su contenido correspondiente. Los controles de pestaña son útiles para mostrar varias páginas (o documentos) de contenido al tiempo que proporciona al usuario la capacidad de reorganizar, abrir o cerrar nuevas pestañas.

¿Es este el control adecuado?

Use tabView para ayudar al usuario a administrar varias páginas de aplicación o documentos dentro de la misma ventana.

No use tabView para mostrar un conjunto estático de pestañas que el usuario no puede reorganizar, abrir o cerrar. En su lugar, use navigationView (NavigationViewPaneDisplayMode of Top).

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class TabView : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class TabView : Control

Public Class TabView
Inherits Control

Herencia

Control

TabView

Atributos

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Ejemplos

Sugerencia

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta Vista de pestañas.

Abra la aplicación Galería de WinUI 2 y vea TabView en acción.

La aplicación WinUI 2 Gallery incluye ejemplos interactivos de la mayoría de los controles, características y funcionalidades de WinUI 2. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.

Ejemplo de TabView básico, similar a un explorador web

<TabView AddTabButtonClick="Tabs_AddTabButtonClick"
         TabCloseRequested="Tabs_TabCloseRequested" />

// Add a new Tab to the TabView
private void Tabs_AddTabButtonClick(TabView sender, TabViewAddTabButtonClickEventArgs e)
{
    var newTab = new TabViewItem();
    newTab.IconSource = new SymbolIconSource() { Symbol = Symbol.Document };
    newTab.Header = "New Document";

    // The Content of a TabViewItem is often a frame which hosts a page.
    Frame frame = new Frame();
    newTab.Content = frame;
    frame.Navigate(typeof(BaconIpsumPage));

    sender.TabItems.Add(newTab);
}

// Remove the requested tab from the TabView
private void Tabs_TabCloseRequested(TabView sender, TabViewTabCloseRequestedEventArgs args)
{
    sender.TabItems.Remove(args.Tab);
}

Comentarios

Estilo de control y plantilla

Puede modificar el Estilo predeterminado y ControlTemplate para dar al control una apariencia única. Para obtener información sobre cómo modificar el estilo y la plantilla de un control, consulta Estilos XAML. El estilo, la plantilla y los recursos predeterminados que definen la apariencia del control se incluyen en el generic.xaml archivo . Para fines de diseño, generic.xaml se instala con el paquete NuGet WinUI (Microsoft.UI.Xaml). De forma predeterminada, la ubicación es \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Los estilos y recursos de diferentes versiones de WinUI pueden tener valores diferentes.

XAML también incluye recursos que puedes usar para modificar los colores de un control en distintos estados visuales sin modificar la plantilla de control. Se prefiere modificar estos recursos para establecer propiedades como Fondo y Primer plano. Para obtener más información, consulta la sección Estilo ligero del artículo Estilos XAML .

Constructores

TabView()

Inicializa una nueva instancia de la clase TabView . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Propiedades

AddTabButtonCommand	Obtiene o establece el comando que se va a invocar cuando se pulsa el botón Agregar (+). Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
AddTabButtonCommandParameter	Obtiene o establece el parámetro que se va a pasar a la propiedad AddTabButtonCommand. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
AddTabButtonCommandParameterProperty	Identifica la propiedad de dependencia AddTabButtonCommandParameter . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
AddTabButtonCommandProperty	Identifica la propiedad de dependencia AddButtonCommand. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
AllowDropTabs	Obtiene o establece un valor que determina si TabView puede ser un destino de colocación para las operaciones de arrastrar y colocar. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
AllowDropTabsProperty	Identifica la propiedad de dependencia AllowDropTabs . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
CanDragTabs	Obtiene o establece un valor que indica si las pestañas se pueden arrastrar como una carga de datos. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
CanDragTabsProperty	Identifica la propiedad de dependencia CanDragTabs . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
CanReorderTabs	Obtiene o establece un valor que indica si las pestañas de TabStrip se pueden reordenar a través de la interacción del usuario. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
CanReorderTabsProperty	Identifica la propiedad de dependencia CanReorderTabs . Identifica la propiedad de dependencia CanReorderTabs. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
CloseButtonOverlayMode	Obtiene o establece un valor que indica el comportamiento del botón cerrar dentro de las pestañas. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
CloseButtonOverlayModeProperty	Identifica la propiedad de dependencia CloseButtonOverlayMode . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsAddTabButtonVisible	Obtiene o establece si el botón de pestaña Agregar (+) está visible. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsAddTabButtonVisibleProperty	Identifica la propiedad de dependencia IsAddTabButtonVisible . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SelectedIndex	Obtiene o establece el índice del elemento seleccionado. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SelectedIndexProperty	Identifica la propiedad de dependencia SelectedIndex . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SelectedItem	Obtiene o establece el elemento seleccionado. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SelectedItemProperty	Identifica la propiedad de dependencia SelectedItem . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabItems	Obtiene la colección usada para generar las pestañas dentro del control . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabItemsProperty	Identifica la propiedad de dependencia TabItems . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabItemsSource	Obtiene o establece un origen de objeto utilizado para generar las pestañas dentro de TabView. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabItemsSourceProperty	Identifica la propiedad de dependencia TabItemsSource . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabItemTemplate	Obtiene o establece la clase DataTemplate usada para mostrar cada elemento. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabItemTemplateProperty	Identifica la propiedad de dependencia TabItemTemplate . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabItemTemplateSelector	Obtiene o establece un objeto de selección que cambia la clase DataTemplate que se va a aplicar al contenido, en función del procesamiento de información sobre el elemento de contenido o su contenedor en tiempo de ejecución. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabItemTemplateSelectorProperty	Identifica la propiedad de dependencia TabItemTemplateSelector . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabStripFooter	Obtiene o establece el contenido que se muestra a la derecha de la franja de pestañas. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabStripFooterProperty	Identifica la propiedad de dependencia TabStripFooter . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabStripFooterTemplate	Obtiene o establece la clase DataTemplate utilizada para mostrar el contenido de TabStripFooter. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabStripFooterTemplateProperty	Identifica la propiedad de dependencia TabStripFooterTemplate . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabStripHeader	Obtiene o establece el contenido que se muestra a la izquierda de la franja de pestañas. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabStripHeaderProperty	Identifica la propiedad de dependencia TabStripHeader . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabStripHeaderTemplate	Obtiene o establece la clase DataTemplate utilizada para mostrar el contenido de TabStripHeader. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabStripHeaderTemplateProperty	Identifica la propiedad de dependencia TabStripHeaderTemplate . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabWidthMode	Obtiene o establece el tamaño de las pestañas. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabWidthModeProperty	Identifica la propiedad de dependencia TabWidthMode. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Métodos

ContainerFromIndex(Int32)	Devuelve el contenedor del elemento en el índice especificado dentro de la colección. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
ContainerFromItem(Object)	Devuelve el contenedor correspondiente al elemento especificado. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Eventos

AddTabButtonClick	Se produce cuando se ha hecho clic en el botón de pestaña Agregar (+). Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SelectionChanged	Se produce cuando cambia la pestaña seleccionada actualmente. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabCloseRequested	Se genera cuando el usuario intenta cerrar una pestaña haciendo clic en el botón x-to-close, CTRL+F4 o mousewheel. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabDragCompleted	Se genera cuando el usuario completa la acción de arrastrar. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabDragStarting	Se produce cuando se inicia una operación de arrastre. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabDroppedOutside	Se produce cuando el usuario completa una operación de arrastrar y colocar colocando una pestaña fuera del área TabStrip. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabItemsChanged	Se genera cuando la colección de elementos ha cambiado. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabStripDragOver	Se produce cuando el sistema de entrada informa de un evento de arrastre subyacente con TabStrip como destino de colocación potencial. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TabStripDrop	Se produce cuando el sistema de entrada notifica un evento drop subyacente con TabStrip como destino de colocación. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Consulte también

• TabViewItem
• TabViewCloseButtonOverlayMode
• Directrices para TabView