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
  • A quel moment les calculs sont effectués ?
  • Récupérer la valeur d'un calcul
  • Modifier les caractéristiques des calculs par programmation
  • Propriétés utilisables sur les cellules de calcul des colonnes
  • Exporter les résultats des calculs
  • Export via les FAA (Fonctionnalités Automatiques de vos Applications) du champ Table
  • Export via les fonctions WLangage
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
A quel moment les calculs sont effectués ?
Les calculs sont effectués :
  • lors de l'initialisation du champ Table.
  • lorsqu'un traitement effectue un ajout ou une modification sur un champ Table avec calculs :
    • les totaux sont recalculés à la fin du traitement (ou lors de l'utilisation de la fonction Multitache).
    • si la valeur d'un calcul est demandée (voir paragraphe suivant), ce calcul est immédiatement ré-effectué.
La propriété TotauxActif permet d'interdire ou de forcer les calculs effectués dans un champ Table.
Attention : Si la propriété AffichageActif est utilisée sur le champ Table et correspond à Faux, les calculs automatiques ne sont pas mis à jour.
Récupérer la valeur d'un calcul
Le résultat des différents calculs réalisés dans un champ Table peuvent être manipulés par programmation.
Plusieurs constantes permettent d'identifier la ligne de calcul d'une colonne :
ligneComptageLigne contenant le résultat du comptage.
ligneMaximumLigne contenant la valeur maximale des cellules de la colonne.
ligneMinimumLigne contenant la valeur minimale des cellules de la colonne.
ligneMoyenneLigne contenant le résultat d'une moyenne.
ligneTotalLigne contenant le résultat d'un total.

Pour récupérer la valeur d'un calcul, il suffit d'utiliser la syntaxe suivante :
<Nom de la colonne>[<Type du calcul>]

Exemple :
// Récupère le calcul de moyenne effectué dans la colonne COL_NOTE
Trace(COL_NOTE[ligneMoyenne])
Modifier les caractéristiques des calculs par programmation
WINDEV permet de modifier les caractéristiques (police, couleur, ...) du résultat d'une colonne par programmation grâce aux propriétés WLangage. Il est par exemple possible d'utiliser les propriétés du WLangage pour modifier la couleur du résultat, sa couleur de fond, sa police, ... Cependant, il n'est pas possible de modifier le contenu de la cellule résultat par programmation.
Pour utiliser une propriété du WLangage sur le résultat d'une colonne, la syntaxe à utiliser est la suivante :
<Nom de la colonne>[<Type du calcul>].<Propriété>

Exemple :
// Colore en rouge le résultat de la moyenne. Le fond est en bleu
COL_NOTE[ligneMoyenne].Couleur = RougeClair
COL_NOTE[ligneMoyenne].CouleurFond = BleuClair

Propriétés utilisables sur les cellules de calcul des colonnes

CouleurPermet de connaître et de modifier la couleur du texte affiché dans une cellule de calcul.
CouleurFondPermet de connaître et de modifier la couleur de fond d'une cellule de calcul.
EtatPermet de connaître et de modifier l'état d'affichage de la ligne contenant la cellule de calcul.
HauteurPermet de connaître et de modifier la hauteur d'une cellule de calcul.
LargeurPermet de connaître et de modifier la largeur d'une cellule de calcul.
LibelléPermet de connaître et de modifier le libellé de la ligne contenant une cellule de calcul.
NomPermet de connaître le nom d'une cellule de calcul.
NotePermet de connaître et de modifier les notes associées à une cellule de calcul.
PolicePermet de connaître et de modifier la police utilisée dans une cellule de calcul.
PoliceBarréePermet de connaître et de modifier l'attribut "Barré" pour une cellule de calcul.
PoliceCondenséePermet de savoir si les caractères des éléments de la colonne sont condensés ou non, et de condenser ou non les caractères des éléments de la colonne.
PoliceEtenduePermet de savoir si les caractères des éléments de la colonne sont étendus ou non et d'étendre ou non les caractères des éléments de la colonne.
PoliceGrasPermet de connaître et de modifier l'attribut "Gras" pour les éléments de la colonne.
PoliceItaliquePermet de connaître et de modifier l'attribut "Italique" pour les éléments de la colonne.
PoliceLargePermet de savoir si les caractères des éléments de la colonne sont élargis ou non, et d'élargir ou non les caractères des éléments de la colonne.
PoliceNomPermet de connaître et de modifier la police utilisée pour les éléments de la colonne.
PoliceSoulignéePermet de connaître et de modifier l'attribut "Souligné" pour les éléments de la colonne.
PoliceTaillePermet de connaître et de modifier la taille de la police utilisée pour les éléments de la colonne.
VisiblePermet de savoir si une colonne est visible et de rendre visible / invisible une colonne.
Exporter les résultats des calculs
WINDEVWindows

Export via les FAA (Fonctionnalités Automatiques de vos Applications) du champ Table

Le menu contextuel des champs Table et Table hiérarchique propose par défaut des options permettant d'exporter le contenu du champ.
Lors de cet export, les résultats des calculs automatiques sont exportés.
Remarques :
  • Seule la valeur est exportée, pas le libellé.
  • Lors de l'export sous Excel, la cellule correspondant au calcul contient la formule Excel correspondante.

Export via les fonctions WLangage

Diverses fonctions WLangage permettent d'exporter le contenu d'un champ Table dans un format spécifique (Word, Excel, XML, ...). Lors de cet export, par défaut les lignes correspondant à un calcul sont également exportées.
Pour ne pas exporter les lignes de calculs, il suffit de spécifier la constante taSansTotaux dans les fonctions suivantes :
TableVersExcelCrée un fichier Excel avec les données d'un champ Table ou Table hiérarchique.
TableVersPressePapierCopie le contenu d'un champ Table ou Table hiérarchique dans le presse-papiers.
TableVersTexteCrée une chaîne de caractères avec les données d'un champ Table ou Table hiérarchique.
TableVersWordCrée un fichier Word (.RTF) avec les données d'un champ Table ou Table hiérarchique.
TableVersXMLCrée un fichier XML avec les données d'un champ Table ou Table hiérarchique.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Total d'une colonne calculée
Seul le total d'une colonne de données peut être récupéré, pas celui d'une colonne calculée.
Jean-Pierre
05 juil. 2024
EN V27 103n : L'indice LigneTotal n'est pas calculé si Affichage actif = faux
Attention :
si pour optimiser votre application vous utilisez Mafenetre..affichageActif = faux alors la valeur de l'indice LigneTotal est faux. il faut donc rétablir l'affichage (Mafenetre..affichageActif = vrai) avant d'exploiter cet indice !
Gilles Fromont
25 aoû. 2022
Récupération de la valeur d'un calcul dans un champ table
L'expression <Nom de la colonne> [<Type du calcul>] ne tient pas compte du filtre établi avec la fonction TableActiveFiltre()
Albert CEZAR
15 juin 2016

Dernière modification : 23/08/2022

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