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)
  • Export et impression
  • Colonne fixée, colonne ancrée
  • 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)
  • Colonne calculée et colonne Interrupteur
  • Style des colonnes Interrupteur
  • Autres caractéristiques des colonnes Interrupteur
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Présentation
Dans un champ Table, les colonnes permettent d'afficher les informations. Toutes les informations affichées dans une même colonne sont du même type.
La fenêtre de description du champ Table permet d'ajouter, de supprimer et de spécifier les caractéristiques des colonnes à l'aide de différents onglets. Pour chaque type de colonne, des caractéristiques spécifiques sont paramétrables.
Les types de données pouvant être affichés dans une colonne sont les suivants :
  • Texte
  • Monétaire
  • Heure
  • Combo
  • Image
  • Jauge
    Java Non disponible.
  • Numérique
  • Date
  • Libellé
  • Interrupteur
  • Durée
  • Conteneur
    (non disponible en Java et en WINDEV Mobile)
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.
Remarques :
  • Il est possible d'insérer une image dans une colonne de type Texte avec la fonction gImage.
  • WINDEVJava Il est possible de réaliser des calculs sur le contenu d'une ou de plusieurs colonnes. Pour plus de détails, consultez Gestion des calculs dans les colonnes d'un champ Table.
  • La programmation de chaque type de colonne correspond à la programmation du champ simple correspondant.
  • Pour les colonnes des champs Table affichées dans une page, consultez Caractéristiques des colonnes d'un champ Table dans une page.
  • WINDEVWindows Les colonnes des champs Table hiérarchique ont les mêmes caractéristiques que les colonnes des champs Table.
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.

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 en WLangage :
  • 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).
WINDEV Le bouton "Options" permet de définir les caractéristiques du tri sur les colonnes de type Texte.
En cochant l'option "Personnaliser le tri", il est possible de sélectionner le mode de tri ou les combinaisons de tri voulues.
Astuce : Activer l'option "Fonctions gXXX" : Cette option permet de trier la colonne en fonction du contenu défini avec la fonction gLien.
Pour utiliser cette fonctionnalité, il suffit d'utiliser la fonction gLien dans l'événement d'affichage d'une ligne. Par exemple, pour afficher les dates en toutes lettres et pour trier la colonne selon la date, le code d'affichage de la ligne est le suivant :
sDateTriable est chaîne
// Récupère le gLien pour le tri + la valeur à afficher
sDateTriable = gLien(dDate) + DateVersJourEnLettre(dDate) + " " + ...
    dDate.Jour + " " + DateVersMoisEnLettre(dDate)+ " " + dDate.Année
// Affiche la date en toutes lettres et trie sur le format normal de date
TableAjouteLigne(TABLE_Commandes, Commande.NuméroInterneCommande, sDateTriable, ... )

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 en WLangage : 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.
WINDEV Un événement optionnel peut également être géré : A chaque tri sur la colonne.

Colonne déplaçable

L'utilisateur pourra déplacer la colonne dans le champ Table et changer l'ordre des colonnes affiché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.
WINDEVJava Deux méthodes sont possibles :
  • L'utilisateur saisit directement le mot recherché. Cette recherche s'effectue automatiquement dans la colonne triée.
  • Un simple clic sur l'entête de la colonne avec loupe permet d'afficher un champ de saisie. L'utilisateur n'a plus qu'à saisir le mot recherché.
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).
WINDEVJava Il est possible de personnaliser l'image de la loupe. Pour plus de détails, consultez Paramétrage des titres des colonnes des champs 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.

WINDEV Un événement optionnel peut également être géré : A chaque recherche avec la loupe de colonne.
WINDEV

Export et impression

La colonne de table pourra être prise en compte à l'impression et dans les exports :
  • Toujours,
  • Jamais,
  • Si la colonne est visible dans la fenêtre.
Remarque : Cette option sera prise en compte :
Programmation : Il est possible de paramétrer cette option par programmation grâce à la propriété VisibleEnExportEtImpression.
Colonne fixée, colonne ancrée
WINDEVWindows

Colonne fixée

Une colonne fixée restera toujours affichée lors du défilement horizontal des colonnes du champ Table. Si la colonne n'est pas fixée, elle sera déplacée avec l'ensemble des colonnes. Les colonnes fixées sont toujours situées à gauche du champ Table.
Il est possible de définir le nombre de colonnes fixées dans la description du champ Table (onglet "Détail", option Nombre de colonnes fixées à gauche). Les x premières colonnes seront alors fixées.
WINDEVWindows

Colonne ancrée

La colonne ancrée est la colonne à laquelle les options d'ancrage seront appliquées. La largeur de la colonne évoluera en fonction de la taille de la fenêtre et de la taille du champ Table.
Il est possible de définir :
  • le numéro de la colonne ancrée dans l'onglet "Général" de la fenêtre de description du champ Table.
  • le taux d'ancrage en largeur d'une colonne dans l'onglet "UI" de la fenêtre de description de la colonne.
Colonne de type Jauge
WINDEVWindows

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, ...
WINDEVWindows

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>
WINDEVWindows

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)
WINDEVWindows

Colonne calculée et colonne Interrupteur

Dans un champ Table fichier chargé en mémoire, il est possible de créer des colonnes calculées : ces colonnes ne sont pas liées à un fichier de données. Ces colonnes peuvent par exemple afficher un calcul, ...
Les colonnes de type "Interrupteur" dans un champ Table fichier chargé en mémoire sont des colonnes calculées spécifiques. Lors d'un déplacement de l'ascenseur, les cases cochées sont automatiquement conservées.
Remarque : Dans un champ Table fichier à accès direct, les colonnes calculées de type Interrupteur (non liées à une rubrique) ne sont pas conservées lors du défilement des lignes.
WINDEVWindows

Style des colonnes Interrupteur

Il est possible de définir le style des Interrupteurs présents dans les colonnes : il est par exemple possible de choisir l'image qui sera utilisée lorsque l'option est sélectionnée.
Pour définir le style des colonnes interrupteur :
  1. Affichez la fenêtre de description du champ Table.
  2. Dans l'onglet "Style", sélectionnez l'élément "Colonne interrupteur". Il est possible de :
    • sélectionner le style de la coche parmi un des styles prédéfinis.
    • choisir une image spécifique pour représenter la coche (option "Style de coche" correspondant à "Image de coche").
WINDEVWindows

Autres caractéristiques des colonnes Interrupteur

Les colonnes de type Interrupteur proposent également les fonctionnalités suivantes :
  • Menu contextuel permettant de cocher/décocher les lignes de la table et de les filtrer. Pour plus de détails, consultez Menu contextuel des colonnes Interrupteur (FAA).
  • Possibilité de ne pas afficher la case des interrupteurs non cochés dans un champ Table en affichage (option "Masquer la coche si décochée (en affichage)" dans l'onglet "Détail" de la fenêtre de description de la colonne ou propriété VideSiZéro).
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 : 13/09/2024

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