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
  • Manipuler une Action Bar par programmation
  • Gérer les vues
  • Recherche dans l'Action Bar (Action Bar système uniquement)
  • Propriétés WLangage
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Manipuler une Action Bar par programmation
Présentation
Une Action Bar peut être manipulé par programmation. Il suffit d'utiliser directement la variable correspondant à l'Action Bar dans le code.
La variable de l'Action Bar correspond au nom de l'Action Bar.
Cette page d'aide détaille comment manipuler une Action Bar par programmation.
Manipuler une Action Bar par programmation

Gérer les vues

Le traitement "Modification de la vue affichée" permet de gérer le changement de la vue affichée.
Dans ce cas, la variable correspondant à l'Action Bar correspond au numéro de la vue sélectionnée. Il est ainsi possible de gérer la fenêtre interne associée à la vue :
SELON ACTB_ActionBar
	CAS 1
		ChangeFenêtreSource(ZAB_Plat, FI_ListePlat, "Entrées", "")
	CAS 2
		ChangeFenêtreSource(ZAB_Plat, FI_ListePlat, "Plats", "")
	CAS 3
		ChangeFenêtreSource(ZAB_Plat, FI_ListePlat, "Desserts", "")
FIN

Recherche dans l'Action Bar (Action Bar système uniquement)

Pour permettre une recherche dans l'Action Bar :
  1. Cochez l'option "Autoriser la recherche dans l'Action Bar". Un nouvel événement est automatiquement associé au champ Action Bar : "Validation de la recherche". Cet événement permet d'effectuer la recherche.
  2. Si l'option "Avec historique de recherche" est cochée, l'historique des dernières recherches effectuées sera proposé à l'utilisateur.
    iPhone/iPad Remarque : L'option "Avec bouton pour vider l'historique" permet de gérer automatiquement la mise à blanc de l'historique.
Pour mettre en place la recherche, effectuez par exemple les manipulations suivantes :
  1. Créez un bouton de recherche dans l'Action Bar (par exemple un bouton "Loupe").
  2. Dans le code de cette option, utilisez la fonction ActionBarRechercheVisible pour afficher le champ de saisie de la recherche. Par exemple :
    ActionBarRechercheVisible(Vrai, "Client à rechercher")
  3. Affichez les événements WLangage associés au champ Action Bar. Dans l'événement "Validation de la recherche", saisissez le code permettant d'effectuer la recherche et d'afficher le résultat. Dans ce code, il est possible de connaître la valeur saisie par l'utilisateur grâce à la propriété ValeurRecherche.
    Par exemple :
    // Recherche d'un produit. 
    // Le résultat est affiché dans un champ Zone répétée. 
    // La valeur recherchée correspond à un paramètre de la requête de base du champ Zone répétée. 
    REQ_Produits.ParamNom = ACTB_ActionBar.ValeurRecherche
    ZoneRépétéeAffiche(ZR_REQ_Produits, taRéExécuteRequete)
Remarques :
  • Si l'historique des recherches est activé :
    • lorsque le champ de saisie est vide, les 10 dernières recherches sont proposées.
    • lorsque la saisie a débuté, 10 propositions sont affichées en fonction de ce qui a été saisi.
  • Il est possible de vider l'historique avec la fonction ActionBarSupprimeHistoriqueRecherche.
  • iPhone/iPad Si l'option "Avec bouton pour vider l'historique" est sélectionnée, l'historique propose un choix pour effacer l'historique à la fin de la liste des propositions.
  • Deux événements WLangage sont automatiquement ajoutés lors de l'activation de la recherche dans l'Action Bar :
    • Validation de la recherche.
    • Modification de la recherche.
  • Annulation de la recherche : Pour savoir si l'utilisateur a annulé la recherche, testez la valeur de la propriété ValeurRecherche dans l'événement "Validation de la recherche". Cette valeur vaut "" (chaîne vide) en cas d'annulation.

Propriétés WLangage

Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec une Action Bar, consultez Propriétés associées aux Action Bar.
iPhone/iPad Les propriétés d'un champ Action Bar ne sont pas modifiables par programmation.
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 18/09/2024

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