Window.SetTitleBar(UIElement) Méthode

Définition

Espace de noms:

Windows.UI.Xaml

Fait qu’un élément XAML interagit avec le système comme s’il s’agit de la barre de titre.

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)

Paramètres

value

UIElement

Contenu XAML personnalisé qui doit faire office de barre de titre. Pour utiliser plusieurs objets, encapsulez-les dans un élément conteneur tel qu’un élément dérivé de Panel.

Remarques

Cette méthode vous permet de spécifier un élément XAML qui interagit avec le système comme s’il s’agit de la barre de titre de la fenêtre d’application. Lorsque vous utilisez cette méthode, vous définissez généralement la propriété CoreApplicationViewTitleBar.ExtendViewIntoTitleBar sur true afin de masquer la barre de titre système par défaut. Toutefois, même lorsque la barre de titre système par défaut n’est pas masquée, cela peut être utilisé pour que d’autres régions de votre application se comportent comme la barre de titre.

Utilisez la propriété CoreApplicationView.TitleBar pour obtenir les instance de CoreApplicationViewTitleBar pour votre fenêtre d’application, comme ceci.

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

// -- OR --

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

Notes

Cette méthode n’a aucun effet lorsqu’une application est exécutée sur un appareil mobile, car les applications sont toujours en plein écran sur les appareils mobiles et n’ont pas de barre de titre de fenêtre.

Entrée

Lorsque vous appelez cette méthode pour définir un UIElement XAML comme barre de titre, elle permet à Windows de gérer l’entrée dans la barre de titre UIElement de la même façon qu’il gère l’entrée dans la barre de titre système par défaut. Par exemple, un utilisateur peut déplacer la fenêtre en faisant glisser l’élément UIElement XAML ou appeler le menu contextuel de la fenêtre en cliquant dessus avec le bouton droit.

Cela signifie que votre application ne reçoit plus d’entrée de pointeur lorsque l’utilisateur interagit avec l’élément UIElement cible ou ses enfants à l’aide de la touche tactile, de la souris ou du stylet. Toutefois, vous devez toujours gérer (ou empêcher) l’entrée au clavier et déterminer si le contenu de la barre de titre peut recevoir le focus en la tablant sur celle-ci avec le clavier.

Disposition et apparence

Vous devez mettre à jour le contenu visuel et la disposition de l’élément UIElement cible en réponse aux modifications apportées à la barre de titre, telles que la visibilité et la taille.

Pour correspondre à la visibilité de la barre de titre système, gérez l’événement CoreApplicationViewTitleBar.IsVisibleChanged et respectez la propriété CoreApplicationViewTitleBar.IsVisible en affichant et en masquant votre barre de titre personnalisée le cas échéant. Cela garantit que le contenu de votre barre de titre personnalisée est correctement masqué lorsque la barre de titre système est masquée ; par exemple, lorsque l’utilisateur choisit d’afficher votre application en mode plein écran.

Pour vous assurer que votre barre de titre correspond à la taille d’autres éléments de barre de titre, tels que les boutons système toujours présents Réduire, Agrandir et Fermer, gérez l’événement CoreApplicationViewTitleBar.LayoutMetricsChanged et respectez les propriétés CoreApplicationViewTitleBar.Height, SystemOverlayLeftInset et SystemOverlayRightInset .

Les boutons de barre de titre par défaut, tels que Réduire, Agrandir et Fermer, sont toujours affichés par le système. Vous pouvez donc également modifier leur couleur pour qu’elle corresponde au contenu de votre barre de titre XAML personnalisée. Pour ce faire, utilisez la propriété Windows.UI.ViewManagement.ApplicationView.TitleBar pour obtenir les instance d’ApplicationViewTitleBar pour votre fenêtre d’application. Vous pouvez ensuite définir les différentes propriétés de couleur sur ApplicationViewTitleBar pour modifier les boutons par défaut.