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
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
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
AndroidiPhone/iPad

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
AndroidiPhone/iPad

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.
Liste des exemples associés :
WM Gestion Contacts Exemples multiplateforme (WINDEV Mobile) : WM Gestion Contacts
[ + ] Cet exemple illustre la gestion de contacts pour Android et iOS.
Il permet de :
- lister les contacts du téléphone
- appeler les contacts
- envoyer des sms aux contacts
- ...
WM Shopping Exemples multiplateforme (WINDEV Mobile) : WM Shopping
[ + ] WM Shopping vous permet de gérer plusieurs listes de courses.
Pour ajouter un produit :
- Scannez directement le code-barre pour l'ajouter
- ou... recherchez un produit ajouté auparavant et ajoutez-le !
- ou encore... ajoutez un produit depuis votre historique d'achat !
Vous pourrez ensuite éditer la quantité, l'image... et ajouter des notes pour vous en rappeler pendant les courses !

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 : 25/05/2022

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