Flex - 日期選擇器控制元件

日期選擇器控制元件用於顯示月份名稱、年份以及月份日期網格，其中列標有星期幾。

日期選擇器控制元件允許使用者選擇日期、日期範圍或多個日期。該控制元件包含用於更改月份和年份的前後箭頭按鈕。

類宣告

以下是mx.controls.DateChooser類的宣告：

public class DateChooser 
   extends UIComponent 
      implements IFocusManagerComponent, IFontContextComponent

公共屬性

序號	屬性 & 描述
1	allowDisjointSelection : 布林值如果為真，則指定在 DateChooser 控制元件中允許非連續（不連續）選擇。
2	allowMultipleSelection : 布林值如果為真，則指定在 DateChooser 控制元件中允許多選。
3	dayNames : 陣列 DateChooser 控制元件的星期名稱。
4	disabledDays : 陣列一週中要停用的日期。
5	disabledRanges : 陣列停用單個和多個日期。
6	displayedMonth : 整數與 displayedYear 屬性一起使用，displayedMonth 屬性指定在 DateChooser 控制元件中顯示的月份。
7	displayedYear : 整數與 displayedMonth 屬性一起使用，displayedYear 屬性指定在 DateChooser 控制元件中顯示的年份。
8	firstDayOfWeek : 物件表示一週中要顯示在 DateChooser 控制元件第一列的日期的數字。
9	maxYear : 整數控制元件中可選擇的最後一年。
10	minYear : 整數控制元件中可選擇的第一個年份。
11	monthNames : 陣列在 DateChooser 控制元件頂部顯示的月份名稱。
12	monthSymbol : 字串此屬性附加到 monthNames 屬性指定的值的末尾，以定義在 DateChooser 控制元件頂部顯示的月份名稱。
13	selectableRange : 物件可選擇日期之間的日期範圍。
14	selectedDate : 日期在 DateChooser 控制元件中選擇的日期。
15	selectedRanges : 陣列選定的日期範圍。
16	showToday : 布林值如果為真，則指定今天在 DateChooser 控制元件中突出顯示。
17	yearNavigationEnabled : 布林值啟用年份導航。
18	yearSymbol : 字串此屬性附加到在 DateChooser 控制元件頂部顯示的年份的末尾。

受保護的屬性

序號	屬性 & 描述
1	calendarLayoutStyleFilters : 物件 [只讀] 要從 DateChooser 傳遞到日曆佈局的樣式集。
2	nextMonthStyleFilters : 物件 [只讀] 要從 DateChooser 傳遞到下個月按鈕的樣式集。
3	nextYearStyleFilters : 物件 [只讀] 要從 DateChooser 傳遞到下一年按鈕的樣式集。
4	prevMonthStyleFilters : 物件 [只讀] 要從 DateChooser 傳遞到上個月按鈕的樣式集。
5	prevYearStyleFilters : 物件 [只讀] 要從 DateChooser 傳遞到上一年按鈕的樣式集。

公共方法

序號	方法 & 描述
1	DateChooser() 建構函式。

事件

序號	事件 & 描述
1	change 選擇或更改日期時排程。
2	scroll 由於使用者互動導致月份更改時排程。

序號

事件 & 描述

change

選擇或更改日期時排程。

scroll

由於使用者互動導致月份更改時排程。

繼承的方法

此類繼承自以下類：

mx.core.UIComponent
mx.core.FlexSprite
flash.display.Sprite
flash.display.DisplayObjectContainer
flash.display.InteractiveObject
flash.display.DisplayObject
flash.events.EventDispatcher
Object

Flex 日期選擇器控制元件示例

讓我們按照以下步驟在 Flex 應用程式中檢查 DateChooser 控制元件的使用，方法是建立一個測試應用程式：

步驟	描述
1	在包com.tutorialspoint.client下建立一個名為HelloWorld的專案，如Flex - 建立應用程式章節中所述。
2	修改HelloWorld.mxml，如下所述。保持其餘檔案不變。
3	編譯並執行應用程式以確保業務邏輯按要求工作。

以下是修改後的 mxml 檔案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>

完成所有更改後，讓我們像在Flex - 建立應用程式章節中一樣，以普通模式編譯並執行應用程式。如果應用程式一切正常，它將產生以下結果：[ 線上嘗試 ]

flex_form_controls.htm

列印頁面