F > FComboBox (composant)

FComboBox (composant)

Le composant ComboBox de l'environnement auteur de Flash fournit les fonctions glisser-déposer pour l'ajout de listes déroulantes à une seule sélection aux documents Flash, mais aussi une interface utilisateur de définition des paramètres de base. Les méthodes du composant FComboBox vous permettent de contrôler les listes déroulantes à l'exécution : vous pouvez créer des listes déroulantes, contrôler des listes déroulantes 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.

Le composant ComboBox crée des listes déroulantes statiques ou modifiables. Une liste statique est une liste déroulante qui permet aux utilisateurs de sélectionner des éléments. Une liste modifiable est une liste déroulante en haut de laquelle se trouve un champ de texte. Vous pouvez permettre aux utilisateurs d'entrer du texte dans le champ de texte pour faire défiler la liste déroulante jusqu'à l'élément désiré, ou utiliser le champ de texte pour définir du texte affiché à l'exécution.

La version statique et la version modifiable du composant ComboBox affichent toutes deux une liste d'éléments de haut en bas en utilisant un système d'indexation basé sur zéro. Si le nombre d'éléments de la liste déroulante crée une liste déroulante qui dépasse l'espace disponible en dessous du composant, la liste s'ouvre vers le haut au lieu de se dérouler vers le bas.

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 ComboBox est supporté par Flash Player 6 et les versions suivantes de Flash Player.

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

 
Méthodes du composant FComboBox

Méthode	Description
FComboBox.addItem	Ajoute un élément à la fin de la liste déroulante.
FComboBox.addItemAt	Ajoute un élément à la liste déroulante, à l'index spécifié.
FComboBox.getEnabled	Renvoie true si la liste déroulante est activée, false si elle est désactivée.
FComboBox.getItemAt	Renvoie l'élément à l'index spécifié sous la forme d'un objet avec les propriétés label et data.
FComboBox.getLength	Renvoie le nombre d'éléments de la liste déroulante.
FComboBox.getRowCount	Renvoie le nombre de lignes visibles dans la liste déroulante.
FComboBox.getScrollPosition	Renvoie l'index de l'élément affiché en haut de la liste déroulante.
FComboBox.getSelectedIndex	Renvoie l'index de l'élément actuellement sélectionné.
FComboBox.getSelectedItem	Renvoie l'objet sélectionné sous la forme d'un objet avec les propriétés label et data.
FComboBox.getValue	Renvoie le texte du champ d'entrée pour les listes déroulantes modifiables ; renvoie l'étiquette ou les données de l'élément sélectionné pour les listes déroulantes statiques.
FComboBox.registerSkinElement	Enregistre un élément d'enveloppe dans une propriété.
FComboBox.removeAll	Supprime tous les éléments de la liste déroulante.
FComboBox.removeItemAt	Supprime l'élément à l'index spécifié.
FComboBox.replaceItemAt	Remplace l'étiquette et les données d'un élément à l'index spécifié.
FComboBox.setChangeHandler	Affecte une fonction à appeler à chaque fois qu'un élément est sélectionné ou que l'utilisateur entre du texte dans le champ de texte.
FComboBox.setDataProvider	Enregistre un objet extérieur au composant en tant que source de données.
FComboBox.setEditable	Détermine si la liste est modifiable (true) ou statique (false).
FComboBox.setEnabled	Spécifie si la liste déroulante est activée (true) ou désactivée (false).
FComboBox.setItemSymbol	Enregistre un identifiant de liaison de symbole pour afficher les éléments de liste déroulante.
FComboBox.setRowCount	Détermine le nombre d'éléments affichés dans la liste déroulante sans barre de défilement.
FComboBox.setSelectedIndex	Sélectionne l'élément à l'index spécifié.
FComboBox.setSize	Définit la largeur de la liste déroulante, en pixels.
FComboBox.setStyleProperty	Définit une propriété de style pour une occurrence de composant.
FComboBox.setValue	Spécifie le texte affiché dans le champ de texte en haut d'une liste déroulante.
FComboBox.sortItemsBy	Trie les éléments de la zone de liste par ordre alphabétique ou numérique, par étiquette ou par données.