Flash CS4 Professional ActionScript 2.0

Composant List

Le composant List est une zone de liste défilante à sélection unique ou multiple. Les listes peuvent également contenir des graphiques et d'autres composants. L'ajout des éléments affichés dans la zone de liste s'effectue via la boîte de dialogue Valeurs qui s'ouvre lorsque vous cliquez dans les champs de paramètres des étiquettes ou des données. Vous pouvez également utiliser les méthodes List.addItem() et List.addItemAt() pour ajouter des éléments à la liste.

REMARQUE

 

Un composant List est pris en charge pour ActionScript 2.0 et ActionScript 3.0.
Ce document présente le composant de la version 2. Si vous utilisez celui de la version 3, reportez-vous à « Utilisation du composant List » dans Utilisation des composants ActionScript 3.0.

Le composant List utilise un index basé sur zéro, où l'élément possédant l'index 0 est le premier affiché. Lorsque vous ajoutez, supprimez ou remplacez les éléments d'une liste au moyen des méthodes et des propriétés de la classe List, il peut s'avérer nécessaire d'indiquer leur index.

La liste reçoit le focus lorsque l'utilisateur clique sur son entrée ou appuie sur la touche de tabulation pour y accéder. Les touches suivantes permettent de la contrôler :

Touche

Description

Touches alphanumériques

Passe à l'élément suivant dont Key.getAscii() est le premier caractère de l'étiquette.

Ctrl

Bouton bascule autorisant plusieurs sélections et désélections non contiguës.

Flèche vers le bas

Déplace la sélection d'un élément vers le bas.

Origine

Déplace la sélection jusqu'au sommet de la liste.

Pg. Suiv.

Déplace la sélection sur la page suivante.

Pg. Préc.

Déplace la sélection sur la page précédente.

Maj

Permet une sélection contiguë.

Flèche vers le haut

Déplace la sélection d'un élément vers le haut.

REMARQUE

 

La taille de page utilisée par les touches Page précédente et Page suivante correspond au nombre d'éléments contenus dans l'affichage, moins un. Par exemple, le passage à la page suivante dans une liste déroulante à dix lignes affiche les éléments 0-9, 9-18,
18-27, etc., avec un élément commun par page.

Pour plus d'informations sur le contrôle du focus, reportez-vous à Classe FocusManager ou à Création de la navigation personnalisée du focus dans Utilisation des composants ActionScript 2.0.

L'aperçu en direct de chaque occurrence de List sur la scène reflète les modifications apportées aux paramètres dans l'inspecteur Propriétés ou des composants au cours de la programmation.

Lorsque vous ajoutez le composant List à une application, vous pouvez utiliser le panneau Accessibilité pour le rendre accessible aux lecteurs d'écran. Commencez par ajouter la ligne de code suivante pour activer l'accessibilité :

mx.accessibility.ListAccImpl.enableAccessibility();

Quel que soit le nombre d'occurrences d'un composant, l'activation de son accessibilité ne se fait qu'une fois. Pour plus d'informations, reportez-vous à Création de contenu accessible dans Utilisation de Flash.

Rubriques connexes