DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Action Bar
  • Présentation
  • Description des différents éléments de l'Action Bar (onglet "Général")
  • Bouton Gauche de l'Action Bar
  • Bouton gauche
  • Options de menu affichées dans l'Action Bar (Action Bar système uniquement)
  • Sous Universal Windows 10 App
  • Vues/Barre de navigation
  • Aspect de l'Action Bar (onglet "Détail")
  • Présentation
  • Aspect de l'Action Bar
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
Une Action Bar peut correspondre à :
  • Une Action Bar système : L'Action Bar dépend du système utilisé. Elle peut être différente selon la plateforme utilisée.
  • Une Action Bar personnalisée, afin d'avoir un fonctionnement identique quelle que soit la plateforme. Dans ce cas, il est possible de :
    • Modifier la hauteur de l'Action Bar,
    • Ajouter des champs dans l'Action Bar.
Cette page d'aide présente les points importants de la fenêtre de description du champ Action Bar :
Description des différents éléments de l'Action Bar (onglet "Général")
L'onglet "Général" permet de définir les différents éléments de l'Action Bar selon la plateforme utilisée. Sur iOS et Android, les éléments sont les mêmes, mais ils ne sont pas disposés de la même façon.
Différents éléments de l'Action Bar
Les deux interfaces sont présentées en aperçu : à gauche l'interface iOS, à droite l'interface Android.
Si votre projet est disponible sur une seule plateforme, seule l'interface correspondante sera active.
Pour définir les différents éléments de l'Action Bar, il suffit de cliquer sur les différents numéros.
Bouton Gauche de l'Action Bar

Bouton gauche

L'Action Bar remplace la barre de titre de la fenêtre :
  • Universal Windows 10 App sous Universal Windows 10 App : Par défaut, l'Action Bar affiche uniquement le titre de la fenêtre courante.
Le titre pourra ne pas être affiché en fonction des éléments affichés dans l'Action Bar.
L'option "1" de l'onglet "Général" de la fenêtre de description du champ Action Bar permet de configurer les différents éléments :
  • Bouton visible ou non,
  • Universal Windows 10 App Icône affichée.
