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 Onglet
  • Présentation
  • Nommer les volets d'onglet
  • Manipuler un volet d'onglet
  • Changer le volet d'onglet actif
  • Remarques
  • Connaître le volet d'onglet actif
  • Numéro du volet d'onglet
  • Libellé du volet d'onglet
  • Fonctions du WLangage permettant de manipuler les champs Onglet
  • Propriétés spécifiques aux champs Onglet
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 un champ Onglet par programmation
Présentation
WINDEV, WINDEV Mobile et WEBDEV permettent de manipuler un champ Onglet directement par programmation. Il suffit d'utiliser directement la variable du champ Onglet dans le code.
La variable du champ Onglet correspond au numéro du volet actif. Cette variable est de type entier. Ce numéro est attribué lors de la description des onglets : dans la liste des onglets, le premier a le numéro 1, le deuxième a le numéro 2, ...
Il est également possible de nommer les volets d'onglets (dans l'onglet "Général" de la fenêtre de description du champ). Dans ce cas, il est possible d'utiliser directement le nom de l'onglet pour le manipuler.
Remarque : Le passage d'un onglet à l'autre (lorsque l'utilisateur clique sur un onglet) est automatiquement géré.
Nommer les volets d'onglet
A partir de la version 26, il est possible de nommer les volets d'onglet. Ce nommage (optionnel) permet de simplifier la manipulation par programmation des onglets. En effet, lorsque les onglets ne sont pas nommés, ils sont manipulés par leur indice. Si l'indice est modifié (déplacement d'un onglet, insertion d'un onglet, ...), tout le code WLangage doit être revu pour prendre en compte le changement des indices des volets.
Le nommage des onglets permet de simplifier ces opérations : le nom du volet d'onglet est donné dans l'onglet "Général" de la fenêtre de description du champ. Il peut alors être utilisé dans le code pour désigner le volet à manipuler. Tout déplacement ou insertion d'un onglet peut être fait sans revoir entièrement le code existant concernant la gestion des onglets.
Manipuler un volet d'onglet
Pour manipuler un volet d'onglet avec les propriétés WLangage, utilisez la syntaxe suivante :
  • Volet d'onglet non nommé : le volet d'onglet est identifié par son numéro. Le numéro est attribué lors de la description des onglets : dans la liste des onglets, le premier a le numéro 1, le deuxième a le numéro 2, ...
    Nom_Champ_Onglet[Numéro_Du_Volet_d_Onglet].NomPropriété = ValeurPropriété

    Par exemple :
    ONG_MonOnglet[2].Etat = Grisé
  • Volet d'onglet nommé : Le volet d'onglet est identifié par son nom spécifié dans l'onglet "Général" de la fenêtre de description du champ.
    Nom_volet_Onglet.NomPropriété = ValeurPropriété

    Par exemple, si le volet d'onglet est nommé "Recherche" :
    Recherche.Etat = Grisé
Remarque : Pour utiliser les propriétés sur un champ, il est possible d'utiliser au choix la syntaxe <Nom du champ>.NomPropriété ou la syntaxe <Nom du champ>..NomPropriété.
Changer le volet d'onglet actif
Par défaut, le volet d'onglet 1 (celui le plus à gauche) est activé. Il est possible de changer l'onglet en cours par programmation.
Pour activer un volet d'onglet :
  • Volet d'onglet non nommé : Affectez l'onglet avec le numéro du volet de l'onglet à activer :
    Nom_Champ_Onglet = Numéro_Du_Volet_d_Onglet
  • Volet d'onglet nommé : Affectez l'onglet avec le nom du volet de l'onglet à activer :
    Nom_Champ_Onglet = Nom_Du_Volet_d_Onglet
  • Utilisez la propriété Valeur.

Remarques

  • Si le volet d'onglet indiqué n'existe pas, le volet d'onglet affiché n'est pas modifié.
  • Sur un même champ Onglet, un seul volet d'onglet peut être affiché à la fois.
  • Lors du changement de volet d'onglet :
    • le code de sortie du champ qui a le focus est exécuté.
    • le code d'entrée du premier champ en saisie dans le volet d'onglet est activé.
Connaître le volet d'onglet actif

Numéro du volet d'onglet

Pour récupérer le numéro du volet d'onglet actif :
  • réalisez une simple affectation. Par exemple :
    NumVoletActif = NomChampOnglet
  • Dans le cas d'un volet nommé :
SELON NomChampOnglet

CAS Recherche : //Onglet nommé recherche actif
CAS Edition : //Onglet nommé Édition actif

FIN
  • utilisez la propriété Valeur.
WINDEVWindowsUniversal Windows 10 AppJava

Libellé du volet d'onglet

Pour récupérer le libellé du volet d'onglet actif, il suffit d'utiliser la propriété Libellé sur le volet d'onglet :
Par exemple :
  • onglet non nommé :
    Trace(ONG_Onglet1[ONG_Onglet1].Libellé)
  • onglet non nommé :
    Trace(Recherche.Libellé)
La propriété Libellé permet également de modifier le libellé du volet d'onglet.
Fonctions du WLangage permettant de manipuler les champs Onglet
Les fonctions suivantes sont spécifiques à la gestion des caractéristiques d'un champ Onglet par programmation.
ChampCloneCloner un volet d'onglet.
EnumèreChampEnumérer les champs associés à un onglet.
EnumèreSousElémentEnumérer les volets d'un onglet.
OngletDuChampConnaître le nom du champ Onglet associé à un champ.
Propriétés spécifiques aux champs Onglet
Les propriétés suivantes sont spécifiques à la gestion des caractéristiques d'un champ Onglet par programmation.
ImagePermet de connaître et de modifier l'image associée à un volet d'onglet ou à un onglet.
Pour manipuler le volet d'onglet, utilisez la syntaxe suivante : <Champ Onglet> [<Indice du volet>].
OccurrencePermet de connaître le nombre de volets d'un onglet.


Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ de type Onglet, consultez Propriétés associées à un champ Onglet.
Voir Aussi
Version minimum requise
  • Version 9
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