QR LIRE INFO COLONNE

4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant

version 2003


QR LIRE INFO COLONNE (zone; numCol; titre; objet; cachée; taille; valeursRépétées; format)

ParamètreTypeDescription
zoneEntier longRéférence de la zone
numColEntier longNuméro de colonne
titreAlphaTitre de la colonne
objetChamp | VariableObjet affecté à la colonne
cachéeEntier long0 = visible, 1 = invisible
tailleEntier longLargeur de la colonne
valeursRépétéesEntier long0 = non répétées, 1 = répétées
formatTexteFormat d'affichage des données

Description

Etats en liste

La commande QR LIRE INFO COLONNE 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 la référence de l'objet associé à la colonne (variable, champ ou formule).

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.

si valeursRépétées vaut 0, les valeurs ne sont pas répétées.

si valeursRépétées vaut 1, les valeurs sont répétées.

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.

Etats tableaux croisés

Avec ce type d'état, la commande QR LIRE INFO COLONNE 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 :

   Boucle ($i;1;3)
      QR LIRE INFO COLONNE(qr_zone;$i;$titre;$obj;$caché;$taille;$rep;$format)
      QR FIXER INFO COLONNE(qr_zone;$i;$titre;$obj;$caché;0;$rep;$format)
   Fin de boucle 

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.

Référence

QR FIXER INFO COLONNE, QR FIXER INFO LIGNE, QR Lire info ligne.


4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant