メソッド | プロパティ | エフェクト | イベント | スタイル | 例 フレームあり | フレームなし

mx.controls
DateField クラス

継承を示す線継承を示す線継承を示す線

DateField クラス
mx.controls.ComboBase の拡張

DateField コントロールは、日付を表示するテキストフィールドで、右側にカレンダーアイコンが表示されます。ユーザーがこのコントロールの境界ボックス内をクリックすると、DateChooser コントロールがポップアップし、現在の日付の月に含まれる日が一覧表示されます。日が選択されない場合、このテキストフィールドは空になり、DateChooser コントロールには現在の日付の月が表示されます。

DateChooser コントロールが開いているときは、ユーザーは月と年をスクロールして、日付を選択できます。日付が選択されると、DateChooser コントロールが閉じ、選択された日付がこのテキストフィールドに表示されます。

MXML シンタックス

<mx:DateField> タグは、親クラスのすべてのプロパティと、次のプロパティを継承します。

 <mx:DateField
   dateFormatter="No default."
   dayNames="["S", "M", "T", "W", "T", "F", "S"]"
   disabledDays="No default."
   disabledRanges="No default."
   displayedMonth="Month number of the current date."
   displayedYear="Current year."
   firstDayOfWeek="0"
     monthNames="["January", "February", "March", "April", "May",
     "June", "July", "August", "September",
   "October", "November", "December"]"
   headerColors="[0xE6EEEE,0xFFFFFF]"
   headerStyleDeclaration="No default."
    rollOverColor="0xCDFFC1"
   selectableRange="No default."
   selectedDate="No default."
   selectionColor="0xCDFFC1"
   showToday="true|false"
   todayColor=""
   todayStyleDeclaration="No default."
   weekdayStyleDeclaration="No default."
   change="Event handler; no default."
   close="Event handler; no default."
   open="Event handler; no default."
   scroll="Event handler; no default." 
 />

例を参照するにはここをクリックしてください

コンストラクタ
DateField ( )
コンストラクタです。



メソッド
       close( ) :  Void
 DateChooser コントロールを閉じます。
       open( ) :  Void
 DateChooser コントロールを開きます。

mx.controls.ComboBase クラスから継承されるメソッド
addItem   addItemAt   getDataProvider   getItemAt   getLength   getSelectedIndex   getSelectedIndices   getSelectedItem   getSelectedItems   layoutChildren   measure   removeAll   removeItemAt   replaceItemAt   setDataProvider   sortItems   sortItemsBy  

mx.core.UIComponent クラスから継承されるメソッド
drawFocus   getFocus   getFocusManager   setEnabled   setFocus  

mx.core.UIObject クラスから継承されるメソッド
addEventListener   applyProperties   buildDepthTable   commitProperties   constructObject2   createAccessibilityImplementation   createChildAtDepth   createChildren   createClassChildAtDepth   createClassObject   createEmptyObject   destroyObject   dispatchEvent   doLater   draw   drawRect   executeBindings   fillRect   findNextAvailableDepth   getRepeaterItem   getStyle   handleEvent   init   invalidate   invalidateLayout   invalidateProperties   invalidateSize   invalidateStyle   layoutChildren   measure   move   redraw   removeEventListener   setDepthAbove   setDepthBelow   setMask   setSize   setSizeNoLayout   setStyle   swapDepths  



プロパティ
       dateFormatter:Function
DateField コントロールのテキストフィールドに表示される日付に、書式設定する場合に使用する関数です。
       dayNames:Array
 DateChooser コントロール用の曜日名です。
       disabledDays:Array
 無効にする曜日です。
       disabledRanges:Array
 1 つまたは複数の日を無効にします。
       displayedMonth:Number
 displayedMonth プロパティは、displayedYear プロパティと共に、DateChooser コントロールに表示される月を指定するために使用します。
       displayedYear:Number
 displayedYear プロパティは、displayedMonth プロパティと共に、DateChooser コントロールに表示される年を決定するために使用します。
       firstDayOfWeek:Number
 DateChooser コントロールの最初の列に表示する曜日です (0 ～ 6。0 は dayNames 配列の最初のエレメント)。
       headerStyleDeclaration:String
 このコントロールのヘッダ領域の日付テキストに適用されるスタイルシート定義です。
       monthNames:Array
 DateChooser コントロールの最上部に表示される月の名前です。
       pullDown:Object   [読み取り専用]
DateField に格納される DateChooser コントロールへの参照を含む読み取り専用プロパティです。
       scaleY:var   [書き込み専用]
このコントロールでは高さの伸縮はサポートされていません。
       selectableRange:Object
 選択可能な日付の範囲です。
       selectedDate:Date
 DateChooser コントロールで選択されている日付です。
       showToday:Boolean
 true の場合、今日の日付が DateChooser コントロールでハイライト表示されます。
       todayStyleDeclaration:String
 現在の日付の数値テキストの外観を設定するためのスタイルシート定義です。現在の日付は showToday プロパティが true のときにコントロールでハイライト表示されます。
staticversion:String
このクラスのバージョンを表すストリング。
       weekDayStyleDeclaration:String
 このコントロールの曜日名に適用されるスタイルシート定義です。

mx.controls.ComboBase クラスから継承されるプロパティ
dataProvider   editable   length   restrict   selectedIndex   selectedItem   text   textField   value   version  

mx.core.UIComponent クラスから継承されるプロパティ
enabled   errorString   tabEnabled   tabIndex   version  

mx.core.UIObject クラスから継承されるプロパティ
alpha   baselinePosition   className   depth   documentDescriptor   height   heightFlex   id   instanceIndices   isDocument   kStretch   layoutHeight   layoutWidth   maxHeight   maxWidth   minHeight   minWidth   mouseX   mouseY   nestLevel   oldHeight   oldWidth   oldX   oldY   parent   parentApplication   parentDocument   percentHeight   percentWidth   preferredHeight   preferredWidth   repeaterIndices   scaleX   scaleY   styleName   tabEnabled   toolTip   version   visible   width   widthFlex   x   y  



エフェクト

mx.core.UIComponent クラスから継承されるエフェクト
focusInEffect   focusOutEffect  

mx.core.UIObject クラスから継承されるエフェクト
creationCompleteEffect   hideEffect   mouseDownEffect   mouseOutEffect   mouseOverEffect   mouseUpEffect   moveEffect   resizeEffect   showEffect  



イベント
changechange イベント用のイベントハンドラです。change イベントは日付が選択または変更されたときにブロードキャストされます。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。type プロパティには、イベントの名前である change が含まれます。
closeclose イベント用のイベントハンドラです。close イベントは、日付が選択されたときか、ユーザーがドロップダウンリストの外側をクリックしたときに、ブロードキャストされます。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。type プロパティには、イベントの名前である close が含まれます。
openopen イベント用のイベントハンドラです。open イベントは、ユーザーがフィールドを選択してドロップダウンリストを開いたときにブロードキャストされます。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。type プロパティには、イベントの名前である open が含まれます。
scrollscroll イベント用のイベントハンドラです。scroll イベントはユーザーの操作によって月が変更されたときにブロードキャストされます。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。type プロパティには、イベントの名前である scroll が含まれます。

mx.core.UIComponent クラスから継承されるイベント
focusIn  focusOut  invalid  keyDown  keyUp  valid  valueCommitted 

mx.core.UIObject クラスから継承されるイベント
creationComplete  dragComplete  dragDrop  dragEnter  dragExit  dragOver  draw  effectEnd  effectStart  hide  hideToolTip  initialize  load  mouseChangeSomewhere  mouseDown  mouseDownSomewhere  mouseMove  mouseMoveSomewhere  mouseOut  mouseOver  mouseUp  mouseUpSomewhere  move  resize  show  showToolTip  unload 



