|
|
|
|
- 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
tcdPosition (Type de variable) En anglais : pvtPosition
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. // 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 |
---|
EnDehors | Boolé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 | | TCDInfoXY | Renvoie les valeurs d'entêtes correspondant à une position en pixels dans un champ Tableau croisé dynamique. | TCDListePositionEntête | Renvoie toutes les valeurs associées à un entête de ligne ou de colonne d'un champ Tableau croisé dynamique. | TCDSelect | Permet de connaître la position des cellules sélectionnées et de sélectionner des cellules dans un champ Tableau croisé dynamique. |
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|