TabView Kelas

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Kontrol TabView adalah cara untuk menampilkan sekumpulan tab dan kontennya masing-masing. Kontrol tab berguna untuk menampilkan beberapa halaman (atau dokumen) konten sambil memberi pengguna kemampuan untuk menyusun ulang, membuka, atau menutup tab baru.

Apakah ini kontrol yang tepat?

Gunakan TabView untuk membantu pengguna mengelola beberapa halaman aplikasi atau dokumen dalam jendela yang sama.

Jangan gunakan TabView untuk menampilkan sekumpulan tab statis yang tidak dapat diatur ulang, dibuka, atau ditutup pengguna. Gunakan NavigationView (NavigationViewPaneDisplayMode dari Atas) sebagai gantinya.

Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi 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

Warisan

Control

TabView

Atribut

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Contoh

Tip

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat Tampilan tab.

Buka aplikasi Galeri WinUI 2 dan lihat TabView beraksi.

Aplikasi WinUI 2 Gallery mencakup contoh interaktif sebagian besar kontrol, fitur, dan fungsi WinUI 2. Dapatkan aplikasi dari Microsoft Store atau dapatkan kode sumber di GitHub.

Sampel TabView Dasar, mirip dengan Browser 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);
}

Keterangan

Gaya kontrol dan templat

Anda dapat mengubah Gaya dan ControlTemplate default untuk memberi kontrol tampilan yang unik. Untuk informasi tentang memodifikasi gaya dan templat kontrol, lihat gaya XAML. Gaya, templat, dan sumber daya default yang menentukan tampilan kontrol disertakan dalam generic.xaml file. Untuk tujuan desain, generic.xaml diinstal dengan paket NuGet WinUI (Microsoft.UI.Xaml). Secara default, lokasi ini adalah \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Gaya dan sumber daya dari versi WinUI yang berbeda mungkin memiliki nilai yang berbeda.

XAML juga menyertakan sumber daya yang dapat Anda gunakan untuk memodifikasi warna kontrol dalam status visual yang berbeda tanpa memodifikasi templat kontrol. Memodifikasi sumber daya ini lebih disukai untuk mengatur properti seperti Latar Belakang dan Latar Depan. Untuk informasi selengkapnya, lihat bagian Gaya ringan dari artikel gaya XAML .

Konstruktor

TabView()

Menginisialisasi instans baru kelas TabView . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Properti

