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 indicé
  • Code d'un champ indicé
  • Manipuler directement un champ indicé (affectation, ...)
  • Champ de saisie ou colonne d'un champ Table
  • Colonne d'un champ Table
  • Remarques : Colonne indicée et colonne non indicée
  • Fonctionnement des fonctions FichierVersEcran et EcranVersFichier
  • Propriétés du WLangage et champ indicés
  • Fonctions WLangage spécifiques à la gestion des champs indicés
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
Code d'un champ indicé
Tous les champs indicés de même nom sont associés aux mêmes traitements.
Par exemple, le code d'initialisation du champ indicé SAI_Saisie1[1] est le même que le code d'initialisation du champ indicé SAI_Saisie1[5].
Manipuler directement un champ indicé (affectation, ...)

Champ de saisie ou colonne d'un champ Table

Pour manipuler un champ indicé par programmation, il est nécessaire de préciser l'indice.
Par exemple : ChampIndicé[1] pour manipuler le premier champ indicé.

Colonne d'un champ Table

Les colonnes d'un champ Table peuvent être indicées : le champ Table comporte plusieurs colonnes de même nom. Chaque colonne est identifiée par son nom et son indice.
Pour récupérer la valeur d'une colonne indicée dans un champ Table, la syntaxe est la suivante :
Valeur = <Nom Colonne>[<Ligne>, <Indice>]
Pour affecter une colonne indicée dans un champ Table, la syntaxe est la suivante :
<Nom Colonne>[<Ligne>, <Indice>] = Valeur
avec :
  • <Nom Colonne> : nom de la colonne indicée.
  • <Ligne> : numéro de la ligne
  • <Indice> : indice de la colonne.
Exemple : Un champ Table contient une colonne indicée COL_Adresse. Deux colonnes sont associées à Adresse. Pour manipuler ces colonnes, la syntaxe est la suivante :
// Affecte la ligne 1 de la colonne COL_Adresse[2]
COL_Adresse[1,2] = "3 impasse de la belle"
// Change la couleur de fond de la ligne 5 dans la colonne COL_Adresse[1]
COL_Adresse[5,1].CouleurFond = VertClair
// Change la couleur de fond de la ligne 4 de la colonne COL_Adresse[2]
COL_Adresse[4,2].CouleurFond = VertClair

Remarques : Colonne indicée et colonne non indicée

  • Pour les colonnes indicées :
    <Nom Colonne>[Indice n] retourne le contenu de la colonne d'indice n sur la ligne en cours.
  • Pour les colonnes non indicées:
    <Nom Colonne>[Indice] retourne le contenu de la colonne sur la ligne n.
  • <Nom Colonne>[<Ligne>][<Indice>] est équivalent à <Nom Colonne>[<Ligne>,<Indice>]
Fonctionnement des fonctions FichierVersEcran et EcranVersFichier
Les fonctions FichierVersEcran et EcranVersFichier gèrent automatiquement la liaison entre les champs indicés et des rubriques tableau. Bien entendu, le champ indicé doit être associé à un des éléments de la rubrique tableau.
Propriétés du WLangage et champ indicés
La syntaxe pour accéder à une propriété d'un champ indicé est la suivante :
<NomChamp> [<Indice>].<Propriété>

<Nom Colonne> [<Ligne>, <Indice>].<Propriété>
  • <NomChamp> est le nom du champ
  • <Indice> est l'indice du champ (par défaut indice est à 1)
  • <Propriété> est une des nombreuses propriétés proposées par WINDEV.
Pour un champ indicé, <Nom du champ>.<Propriété> n'affecte que le champ d'indice 1.
Toutes les propriétés utilisables sur les champs de saisie et les colonnes des champs Table peuvent être utilisées sur les champs indicés.
Les propriétés s'appliquent à chaque champ et non à l'ensemble des champs du champ indicé.
Fonctions WLangage spécifiques à la gestion des champs indicés
Les fonctions WLangage suivantes sont spécifiques à la gestion des champs indicés :
ColonneEnCoursRenvoie l'indice de la colonne indicée en cours dans un champ Table fichier ou un champ Table par programmation.
EcranPremierDéfinit le prochain champ qui sera en saisie dans la fenêtre en cours.
IndiceEnCoursRenvoie l'indice du champ en cours.
IndiceSuivantRenvoie le numéro de la ligne suivante affichée dans le champ Table en cours.
Renvoie l'indice du champ indicé suivant.
Version minimum requise
  • Version 9
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