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 Colonne de table
  • Présentation
  • Caractéristiques des colonnes d'un champ Table dans une fenêtre
  • Image du titre de colonne
  • Colonne redimensionnable
  • Colonne triable
  • Colonne déplaçable
  • Recherche (Loupe / Filtre)
  • Colonne fixée, colonne ancrée
  • Colonne de type Jauge
  • Description
  • Jauge avec une borne maximale différente pour chaque ligne du champ Table
  • Propriétés utilisables sur une cellule de type Jauge
  • Colonne calculée et colonne de type Interrupteur (champ Table par programmation et champ Table fichier chargé en mémoire)
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
Les colonnes permettent d'afficher les informations dans un champ Table. Toutes les informations affichées dans une même colonne sont du même type.
Les types de données pouvant être affichés dans une colonne sont les suivants :
  • Texte
  • Monétaire
  • Heure
  • Combo
    AndroidiPhone/iPad Non disponible.
  • Image
  • Jauge
  • Numérique
  • Date
  • Libellé
  • Interrupteur
    AndroidiPhone/iPad Non disponible.
  • Durée
    Android Non disponible.
  • Conteneur
    (non disponible en Java et en WINDEV Mobile)
Remarque : Pour utiliser la fonction gImage dans une colonne, utilisez une colonne de type Texte.
Pour chaque type de colonne, des caractéristiques spécifiques sont paramétrables.
La programmation de chaque type de colonne correspond à la programmation du champ simple correspondant.
Les paragraphes suivants présentent les principales caractéristiques des colonnes d'un champ Table affichées dans une fenêtre, disponibles quel que soit le type de la colonne. Pour les colonnes des champs Table affichées dans une page, consultez Caractéristiques des colonnes d'un champ Table dans une page.
Caractéristiques des colonnes d'un champ Table dans une fenêtre
La majorité des caractéristiques des colonnes d'un champ Table sont configurées dans l'onglet "Général" des caractéristiques de chacune des colonnes.
Caractéristiques de colonnes

Image du titre de colonne

Cette option permet de définir l'image qui sera utilisée en image de fond du titre de la colonne.
AndroidiPhone/iPad Les colonnes du champ Table ne peuvent pas avoir une image dans le titre de la colonne.

Colonne redimensionnable

