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 Table
  • Présentation
  • Etat initial du champ Table
  • Détail des options d'affichage
  • Mode de sélection
  • Options d'affichage des colonnes
  • Ascenseurs dans un champ Table
  • Options conservées par compatibilité avec les anciennes versions
  • Forcer le titre en mono-ligne
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
Le champ Table permet aussi bien d'afficher et/ou de saisir des informations. Ces informations peuvent provenir d'une source de données, d'une variable WLangage ou elles peuvent également être déterminées par programmation.
Cette page d'aide présente les principales caractéristiques pouvant être définies pour un champ Table présent dans une fenêtre :
Il est également possible de définir la source des données affichée dans le champ. Pour plus de détails, consultez Contenu d'un champ Table.
Etat initial du champ Table
L'état initial d'un champ Table peut être :
Etat initial d'un champ Table
Cet état initial est défini lors de la création du champ et peut être modifié à tout moment dans l'onglet "UI" de la fenêtre de description du champ Table.
Les différentes possibilités sont les suivantes :
  • Visible : Le champ Table sera visible ou non. Cette option peut être modifiée en programmation grâce à la propriété Visible.
  • En saisie : L'utilisateur pourra saisir dans les différentes colonnes du champ si ces colonnes sont en saisie.
    iPhone/iPad Le champ Table n'est pas disponible en saisie. Il est disponible en lecture seulement.
  • Sélection (sans saisie) : L'utilisateur ne pourra pas saisir dans les colonnes du champ. Il sera possible de sélectionner une ligne du champ :
    • soit en cliquant sur cette ligne.
    • soit en utilisant la fonction TableSelectPlus.
      La ligne sera sélectionnée grâce au bandeau de sélection.
      Remarque : La valeur du champ Table correspond à la ligne sélectionnée. A chaque sélection, le code de sélection de ligne est exécuté.
  • Ni saisie, ni sélection : L'utilisateur ne pourra pas saisir dans les colonnes du champ. Il sera possible de sélectionner une ligne du champ uniquement par programmation grâce à la fonction TableSelectPlus. Cette ligne sera sélectionnée grâce au bandeau de sélection. L'utilisateur ne pourra pas modifier la position du bandeau de sélection.
    Remarque : La valeur du champ Table correspond à la ligne sélectionnée.
    Conseil : Cette option est conseillée lorsqu'il est nécessaire de mettre en valeur une ligne grâce au bandeau de sélection.
  • Grisé : Le champ Table et ses colonnes seront grisés. L'utilisateur ne pourra pas saisir d'informations dans le champ.
Détail des options d'affichage

Mode de sélection

Les modes de sélection déterminent comment les différents éléments d'un champ Table (ligne, colonne, cellule) pourront être sélectionnés aussi bien par l'utilisateur que par programmation. Ce mode de sélection est défini lors de la création du champ. Il peut être modifié à tout moment dans l'onglet "UI" de la fenêtre de description du champ Table.
Les modes de sélection disponibles sont les suivants :
Modes de sélection
  • Sans sélection : Le bandeau de sélection ne sera pas affiché, cependant la ligne, la colonne ou la cellule sélectionnée aura le focus (elle sera entourée de pointillés). Il sera possible de sélectionner une ligne, une colonne ou une cellule par un clic sur cet élément ou par programmation.
  • Sélection simple : La ligne, la colonne ou la cellule sélectionnée apparaîtra sous le bandeau de sélection. Il sera possible de sélectionner une ligne, une colonne ou une cellule par un clic sur cet élément ou par programmation.
  • Sélection multiple : Il est possible de sélectionner simultanément plusieurs lignes, colonnes ou cellules du champ Table :
    • grâce à la touche Maj si les lignes, colonnes ou cellules se suivent, et à la touche Ctrl pour si les éléments ne se suivent pas.
    • par programmation.
      Dans ce cas, il y aura autant de bandeaux de sélection que d'éléments sélectionnés.
Remarques :
  • Si vous tentez de réaliser une sélection multiple par programmation alors que le mode de sélection est "Sélection simple", une erreur du WLangage sera affichée.
  • Lors d'une sélection multiple par cellule, pour sélectionner une ligne, il est nécessaire de sélectionner toutes les cellules de la ligne. Pour simplifier cette opération, il est possible d'afficher un sélecteur de ligne (onglet "Style", élément "Sélecteur de ligne", option "Sélecteur" correspondant à "Flèche à gauche").
