Les méthodes de l'objet LISTE

Ajoute une image à la fin de la liste d'images de l'objet.

Les images possèdent un numéro implicite qui correspond à leur position dans la liste, la première image ayant le numéro 1.

Remarque : Pour insérer une image dans la liste graphique, l'utilisateur doit fixer le type Image pour la propriété Type Adélia de l'objet colonne et affecter à la propriété Valeur le numéro de l'image qu'il souhaite afficher.

Remarque : cette méthode n'est pas mise en oeuvre par le générateur Java.

Ajoute une image à la fin de la liste d'images de l'objet.

Les images possèdent un numéro implicite qui correspond à leur position dans la liste, la première image ayant le numéro 1.

Remarque : Pour insérer une image dans la liste graphique, l'utilisateur doit fixer le type Image pour la propriété Type Adélia de l'objet colonne et affecter à la propriété Valeur le numéro de l'image qu'il souhaite afficher.

Remarque : cette méthode n'est pas mise en oeuvre par le générateur Mobile.

Ajoute une image à la fin de la liste d'images de l'objet.

Les images possèdent un numéro implicite qui correspond à leur position dans la liste, la première image ayant le numéro 1.

Remarque : Pour insérer une image dans la liste graphique, l'utilisateur doit fixer le type Image pour la propriété Type Adélia de l'objet colonne et affecter à la propriété Valeur le numéro de l'image qu'il souhaite afficher.

Remarque : cette méthode n'est mise en oeuvre ni par le générateur Java, ni par le générateur Mobile.

Efface les indicateurs de tri des en-têtes de colonne de la liste et fixe la propriété INDICATEUR_TRI des colonnes permettant un tri à _COL_INDIC_TRI_AUTORISE.

Remarque : cette méthode n'est mise en oeuvre ni en génération Java ni en génération Mobile.

Rend visible toutes les lignes de la liste et exécute les filtres automatiques définis sur toutes les colonnes.

Cette méthode est utile dans une liste où à la fois des filtres manuels et automatiques ont été définis. Dans ce cas l'utilisateur peut, dans l'événement ACTION_FILTRE des colonnes définies avec un filtre manuel, exécuter tous les filtres automatiques avant d'exécuter son filtre personnalisé.

Attention : après l'exécution de la méthode, l'événement AprèsFiltreAuto est déclenché.

Remarque : cette méthode n'est mise en œuvre ni en génération Java ni en génération Mobile.

Permet d'exporter le contenu de la liste graphique vers un fichier ASCII délimité (fichier texte ou ".csv") ou vers un fichier Excel formaté. Dans le dernier cas, une grande partie des propriétés de l'objet sont reprises dans l'exportation.

Seules les colonnes visibles de la liste sont exportées.

Remarque :

En génération client Windows, s'il existe une configuration Middleware utilisant le serveur logique *DOC_SERVER associé à un Daemon Middleware Java, la méthode se comporte de la même façon qu'en génération Cloud, comme indiqué ci-dessous.

En revanche, si la configuration de *DOC_SERVER n'est pas active, les types de données ne sont pas conservés et les cellules Excel ont toutes le format texte.

Note pour la génération Client Windows avec configuration *DOC_SERVER ou Client Cloud :

En fonction de l'extension du fichier (.xls ou .xlsx) renseigné dans la méthode, le fichier produit sera au format XLS ou XLSX.

Les types de données numériques et dates sont conservés lors de l'export. Cela implique un certain nombre de limitations :