スタイル
headerColor型 : Number   形式 : Color   CSS の継承 : あり
DateChooser コントロールの最上部の領域の色です。デフォルト値は 0xE6EEEE です。Deprecated - headerColors を代わりに使用します。
headerColors 型 : Array   CSS の継承 : あり
DateChooser コントロールの最上部の領域の色です。デフォルト値は [0xE6EEEE,0xFFFFFF] です。
rollOverColor型 : Number   形式 : Color   CSS の継承 : あり
DateChooser コントロールで日付上にマウスポインタが置かれているときの背景色です。デフォルト値は 0xE3FFD6 です。
selectionColor型 : Number   形式 : Color   CSS の継承 : あり
DateChooser コントロールで現在選択されている日付の背景色です。デフォルト値は 0xCDFFC1 です。
todayColor型 : Number   形式 : Color   CSS の継承 : あり
DateChooser コントロールにおける今日の日付のハイライト表示の色です。デフォルト値は 0x2B333C です。

mx.core.UIComponent クラスから継承されるスタイル
backgroundAlpha   backgroundColor   backgroundDisabledColor   backgroundImage   backgroundSize   barColor   borderCapColor   borderColor   borderSides   borderStyle   borderThickness   cornerRadius   disabledColor   dropShadow   errorColor   fillColors   highlightColor   modalTransparency   scrollTrackColor   selectedFillColors   shadowCapColor   shadowColor   shadowDirection   shadowDistance   symbolBackgroundColor   symbolBackgroundDisabledColor   symbolBackgroundPressedColor   symbolColor   symbolDisabledColor   themeColor  

mx.core.UIObject クラスから継承されるスタイル
color   fontFamily   fontSize   fontStyle   fontWeight   horizontalGap   leading   marginLeft   marginRight   textAlign   textDecoration   textIndent   verticalGap  



コンストラクタの詳細

DateField

DateField( )

コンストラクタです。



メソッドの詳細

close

close( ) :  Void

DateChooser コントロールを閉じます。

open

open( ) :  Void

DateChooser コントロールを開きます。



プロパティの詳細

dateFormatter

dateFormatter:Function  

DateField コントロールのテキストフィールドに表示される日付に、書式設定する場合に使用する関数です。この関数はパラメータとして Date オブジェクトを受け取り、表示する形式のストリングを返します。関数を指定しない場合は、デフォルトの形式が使用されます。デフォルト値は undefined です。

dayNames

dayNames:Array  

DateChooser コントロール用の曜日名です。このプロパティを設定すると、DateChooser コントロールの日付ラベルが変更されます。日曜日が最初の曜日 (インデックス 0) です。以降の曜日が通常の順序で続きます。デフォルト値は ["S", "M", "T", "W", "T", "F", "S"] です。

disabledDays

disabledDays:Array  

無効にする曜日です。指定した曜日に該当するその月のすべての日付が無効になります。このプロパティは、DateChooser コントロールのユーザーインターフェイスを直ちに変更します。この配列のエレメントは 0 (日曜日) から 6 (土曜日) の範囲の値です。たとえば、値 "[0,6]" を指定すると日曜日と土曜日が無効になります。

disabledRanges

disabledRanges:Array  

1 つまたは複数の日を無効にします。このプロパティは、パラメータとしてオブジェクトの配列を受け入れます。この配列にあるオブジェクトはそれぞれ Date オブジェクトであり、無効にする 1 日を指定するか、あるいは、rangeStart および rangeEnd プロパティ (これらの値はそれぞれ Date オブジェクト) のいずれか一方または両方を含むオブジェクトを指定します。これらのプロパティの値は、日付範囲の先頭と末尾を示します。一方を省略した場合、そちら側は無制限と見なされます。
rangeStart のみを指定した場合は、指定した日付より後の日付がすべて無効になります。rangeEnd のみを指定した場合は、指定した日付より前の日付がすべて無効になります。
ある 1 日を無効にするには、その日付を指定する Date オブジェクトを、配列の中で他のオブジェクトと共に使用します。このプロパティを設定すると、DateChooser コントロールの外観が直ちに変更されます (無効にされた日付が displayedMonth および displayedYear プロパティに含まれる場合)。

displayedMonth

displayedMonth:Number  