Si une colonne est redimensionnable :
  • L'utilisateur pourra manipuler la taille des colonnes à l'aide de la souris.
  • Cette colonne sera automatiquement redimensionnée lors de l'utilisation de l'option de menu "Ajuster toutes les colonnes" (option du menu contextuel de l'entête de la colonne).
Programmation :
  • Il est possible de redimensionner la taille des colonnes grâce à la fonction TableAjuste.
  • Il est possible d'ajuster la taille des colonnes à leur contenu en utilisant la fonction FAAExécute avec la constante faaAjusterToutesLesColonnes.

Colonne triable

L'utilisateur pourra trier la colonne d'un simple clic sur son entête. Cette option est disponible :
  • sur toutes les colonnes d'un champ Table par programmation ou d'un champ Table hiérarchique par programmation.
  • sur certaines colonnes d'un champ Table fichier (uniquement les colonnes basées sur des rubriques clé, non filtrées).


Remarque : En exécution les icônes Tri croissant et Tri décroissant permettent de connaître à tout moment le sens de tri de la colonne. Il est possible de personnaliser les images utilisées. Pour plus de détails, consultez Paramétrage des titres des colonnes dans un champ Table.
Programmation : Le tri peut également être effectué par programmation grâce aux fonctions :
TableTriePermet de trier le contenu d'un champ Table ou Table hiérarchique sur une ou plusieurs colonnes
TableTrieFilsPermet de trier une branche d'un champ Table hiérarchique sur une ou plusieurs colonnes (tri lexicographique).

La propriété OptionTri permet de définir les options de tri à utiliser.

Colonne déplaçable

L'utilisateur pourra déplacer la colonne dans le champ Table et changer l'ordre des colonnes affichées.
AndroidiPhone/iPad Les colonnes du champ Table ne peuvent pas être déplacées.

Recherche (Loupe / Filtre)

L'utilisateur pourra effectuer un filtre de type "Commence par" directement dans la colonne. Seuls les éléments commençant par les lettres saisies pour la colonne seront affichés.
AndroidiPhone/iPad L'utilisateur clique sur l'entête de colonne pour afficher le menu contextuel.
  • Dans le menu contextuel, l'utilisateur sélectionne la loupe :
    Loupe de recherche
  • Dans la zone de saisie qui s'affiche en haut du champ Table, l'utilisateur saisit le mot recherché.
    Saisie de la recherche
La loupe est disponible :
  • sur toutes les colonnes d'un champ Table par programmation.
  • sur les colonnes des champs Table fichier à parcours automatique (uniquement les colonnes triables, basées sur des rubriques clé, non filtrées).
Attention : La loupe n'est pas disponible :
  • sur les rubriques associées à une liaison multifichier.
  • sur les champs Table utilisant un ascenseur non proportionnel (option "Ascenseur proportionnel" décochée dans l'onglet "Détail" de la fenêtre de description du champ Table).
Programmation : Cette fonctionnalité peut être effectuée par programmation grâce aux fonctions :
TableChercheRecherche une valeur dans une colonne d'un champ Table par programmation, Table fichier ou Table hiérarchique.
TableChercheFilsRecherche une valeur dans une colonne d'un champ Table hiérarchique, dans une branche spécifiée.

Colonne fixée, colonne ancrée
Colonne de type Jauge
AndroidiPhone/iPad

Description

La configuration de la jauge est effectuée dans l'onglet "Général" de la description de la colonne. Il est possible de paramétrer :
  • la valeur d'origine de la jauge,
  • la valeur maximale de la jauge,
  • l'image active et l'image de fond.
L'onglet "Détail" de la description de la colonne permet de paramétrer l'affichage du pourcentage de progression, ...
AndroidiPhone/iPad

Jauge avec une borne maximale différente pour chaque ligne du champ Table

Il est possible d'afficher une jauge avec une borne maximale différente pour chaque ligne. Dans ce cas, il faut :
  1. Affecter la propriété BorneMax à 100 pour la colonne.
  2. Dans le code d'affichage de ligne, faire le calcul voulu :
    <Colonne Jauge> = <Valeur Jauge>*100/<Valeur Max>
AndroidiPhone/iPad

Propriétés utilisables sur une cellule de type Jauge

Il est possible d'utiliser les propriétés BorneMax et BorneMin sur les cellules de type Jauge, en utilisant la syntaxe suivante :
<Nom de la colonne>[<Numéro de la ligne>].BorneMax = <Valeur>
<Nom de la colonne>[<Numéro de la ligne>].BorneMin = <Valeur>
Colonne calculée et colonne de type Interrupteur (champ Table par programmation et champ Table fichier chargé en mémoire)
Liste des exemples associés :
Style d'affichage des cellules de table Exemples unitaires (WINDEV) : Style d'affichage des cellules de table
[ + ] Modification du style d'affichage des cellules de table.
La propriété ..StyleFond permet d'hachurer des cellules ou de faire un dégradé de couleur avec effet "tube".
Calculs Personnalisés Exemples unitaires (WINDEV) : Calculs Personnalisés
[ + ] Utilisation d'une formule saisie par l'utilisateur dans un champ Table.
La formule est simplement saisie dans la colonne puis mémorisée dans un fichier .INI pour être utilisée à chaque affichage de la table. Evidemment, la formule peut être modifiée à n'importe quel moment par l'utilisateur.
Le champ Table / Table hiérarchique (colonnes de type Jauge) Exemples unitaires (WINDEV) : Le champ Table / Table hiérarchique (colonnes de type Jauge)
[ + ] Utilisation d'une colonne de type jauge ainsi que de la propriété ..TexteJauge dans un champ Table ou Table hiérarchique
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/06/2022

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