• • Les données DATE et TIMESTAMP de valeur antérieure au 1er janvier 1900 ne peuvent pas être représentées et apparaissent en erreur dans Excel.
  • Excel est limité à 15 chiffres significatifs pour les types numériques. Les données numériques d'une précision supérieure dans Adélia (NUM_BIN_8, NUM_E de grande précision) pourront être arrondies.
  • Il n'est pas possible de masquer le séparateur décimal. Celui-ci sera forcé quel que soit le code d'édition ou le mot d'édition donné. Le code d'édition Z, notamment, sera affiché comme le code d'édition 4 dans le fichier Excel, et l'affichage du code d'édition Y sera incorrect si le type de données contient des décimales.
  • Les positions des caractères de séparateur décimal et de séparateur de milliers ("." et ",") doivent être consistantes dans un mot d'édition. Si elles le sont, les séparateurs seront affichés correctement dans le format Excel généré, sinon ils seront assimilés à des caractères standard dans le format généré. Dans tous les cas, pour les caractères numériques à décimales, le séparateur décimal sera affiché.
  • Dans un mot d'édition Adélia, les caractères non numériques situés à gauche du premier chiffre affiché ne sont pas visibles. Dans le format Excel, ils le seront de façon systématique.

Fige un ou plusieurs objets COLONNE. Une colonne figée est une colonne insensible aux actions sur la barre de défilement horizontale. Les colonnes figées sont consécutives à partir du côté gauche de l'objet.

Remarque : cette méthode n'est pas mise en oeuvre par le générateur Java.

Permet de faire passer l'objet du mode sélection (ligne ou cellule) au mode saisie, et inversement. Le mode choisi peut être figé (l'utilisateur ne peut plus passer d'un mode à l'autre via l'interface).

Fixe les propriétés modifiables des cellules qui constituent la ligne dont le numéro est indiqué dans NumLigne .

Les propriétés mises à jour sont : ALIGNEMENT, COULEUR_FOND, COULEUR_TEXTE, INVERSION_IMAGE, LECTURE_SEULE, POLICE et VALEUR.

Permet de définir les touches du clavier pour lesquelles on souhaite récupérer l'état (enfoncé/non enfoncé) au moment de l'événement "MouvementSouris" de la liste.

Cette méthode doit être utilisée avant l'appel de la méthode RECUPERER_TOUCHES_EVT_SOURIS du même objet.

La longueur du tableau TabAutresTouches doit être au moins égale à la taille indiquée.

Si le tableau TabAlphaNum est vide, les touches A->Z et 0->9 du clavier ne seront pas testées lors du prochain appel à la méthode RECUPERER_TOUCHES_EVT_SOURIS.

De même, si la valeur du paramètre TailleTabAutresTouches est égale à 0, alors les touches "autres" ne seront pas testées lors du prochain appel à la méthode RECUPERER_TOUCHES_EVT_SOURIS.

Remarque : cette méthode n'est mise en œuvre ni en génération Java ni en génération Mobile.

Fixe la valeur des cellules qui constituent la ligne dont le numéro est indiqué dans NumLigne par la propriété VALEUR des objets COLONNE constituant la liste. La ligne de la liste sera elle aussi passée à l'état Modifié.

Cette méthode indique si des données d'un format spécifié sont disponibles parmi les données concernées par l'opération de glisser-déposer en cours. Le format est un format prédéfini sous Windows, ou peut être un format défini par le développeur.

Remarques :

Cette méthode n'est pas mise en oeuvre par le générateur Java.

Elle n'est pas disponible en génération Mobile.

Cette méthode ajoute des données (le contenu des variables Adélia) aux données qui seront transmises par une opération de glisser-déposer. Ces informations sont stockées dans l'objet jusqu'à la fin de l'opération de glisser-déposer, puis sont effacées automatiquement.

Remarques :

• • L'appel de cette méthode avec un tableau de n éléments est équivalent à n appels de cette méthode avec une variable contenant les éléments du tableau.
  • Aucune distinction n'est faite entre les types numériques étendu et condensé.

Remarques :

Cette méthode n'est pas mise en oeuvre par le générateur Java.

Elle n'est pas disponible en génération Mobile.

Cette méthode provoque le début d'une opération de glisser-déposer entre un objet source et un objet cible avec les données stockées dans l'objet source par la méthode GD_ECRIRE_DONNEES.

