Window.SetTitleBar(UIElement) Metode

Definisi

Ruang nama:

Windows.UI.Xaml

Membuat elemen XAML berinteraksi dengan sistem seolah-olah itu adalah bilah judul.

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)

Parameter

value

UIElement

Konten XAML kustom yang harus bertindak sebagai bilah judul. Untuk menggunakan beberapa objek, bungkus dalam elemen kontainer seperti satu yang berasal dari Panel.

Keterangan

Metode ini memungkinkan Anda menentukan elemen XAML yang berinteraksi dengan sistem seolah-olah itu adalah bilah judul jendela aplikasi. Saat Anda menggunakan metode ini, Anda biasanya mengatur properti CoreApplicationViewTitleBar.ExtendViewIntoTitleBar ke true untuk menyembunyikan bilah judul sistem default. Namun, bahkan ketika bilah judul sistem default tidak disembunyikan, ini dapat digunakan untuk membuat wilayah tambahan di aplikasi Anda bersifat seperti bilah judul.

Gunakan properti CoreApplicationView.TitleBar untuk mendapatkan instans CoreApplicationViewTitleBar untuk jendela aplikasi Anda, seperti ini.

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

// -- OR --

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

Catatan

Metode ini tidak berpengaruh ketika aplikasi dijalankan di perangkat seluler, karena aplikasi selalu layar penuh di perangkat seluler dan tidak memiliki bilah judul jendela.

Input

Ketika Anda memanggil metode ini untuk mengatur XAML UIElement sebagai bilah judul, itu memungkinkan Windows menangani input ke bilah judul UIElement dengan cara yang sama seperti menangani input ke bilah judul sistem default. Misalnya, pengguna dapat memindahkan jendela dengan menyeret UIElement XAML, atau memanggil menu konteks jendela dengan mengklik kanannya.

Ini berarti bahwa aplikasi Anda tidak lagi menerima input pointer saat pengguna berinteraksi dengan UIElement target atau anak-anaknya menggunakan sentuhan, mouse, atau pena. Namun, Anda masih harus menangani (atau mencegah) input keyboard, dan menentukan apakah konten di bilah judul dapat menerima fokus dengan bertab dengan keyboard.

Tata letak dan tampilan

Anda harus memperbarui konten visual dan tata letak UIElement target sebagai respons terhadap perubahan bilah judul, seperti visibilitas dan ukuran.

Untuk mencocokkan visibilitas bilah judul sistem, tangani peristiwa CoreApplicationViewTitleBar.IsVisibleChanged dan hormati properti CoreApplicationViewTitleBar.IsVisible dengan menampilkan dan menyembunyikan bilah judul kustom Anda sebagaimana mestinya. Ini memastikan bahwa konten bilah judul kustom Anda disembunyikan dengan benar saat bilah judul sistem disembunyikan; misalnya, saat pengguna memilih untuk menampilkan aplikasi Anda dalam mode layar penuh.

Untuk memastikan bahwa bilah judul Anda cocok dengan ukuran elemen bilah judul lainnya seperti tombol Minimalkan, Maksimalkan, dan Tutup sistem selalu ada, tangani peristiwa CoreApplicationViewTitleBar.LayoutMetricsChanged dan hormati properti CoreApplicationViewTitleBar.Height, SystemOverlayLeftInset, dan SystemOverlayRightInset .

Tombol bilah judul default, seperti Minimalkan, Maksimalkan, dan Tutup, selalu ditampilkan oleh sistem, sehingga Anda mungkin juga ingin memodifikasi warnanya agar sesuai dengan konten bilah judul XAML kustom Anda. Untuk melakukan ini, gunakan properti Windows.UI.ViewManagement.ApplicationView.TitleBar untuk mendapatkan instans ApplicationViewTitleBar untuk jendela aplikasi Anda. Anda kemudian dapat mengatur berbagai properti warna di ApplicationViewTitleBar untuk mengubah tombol default.