Les propriétés de l'objet LISTE

Valeur de l'abscisse de la position de l'objet relativement à la surface de la fenêtre, de la page ou de la vue.

Le point de référence est celui situé le plus en haut à gauche de l'objet.

Définit l'ajustement d'un objet positionné dans une vue d'un objet barre de division lorsque l'utilisateur déplace la barre horizontale située au-dessous de l'objet, ou lorsqu'il redimensionne la fenêtre en bas et que la barre de division s'étire (propriété AJUSTEMENT_VERTICAL égale à _BARD_AJUST_ETIRER_HAUTEUR) et que l'objet appartient à une des vues situées les plus en bas.

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

Définit l'ajustement d'un objet positionné dans une vue d'un objet barre de division lorsque l'utilisateur déplace la barre verticale située à droite de l'objet, ou lorsqu'il redimensionne la fenêtre à droite et que la barre de division s'étire (propriété AJUSTEMENT_HORIZONTAL égale à _BARD_AJUST_ETIRER_LARGEUR) et que l'objet appartient à une des vues situées les plus à droite.

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

Définit l'ajustement d'un objet positionné dans une vue d'un objet barre de division lorsque l'utilisateur déplace la barre verticale située à gauche de l'objet, ou lorsqu'il redimensionne la fenêtre à gauche et que la barre de division s'étire (propriété AJUSTEMENT_HORIZONTAL égale à _BARD_AJUST_ETIRER_LARGEUR) et que l'objet appartient à une des vues situées les plus à droite.

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

Définit l'ajustement d'un objet positionné dans une vue d'un objet barre de division lorsque l'utilisateur déplace la barre horizontale située au-dessus de l'objet, ou lorsqu'il redimensionne la fenêtre en haut et que la barre de division s'étire (propriété AJUSTEMENT_VERTICAL égale à _BARD_AJUST_ETIRER_HAUTEUR) et que l'objet appartient à une des vues situées les plus en bas.

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

Autorise la prise de focus de l'objet. Un objet prenant le focus est réceptif aux actions qu'effectue l'utilisateur au clavier et à la souris.

Définit la manière dont le contrôle graphique est ajusté lorsqu'on élargit la fenêtre.

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

Définit la manière dont le contrôle graphique est ajusté lorsqu'on agrandit la fenêtre.

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

Autorise la prise de focus de l'objet via le clavier (touche TAB ou MAJ+TAB).

Gère l'affichage des barres d'ascenseurs horizontales et verticales.
Si la propriété a la valeur *FAUX, alors l'affichage des barres dépend de la valeur de la propriété ASCENSEURS_FIXES. Sinon, elles sont toujours cachées même lorsque le nombre de colonnes dépasse la largeur de la liste ou le nombre de lignes dépasse la hauteur de la liste.

Remarque : cette propriété n'est pas mise en oeuvre en génération Mobile et Java.

Gère l'affichage des barres d'ascenseurs horizontales et verticales.
Si la propriété a la valeur *VRAI, alors les barres d'ascenseurs sont toujours visibles. Sinon, elles sont visibles seulement lorsque cela est nécessaire (c'est-à-dire lorsque le nombre de colonnes dépasse la largeur de la liste ou le nombre de lignes dépasse la hauteur de la liste).

Remarque : cette propriété n'est pas mise en oeuvre en génération Mobile.

Dessine un cadre autour de l'objet.

Remarque : cette propriété n'est prise en compte que par Adélia Cloud.

Définit le comportement du Ctrl+C (Copier) et des Ctrl+X et Maj+Suppr (Couper) pour les lignes sélectionnées. Si la propriété est à vrai, seules les valeurs des colonnes visibles sont copiées dans le presse-papiers, sinon ce sont toutes les colonnes.

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

Définit la couleur RVB du fond de l'objet.

Couleur RVB du dessin de l'arrière plan de la ligne sélectionnée.

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

Définit la couleur RVB du trait d'affichage des lignes constituant la grille.

Remarque : cette propriété n'est pas mise en oeuvre en génération Mobile.

Couleur RVB du dessin du texte de la ligne sélectionnée.

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

Spécifie le premier objet d'un groupe d'objets. Un groupe d'objets est défini par son premier objet ainsi que tous les autres objets (suivant l'ordonnancement des objets) jusqu'au premier objet d'un autre groupe. L'utilisateur peut changer le focus d'un objet à un autre, à l'intérieur d'un groupe, en utilisant les touches de direction.