Les données concernées peuvent être soit copiées, soit déplacées dans l'objet cible.

L'ensemble de ces données est identifié par un nom de format. Le format est un format prédéfini sous Windows, ou peut être un format défini par le développeur.

Remarque : dans le cas de l'utilisation d'un format prédéfini, seule la première donnée écrite par la méthode GD_ECRIRE_DONNEES est prise en compte.

Remarques :

Cette méthode n'est pas mise en oeuvre par le générateur Java.

Elle n'est pas disponible en génération Mobile.

Cette méthode permet de lire les données qui sont transmises dans l'opération de glisser-déposer en cours. Ces données sont une copie des données écrites dans l'objet source par la méthode GD_ECRIRE_DONNEES.

Cette méthode doit être utilisée en boucle pour parcourir toutes les données d'un type Adélia donné.

Toutes les données d'un type sont lues lorsque le nombre de données lues est strictement inférieur au nombre de données à lire.

Remarques :

• • • L'appel de cette méthode avec un tableau Adélia de n éléments est équivalent à n appels de cette méthode avec une variable Adélia.

    • Si la méthode GD_ECRIRE_DONNEES a été utilisée pour écrire n enregistrements dont chacun contient deux variables de type ALPHA, la méthode GD_LIRE_DONNEES doit être utilisée deux fois avec les indices (2n - 1) et 2n pour récupérer les chaînes du énième enregistrement, ou une fois avec l'indice (2n-1) et un tableau recevant 2 données.

    • Aucune distinction n'est faite entre les variables de type numérique étendu et condensé, quels que soient la longueur et le nombre de décimales. Les valeurs des variables de type numérique ou étendu peuvent donc être tronquées lors de la lecture. Quant aux chaînes, la lecture échoue si la taille de la variable Adélia est insuffisante pour contenir la chaîne lue.

Remarques :

Cette méthode n'est pas mise en oeuvre par le générateur Java.

Elle n'est pas disponible en génération Mobile.

Cette méthode efface les données stockées dans l'objet qui seraient utilisées dans une opération de glisser-déposer.

Ces données ont été créées auparavant par la méthode GD_ECRIRE_DONNEES.

Remarques :

Cette méthode n'est pas mise en oeuvre par le générateur Java.

Elle n'est pas disponible en génération Mobile.

Positionne le champ filtre à "*" et remet à blanc la propriété VALEUR_INTERNE_FILTRE pour toutes les colonnes de la liste.

Met le focus sur l'objet.

Autorise l'objet à effectuer les traitements internes nécessaires lors de la mise à jour d'une propriété ou l'appel d'une méthode de l'objet LISTE ou de l'objet COLONNE.

L'utilisateur peut empêcher le traitement interne de s'effectuer autant de fois qu'il y a de propriétés à mettre à jour en plaçant les instructions entre deux appels à cette méthode. Le traitement ne s'effectuera alors qu'une seule fois.

Les propriétés de l'objet COLONNE concernées sont :

LARGEUR

VISIBILITE

EN_TETE_POLICE

FILTRE

TEXTE

ALIGNEMENT

INDICATEUR_TRI

Les propriétés de l'objet LISTE concernées sont :

ABSCISSE

ORDONNEE

LARGEUR

HAUTEUR_ENTETE

PAG_DYN_AVANT et PAG_DYN_ARRIERE si au moins une colonne a la propriété FILTRE égale à _COL_FILTRE_AUTOMATIQUE_LISTE_COMPLETE

Les méthodes de l'objet COLONNE concernées sont :

FIXER_NUMERO_ORDRE

INITIALISER_CHAMP_FILTRE

Remarque : le déplacement d'une colonne via l'interface entraîne également un rafraîchissement des colonnes.

La méthode de l'objet LISTE concernée est :

INITIALISER_CHAMPS_FILTRES

Remarque : cette méthode n'est mise en oeuvre ni par le générateur Java, ni par le générateur Mobile.

