Condividi tramite


TabView Classe

Definizione

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).

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class TabView : Control
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
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(Microsoft.UI.Xaml.XamlContract, 65536)]
class TabView : Control
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class TabView : Control
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
public 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à
TabView
Attributi

Esempio

Suggerimento

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

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).

Si applica a

Vedi anche