L'utilisateur peut cliquer sur le bouton gauche affiché dans l'Action Bar d'une fenêtre. L'événement "Clic sur le bouton de gauche" de l'Action Bar est associé à cette action.
La fenêtre de description de l'Action Bar permet de paramétrer l'action du clic sur le bouton gauche. Il est possible de sélectionner une des options suivantes :
Fenêtre de description
  • Code : Exécuter le traitement de clic du champ : L'événement "Clic sur le bouton de gauche" sera alors automatiquement exécuté.
  • Universal Windows 10 App Home : Revenir à la première fenêtre de l'application : Dans ce cas, l'application :
    • Exécutera l'événement "Clic sur le bouton de gauche".
    • Exécutera le traitement prédéfini : toutes les fenêtres encore ouvertes sont fermées à l'exception de la fenêtre principale (qui est ré-ouverte si nécessaire). Ce traitement prédéfini ne sera pas exécuté si l'événement "Clic sur le bouton de gauche" retourne Faux (cela permet par exemple de demander une confirmation à l'utilisateur).
      Remarques :
      • Si la fenêtre principale est déjà affichée ou si l'application n'a pas de fenêtre principale, aucune action par défaut ne sera exécutée. Seul l'événement "Clic sur le bouton de gauche" sera exécuté.
      • Le code de fermeture des fenêtres fermées ne sera pas exécuté.
  • Fenêtre coulissante gauche : Ouvre la fenêtre coulissante gauche : Dans ce cas, l'application :
    • Exécutera l'événement "Clic sur le bouton de gauche".
    • Exécutera le traitement prédéfini : la fenêtre coulissante gauche définie dans la fenêtre de description sera affichée avec l'effet indiqué.
      Pour plus de détails, consultez Fenêtre coulissante (Sliding menu).
Options de menu affichées dans l'Action Bar (Action Bar système uniquement)
Universal Windows 10 App

Sous Universal Windows 10 App

Dans une fenêtre n'utilisant pas d'Action Bar, le menu principal de l'application est affiché en bas de la fenêtre.
Dans une fenêtre avec Action Bar, les options du menu peuvent être :
  • présentes en haut à droite de l'Action Bar.
  • présentes en bas de la fenêtre.
La position des options dépend du matériel sur lequel l'application est exécutée.
Si l'application est exécutée sur PC, toutes les options sont affichées dans l'Action Bar en haut de l'écran. Si les options sont associées à des images, seule l'image est affichée dans l'Action Bar. Dès qu'il n'y a plus de place dans l'Action Bar pour afficher une option supplémentaire ou dès qu'une option n'est pas associée à une image, un menu déroulant est affiché. Ce menu déroulant peut être ouvert via un bouton "...".
Si l'application est exécutée sur Mobile, toutes les options sont affichées dans l'Action Bar en haut de l'écran ou dans une barre de menu en bas de l'écran (selon la position choisie dans l'interface). Les règles d'affichage dans l'Action Bar et dans la barre de menu sont identiques :
  • Si les options sont associées à des images, seule l'image est affichée dans l'Action Bar/la barre de menu.
  • Dès qu'il n'y a plus de place dans l'Action Bar/la barre de menu pour afficher une option supplémentaire ou dès qu'une option n'est pas associée à une image, un menu déroulant est affiché. Ce menu déroulant peut être ouvert via un bouton "...".
Pour gérer les options de menu présentes dans l'Action Bar :
  • Cas 1 : Vous transformez une fenêtre possédant un menu en une fenêtre avec une Action Bar : le menu de la fenêtre est automatiquement affiché dans l'Action Bar, en bas de la fenêtre.
  • Cas 2 : Vous créez une fenêtre avec Action Bar et vous voulez créer le menu :
    1. Dans l'onglet "Général" de la fenêtre de description de l'Action Bar, cliquez sur "2" ou "3" (options de la barre d'outils).
    2. Deux listes apparaissent.
      • La liste "En haut à droite" permet de définir les options affichées directement dans l'Action Bar.
      • La liste "En bas/dans le menu" permet de définir les options de menu apparaissant dans le menu en bas de la fenêtre.
        Rappel : Si l'application est exécutée sur PC, ces options sont affichées à la suite de celles de la liste "En haut à droite" dans l'Action Bar.
    3. Cliquez sur "+" pour ajouter une nouvelle option : l'option ajoutée peut être modifiée dans la partie basse de l'écran.
      Si l'option de menu est associée à une image, seule l'image sera affichée dans l'Action Bar.
Remarque : Pour éditer les options sous l'éditeur, cliquez sur l'option : un menu déroulant apparaît avec les différents options correspondantes. Le menu contextuel permet de paramétrer les options (notamment d'éditer le code).
Vues/Barre de navigation
Aspect de l'Action Bar (onglet "Détail")

Présentation

L'onglet "Détail" de la fenêtre de description de l'Action Bar permet de définir son aspect. Il est possible de choisir :
  • L'aspect de l'Action Bar/NavBar.

Aspect de l'Action Bar

L'aspect de l'Action Bar est configuré via :
  • le bouton "Éditer le style des barres", qui permet de paramétrer le style de la barre système et de l'Action Bar.
  • la hauteur de l'Action Bar (disponible uniquement pour les Action Bar personnalisées). Cette option permet d'harmoniser la hauteur de l'action Bar quelque soit le système utilisé. Cette hauteur est exprimée en pixels.
La fenêtre de paramétrage des styles propose :
  • Le paramétrage de la barre système :
    Les éléments pouvant être configurés sont :
    • la couleur de fond utilisée.
    • la couleur du texte.
    • le mode de recouvrement. L'option "Barre affichée par dessus" permet de gérer la transparence de la barre système. Lorsque cette option est cochée, la barre système devient transparente. Il est alors possible de paramétrer l'opacité de la barre système grâce à la propriété Opacité. Cette propriété peut être utilisée par exemple dans l'événement optionnel de la fenêtre "Déplacement de l'ascenseur".
      Attention : L'option "Barre affichée par dessus" modifie l'origine des champs. Sous l'éditeur, les champs situés sous la barre système sont automatiquement déplacés.
  • Le paramétrage de l'Action Bar :
    Les éléments pouvant être configurés sont :
    • la couleur de fond utilisée.
    • la couleur de la police utilisée.
      l'option "Appliquer la couleur de police aux icônes actives (Action Bar et barre de navigation)" permet d'appliquer la couleur de la police aux icônes. Dans ce cas, les icônes choisies doivent être monochromes.
    • le mode de recouvrement. L'option "Barre affichée par dessus" permet de gérer la transparence de l'Action Bar. Lorsque cette option est cochée, l'Action Bar devient transparente. Il est alors possible de paramétrer l'opacité de l'Action Bar grâce à la propriété Opacité. Cette propriété peut être utilisée par exemple dans l'événement optionnel de la fenêtre "Déplacement de l'ascenseur". Exemple :
      // Permet d'avoir 30% d'opacité maximum Ã  150px en Y
      // L'opacité va de 0 Ã  30% 
      nOpacitéMax est un entier = 30
      nOpacité est un entier 
      nOpacité = nOpacitéMax * AscenseurPosition(MaFenêtre) / CoordonnéeEditeurVersEcran(150)
      SI nOpacité > nOpacitéMax ALORS
      nOpacité = nOpacitéMax
      FIN
      ACTB_ActionBar.Opacité = nOpacité

      Attention : L'option "Barre affichée par dessus" modifie l'origine des champs. Sous l'éditeur, les champs situés sous l'Action Bar sont automatiquement déplacés.
Version minimum requise
  • Version 19
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 23/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale