Automatically sets showListAbove based on where the DropDown is on the stage. If when the DropDown opens the list will be clipped by the stage edge, showListAbove is toggled.

Gets or sets the DataProvider for the DropDown list.

See also

Gets or sets the property that determines the parent for the drop down list.

The default value is the DropDown component itself.

Returns true if the list is open in the DropDown.

The default value is false.

Gets or sets the drop down list width offset from the width of the button.

The drop down width (in pixels) offset from the width of the button. A positive value would make the drop-down list wider than the drop-down button. A negative value would make the drop-down list narrower than the drop-down button.

Gets or sets the drop down list y coordinate offset. The offset determines the position of the open list relative to the button.

Gets or sets the prompt that appears in the drop down.

The prompt is shown as the default message in the drop down when the selectedIndex value is set to -1. For example, the String "Select an item" prompts the user to select an item from the drop down list. If no prompt is set, the selectedIndex value is set to 0 and the first item in the DataProvider is displayed in the drop down.

Gets or sets the number of visible rows in the drop down list.

Gets or sets the row height for the drop down list.

The row height represents ths height of each item in the list (in pixels).

Gets or sets the index of the currently selected item in the drop down.

Gets or sets the currently selected item.

In the included example, an event listener calls the function below to return information about the currently selected cell:

         private function onSelect(event:Event):void {
         
                 trace("selected index: " + event.target.selectedIndex);
         
                 var myObj:Object = new Object();
                 myObj = event.target.selectedItem;
                 trace("Selected Item: " + myObj.label);
         }
         

Determines if the drop down list will expand above or below the drop down button.

In the following image, the drop down list expands above the drop down button (the showListAbove property is set to true):

Creates a new DropDown instance.

Adds an item to the list.

Parameters

Adds an item to the list at the specified index.

Parameters

Adds an array item at the specified index.

Parameters

See also

Closes the list of the DropDown component if it is open. Calling this method will not fire a Event.CLOSE event.

Returns the item in the DataProvider at the specified index.

Parameters

Opens the list of the DropDown component if it is closed. Calling this method will not fire a Event.OPEN event.

Removes all the items from the list.

Removes the item from the list.

Parameters

Removes an item from list at the specified index.

Parameters

Replaces an item, given the new item object and the old item.

Parameters

Replaces the item in the list at the specified index, given the new item.

Parameters

Sets the skin for the List background.

This method takes a DisplayObject class.

            var myDDList:DropDown = new DropDown();            
            myDDList.setPosition(100, 500); 
            myDDList.width = 195;
            myDDList.showListAbove = true;
            myDDList.setAboveBackgroundSkin(DropDownBackgroundSkinBlack);
            myDDList.prompt = "Intramurals";
            

You can pass in a qualified class name String, or the actual class. In either instance the class that is used must implement the ICellRenderer interface.

Parameters

Sets the skin for the drop down button when list expands upward.

You can pass in a qualified class name String, or the actual class. In either instance the class that is used must implement the ISkin interface.

Note: Do not pass in an instance of a skin class. This may cause unexpected behavior.

Parameters

Sets the CellRenderer for the List when list expands upward.

By default, the DropDown class uses the CellRenderer class to render the cells in the list. In the example below, the AlternatingCellRenderer class is passed in to the setListSkin method to provide alternating colors (grey and white) for the adjacent cells in the list.

         var myDDList:DropDown = new DropDown();
         myDDList.setPosition(100, 400);
         myDDList.width = 195;
         myDDList.prompt = "Intramurals";
         myDDList.showListAbove = true;
         myDDList.setAboveListSkin(AlternatingCellRenderer);
         

You can pass in a qualified class name String, or the actual class. In either instance the class that is used must implement the ICellRenderer interface.

Note: Do not pass in an instance of a skin class. This may cause unexpected behavior.

Parameters

Sets the skin for the List background.

This method takes a DisplayObject class.

            var myDDList:DropDown = new DropDown();            
            myDDList.setPosition(100, 200); 
            myDDList.width = 195;
            myDDList.setBackgroundSkin(DropDownBackgroundSkinBlack);
            myDDList.prompt = "Intramurals";
         

Parameters

Sets the skin for the drop down button.

You can pass in a qualified class name String, or the actual class. In either instance the class that is used must implement the ISkin interface.

Note: Do not pass in an instance of a skin class. This may cause unexpected behavior.

Parameters

Sets the CellRenderer for the List.

By default, the DropDown class uses the CellRenderer class to render the cells in the list. In the example below, the AlternatingCellRenderer class is passed in to the setListSkin method to provide alternating colors (grey and white) for the adjacent cells in the list.

         var myDDList:DropDown = new DropDown();
         myDDList.setPosition(100, 400);
         myDDList.prompt = "Intramurals";
         myDDList.showListAbove = true;
         myDDList.setListSkin(DropDownCellRendererSkin);
         

You can pass in a qualified class name String, or the actual class. In either instance the class that is used must implement the ICellRenderer interface.

Note: Do not pass in an instance of a skin class. This may cause unexpected behavior.

Parameters

Updates the item in the list.

Parameters

Updates the item in the list at the specified index.

Parameters

Updates the items starting at the specified index with new items.

Parameters

See also

Dispatched when the drop down list is closed.

Dispatched when the drop down list is opened.

Dispatched when an item in the drop down list is selected.

The following example creates a simple DropDown instance. The dropdown uses event listeners to capture user interaction.

package
{
    import flash.display.Sprite;
    import flash.events.Event;
    
    import qnx.ui.data.DataProvider;
    import qnx.ui.listClasses.DropDown;
    import qnx.fuse.ui.listClasses.DropDown;
    
    [SWF(height="600", width="1024", 
    frameRate="30", backgroundColor="#FFFFFF")]
    frameRate="30", backgroundColor="#FFFFFF")]
    
    public class MyDropDownExample extends Sprite
    {
        public function MyDropDownExample()
        {
            initializeUI();
        }
        
        private function initializeUI():void
        {
            
            var arrMonth:Array=[];
            // add objects with a label property
            arrMonth.push({label: "Hockey"});
            arrMonth.push({label: "Baseball"});
            arrMonth.push({label: "Football"});
            arrMonth.push({label: "Golf"});
            arrMonth.push({label: "Basketball"});
                
            var myDDList:DropDown = new DropDown();            
            myDDList.setPosition(100, 100);    
            
            var myDDList:DropDown = new DropDown();            
            myDDList.setPosition(100, 100); 
            myDDList.width = 195;
            myDDList.prompt = "Intramurals";
    
            
            
            //set the dataProvider
            myDDList.dataProvider = new DataProvider(arrMonth);
            
            myDDList.addEventListener(Event.SELECT, onSelect);
            this.addChild(myDDList);
            
        }
        
        private function onSelect(event:Event):void {
            
            trace("selected index: " + event.target.selectedIndex);
            
            var myObj:Object = new Object();
            myObj = event.target.selectedItem;
            trace("Selected Item: " + myObj.label);
            
            
        }
        
    
        
    }
}