DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Tableau croisé dynamique
  • Propriétés spécifiques à la description des variables de type tcdPosition
  • Fonctionnement
  • Cas des tableaux croisés dynamiques avec filtre
  • Modifier les caractéristiques d'une cellule
  • Fonctions manipulant les variables de type tcdPosition
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
Le type tcdPosition permet de manipuler directement une cellule d'un champ Tableau croisé dynamique. Ce type de variable permet notamment de récupérer la valeur présente dans une cellule ou de modifier les caractéristiques de la cellule (la couleur de fond par exemple).
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Exemple
// Déclaration
x est un tcdPosition de TCD_Ventes
// Spécifie les valeurs des entêtes de la cellule
x.Année = "2020"
x.Trimestre = "2020T1"
x.Mois = "202001"
x.Produit.Cumul = Vrai
// Afficher le total des ventes de tous les produits en janvier 2020
LIB_Resultat = TCD_Ventes.Valeur1[x]
Remarques

Propriétés spécifiques à la description des variables de type tcdPosition

Les propriétés suivantes peuvent être utilisées pour manipuler une variable de type tcdPosition :
Nom de la propriétéType manipuléEffet
EnDehorsBooléen
  • Vrai si la position indiquée est en dehors du tableau croisé dynamique.
  • Faux si la position est valide.
Cette propriété est disponible en lecture seulement.
Cette propriété est notamment utile pour savoir si la position indiquée avec la fonction TCDInfoXY existe.

Fonctionnement

Pour manipuler une variable de type tcdPosition, il suffit de :
  • spécifier les valeurs des entêtes de la cellule voulue. Par exemple :
    MaPosition est un tcdPosition de TCD_Statistiques
    // Indique les entêtes
    MaPosition.COL_Continent = "Europe"
    MaPosition.COL_DateCommande_Année = "2012"
  • accéder à une valeur du tableau croisé dynamique par la syntaxe suivante :
    <Nom Tableau croisé dynamique>.<Nom valeur>[<variable tcdPosition>]

    Par exemple :
    // Récupère la valeur "VAL_Qté"
    nQuantité = TCD_Statistiques.VAL_Qté[MaPosition]
Remarques :
  • Si la position ne correspond pas à une cellule affichée (par exemple parce qu'elle est repliée), il ne sera pas possible de récupérer la valeur de la cellule ou de modifier sa couleur.
  • Si la position ne correspond pas à une valeur qui existe dans le résultat (par exemple un produit qui ne s'est pas vendu ce jour-là), la valeur renvoyée est 0.
  • Si la position possède un nom d'entête qui n'existe pas dans le tableau croisé dynamique, une erreur WLangage est affichée.
  • Si la position est en-dehors du tableau croisé dynamique, une erreur WLangage est affichée.
  • Pour obtenir un cumul sur un entête, il suffit de ne pas spécifier l'entête ou d'utiliser la propriété .Cumul à Vrai.
  • La propriété .EnDehors est utile pour savoir si la position renvoyée par la fonction TCDInfoXY existe.

Cas des tableaux croisés dynamiques avec filtre

Les variables de type tcdPosition manipulent les données du tableau croisé dynamique en entier : les données non affichées sont également prises en compte. En cas d'utilisation de filtres (fonction TCDFiltre), il est nécessaire de déclarer ce filtre dans la variable tcdPosition.
Exemple :
MaPosition est un tcdPosition de TCD_Statistiques
// Indique le filtre
MaPosition.COL_FILTRE_Produit = COMBO_Produit
// Indique les entêtes
MaPosition.COL_Continent = "Europe"
MaPosition.COL_DateCommande_Année = "2012"
// Récupère la valeur "VAL_Qté"
nQuantité = TCD_Statistiques.VAL_Qté[MaPosition]

Modifier les caractéristiques d'une cellule

Pour mettre en avant une cellule à l'affichage (valeur maximale, minimale, ...), il est possible d'utiliser une variable de type tcdPosition.
Exemple :
MaPosition est un tcdPosition de TCD_Statistiques
 
// Indique les entêtes
MaPosition.COL_Continent = "Europe"
MaPosition.COL_DateCommande_Année = "2012"
 
// Modifie la couleur de fond de la valeur "VAL_Qté"
VAL_Qté[MaPosition].CouleurFond = RougeClair

Fonctions manipulant les variables de type tcdPosition

TCDInfoXYRenvoie les valeurs d'entêtes correspondant à une position en pixels dans un champ Tableau croisé dynamique.
TCDListePositionEntêteRenvoie toutes les valeurs associées à un entête de ligne ou de colonne d'un champ Tableau croisé dynamique.
TCDSelectPermet de connaître la position des cellules sélectionnées et de sélectionner des cellules dans un champ Tableau croisé dynamique.
Version minimum requise
  • Version 18
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/09/2023

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