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 Bandeau défilant
  • Présentation
  • Défilement et parcours des plans
  • Défilement automatique des plans dans un champ Bandeau défilant
  • Défilement via les boutons gauche, droit et des puces
  • Personnalisation du passage d'un plan à un autre
  • Manipulation des plans d'un champ Bandeau défilant
  • Rendre un plan invisible
  • Récupérer le plan en cours
  • Propriétés disponibles sur un champ Bandeau défilant
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
Un champ Bandeau défilant peut être manipulé par programmation. Il suffit d'utiliser directement la variable du champ Bandeau défilant dans le code.
La variable du champ Bandeau défilant correspond au numéro du plan actif. Cette variable est de type entier.
Pour manipuler un champ Bandeau défilant par programmation, WEBDEV propose les Fonctions de gestion du champ Bandeau défilant.
Cette page d'aide détaille comment manipuler un champ Bandeau défilant par programmation.
Défilement et parcours des plans

Défilement automatique des plans dans un champ Bandeau défilant

Pour utiliser le défilement automatique d'un champ Bandeau défilant, il est possible :
  • soit de cocher l'option "Démarrer automatiquement le défilement" dans l'onglet "Détail" de la fenêtre de description du champ.
  • soit d'utiliser la fonction WLangage BandeauLanceDéfilement.
Dans ce cas, les différents plans visibles du champ Bandeau défilant seront automatiquement affichés dans le champ :
  • selon l'ordre définit dans l'onglet "Général" du champ Bandeau défilant.
  • avec la durée d'affichage définie dans l'onglet "Général" du champ Bandeau défilant.
Pour arrêter le défilement automatique, utilisez la fonction BandeauArrêteDéfilement.

Défilement via les boutons gauche, droit et des puces

Si vous utilisez les boutons gauche, droit et les puces proposés dans le champ Bandeau défilant, aucune programmation spécifique n'est nécessaire. La gestion du passage d'un plan à un autre est automatiquement gérée.
Remarques :
  • L'ordre des plans est celui défini dans la fenêtre de description du champ Bandeau défilant.
  • Les plans invisibles ne sont pas pris en compte.

Personnalisation du passage d'un plan à un autre

Si vous utilisez des champs spécifiques pour passer d'un plan à un autre (par exemple des boutons spécifiques, placés hors du champ), vous pouvez gérer le passage d'un plan à un autre :
  • soit en utilisant les fonctions WLangage suivantes :
    BandeauDernierAffiche le dernier plan d'un champ Bandeau défilant.
    BandeauPrécédentAffiche le plan précédent d'un champ Bandeau défilant.
    BandeauPremierAffiche le premier plan d'un champ Bandeau défilant.
    BandeauSuivantAffiche le plan suivant d'un champ Bandeau défilant.
    Remarque : Les plans invisibles ne sont pas pris en compte.
  • soit en utilisant la propriété Valeur pour afficher le plan voulu.
    Par exemple :
    // Affiche le plan 3 dans le champ Bandeau défilant
    BAN_Bannière.Valeur = 3
  • soit en affectant le champ Bandeau défilant avec la valeur du plan voulu.
    Par exemple :
    NomChampBandeauDéfilant = NuméroDuPlan
Remarque : Le numéro des plans et leur ordre est défini dans la fenêtre de description du champ Bandeau défilant.
Manipulation des plans d'un champ Bandeau défilant

Rendre un plan invisible

Il est possible d'utiliser la propriété Visible pour rendre un plan visible et inversement. La visibilité des plans est prise en compte lors du parcours des différents plans utilisés par le champ Bandeau défilant (parcours automatique ou programmé).
Par exemple le code suivant permet de rendre invisible le plan 5 du champ BAN_Annonce au mois d'Août :
DateJour est une Date
SI DateJour.Mois = 8 ALORS
BAN_Annonce[5].Visible = Faux
FIN
Astuce : Il est possible de préparer un plan (par exemple concernant une promotion) et de ne le rendre visible qu'à une date donnée, pour une période donnée.

Récupérer le plan en cours

Pour récupérer le numéro du plan en cours :
  • réalisez une simple affectation. Par exemple :
    NumPlanActif = NomChampBandeauDéfilant
  • utilisez la propriété Valeur.
Propriétés disponibles sur un champ Bandeau défilant
Des propriétés WLangage sont disponibles pour manipuler :
  • le champ Bandeau défilant.
  • les plans associés au champ Bandeau défilant.
Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ de type Bandeau défilant, consultez Propriétés associées au champ Bandeau défilant.
Version minimum requise
  • Version 22
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