Permet ou non à l'utilisateur de modifier l'ordre des colonnes, en cliquant sur un en-tête et en le relâchant à l'endroit voulu.

Remarques :

- Le fait que cette propriété possède la valeur *FAUX n'empêche pas l'utilisation de la méthode FIXER_NUMERO_ORDRE de l'objet COLONNE.

- Il est possible d'empêcher le déplacement d'une colonne donnée à une position donnée tout en permettant le déplacement des autres colonnes.

- Le fonctionnement du déplacement de colonnes prend en compte l'existence de colonnes invisibles. Il est donc possible de déposer une colonne à ce qui semble être sa position de départ, lorsque la colonne déplacée est contiguë à une colonne invisible.

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

Définit le mode de déplacement utilisé pour passer de la ligne/colonne courante à la ligne/colonne suivante.

Cette propriété est mise à jour par le déclenchement de l'événement ChangementLigneColonne.

Permet de différencier les lignes de rang pair des lignes de rang impair par une couleur de texte (propriétés LIGNE_PAIRE_COUL_TXT et LIGNE_IMPAIRE_COUL_TXT) et de fond (propriétés LIGNE_PAIRE_COUL_FOND et LIGNE_IMPAIRE_COUL_FOND) distinctes.

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Définit la couleur RVB de l'ombre claire de l'en-tête de l'objet (bords gauche et supérieur de l'en-tête).

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Définit la couleur RVB de l'ombre foncée de l'en-tête de l'objet (bords droit et inférieur de l'en-tête).

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Définit la couleur RVB du fond de l'en-tête de l'objet.

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Définit la couleur RVB du texte de l'en-tête de l'objet.

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Définit si le rafraîchissement de la liste graphique se fait après chaque opération sur la liste.
Si ETAT_RAFRAICHISSEMENT a pour valeur *VRAI, la liste est rafraîchie après chaque opération ; sinon la liste n'est pas rafraîchie.
La valeur de la propriété est modifiée par l'utilisation de la méthode RAFRAICHIR_LISTE.

Indique si l'objet peut être la cible d'une opération de glisser-déposer.

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Valeur de la hauteur de l'objet.

Valeur de la hauteur de toutes les colonnes de la liste.

Remarque : cette propriété n'est pas mise en oeuvre en génération Mobile.

Hauteur de la prochaine ligne créée ou modifiée.

Si la propriété a la valeur zéro, la hauteur de la ligne s'ajuste aux polices définies au niveau des colonnes.

Remarque : cette propriété n'est pas mise en oeuvre en génération Mobile et Java.

Autorise l'apparition d'infobulles sur les en-têtes de colonne, sur les éléments de l'objet et sur les indicateurs de note.

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

Permet d'afficher ou pas une infobulle lors du déplacement de la barre de défilement de l'ascenseur horizontal. Le texte de l'infobulle indique le numéro de la première colonne visible de la liste. Par défaut, le texte est "colonne n" ; il est possible de le modifier en renommant le fichier OBJECTSV.SAV dans le répertoire ADELIWS en OBJECTSV.INI et en modifiant la valeur de la clé TOOLTIP_SCROLLBAR_H de la section CONTAINR.

Attention : La valeur de la clé doit absolument contenir la chaîne "%d" (qui recevra le nombre de lignes) et ne doit pas contenir de caractère "%" supplémentaire.

Remarque : cette propriété n'est mise en œuvre ni en génération Mobile, ni en génération Java, ni en génération Cloud.

Permet d'afficher ou pas une infobulle lors du déplacement de la barre de défilement de l'ascenseur vertical. Le texte de l'infobulle indique le numéro de la première ligne visible de la liste. Par défaut, le texte est "ligne n" ; il est possible de le modifier en renommant le fichier OBJECTSV.SAV dans le répertoire ADELIWS en OBJECTSV.INI et en modifiant la valeur de la clé TOOLTIP_SCROLLBAR_V de la section CONTAINR.

Attention : La valeur de la clé doit absolument contenir la chaîne "%d" (qui recevra le nombre de lignes) et ne doit pas contenir de caractère "%" supplémentaire.

Remarque : cette propriété n'est mise en œuvre ni en génération Mobile, ni en génération Java, ni en génération Cloud.

Définit la couleur du fond des infobulles associées aux en-têtes de colonne, aux éléments de l'objet et aux indicateurs de note.

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

Définit la couleur du texte des infobulles associées aux en-têtes de colonne, aux éléments de l'objet et aux indicateurs de note.

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

