Flex - DropDownList Control



The DropDownList control contains a drop-down list from which the user can select a single value similar to that of the SELECT form element in HTML.

Class declaration

Following is the declaration for spark.components.DropDownList class:

public class DropDownList 
   extends DropDownListBase 

Public properties

S.N.Property & Description
1prompt : String
The prompt for the DropDownList control.
2typicalItem : Object
[override] Layouts use the preferred size of the typicalItem when fixed row or column sizes are required, but a specific rowHeight or columnWidth value is not set.

Public methods

S.N.Method & Description

Methods inherited

This class inherits methods from the following classes:

  • spark.components.supportClasses.DropDownListBase

  • spark.components.List

  • spark.components.supportClasses.ListBase

  • spark.components.SkinnableDataContainer

  • spark.components.supportClasses.SkinnableContainerBase

  • spark.components.supportClasses.SkinnableComponent

  • mx.core.UIComponent

  • mx.core.FlexSprite

  • flash.display.Sprite

  • flash.display.DisplayObjectContainer

  • flash.display.InteractiveObject

  • flash.display.DisplayObject

  • flash.events.EventDispatcher

  • Object

Flex DropDownList Control Example

Let us follow the following steps to check usage of DropDownList control in a Flex application by creating a test application:

1Create a project with a name HelloWorld under a package com.tutorialspoint.client as explained in the Flex - Create Application chapter.
2Modify HelloWorld.mxml as explained below. Keep rest of the files unchanged.
3Compile and run the application to make sure business logic is working as per the requirements.

Following is the content of the modified mxml file src/com.tutorialspoint/HelloWorld.mxml.

<?xml version="1.0" encoding="utf-8"?>
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
   width="100%" height="100%" minWidth="500" minHeight="500"

   <fx:Style source="/com/tutorialspoint/client/Style.css"/>

         import mx.collections.ArrayCollection; 
         import spark.events.IndexChangeEvent;
         public var data:ArrayCollection = new ArrayCollection(
            {value:"France", code:"FR"},
            {value:"Japan", code:"JP"},
            {value:"India", code:"IN"},
            {value:"Russia", code:"RS"},
            {value:"United States", code:"US"}		

         protected function dropDownList_changeHandler

   <s:BorderContainer width="550" height="400" id="mainContainer"
      <s:VGroup width="100%" height="100%" gap="50" horizontalAlign="center"
         <s:Label id="lblHeader" text="Form Controls Demonstration" 
         fontSize="40" color="0x777777" styleName="heading"/>
         <s:Panel id="dropDownListPanel" title="Using DropDownList" 
            width="420" height="200">
               <s:VerticalLayout  gap="10" verticalAlign="middle" 
               <s:Label text="Index :"/>
               <s:Label id="ddlIndex" fontWeight="bold"/>
               <s:Label text="Value :"/> 
               <s:Label id="ddlSelectedItem" 
                  text="{dropDownList.selectedItem.value}" fontWeight="bold"/>
               <s:Label text="Code :"/> 
               <s:Label id="ddlCode" 
                  text="{dropDownList.selectedItem.code}" fontWeight="bold"/>
            <s:DropDownList  id="dropDownList" dataProvider="{data}" 
               width="150" change="dropDownList_changeHandler(event)"
               selectedIndex="0" labelField="value"/>     				

Once you are ready with all the changes done, let us compile and run the application in normal mode as we did in Flex - Create Application chapter. If everything is fine with your application, this will produce following result: [ Try it online ]

Flex DropDownList Control