La récupération des éléments sélectionnés se fera :
  • avec la fonction TableSelect. Les constantes tsLigne, tsColonne, tsLigneCellule et tsColonneCellule permettent de récupérer respectivement les informations sur les lignes, les colonnes et les cellules sélectionnées.
  • avec la fonction TableSelectOccurrence. Les constantes tsLigne, tsColonne et tsCellule permettent de récupérer respectivement le nombre de lignes, colonnes et cellules sélectionnées.
Exemple : L'exemple suivant permet de récupérer le numéro de la ligne et celui de la colonne des cellules sélectionnées dans le champ Table.
// Récupération du nombre de cellules sélectionnées
NbSelectionne est un entier
NbSelectionne = TableSelectOccurrence(TABLE_StatsFiliales, tsCellule)
// Parcours des cellules sélectionnées
POUR i = 1 _À_ NbSelectionne
// Récupération de la ligne et de la colonne
nLigne = TableSelect(TABLE_StatsFiliales, i, tsLigneCellule)
nColonne = TableSelect(TABLE_StatsFiliales, i, tsColonneCellule)
// Traitement
...
FIN

AndroidiPhone/iPad Seul le mode de sélection des lignes est disponible.

Options d'affichage des colonnes

De nombreuses options sont disponibles pour paramétrer l'affichage des colonnes. Ces options sont disponibles dans l'onglet "Détail" de la fenêtre de description du champ Table.
Options d'affichage des colonnes
Ces options sont les suivantes :
  • Mémoriser la config. des colonnes : Cette option permet de mémoriser la configuration des colonnes (taille, ordre, etc.) à la fermeture de la fenêtre ou de l'application.
  • Menu 'Sélectionner les colonnes...' : Cette option permet d'afficher un menu contextuel afin que l'utilisateur puisse sélectionner les colonnes à afficher ou a masquer dans le champ Table.
  • Colonnes texte multilignes : Cette option permet de rendre les colonnes de texte multilignes. Ainsi, le texte est entièrement affiché dans la cellule s'il ne peut pas entrer dans la colonne.
  • Nb. max. de lignes affichées dans une ligne : Dans la ligne d'un champ Table, il est possible d'afficher plusieurs lignes. Cette option permet de fixer le nombre de lignes affichées (évite par exemple d'avoir une cellule qui comporte 20 lignes, et qui augmente ainsi de manière démesurée la hauteur de la ligne).
  • Nombre de colonnes fixées à gauche : Cette option permet d'indiquer le nombre de colonnes fixées à gauche. Ces colonnes seront "collées" au côté gauche du champ et ne pourront pas être déplacées. L'ascenseur horizontal du champ ne permettra pas de déplacer ces colonnes.
    L'utilisateur peut également fixer ou "défixer" les colonnes via le curseur "Verrou" ou via l'option "Colonne fixée" du menu contextuel du titre de la colonne. Pour plus de détails, consultez Fixer les colonnes des champs Table.
    Il est également possible de fixer une colonne par programmation grâce à la fonction TableFixeColonne.
  • AndroidiPhone/iPad Éditer les sur-entêtes de colonnes : Il est possible de définir des sur-entêtes de colonnes. Un sur-entête de colonnes est un titre supplémentaire affiché au-dessus du titre d'une ou plusieurs colonnes. Pour plus de détails, consultez Gestion des titres des colonnes dans un champ Table.
Remarque : Par défaut, les titres des colonnes sont multilignes. La hauteur de l'entête est automatiquement ajustée au nombre de lignes. Les titres de colonnes supportent le RTF.
Ascenseurs dans un champ Table
Options conservées par compatibilité avec les anciennes versions

Forcer le titre en mono-ligne

Par défaut, le titre des colonnes d'un champ Table est multiligne. L'option "Forcer le titre en monoligne (8)" permet de retrouver le comportement par défaut de la version 8.
Sur les champs Table créés avec la version 8 (ou précédente), cette option doit être décochée pour obtenir un titre de colonnes multiligne.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 23/06/2022

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