Window.SetTitleBar(UIElement) Метод

Определение

Пространство имен:

Windows.UI.Xaml

Позволяет элементу XAML взаимодействовать с системой, как если бы это строка заголовка.

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)

Параметры

value

UIElement

Пользовательское содержимое XAML, которое должно выступать в качестве строки заголовка. Чтобы использовать несколько объектов, заключите их в элемент контейнера, например в элемент , производный от Panel.

Комментарии

Этот метод позволяет указать элемент XAML, взаимодействующий с системой, как если бы это строка заголовка окна приложения. При использовании этого метода обычно присваивается свойству CoreApplicationViewTitleBar.ExtendViewIntoTitleBarзначение true , чтобы скрыть строку заголовка системы по умолчанию. Тем не менее, даже если строка заголовка системы по умолчанию не скрыта, это можно использовать для того, чтобы дополнительные регионы в приложении велись так же, как строка заголовка.

Используйте свойство CoreApplicationView.TitleBar , чтобы получить экземпляр CoreApplicationViewTitleBar для окна приложения, как показано ниже.

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

// -- OR --

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

Примечание

Этот метод не влияет на запуск приложения на мобильном устройстве, так как приложения всегда являются полноэкранными на мобильных устройствах и не имеют заголовка окна.

Входные данные

При вызове этого метода для задания XAML UIElement в качестве строки заголовка он позволяет Windows обрабатывать входные данные в строке заголовка UIElement так же, как он обрабатывает входные данные в строке заголовка системы по умолчанию. Например, пользователь может переместить окно, перетащив XAML UIElement, или вызвать контекстное меню окна, щелкнув его правой кнопкой мыши.

Это означает, что приложение больше не получает входные данные указателя, когда пользователь взаимодействует с целевым элементом UIElement или его дочерними элементами с помощью сенсорного ввода, мыши или пера. Однако необходимо по-прежнему обрабатывать (или запрещать) ввод с помощью клавиатуры, а также определять, может ли содержимое в строке заголовка получать фокус, нажимая на него вкладку с помощью клавиатуры.

Макет и внешний вид

Необходимо обновить визуальное содержимое и макет целевого элемента UIElement в ответ на изменения заголовка окна, такие как видимость и размер.

Чтобы соответствовать видимости строки заголовка системы, обработайте событие CoreApplicationViewTitleBar.IsVisibleChanged и учитывайте свойство CoreApplicationViewTitleBar.IsVisible , отображая и скрывая настраиваемую строку заголовка соответствующим образом. Это гарантирует правильное скрытие содержимого пользовательской строки заголовка при скрытии системной строки заголовка; например, когда пользователь выбирает отображение приложения в полноэкранном режиме.

Чтобы строка заголовка соответствовала размеру других элементов заголовка, таких как всегда присутствующие системные кнопки Свернуть, Развернуть и Закрыть, обработайте событие CoreApplicationViewTitleBar.LayoutMetricsChanged и учитывайте свойства CoreApplicationViewTitleBar.Height, SystemOverlayLeftInset и SystemOverlayRightInset .

Кнопки заголовка по умолчанию, такие как Свернуть, Развернуть и Закрыть, всегда отображаются системой, поэтому вы также можете изменить их цвет в соответствии с пользовательским содержимым заголовка XAML. Для этого используйте свойство Windows.UI.ViewManagement.ApplicationView.TitleBar , чтобы получить экземпляр ApplicationViewTitleBar для окна приложения. Затем можно задать различные свойства цвета в ApplicationViewTitleBar , чтобы изменить кнопки по умолчанию.