displayedMonth プロパティは、displayedYear プロパティと共に、DateChooser コントロールに表示される月を指定するために使用します。月を表す数字は 0 から始まるので、1 月は 0 で、12 月は 11 です。このプロパティを設定すると、DateChooser コントロールの外観が直ちに変更されます。デフォルト値は今日の日付の月番号です。

displayedYear

displayedYear:Number  

displayedYear プロパティは、displayedMonth プロパティと共に、DateChooser コントロールに表示される年を決定するために使用します。このプロパティを設定すると、DateChooser コントロールの外観が直ちに変更されます。デフォルト値は現在の年です。

firstDayOfWeek

firstDayOfWeek:Number  

DateChooser コントロールの最初の列に表示する曜日です (0 ～ 6。0 は dayNames 配列の最初のエレメント)。このプロパティを設定すると、日付列の順序が変更されます。デフォルト値は 0 です。

headerStyleDeclaration

headerStyleDeclaration:String  

このコントロールのヘッダ領域の日付テキストに適用されるスタイルシート定義です。省略した場合、ヘッダ領域はこのコントロールのテキストスタイルを継承します。

monthNames

monthNames:Array  

DateChooser コントロールの最上部に表示される月の名前です。デフォルト値は ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"] です。

pullDown

pullDown:Object   [読み取り専用]

DateField に格納される DateChooser コントロールへの参照を含む読み取り専用プロパティです。DateChooser コントロールは、ユーザーが DateField コンポーネントをクリックしたときにインスタンス化されます。ただし、ユーザーがコンポーネントをクリックする前にこのプロパティが参照された場合は、DateChooser コンポーネントがインスタンス化されて非表示になります。それ以降、コンポーネントがクリックされると DateChooser の同じインスタンスが使用されます。

scaleY

scaleY:var   [書き込み専用]

このコントロールでは高さの伸縮はサポートされていません。

selectableRange

selectableRange:Object  

選択可能な日付の範囲です。たとえば、2001 年 12 月 04 日から 2003 年 12 月 04 日までの日付を選択可能にし、この範囲外の日付を無効にします。このプロパティは、パラメータとして 1 つのオブジェクトを受け入れます。
このオブジェクトには、rangeStart と rangeEnd の 2 つの Date 型プロパティが含まれます。rangeStart のみを指定した場合は、指定した日付より後の日付がすべて有効になります。rangeEnd のみを指定した場合は、指定した日付より前の日付がすべて有効になります。DateChooser コントロールで 1 つの日付のみを有効にするには、Date オブジェクトを直接渡します。

selectedDate

selectedDate:Date  

DateChooser コントロールで選択されている日付です。パラメータとして 1 つの Date オブジェクトを受け入れます。

showToday

showToday:Boolean  

true の場合、今日の日付が DateChooser コントロールでハイライト表示されます。このプロパティを設定すると、DateChooser コントロールの外観が直ちに変更されます。デフォルト値は true です。

todayStyleDeclaration

todayStyleDeclaration:String  

現在の日付の数字の外観を設定するためのスタイルシート定義です。現在の日付は showToday プロパティが true のときにコントロールでハイライト表示されます。省略した場合、現在の日付テキストはこのコントロールのテキストスタイルを継承します。

version

static  version:String  

このクラスのバージョンを表すストリングです。

weekDayStyleDeclaration

weekDayStyleDeclaration:String  

このコントロールの曜日名に適用されるスタイルシート定義。省略した場合、曜日名はこのコントロールのテキストスタイルを継承します。


例
DateFieldExample.mxml 
<?xml version="1.0" encoding="utf-8"?>
<!-- DateField コントロールの使用方法を示す簡単な例 -->
<mx:Application xmlns:mx="http://www.macromedia.com/2003/mxml" backgroundColor="#FFFFFF">

<mx:Panel title="Date Field Panel">

<!-- 日付とその右横にカレンダーアイコンを表示するテキストフィールドのある簡単な DateField コントロール -->
<mx:Box direction="horizontal">

<mx:Label text="DateField"/>
<mx:DateField width="100"/>

</mx:Box>

</mx:Panel>

</mx:Application>