Durée (en ms) qui s'écoule entre l'instant où le pointeur souris s'immobilise au-dessus d'un en-tête de colonne ou d'une cellule et l'instant où l'infobulle apparaît.

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

Police de caractères utilisée pour afficher le texte des infobulles associées aux en-têtes de colonne, aux éléments de l'objet et aux indicateurs de note.

Le format de la chaîne de caractères contient dans l'ordre le nom, la taille, le style et le script. Un point-virgule doit séparer chaque information.

Lorsque l'utilisateur fixe la valeur de la propriété, le nom et la taille sont obligatoires.

Les différents styles sont donnés par les valeurs suivantes :

1 : Normal (pas de style particulier)

2 : Barré

16 : Italique

256 : Gras

4096 : Souligné

La valeur de style à indiquer dans la chaîne de caractères peut donc être l'une des valeurs ci-dessus, ainsi que la somme de valeurs différentes de 1.

Les différentes valeurs de script sont les suivantes :

Remarques :

La taille, le style et le script doivent être compatibles avec la police choisie. La boîte de dialogue système Windows de choix de police, accessible par les pages de propriétés de l'objet graphique, peut guider dans le choix de valeurs cohérentes.

La propriété Police n'est disponible ni en génération Mobile ni en génération Java.

Valeur de la largeur de l'objet.

Définit la couleur RVB du fond des éléments constituant les lignes impaires de la liste.

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Définit la couleur RVB du texte des éléments constituant les lignes impaires de la liste.

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Définit la couleur RVB du fond des éléments constituant les lignes paires de la liste.

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Définit la couleur RVB du texte des éléments constituant les lignes paires de la liste.

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Indique si la ligne est visible ou pas.

Liste des éléments de l'objet.

Rend actif ou non le mode de pagination avant automatique.

Si cette propriété a la valeur *VRAI et que les ascenseurs horizontal et vertical de la liste sont visibles, un bouton poussoir est rendu visible dans l'angle en bas à droite de l'objet liste.

Trois états (représentés par trois images) sont disponibles sur ce bouton :

• La liste est totalement chargée (la propriété PAG_DYN_AVANT est égale à *FAUX). Un clic sur le bouton n'a aucun effet.
• la liste n'est pas totalement chargée (la propriété PAG_DYN_AVANT est égale à *VRAI). Un clic sur le bouton déclenche automatiquement n fois l'exécution du code Visual associé à l'événement PaginationDynamiqueAvant (la valeur n correspondant à la valeur de la propriété NB_PAG_DYN_AV_AUTO). Durant cette exécution, l'image associée au bouton change. Elle devient . A la fin de l'exécution, si la liste est totalement chargée, l'image passe à , sinon elle redevient .
• la liste est en cours de chargement. Un clic sur le bouton arrête le chargement, l'image du bouton repasse à .

Remarque :

La modification par programme de la propriété PAG_DYN_AVANT modifie l'état et donc l'image du bouton. Si la propriété PAG_DYN_AVANT est égale à vrai, l'image du bouton est sinon l'image est .

Une infobulle rappelle l'état du bouton. Il est possible de changer le texte correspondant à chaque état en renommant le fichier OBJECTSV.SAV dans le répertoire ADELIWS en OBJECTSV.INI et en modifiant la valeur des clés BTN_START_LOAD, BTN_ALL_LOADED, BTN_LOADING de la section CONTAINR.

Attention : La valeur de la clé doit absolument contenir la chaîne "%d" (qui recevra le nombre de lignes) et ne doit pas contenir de caractère "%" supplémentaire.

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

Définit le mode de sélection des cellules constituant les lignes de l'objet.

Permet de n'avoir qu'une ligne sélectionnée dans la liste.

Fournit le nombre de lignes sélectionnées dans la liste.

Remarque : si la liste est en mode sélection cellule, la valeur rendue vaut 0.

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Fixe le nombre de fois où le code associé à l'événement PaginationDynamiqueAvant est exécuté lorsque la liste se trouve dans le mode de pagination avant automatique (c'est-à-dire quand la propriété MODE_PAGINATION_AV_AUTO est égale à *VRAI).

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

Nom statique de l'objet.

