Flex - Controle DateChooser

O controle DateChooser é usado para exibir o nome de um mês, o ano e uma grade dos dias do mês, com colunas rotuladas para o dia da semana.

O controle DateChooser permite que o usuário selecione uma data, um intervalo de datas ou várias datas. O controle contém botões de seta para frente e para trás para alterar o mês e o ano.

Declaração de Classe

A seguir está a declaração para mx.controls.DateChooser classe -

public class DateChooser 
   extends UIComponent 
      implements IFocusManagerComponent, IFontContextComponent

Propriedades Públicas

Sr. Não	Descrição da Propriedade
1	allowDisjointSelection : Boolean Se verdadeiro, especifica que a seleção não contígua (disjunta) é permitida no controle DateChooser.
2	allowMultipleSelection : Boolean Se verdadeiro, especifica que a seleção múltipla é permitida no controle DateChooser.
3	dayNames : Array Os nomes dos dias da semana para o controle DateChooser.
4	disabledDays : Array Os dias a serem desativados em uma semana.
5	disabledRanges : Array Desativa dias únicos e múltiplos.
6	displayedMonth : int Usada junto com a propriedade displayYear, a propriedade displayMonth especifica o mês exibido no controle DateChooser.
7	displayedYear : int Usada junto com a propriedade displayMonth, a propriedade displayYear especifica o ano exibido no controle DateChooser.
8	firstDayOfWeek : Object Número que representa o dia da semana a ser exibido na primeira coluna do controle DateChooser.
9	maxYear : int O último ano selecionável no controle.
10	minYear : int O primeiro ano selecionável no controle.
11	monthNames : Array Nomes dos meses exibidos na parte superior do controle DateChooser.
12	monthSymbol : String Esta propriedade é anexada ao final do valor especificado pela propriedade monthNames para definir os nomes dos meses exibidos na parte superior do controle DateChooser.
13	selectableRange : Object Intervalo de datas entre as quais as datas são selecionáveis.
14	selectedDate : Date Data selecionada no controle DateChooser.
15	selectedRanges : Array Intervalos de datas selecionados.
16	showToday : Boolean Se verdadeiro, especifica que o dia de hoje é realçado no controle DateChooser.
17	yearNavigationEnabled : Boolean Ativa a navegação anual.
18	yearSymbol : String Esta propriedade é anexada ao final do ano exibido na parte superior do controle DateChooser.

Propriedades Protegidas

Sr. Não	Descrição da Propriedade
1	calendarLayoutStyleFilters : Object [somente leitura] O conjunto de estilos a serem transmitidos do DateChooser para o layout do calendário.
2	nextMonthStyleFilters : Object [somente leitura] O conjunto de estilos para passar do DateChooser para o botão do próximo mês.
3	nextYearStyleFilters : Object [somente leitura] O conjunto de estilos para passar do DateChooser para o botão do próximo ano.
4	prevMonthStyleFilters : Object [somente leitura] O conjunto de estilos a serem transmitidos do botão DateChooser para o mês anterior.
5	prevYearStyleFilters : Object [somente leitura] O conjunto de estilos a serem transmitidos do botão DateChooser para o ano anterior.

Métodos Públicos

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

Eventos

Sr. Não	Descrição do Evento
1	change Enviado quando uma data é selecionada ou alterada.
2	scroll Enviado quando o mês muda devido à interação do usuário.

Métodos herdados

Esta classe herda métodos das seguintes classes -

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 DateChooser

Vamos seguir as etapas a seguir para verificar o uso do controle DateChooser 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"
   applicationComplete = "application_applicationCompleteHandler(event)">

   <fx:Style source = "/com/tutorialspoint/client/Style.css" />
   <fx:Script>
      <![CDATA[
         import mx.events.CalendarLayoutChangeEvent;
         import mx.events.FlexEvent;

         [Bindable]
         private var selectedDate:String = "";
         protected function dateChooser_changeHandler
            event:CalendarLayoutChangeEvent):void {            
            var date:Date = DateChooser(event.target).selectedDate;
            selectedDate = dateFormatter.format(date);
         }
			
         protected function application_applicationCompleteHandler
            (event:FlexEvent):void {
            selectedDate = dateFormatter.format(new Date());
         }
      ]]>
   </fx:Script>
   
   <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 = "dateChooserPanel" title = "Using DateChooser" width = "400" 
            height = "300" includeInLayout = "true" visible = "true">
            <s:layout>
               <s:HorizontalLayout  gap = "10" verticalAlign = "middle" 
                  horizontalAlign = "center" />	
            </s:layout>
            
            <mx:DateChooser id = "dateChooser" yearNavigationEnabled = "true"
               change = "dateChooser_changeHandler(event)" />
            <s:Label id = "selection" fontWeight = "bold" 
               text = "Date selected: {selectedDate}" />
         </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: [ Experimente online ]

↰ Previous page