F > FListBox (composant)

FListBox (composant)

Le composant ListBox de l'environnement auteur de Flash fournit les fonctions glisser-déposer pour l'ajout de zones de liste à une seule ou plusieurs sélection aux documents Flash, mais aussi une interface utilisateur de définition des paramètres de base. Les méthodes du composant FListBox vous permettent de contrôler les zones de liste à l'exécution : vous pouvez créer des zones de liste, contrôler des zones de liste créées lors de la programmation, définir ou remplacer des paramètres de base, et définir des options supplémentaires à l'exécution. Il n'est pas nécessaire d'utiliser un constructeur pour accéder aux méthodes des composants.

Les méthodes des composants n'effectuant pas de vérification d'erreur pour le type, au contraire des autres objets et actions ActionScript natifs, il est recommandé de valider les paramètres avant de les transmettre aux méthodes.

Le composant ListBox est supporté par Flash Player 6 et les versions suivantes de Flash Player.

Pour plus d'informations sur l'utilisation du composant ListBox, la définition des paramètres au cours de la programmation et le changement de la couleur et de l'apparence des composants, consultez les sections Personnalisation de la couleur et du texte des composants et Personnalisation des enveloppes de composant du chapitre Utilisation des composants de Utilisation de Flash.

 
Méthodes du composant FListBox

Méthode	Description
FListBox.addItem	Ajoute un élément à la fin de la liste.
FListBox.addItemAt	Ajoute un élément à la liste, à l'index spécifié.
FListBox.getEnabled	Renvoie true si la zone de liste est activée, false si elle est désactivée.
FListBox.getItemAt	Renvoie l'étiquette et la valeur de l'élément à l'index spécifié.
FListBox.getLength	Renvoie le nombre d'éléments de la zone de liste.
FListBox.getRowCount	Renvoie le nombre d'éléments visibles dans la zone de liste.
FListBox.getScrollPosition	Renvoie l'index de l'élément affiché en haut de la zone de liste.
FListBox.getSelectedIndex	Renvoie l'index du dernier élément sélectionné.
FListBox.getSelectedIndices	Renvoie les index de plusieurs éléments sélectionnés.
FListBox.getSelectedItem	Renvoie l'étiquette et la valeur de l'élément sélectionné.
FListBox.getSelectedItems	Renvoie l'étiquette et la valeur de plusieurs éléments sélectionnés.
FListBox.getSelectMultiple	Renvoie true si la sélection multiple est autorisée, false si la sélection unique est autorisée.
FListBox.getValue	Renvoie l'étiquette de l'élément sélectionné ou toute information sur les données associées.
FListBox.registerSkinElement	Enregistre un élément d'enveloppe dans une propriété.
FListBox.removeAll	Supprime tous les éléments de la zone de liste.
FListBox.removeItemAt	Supprime l'élément à l'index spécifié.
FListBox.replaceItemAt	Remplace l'étiquette et les données d'un élément à un index spécifié par une nouvelle étiquette et de nouvelles données.
FListBox.setAutoHideScrollBar	Détermine si une barre de défilement est masquée (true) ou affichée (false) lorsque le nombre d'éléments de la zone de liste ne nécessite pas de défilement.
FListBox.setChangeHandler	Affecte une fonction à appeler à chaque fois que la sélection change.
FListBox.setDataProvider	Associe un objet extérieur à la zone de liste.
FListBox.setEnabled	Spécifie si la zone de liste est activée (true) ou désactivée (false).
FListBox.setItemSymbol	Enregistre un identifiant de liaison de symbole pour afficher les éléments de zone de liste.
FListBox.setRowCount	Détermine le nombre d'éléments affichés dans la zone de liste.
FListBox.setScrollPosition	Entraîne le défilement de la liste pour afficher l'élément à l'index spécifié en haut de la liste.
FListBox.setSelectedIndex	Sélectionne l'élément à l'index spécifié et met la zone de liste à jour.
FListBox.setSelectedIndices	Sélectionne les éléments aux index spécifiés et met la zone de liste à jour.
FListBox.setSelectMultiple	Détermine si l'utilisateur peut sélectionner plus d'un élément dans la liste (true) ou non (false).
FListBox.setSize	Définit la largeur et la hauteur de la zone de liste, en pixels.
FListBox.setStyleProperty	Définit une propriété de style pour un composant.
FListBox.setWidth	Définit la largeur de la zone de liste, en pixels.
FListBox.sortItemsBy	Trie les éléments de la zone de liste par ordre alphabétique ou numérique, par étiquette ou par données.