Flex - Controle ComboBox

Quando o usuário seleciona um item da lista suspensa no controle ComboBox, o item de dados aparece na área de prompt do controle.

Uma diferença entre os controles ComboBox e DropDownList é que a área de prompt do controle ComboBox é implementada usando o controle TextInput, enquanto no caso do controle DropDownList, é o controle Label. Portanto, um usuário pode editar a área de prompt do controle para inserir um valor que não seja uma das opções disponíveis.

Declaração de Classe

A seguir está a declaração para spark.components.ComboBox classe -

public class ComboBox 
   extends DropDownListBase 
      implements IIMESupport

Propriedades Públicas

Sr. Não	Descrição da Propriedade
1	enableIME : Boolean [somente leitura]
2	imeMode : String
3	itemMatchingFunction : Function = null Especifica uma função de retorno de chamada usada para pesquisar a lista de itens conforme o usuário insere caracteres na área de prompt.
4	labelToItemFunction : Function Especifica uma função de retorno de chamada para converter um novo valor inserido na área de prompt para o mesmo tipo de dados que os itens de dados no provedor de dados.
5	maxChars : int O número máximo de caracteres que a área de prompt pode conter, conforme inserido por um usuário.
6	openOnInput : Boolean = true Se verdadeiro, a lista suspensa é aberta quando o usuário edita a área de prompt.
7	prompt : String Texto a ser exibido se / quando o texto de entrada for nulo.
8	restrict : String Especifica o conjunto de caracteres que um usuário pode inserir na área de prompt.

Métodos Públicos

Sr. Não	Método e Descrição
1	ComboBox() Construtor.

Métodos herdados

Esta classe herda métodos das seguintes 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

Exemplo de controle Flex ComboBox

Vamos seguir as etapas a seguir para verificar o uso do controle ComboBox em um aplicativo Flex criando um aplicativo de teste -

Degrau	Descrição
1	Crie um projeto com um nome HelloWorld em um pacote com.tutorialspoint.client conforme explicado no capítulo Flex - Criar aplicativo .
2	Modifique HelloWorld.mxml conforme explicado abaixo. Mantenha o resto dos arquivos inalterados.
3	Compile e execute o aplicativo para ter certeza de que a lógica de negócios está funcionando de acordo com os requisitos.

A seguir está o conteúdo do arquivo mxml modificado src/com.tutorialspoint/HelloWorld.mxml

<?xml version = "1.0" encoding = "utf-8"?>
<s:Application xmlns:fx = "http://ns.adobe.com/mxml/2009"
   xmlns:s = "library://ns.adobe.com/flex/spark"
   xmlns:mx = "library://ns.adobe.com/flex/mx"
   width = "100%" height = "100%" minWidth = "500" minHeight = "500">
   
   <fx:Style source = "/com/tutorialspoint/client/Style.css" />
   <fx:Script>
      <![CDATA[
         import mx.collections.ArrayCollection; 

         [Bindable]
         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"}		
         ]                
         );

         private function mappingFunction(input:String):Object {
            switch (input){
               case "France":
                  return {value:input, code:"FR"};		
               case "Japan":
                  return {value:input, code:"JP"};		
               case "India":
                  return {value:input, code:"IN"};		
               case "Russia":
                  return {value:input, code:"RS"};		
               case "United States":
                  return {value:input, code:"US"};		
            }			
            return null;
         }

      ]]>
   </fx:Script>
   
   <fx:Declarations>
      <mx:DateFormatter id = "dateFormatter" />
   </fx:Declarations>
   
   <s:BorderContainer width = "550" height = "400" id = "mainContainer"
      styleName = "container">
      <s:VGroup width = "100%" height = "100%" gap = "50" horizontalAlign = "center"
         verticalAlign = "middle">
         <s:Label id = "lblHeader" text = "Form Controls Demonstration" 
            fontSize = "40" color = "0x777777" styleName = "heading" />
         
         <s:Panel id = "comboBoxPanel" title = "Using ComboBox" width = "420" 
            height = "200">
         <s:layout>
            <s:VerticalLayout  gap = "10" verticalAlign = "middle" 
               horizontalAlign = "center" />	
         </s:layout>
         
         <s:HGroup>
            <s:Label text = "Index :" /> <s:Label 
               text = "{comboBox.selectedIndex}" fontWeight = "bold" />
            <s:Label text = "Value :" /> <s:Label 
               text = "{comboBox.selectedItem.value}" fontWeight = "bold" />
            <s:Label text = "Code :" /> <s:Label 
               text = "{comboBox.selectedItem.code}" fontWeight = "bold" />
         </s:HGroup>
         
         <s:ComboBox  id = "comboBox"  dataProvider = "{data}" width = "150" 
            labelToItemFunction = "{mappingFunction}" selectedIndex = "0" 
            labelField = "value" />     
         </s:Panel>
      </s:VGroup>	 
   </s:BorderContainer>	
</s:Application>

Quando estiver pronto com todas as alterações feitas, vamos compilar e executar o aplicativo no modo normal como fizemos no capítulo Flex - Criar aplicativo . Se tudo estiver bem com sua aplicação, ele produzirá o seguinte resultado: [ ]

↰ Previous page