AddTabButtonCommand	Mendapatkan atau mengatur perintah yang akan dipanggil saat tombol tambahkan (+) diketuk. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
AddTabButtonCommandParameter	Mendapatkan atau mengatur parameter untuk diteruskan ke properti AddTabButtonCommand. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
AddTabButtonCommandParameterProperty	Mengidentifikasi properti dependensi AddTabButtonCommandParameter . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
AddTabButtonCommandProperty	Mengidentifikasi properti dependensi AddButtonCommand. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
AllowDropTabs	Mendapatkan atau menetapkan nilai yang menentukan apakah TabView dapat menjadi target penurunan untuk tujuan operasi seret dan letakkan. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
AllowDropTabsProperty	Mengidentifikasi properti dependensi AllowDropTabs . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
CanDragTabs	Mendapatkan atau menetapkan nilai yang menunjukkan apakah tab dapat diseret sebagai payload data. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
CanDragTabsProperty	Mengidentifikasi properti dependensi CanDragTabs . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
CanReorderTabs	Mendapatkan atau menetapkan nilai yang menunjukkan apakah tab di TabStrip dapat disusun ulang melalui interaksi pengguna. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
CanReorderTabsProperty	Mengidentifikasi properti dependensi CanReorderTabs . Mengidentifikasi properti dependensi CanReorderTabs. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
CloseButtonOverlayMode	Mendapatkan atau menetapkan nilai yang menunjukkan perilaku tombol tutup dalam tab. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
CloseButtonOverlayModeProperty	Mengidentifikasi properti dependensi CloseButtonOverlayMode . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
IsAddTabButtonVisible	Mendapatkan atau mengatur apakah tombol tab tambahkan (+) terlihat. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
IsAddTabButtonVisibleProperty	Mengidentifikasi properti dependensi IsAddTabButtonVisible . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SelectedIndex	Mendapatkan atau menyetel indeks item yang dipilih. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SelectedIndexProperty	Mengidentifikasi properti dependensi SelectedIndex . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SelectedItem	Mendapatkan atau menyetel item terpilih. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SelectedItemProperty	Mengidentifikasi properti dependensi SelectedItem . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabItems	Mendapatkan koleksi yang digunakan untuk menghasilkan tab dalam kontrol. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabItemsProperty	Mengidentifikasi properti dependensi TabItems . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabItemsSource	Mendapatkan atau mengatur sumber objek yang digunakan untuk menghasilkan tab dalam TabView. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabItemsSourceProperty	Mengidentifikasi properti dependensi TabItemsSource . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabItemTemplate	Mendapatkan atau mengatur DataTemplate yang digunakan untuk menampilkan setiap item. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabItemTemplateProperty	Mengidentifikasi properti dependensi TabItemTemplate . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabItemTemplateSelector	Mendapatkan atau mengatur objek pilihan yang mengubah DataTemplate untuk diterapkan untuk konten, berdasarkan informasi pemrosesan tentang item konten atau kontainernya pada durasi. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabItemTemplateSelectorProperty	Mengidentifikasi properti dependensi TabItemTemplateSelector . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabStripFooter	Mendapatkan atau mengatur konten yang ditampilkan di sebelah kanan strip tab. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabStripFooterProperty	Mengidentifikasi properti dependensi TabStripFooter . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabStripFooterTemplate	Mendapatkan atau mengatur DataTemplate yang digunakan untuk menampilkan konten TabStripFooter. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabStripFooterTemplateProperty	Mengidentifikasi properti dependensi TabStripFooterTemplate . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabStripHeader	Mendapatkan atau mengatur konten yang ditampilkan di sebelah kiri strip tab. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabStripHeaderProperty	Mengidentifikasi properti dependensi TabStripHeader . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabStripHeaderTemplate	Mendapatkan atau mengatur DataTemplate yang digunakan untuk menampilkan konten TabStripHeader. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabStripHeaderTemplateProperty	Mengidentifikasi properti dependensi TabStripHeaderTemplate . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabWidthMode	Mendapatkan atau mengatur bagaimana tab harus berukuran. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabWidthModeProperty	Mengidentifikasi properti dependensi TabWidthMode. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Metode

ContainerFromIndex(Int32)	Mengembalikan kontainer untuk item pada indeks yang ditentukan dalam koleksi. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
ContainerFromItem(Object)	Mengembalikan kontainer yang sesuai dengan item yang ditentukan. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Acara

AddTabButtonClick	Terjadi ketika tombol tab tambahkan (+) telah diklik. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SelectionChanged	Terjadi ketika tab yang saat ini dipilih berubah. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabCloseRequested	Muncul ketika pengguna mencoba menutup Tab melalui mengklik tombol x-to-close, CTRL+F4, atau mousewheel. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabDragCompleted	Muncul saat pengguna menyelesaikan tindakan seret. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabDragStarting	Terjadi ketika operasi seret dimulai. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabDroppedOutside	Terjadi ketika pengguna menyelesaikan operasi seret dan letakkan dengan menghilangkan tab di luar area TabStrip. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabItemsChanged	Dimunculkan ketika koleksi item telah berubah. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabStripDragOver	Terjadi ketika sistem input melaporkan peristiwa seret yang mendasar dengan TabStrip sebagai target penurunan potensial. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
TabStripDrop	Terjadi ketika sistem input melaporkan peristiwa penurunan yang mendasar dengan TabStrip sebagai target penurunan. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Lihat juga

• TabViewItem
• TabViewCloseButtonOverlayMode
• Panduan untuk TabView