Window.SetTitleBar(UIElement) Método

Definição

Namespace:

Windows.UI.Xaml

Faz com que um elemento XAML interaja com o sistema como se fosse a barra de título.

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)

Parâmetros

value

UIElement

Conteúdo XAML personalizado que deve atuar como a barra de título. Para usar vários objetos, encapsule-os em um elemento de contêiner, como um derivado de Panel.

Comentários

Esse método permite especificar um elemento XAML que interage com o sistema como se fosse a barra de título da janela do aplicativo. Ao usar esse método, você normalmente define a propriedade CoreApplicationViewTitleBar.ExtendViewIntoTitleBar como true para ocultar a barra de título do sistema padrão. No entanto, mesmo quando a barra de título do sistema padrão não está oculta, isso pode ser usado para fazer com que regiões adicionais em seu aplicativo se comportem como a barra de título.

Use a propriedade CoreApplicationView.TitleBar para obter a instância do CoreApplicationViewTitleBar para a janela do aplicativo, assim.

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

// -- OR --

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

Observação

Esse método não tem efeito quando um aplicativo é executado em um dispositivo móvel, pois os aplicativos são sempre de tela inteira em dispositivos móveis e não têm uma barra de título de janela.

Entrada

Quando você chama esse método para definir um UIElement XAML como a barra de título, ele permite que o Windows manipule a entrada para a barra de título UIElement da mesma forma que manipula a entrada para a barra de título do sistema padrão. Por exemplo, um usuário pode mover a janela arrastando o XAML UIElement ou invocar o menu de contexto da janela clicando nele com o botão direito do mouse.

Isso significa que seu aplicativo não recebe mais entrada de ponteiro quando o usuário interage com o UIElement de destino ou seus filhos usando toque, mouse ou caneta. No entanto, você ainda deve manipular (ou impedir) a entrada do teclado e determinar se o conteúdo na barra de título pode receber o foco guiando-o com o teclado.

Layout e aparência

Você deve atualizar o conteúdo visual e o layout do UIElement de destino em resposta a alterações na barra de título, como visibilidade e tamanho.

Para corresponder à visibilidade da barra de título do sistema, manipule o evento CoreApplicationViewTitleBar.IsVisibleChanged e respeite a propriedade CoreApplicationViewTitleBar.IsVisible mostrando e ocultando sua barra de título personalizada conforme apropriado. Isso garante que o conteúdo da barra de título personalizada esteja corretamente oculto quando a barra de título do sistema estiver oculta; por exemplo, quando o usuário opta por exibir seu aplicativo no modo de tela inteira.

Para garantir que a barra de título corresponda ao tamanho de outros elementos da barra de título, como os botões Minimizar, Maximizar e Fechar do sistema sempre presentes, manipule o evento CoreApplicationViewTitleBar.LayoutMetricsChanged e respeite as propriedades CoreApplicationViewTitleBar.Height, SystemOverlayLeftInset e SystemOverlayRightInset .

Os botões de barra de título padrão, como Minimizar, Maximizar e Fechar, sempre são mostrados pelo sistema, portanto, talvez você também queira modificar a cor para corresponder ao conteúdo da barra de título XAML personalizada. Para fazer isso, use a propriedade Windows.UI.ViewManagement.ApplicationView.TitleBar para obter a instância de ApplicationViewTitleBar para a janela do aplicativo. Em seguida, você pode definir as várias propriedades de cor em ApplicationViewTitleBar para modificar os botões padrão.