Partager via

Utilisation des barres de navigation tvOS dans Xamarin

  • Article

Les barres de navigation peuvent être ajoutées en haut des affichages pour afficher un titre et des boutons de barre de navigation facultatifs. En règle générale, ils sont utilisés lorsque l’utilisateur a accédé à partir d’une page principale, comme un affichage table, une collection ou un menu vers une sous-vue affichant les détails de l’élément sélectionné.

Exemple de barre de navigation

En plus du titre (affiché dans le centre), les barres de navigation peuvent contenir un ou plusieurs boutons de barre de navigation (UIBarButtonItem) sur les côtés gauche et droit de la barre.

Important

Les barres de navigation sont totalement transparentes par défaut. Veillez à ce que le contenu de la barre de navigation reste lisible sur le contenu sous celui-ci. Par exemple, lorsque le contenu d’une vue table ou d’une collection fait défiler sous celui-ci.

Le moyen le plus simple d’utiliser les barres de navigation dans une application Xamarin.tvOS consiste à les ajouter à l’interface utilisateur de l’application à l’aide du Concepteur iOS.

  1. Dans le panneau Solution, double-cliquez sur Main.storyboard le fichier et ouvrez-le pour modification.

  2. Faites glisser une barre de navigation à partir de la boîte à outils et déposez-la en haut de l’écran :

    Barre de navigation

  3. Double-cliquez sur la barre de navigation pour sélectionner l’élément de navigation. Dans l’onglet Widget du panneau Propriétés, vous pouvez définir le titre :

    Définir le titre

  4. Ensuite, vous pouvez ajouter un ou plusieurs éléments de bouton barre à l’une des extrémités de la barre :

    Élément du bouton Barre

  5. Enfin, associez les éléments du bouton Barre aux actions sous l’onglet Événements de l’Explorateur de propriétés :

    Action d’élément de bouton barre

  6. Enregistrez vos modifications.

Important

Bien qu’il soit possible d’affecter des événements tels qu’un TouchUpInside élément d’interface utilisateur (tel qu’un UIButton) dans le Concepteur iOS, il ne sera jamais appelé, car Apple TV n’a pas d’écran tactile ou ne prend pas en charge les événements tactiles. Vous devez toujours utiliser l’événement lors de la Primary Action création de gestionnaires d’événements pour les éléments d’interface utilisateur tvOS.

Le code suivant donne un exemple de gestionnaires d’événements sur trois barButtonItems différents : ShowFirstHotel, ShowSecondHotelet ShowThirdHotel. Lorsque chaque élément est cliqué, l’image HotelImage d’arrière-plan est modifiée. Ceci est modifié dans le fichier Contrôleur de vue (exemple ViewController.cs) :

using System;
using Foundation;
using UIKit;

namespace MySingleView
{
    public partial class ViewController : UIViewController
    {
        #region Constructors
        public ViewController (IntPtr handle) : base (handle)
        {
        }
        #endregion

        #region Override Methods
        public override void ViewDidLoad ()
        {
            base.ViewDidLoad ();
            // Perform any additional setup after loading the view, typically from a nib.
        }

        public override void DidReceiveMemoryWarning ()
        {
            base.DidReceiveMemoryWarning ();
            // Release any cached data, images, etc that aren't in use.
        }
        #endregion

        #region Custom Actions
        partial void ShowFirstHotel (UIBarButtonItem sender) {
            // Change background image
            HotelImage.Image = UIImage.FromFile("Motel01.jpg");
        }

        partial void ShowSecondHotel (UIBarButtonItem sender) {
            // Change background image
            HotelImage.Image = UIImage.FromFile("Motel02.jpg");
        }

        partial void ShowThirdHotel (UIBarButtonItem sender) {
            // Change background image
            HotelImage.Image = UIImage.FromFile("Motel03.jpg");
        }
        #endregion
    }
}

Tant que la propriété d’un Enabled bouton est true et qu’elle n’est pas couverte par un autre contrôle ou vue, elle peut être effectuée à l’aide de Siri Remote.

Pour plus d’informations sur l’utilisation de Storyboards, consultez notre Guide de démarrage rapide Hello, tvOS.

Résumé

Cet article a abordé la conception et l’utilisation des barres de navigation à l’intérieur d’une application Xamarin.tvOS.