PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.Annee = "2009"
x.Trimestre = "2009T1"
x.Mois = "200901"
x.Produit..Cumul = Vrai

// Afficher le total des ventes de tous les produits en janvier 2009
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 uniquement en lecture.
Cette propriété est notamment utile pour savoir si la position indiquée avec la fonction TCDInfoXY existe.
Remarque : Ces propriétés peuvent être utilisées avec une des deux syntaxes suivantes :
  • <Nom de la variable>..<Nom de la propriété>
  • <Nom de la variable>.<Nom de la propriété>

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

Versions 18 et supérieures
TCDInfoXY
Nouveauté 18
TCDInfoXY
TCDInfoXY
Renvoie les valeurs d'entêtes correspondant à une position en pixels dans un champ Tableau croisé dynamique.
Versions 19 et supérieures
TCDListePositionEntête
TCDListePositionEntête
Renvoie toutes les valeurs associées à un entête de ligne ou de colonne d'un champ Tableau croisé dynamique.
Versions 19 et supérieures
TCDSelect
Nouveauté 19
TCDSelect
TCDSelect
Permet 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