Gets or sets the disabled indices in the list.

Gets or sets the header indicies for the list.

You can use this method to create a header for the popup list. You can pass an Array of index values into the headerIndices() function to define which list cell labels will appear in bold. In the following listing, a header is applied to the first index in the list.

            var popUp:PopupList;
            popUp = new PopupList();
            popUp.title = "Wireless Networks";
            popUp.headerIndices = ['0'];
            popUp.items = ['Network name', 'Home',  'work', 'g-band', 'Cottage', 'patio'];
            popUp.addButton("OK");
            popUp.addButton("Test");
            popUp.addButton("Cancel");
            popUp.dialogSize= DialogSize.SIZE_MEDIUM;
            popUp.addEventListener(Event.SELECT, dButtonClicked); 
            popUp.show(IowWindow.getAirWindow().group);      
         

The code listing above creates the following dialog:

Sets the list item array. The list item array provides a list of choices for the user.

The items method takes an Array of Strings:

         popUp.items = ['Home', 'Work', 'Cottage', 'School'];
         

Sets a Boolean that allows multiple item selection in the list.

Gets or sets the index in the list to scroll to.

Gets or sets the selected item index array.

Gets or sets the separator indicies in the list.

You can use this method to create separator cells within the popup list. You can pass an Array of index values into the separatorIndices() function to define which list cell labels will appear shaded. In the following listing, separator cells are added to the popup list in order to separate wireless networks by location.

            var popUp:PopupList;
            popUp = new PopupList();
            popUp.title = "Wireless Networks";
            popUp.headerIndices = ['0'];
            popUp.separatorIndices = ['1', '4'];
            popUp.items = ['Network name', 'Home',  'work', 'g-band', 'Cottage', 'patio'];
            popUp.addButton("OK");
            popUp.addButton("Test");
            popUp.addButton("Cancel");
            popUp.dialogSize= DialogSize.SIZE_MEDIUM;
            popUp.addEventListener(Event.SELECT, dButtonClicked); 
            popUp.show(IowWindow.getAirWindow().group);       
         

The code listing above creates the following dialog:

Constructor for the PopupList class.

The following listing shows a dialog with a PopupList. The dialog allows a user to select a wireless network SSID from a group of available networks:

      private function showPopup():void
      {
        popUp = new PopupList();
        popUp.title = "Wireless Networks";
        popUp.items = ['Home', 'Work', 'Cottage', 'School'];
        popUp.addButton("OK");
        popUp.addButton("Cancel");
        popUp.dialogSize= DialogSize.SIZE_MEDIUM;
        popUp.addEventListener(Event.SELECT, dButtonClicked); 
        popUp.show(IowWindow.getAirWindow().group);            
      } 
     

The code snippet above produces the following dialog:

You can use the selectedIndices method to specify an array of indices. The indices will appear as selected when the dialog is loaded. The multiSelect property enables the user to select multiple list items at once.

Note: In the last line of the code snippet above, the window group ID is passed into the show method:

     .show(IowWindow.getAirWindow().group);
     

This ensures that the dialog will be modal for only this application. In other words, the application can still be minimized when this dialog is active.