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
  • Titre des colonnes
  • Image du titre des colonnes
  • Titre de colonne multiligne
  • Inclinaison du titre des colonnes
  • Image de fond de la zone de titre de la colonne
  • Sur-entête de colonnes
  • Icônes affichées dans les colonnes
  • Affichage de l'icône de tri
  • Personnalisation des icônes "Loupe", tri, menu contextuel et filtre
  • Position des icônes de tri et de recherche
  • Mode de recherche par défaut
  • Bandeau de sélection
  • Affichage ou non du bandeau de sélection sur la colonne
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 titre des colonnes est un élément important d'un champ Table. En effet, le titre des colonnes permet d'intervenir aussi bien au niveau du look (avec la possibilité d'intégrer des images) qu'au niveau des fonctionnalités (filtre, recherche).
Cette page d'aide présente les différentes fonctionnalités disponibles :
Titre des colonnes
WINDEV

Image du titre des colonnes

Il est possible d'afficher une image dans le titre d'une colonne. Si un libellé est affiché dans le titre de la colonne, cette image sera positionnée à gauche du libellé. Cette image peut être insérée sous l'éditeur ou par programmation.
Pour insérer une image dans le titre d'une colonne sous l'éditeur :
  1. Affichez la fenêtre de description de la colonne (option "Description de la colonne" du menu contextuel).
  2. Dans l'onglet "Général", indiquez l'image du titre de la colonne en cliquant le bouton Bouton déroulant :
    • L'option "Parcourir" permet de sélectionner un fichier image disponible depuis votre poste.
    • L'option "Catalogue" permet de choisir une image présente dans le catalogue d'images de WINDEV.
  3. Validez. L'image apparaît dans le titre de la colonne sous l'éditeur.
Pour afficher une image dans un titre de colonne par programmation, utilisez la propriété ImageTitre.

Titre de colonne multiligne

Par défaut, le titre de colonne est affiché sur plusieurs lignes.
Pour paramétrer le mode de gestion du titre des colonnes (mono-ligne ou multi-ligne)  :
  1. Affichez la fenêtre de description du champ Table (option "Description de la table" du menu contextuel).
  2. Dans l'onglet "Détail", cochez ou décochez l'option "Forcer le titre en monoligne (8)".
  3. Validez.
Remarques :
  • Le titre des colonnes supporte également le RTF et les fonctions graphiques (fonctions gXXX).
  • Dans l'éditeur de fenêtres, la hauteur des titres de colonnes peut être modifiée à la souris.
  • Le titre des colonnes peut être modifié par programmation grâce à la propriété Titre ou à la propriété Libellé.
  • La hauteur des titres des colonnes peut être modifié par programmation grâce à la propriété HauteurTitre.
WINDEV

Inclinaison du titre des colonnes

Dans un champ Table, il est possible de fixer un angle d'écriture des titres (en degrés). Il est ainsi possible de créer des titres de colonne inclinés.
Pour incliner le titre des colonnes :
  1. Affichez la fenêtre de description du champ Table (option "Description" du menu contextuel).
  2. Dans l'onglet "Détail", saisissez la valeur de l'option "Angle du titre des colonnes" (en degrés). Le bouton fléché à côté du champ permet de sélectionner de manière précise l'angle voulu.
  3. Validez.
Pour incliner le titre des colonnes par programmation, utilisez la propriété AngleTitre.
WINDEV

Image de fond de la zone de titre de la colonne

Il est possible d'inclure une image dans chaque cellule de titre.
Pour personnaliser l'image de la zone de titre :
  1. Affichez l'onglet "Style" de la fenêtre de description du champ Table (option "Description" du menu contextuel).
  2. Sélectionnez l'élément "Cadre titre de colonne".
  3. Ouvrez la combo "Cadre" et sélectionnez l'option "Image (Mode 9 images)".
  4. Cliquez sur le bouton "Flèche droite" situé à droite de la combo "Cadre". Une fenêtre de paramétrage de l'image du titre des colonnes s'ouvre.
  5. Sélectionnez l'image du cadre à utiliser en cliquant le bouton Bouton déroulant :
    • L'option "Parcourir" permet de sélectionner un fichier image disponible depuis votre poste.
    • L'option "Catalogue" permet de choisir une image présente dans le catalogue d'images de WINDEV. Le catalogue d'images propose uniquement les images pouvant être utilisées comme titre de colonne.
  6. Si l'image sélectionnée contient plusieurs états, spécifiez ce nombre d'états.
  7. Fermez la fenêtre de paramétrage de l'image des cellules de titre.
  8. Validez.
Remarque : L'élément "Cadre titre de colonne" de l'onglet "Style" permet également de paramétrer la hauteur de la zone de titre des colonnes.
WINDEVAndroidiPhone/iPad

Sur-entête de colonnes

Il est possible de définir un sur-entête de colonnes. Un sur-entête de colonnes est un titre supplémentaire affiché au-dessus du titre d'une ou plusieurs colonnes.
Pour définir un sur-entête de colonnes :
  1. Affichez l'onglet "Détail" de la fenêtre de description du champ Table (option "Description" du menu contextuel).
  2. Cliquez sur le bouton "Éditer les sur-entêtes de colonnes".
  3. Dans la fenêtre qui s'ouvre, les différentes colonnes de la table sont affichées.
    Dans cette fenêtre, il est possible de :
    • 1 : Ajouter des sur-entêtes (bouton "+") ou supprimer des sur-entêtes (bouton "-").
    • 2 : Redimensionner et fusionner les différentes cellules des sur-entêtes en survolant les séparateurs.
    • 3 : Renommer les cellules des sur-entêtes en cliquant dessus.
  4. Validez.
Remarques :
  • Il est possible de créer des sur-entêtes de colonnes par programmation grâce à la fonction TableAjouteSurEntête.
  • La propriété Fusion permet de fusionner :
    • les cellules d'un champ Table.
    • les titres des colonnes.
  • Si les sur-entêtes de colonnes sont activés, la modification du libellé des colonnes via la fenêtre de description de la colonne n'est pas prise en compte : le libellé doit être modifié dans la fenêtre d'édition des sur-entêtes de colonnes.
  • WINDEV La propriété Surentête permet de :
    • Connaître et modifier le titre et l'aspect d'un sur-entête de colonne de table.
    • Connaître le nombre de sur-entêtes d'une colonne de table.
Icônes affichées dans les colonnes

Affichage de l'icône de tri

Par défaut, dans une colonne triable, l'icône de tri est affichée si l'utilisateur clique dans la colonne. L'icône de tri indique alors le sens de tri de la colonne.
Il est également possible d'afficher tout le temps une icône de tri dans la colonne. Dans ce cas, lorsque la colonne n'est pas triée, une icône indique à l'utilisateur qu'un tri peut être effectué sur cette colonne.
Pour afficher l'icône de tri :
  1. Affichez l'onglet "Style" de la fenêtre de description du champ Table (option "Description" du menu contextuel).
  2. Sélectionnez l'élément "Cadre titre de colonne".
  3. Sélectionnez l'option "Afficher l'icône de tri".
WINDEV

Personnalisation des icônes "Loupe", tri, menu contextuel et filtre

Dans une colonne, plusieurs icônes permettent d'indiquer à l'utilisateur si la colonne est triable, si la colonne est triée et dans quel sens, si la colonne permet une recherche ou un filtre.
Pour personnaliser le look de ces éléments :
  1. Affichez l'onglet "Style" de la fenêtre de description du champ Table (option "Description" du menu contextuel).
  2. Sélectionnez l'élément "Cadre titre de colonne".
  3. Cliquez sur le bouton "Image Tri/Loupe" et sélectionnez l'image à utiliser pour la loupe via le bouton Bouton déroulant (option "Parcourir" ou "Catalogue").
    Cette image doit avoir pour taille 53 x 33 pixels et doit contenir les éléments suivants :
    • Image de colonne triable : 9 x 8 pixels
    • Images de colonne triée : triée vers le bas et vers le haut (22 x 9 pixels chaque dessin)
    • Images de la loupe : grisée, actif et enfoncée (33 x 11 pixels chaque dessin)
    • Image du menu contextuel (10 x 14 pixels)
    • Image du filtre : grisée, actif et enfoncée (33 x 11 pixels chaque dessin)
Par exemple :
WINDEV

Position des icônes de tri et de recherche

Par défaut, les différentes icônes affichées dans le titre de la colonne ont une position précise :
  • les icônes permettent d'indiquer à l'utilisateur si la colonne est triable, si la colonne est triée et dans quel sens sont affichés à gauche.
  • les icônes permettant d'indiquer si la colonne permet une recherche ou un filtre sont affichées à droite.
Pour personnaliser la position de ces éléments :
  1. Affichez la fenêtre de description de la colonne (option "Description" du menu contextuel).
  2. Dans l'onglet "Style", sélectionnez l'élément "Cadre titre de colonne".
  3. Cliquez sur le bouton "Position Image Tri/Loupe" et indiquez la position des différentes icônes par rapport au cadre du titre de la colonne.
WINDEV

Mode de recherche par défaut

Une colonne d'un champ Table peut permettre à l'utilisateur de réaliser une recherche ou un filtre. Il est possible de choisir le fonctionnement par défaut des colonnes d'un champ Table :
  • Mode loupe = Recherche : Lorsque l'utilisateur saisira des caractères dans l'entête de colonne, une recherche sera automatiquement effectuée sur le contenu de la colonne. Les lignes dont le contenu commence par les caractères saisis seront affichées.
  • Mode loupe = Filtre <Contient> : Lorsque l'utilisateur saisira des caractères dans l'entête de colonne, une recherche sera automatiquement effectuée sur le contenu de la colonne. Les lignes dont le contenu contient les caractères saisis seront affichées.
Pour paramétrer le mode de recherche par défaut des colonnes sous l'éditeur :
  1. Affichez la fenêtre de description du champ Table (option "Description" du menu contextuel).
  2. Dans l'onglet "Général", indiquez le "Mode loupe" voulu.
  3. Validez.
Pour paramétrer le mode de recherche par défaut des colonnes par programmation, utilisez la propriété ModeLoupe. Cette propriété permet d'utiliser tous les modes disponibles.
Bandeau de sélection
WINDEV

Affichage ou non du bandeau de sélection sur la colonne

Dans un champ Table, le bandeau de sélection permet de visualiser rapidement la ou les lignes sélectionnées. Dans certains cas, il est possible de vouloir afficher le bandeau de sélection uniquement sur certaines colonnes du champ Table.
Pour ne pas afficher le bandeau de sélection sur certaines colonnes sous l'éditeur :
  1. Affichez la fenêtre de description de la colonne (option "Description" du menu contextuel).
  2. Dans l'onglet "Détail", décochez l'option "Afficher le bandeau sur cette colonne".
  3. Validez.
Pour ne pas afficher le bandeau de sélection sur certaines colonnes par programmation, utilisez la propriété BandeauVisible.
Version minimum requise
  • Version 14
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