Numéro de la dernière colonne active (colonne associée à l'élément ayant le focus).

Retourne le numéro de colonne sur laquelle se trouve le curseur de la souris au moment des événements souris de l'objet LISTE ou COLONNE.

Numéro de la prochaine colonne active (colonne associée à l'élément ayant le focus). Cette propriété est mise à jour par le déclenchement de l'événement ChangementLigneColonne.

Rang de la dernière ligne active (ligne ayant le focus).

Retourne le numéro de ligne sur laquelle se trouve le curseur de la souris au moment des événements souris de l'objet LISTE ou COLONNE.

Rang de la prochaine ligne active (ligne ayant le focus). Cette propriété est mise à jour par le déclenchement de l'événement ChangementLigneColonne.

Valeur de l'ordonnée de la position de l'objet relativement à la surface de la fenêtre, de la page ou de la vue.

Le point de référence est celui situé le plus en haut à gauche de l'objet.

Autorise le déclenchement de l'événement PaginationDynamiqueArriere.

Autorise le déclenchement de l'événement PaginationDynamiqueAvant.

Indique le nombre estimé de lignes visibles dans une liste graphique. Cette valeur est estimée à partir de la hauteur de la liste et de la hauteur de la ligne qui sera ajoutée ultérieurement à la liste. La valeur est calculée à l'aide des valeurs des propriétés POLICE des colonnes.

Numéro de la première colonne visible de l'objet. Les numéros de colonne commencent à 1.

Lorsque l'on veut fixer comme première colonne visible une colonne dont la propriété VISIBILITE vaut *FAUX, c'est la première colonne suivante dont la propriété VISIBILITE vaut *VRAI qui devient la première colonne visible. Si aucune colonne suivante ne possède la propriété VISIBILITE égale à *VRAI, aucune colonne n'est montrée dans la liste.

Remarque : cette propriété n'est pas mise en oeuvre en génération Java.

Numéro de la première ligne visible de l'objet. Les numéros de ligne commencent à 1.

Autorise la modification de la largeur des objets colonne en utilisant la souris.

Mode de saisie des caractères dans l'élément ayant le focus. Si cette propriété a pour valeur *VRAI, le texte saisi remplace le texte existant ; sinon, le texte saisi est concaténé à droite du texte existant.

Mode d'entrée en saisie sur l'élément ayant le focus. Si cette propriété a pour valeur *VRAI, le Caret (curseur clignotant au point d'insertion) est visible dans l'élément ayant le focus ; sinon, le Caret est invisible et ne devient visible que lorsque l'utilisateur saisit du texte.

Autorise l'objet à se dessiner par-dessus un contrôle qui se trouve devant lui dans l'ordonnancement des objets de la fenêtre.

Dans le cas particulier où il y a une image de fond sur la fenêtre avec des objets transparents placés en avant plan, il est nécessaire de fixer la propriété à *VRAI si l'on souhaite positionner l'objet après un objet "transparent" dans l'ordre de tabulation.

Rappel : un objet "superposé" doit être placé après l'image de fond, tandis qu'un objet "non superposé" doit être placé avant l'image de fond.

Pour plus d'informations sur la gestion de la superposition des objets graphiques consulter la rubrique Gestion de la superposition des objets.

Remarque : cette propriété n'est pas mise en oeuvre en génération Mobile et Java.

Définit le style du trait d'affichage des lignes constituant la grille.

Remarque : cette propriété n'est pas mise en oeuvre en génération Mobile.

Permet de rendre le fond transparent pour :

• • la liste,
  • les lignes (sauf si des couleurs pour les lignes paires et impaires sont spécifiées) et
  • les cellules (sauf si la couleur de la colonne est spécifiée).

Remarque : cette propriété n'est prise en compte que par Adélia Cloud

Permet l'exécution d'un tri automatique lorsque l'utilisateur clique sur un en-tête de colonne. La liste est triée en fonction des valeurs de la colonne, alternativement selon un ordre ascendant et descendant. Un indicateur de tri peut être dessiné dans l'en-tête pour indiquer le sens du tri.

Il est possible de désactiver le tri au niveau d'une colonne donnée (propriété INDICATEUR_TRI de l'objet COLONNE). Dans ce cas, aucun tri n'est effectué lors du clic sur l'en-tête correspondant.

Remarques :

• • La propriété TRI_EN_TETE permet l'exécution d'un tri, mais ne l'effectue pas.
  • Si sa valeur est mise à _LST_TRI_AUCUN, le tri est désactivé sur toutes les colonnes (la propriété INDICATEUR_TRI des colonnes est mise à _COL_INDIC_TRI_DESACTIVE).

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

Définit l'affichage des lignes constituant la grille.

Visibilité de l'objet.

• 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)