4D v16.3

QR GET INFO COLUMN

Accueil

 
4D v16.3
QR GET INFO COLUMN

QR GET INFO COLUMN 


 

QR GET INFO COLUMN ( zone ; numColonne ; titre ; objet ; cachée ; taille ; valeursRépétées ; format {; varRésultat} ) 
Paramètre Type   Description
zone  Entier long in Référence de la zone
numColonne  Entier long in Numéro de colonne
titre  Texte in Titre de la colonne
objet  Texte in Nom du champ ou contenu de la formule affecté(e) à la colonne
cachée  Entier long in 0 = visible, 1 = invisible
taille  Entier long in Largeur de la colonne
valeursRépétées  Entier long in 0 = non répétées, 1 = répétées
format  Texte in Format d'affichage des données
varRésultat  Texte in Nom de la variable de formule

La commande QR GET INFO COLUMN vous permet de récupérer les paramètres d'une colonne existante de l'état présent dans la zone.

Passez dans zone la référence de la zone d'état rapide et dans numColonne le numéro de la colonne à définir.

Le paramètre titre retourne l'intitulé de l'en-tête de la colonne.

Le paramètre objet retourne le nom du champ ou la formule associé(e) à la colonne.

Note : La commande ne tient pas compte de la structure virtuelle éventuellement définie via les commandes SET TABLE TITLES et SET FIELD TITLES. Le nom réel des champs est retourné dans le paramètre objet.

Le paramètre cachée indique si la colonne est affichée ou masquée :

  • si cachée vaut 1, la colonne est masquée ;
  • si cachée vaut 0, la colonne est affichée.

Le paramètre taille retourne la taille en pixels de la colonne. Si la valeur retournée est négative, la taille de la colonne est automatique.

valeursRépétées retourne le statut de la propriété de répétition des données. Par exemple, si la valeur d'un champ ou d'une variable ne change pas d'un enregistrement à l'autre, il est possible de la répéter ou non dans chaque ligne de la colonne.

Le paramètre format retourne le format d'affichage de la colonne. Vous pouvez utiliser tout format d'affichage standard de 4D compatible avec les données affichées dans la colonne.

Le paramètre optionnel varRésultat, lorsqu'il est passé, retourne le nom de la variable automatiquement affectée par l'éditeur d'états rapides à la colonne de formule (le cas échéant) : "C1" pour la première colonne de formule, "C2" pour la seconde, et ainsi de suite. 4D utilise cette variable pour stocker les résultats de la dernière exécution de la formule de colonne lors de la génération de l'état.

Avec ce type d'état, la commande QR GET INFO COLUMN permet de récupérer globalement les mêmes paramètres que ceux décrits dans le paragraphe ci-dessus, toutefois les zones auxquelles ils s'appliquent sont différentes et varient en fonction du paramètre à lire.
En outre, les paramètres titre, cachée et valeursRépétées ne sont pas utilisés lorsque vous travaillez avec des états tableaux croisés, les valeurs retournées dans ces paramètres ne sont donc pas significatives.
La valeur à passer dans le paramètre numColonne dépend de l'opération que vous souhaitez effectuer : lire la taille de la colonne ou lire la source de données et le format d'affichage.

  • Taille de la colonne
    Il s'agit d'un attribut “visuel”, par conséquent les colonnes sont simplement numérotées de gauche à droite, comme illustré ci-dessous :

La méthode suivante affecte une taille automatique à toutes les colonnes d'un état en tableau croisé et laisse les autres éléments inchangés :

 For($i;1;3)
    QR GET INFO COLUMN(qr_zone;$i;$titre;$obj;$caché;$taille;$rep;$format)
    QR SET INFO COLUMN(qr_zone;$i;$titre;$obj;$caché;0;$rep;$format)
 End for

  • Source de données (objet) et format d'affichage
    Dans ce cas, la numérotation des colonnes s'effectue de la manière suivante :

Si un numéro de zone invalide est passé, l’erreur -9850 est générée.
Si le paramètre numColonne est incorrect, l’erreur -9852 est générée.

Exemple  

Vous avez construit l'état suivant :

Vous pouvez écrire :

 C_TEXT($vTitle;$vObject;$vDisplayFormat;$vResultVar)
 C_LONGINT($area;$vHide;$vSize;$vRepeatedValue)
 QR GET INFO COLUMN($area;3;$vTitle;$vObject;$vHide;$vSize;$vRepeatedValue;$vDisplayFormat;$vResultVar)
  //$vTitle = "Age"
  //$vObject = "[Personnes]Date_Naissance-Date du jour" ou
  // "[Personnes]Date_Naissance-Current date" selon vos préférences de langage
  //$vHide = 0
  //$vSize = 57
  //$vRepeatedValue = 1
  //$vDisplayFormat = ""
  //$vResultVar = "C1"



Voir aussi  

QR Get info row
QR SET INFO COLUMN
QR SET INFO ROW

 
PROPRIÉTÉS 

Produit : 4D
Thème : Etats rapides
Numéro : 766

Cette commande modifie la variable système Error

 
HISTORIQUE 

Créé : 4D 2003
Modifié : 4D v15 R3

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)