Autorise l'objet à se redessiner. L'utilisateur peut ainsi figer l'affichage de l'objet entre deux appels à cette méthode.

Remarque : cette méthode n'est pas mise en oeuvre par le générateur Java.

Récupère dans un tableau le nom des colonnes de la liste graphique.

Le tableau est trié selon l'ordre des colonnes de la liste graphique.

Remarques :
La longueur du tableau TableauNomColonnes doit être au moins égale à la taille indiquée.
S'il y a plus de colonnes que la taille indiquée, le code retour aura la valeur -1 mais le tableau sera bien rempli.

Exemple d'utilisation : Les noms d'objets récupérés peuvent être utilisés par la fonction prédéfinie &RECUPERER_OBJET afin de manipuler les propriétés des objets.

Remarque : cette méthode n'est pas mise en oeuvre en génération Java.

Récupère le nombre d'objets COLONNE figés lors d'un appel à la méthode FIXER_COLONNES_FIGEES.

Remarque : cette méthode n'est pas mise en oeuvre par le générateur Java.

Remarque : cette méthode n'est pas mise en oeuvre par le générateur Java.

Récupère le numéro de ligne et de colonne de la cellule qui se trouve à la position donnée au moment de l'appel de cette méthode. La position est un couple de valeurs en pixels relative au coin supérieur gauche de la liste.

Si la position correspond à une cellule ou à un en-tête, le booléen CelluleTrouvee est à *VRAI.

Si la position correspond à un point situé sur le bord ou sur le fond de la liste, le booléen est à *FAUX.

Retourne la hauteur de la ligne passée en paramètre.

Retourne le mode courant (sélection ou saisie) de l'objet ainsi que son état.

Récupère les propriétés des objets COLONNE constituant la liste avec les valeurs des propriétés de la ligne dont le numéro est indiqué dans NumLigne .

Les propriétés de l'objet COLONNE mises à jour sont : ALIGNEMENT, COULEUR_FOND, COULEUR_TEXTE, INVERSION_IMAGE, LECTURE_SEULE, VALEUR et POLICE.

Permet de récupérer les touches du clavier qui ont été définies lors du précédent appel à la méthode FIXER_TOUCHE_EVT_SOURIS et qui étaient dans l'état "enfoncé" lors du dernier événement 'MouvementSouris' sur l'objet Liste.

La longueur du tableau TabAutresTouches doit être au moins égale à la taille indiquée.

La valeur des paramètres EtatToucheMaj et EtatToucheCtr est fixée à *Vrai lorsque respectivement les touches Maj gauche ou droite et Ctrl gauche ou droite sont dans l'état "enfoncé".

Il est possible de différencier les touches gauche et droite en utilisant les valeurs _LST_TOUCHE_CLAVIER_MAJ_G et _LST_TOUCHE_CLAVIER_MAJ_D pour la touche Maj et _LST_TOUCHE_CLAVIER_CTRL_G et _LST_TOUCHE_CLAVIER_CTRL_D pour la touche Ctrl dans le paramètre TabAutresTouches.

Si la touche Alt Gr est dans l'état "enfoncé", la valeur des paramètres EtatToucheAlt et EtatToucheCtr est fixée à *Vrai.

Remarque : cette méthode n'est mise en œuvre ni en génération Java ni en génération Mobile.

Récupère la propriété VALEUR des objets COLONNE constituant la liste avec les valeurs de la ligne dont le numéro est indiqué dans NumLigne .

Supprime une image dans la liste d'images de l'objet.

Remarque : cette méthode n'est pas mise en oeuvre par le générateur Java.

• Page:
  Les méthodes de l'objet LISTE
• Page:
  Les propriétés de l'objet LISTE
• Page:
  Les propriétés liées aux événements de l'objet LISTE
• Page:
  Les événements de l'objet LISTE
• Page:
  LISTE (Contexte Visual Adélia)