TabView Classe

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Il controllo TabView consente di visualizzare un set di schede e il rispettivo contenuto. I controlli Struttura a schede sono utili per visualizzare più pagine (o documenti) di contenuto, offrendo all'utente la possibilità di ridisporre, aprire o chiudere nuove schede.

È il controllo giusto?

Usa un controllo TabView per aiutare l'utente a gestire più pagine o documenti dell'app nella stessa finestra.

Non utilizzare un controllo TabView per visualizzare un set statico di schede che l'utente non può ridisporre, aprire o chiudere. Usare invece navigationView (NavigationViewPaneDisplayMode in alto).

Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di 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

Ereditarietà

Control

TabView

Attributi

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Esempio

Suggerimento

Per altre info, linee guida per la progettazione ed esempi di codice, vedi Visualizzazione tabulazioni.

Aprire l'app Raccolta WinUI 2 e vedere TabView in azione.

L'app Raccolta WinUI 2 include esempi interattivi della maggior parte dei controlli, delle funzionalità e delle funzionalità winUI 2. Ottenere l'app da Microsoft Store o ottenere il codice sorgente in GitHub.

Esempio TabView di base, simile a un Web browser

<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);
}

Commenti

Stile di controllo e modello

È possibile modificare lo stile predefinito e controlTemplate per assegnare al controllo un aspetto univoco. Per informazioni sulla modifica dello stile e del modello di un controllo, vedi Stili XAML. Lo stile predefinito, il modello e le risorse che definiscono l'aspetto del controllo sono inclusi nel generic.xaml file. Ai fini della progettazione, generic.xaml viene installato con il pacchetto NuGet WinUI (Microsoft.UI.Xaml). Per impostazione predefinita, il percorso è \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Gli stili e le risorse di versioni diverse di WinUI potrebbero avere valori diversi.

XAML include anche risorse che è possibile usare per modificare i colori di un controllo in stati di visualizzazione diversi senza modificare il modello di controllo. La modifica di queste risorse è preferibile per impostare proprietà come Background e Foreground. Per altre info, vedi la sezione Stili leggeri dell'articolo Stili XAML .

Costruttori

TabView()

Inizializza una nuova istanza della classe TabView . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Proprietà

AddTabButtonCommand	Ottiene o imposta il comando da richiamare quando viene toccato il pulsante add (+). Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
AddTabButtonCommandParameter	Ottiene o imposta il parametro da passare alla proprietà AddTabButtonCommand. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
AddTabButtonCommandParameterProperty	Identifica la proprietà di dipendenza AddTabButtonCommandParameter . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
AddTabButtonCommandProperty	Identifica la proprietà di dipendenza AddButtonCommand. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
AllowDropTabs	Ottiene o imposta un valore che determina se TabView può essere una destinazione di rilascio ai fini delle operazioni di trascinamento e rilascio. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
AllowDropTabsProperty	Identifica la proprietà di dipendenza AllowDropTabs . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
CanDragTabs	Ottiene o imposta un valore che indica se le schede possono essere trascinate come payload dati. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
CanDragTabsProperty	Identifica la proprietà di dipendenza CanDragTabs . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
CanReorderTabs	Ottiene o imposta un valore che indica se le schede contenute in TabStrip possono essere riordinate tramite l'interazione dell'utente. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
CanReorderTabsProperty	Identifica la proprietà di dipendenza CanReorderTabs . Identifica la proprietà di dipendenza CanReorderTabs. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
CloseButtonOverlayMode	Ottiene o imposta un valore che indica il comportamento del pulsante di chiusura all'interno delle schede. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
CloseButtonOverlayModeProperty	Identifica la proprietà di dipendenza CloseButtonOverlayMode . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
IsAddTabButtonVisible	Ottiene o imposta se il pulsante aggiungi (+) è visibile. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
IsAddTabButtonVisibleProperty	Identifica la proprietà di dipendenza IsAddTabButtonVisible . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
SelectedIndex	Ottiene o imposta l'indice dell'elemento selezionato. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
SelectedIndexProperty	Identifica la proprietà di dipendenza SelectedIndex . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
SelectedItem	Ottiene o imposta l'elemento selezionato. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
SelectedItemProperty	Identifica la proprietà di dipendenza SelectedItem . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabItems	Ottiene la raccolta usata per generare le schede all'interno del controllo. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabItemsProperty	Identifica la proprietà di dipendenza TabItems . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabItemsSource	Ottiene o imposta un'origine oggetto usata per generare le schede all'interno di TabView. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabItemsSourceProperty	Identifica la proprietà di dipendenza TabItemsSource . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabItemTemplate	Ottiene o imposta l'oggetto DataTemplate usato per visualizzare ogni elemento. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabItemTemplateProperty	Identifica la proprietà di dipendenza TabItemTemplate . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabItemTemplateSelector	Ottiene o imposta un oggetto di selezione che modifica DataTemplate da applicare per il contenuto, in base all'elaborazione delle informazioni sull'elemento del contenuto o sul relativo contenitore in fase di esecuzione. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabItemTemplateSelectorProperty	Identifica la proprietà di dipendenza TabItemTemplateSelector . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabStripFooter	Ottiene o imposta il contenuto visualizzato a destra della barra delle schede. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabStripFooterProperty	Identifica la proprietà di dipendenza TabStripFooter . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabStripFooterTemplate	Ottiene o imposta l'oggetto DataTemplate utilizzato per visualizzare il contenuto di TabStripFooter. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
TabStripFooterTemplateProperty	Identifica la proprietà di dipendenza TabStripFooterTemplate . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
TabStripHeader	Ottiene o imposta il contenuto visualizzato a sinistra della barra delle schede. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
TabStripHeaderProperty	Identifica la proprietà di dipendenza TabStripHeader . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
TabStripHeaderTemplate	Ottiene o imposta l'oggetto DataTemplate utilizzato per visualizzare il contenuto di TabStripHeader. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
TabStripHeaderTemplateProperty	Identifica la proprietà di dipendenza TabStripHeaderTemplate . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
TabWidthMode	Ottiene o imposta la modalità di ridimensionare le schede. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
TabWidthModeProperty	Identifica la proprietà di dipendenza TabWidthMode. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

Metodi

ContainerFromIndex(Int32)	Restituisce il contenitore per l'elemento in corrispondenza dell'indice specificato all'interno della raccolta. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
ContainerFromItem(Object)	Restituisce il contenitore corrispondente all'elemento specificato. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Eventi

AddTabButtonClick	Si verifica quando è stato fatto clic sul pulsante aggiungi (+). Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
SelectionChanged	Si verifica quando cambia la scheda attualmente selezionata. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabCloseRequested	Generato quando l'utente tenta di chiudere una scheda facendo clic sul pulsante x-to-close, CTRL+F4 o mousewheel. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabDragCompleted	Generato quando l'utente completa l'azione di trascinamento. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabDragStarting	Si verifica quando viene avviata un'operazione di trascinamento. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabDroppedOutside	Si verifica quando l'utente completa un'operazione di trascinamento e rilascio eliminando una scheda all'esterno dell'area TabStrip. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabItemsChanged	Generato quando la raccolta di elementi è stata modificata. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabStripDragOver	Si verifica quando il sistema di input segnala un evento di trascinamento sottostante con TabStrip come destinazione potenziale di rilascio. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
TabStripDrop	Si verifica quando il sistema di input segnala un evento di eliminazione sottostante con TabStrip come destinazione di rilascio. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Vedi anche

• TabViewItem
• TabViewCloseButtonOverlayMode
• Linee guida per TabView