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

mx.controls
DateChooser クラス

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


DateChooser クラス
mx.core.UIComponent の拡張

DateChooser コントロールは、月の名前、年、および曜日を示すラベルの列と共に日付のグリッドを表示します。ユーザーはある日付、日付の範囲、または複数の日付を選択できます。このコントロールには、月と年を前後に移動するための矢印ボタンが含まれます。ユーザーが複数の日付を選択できるようにしたり、特定の日付を選択できないようにしたり、表示される日付を一定の範囲に制限することができます。

MXML シンタックス

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

 <mx:DateChooser
dayNames="["S", "M", "T", "W", "T", "F", "S"]"
disabledDays="No default."
disabledRanges="No default."
displayedMonth="Current month."
displayedYear="現在の年。"
firstDayOfWeek="0"
headerColors="[0xE6EEEE,0xFFFFFF]"
headerStyleDeclaration="No default."
monthNames="["January", "February", "March", "April", "May",
"June", "July", "August", "September", "October", "November",
"December"]"
rollOverColor="0xE3FFD6"
selectableRange="No default."
selectedDate="No default."
selectionColor="0xCDFFC1"
showToday="true|false"
todayColor=""
todayStyleDeclaration="No default."
weekdayStyleDeclaration="No default."
change="Event handler; no default."
scroll="Event handler; no default."
/>

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

関連項目
    DateField
    SimpleButton
    mx.styles.StyleManager



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



メソッド

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  



プロパティ
       className:String
このクラスの名前です。
       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 コントロールの最上部に表示される月の名前です。
       selectableRange:Object
選択可能な日付の範囲です。
       selectedDate:Date
DateChooser コントロールで選択されている日付です。
       showToday:Boolean
true の場合、今日の日付が DateChooser コントロールでハイライト表示されます。
       todayStyleDeclaration:String
現在の日付の数字の外観を設定するためのスタイルシート定義です。現在の日付は showToday プロパティが true のときにコントロールでハイライト表示されます。
staticversion:String
このクラスのバージョンを表すストリングです。
       weekDayStyleDeclaration:String
このコントロールの曜日名に適用されるスタイルシート定義です。

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 が含まれます。
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 の継承 : あり
ユーザーがマウスポインタを置いている日付の背景色です。デフォルト値は 0xE3FFD6 です。
selectionColor型 : Number   形式 : Color   CSS の継承 : あり
現在選択されている日付の背景色です。デフォルト値は 0xCDFFC1 です。
todayColor型 : Number   形式 : Color   CSS の継承 : あり
今日の日付の背景色です。デフォルト値は 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  



コンストラクタの詳細

DateChooser

DateChooser( )

コンストラクタです。



プロパティの詳細

className

className:String  

このクラスの名前です。


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 日を指定するか、あるいは、Date 型の rangeStart および rangeEnd プロパティのいずれか一方または両方を含むオブジェクトを指定します。これらのプロパティの値は、日付範囲の先頭と末尾を示します。一方を省略した場合、そちら側は無制限と見なされます。
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"] です。


selectableRange

selectableRange:Object  

選択可能な日付の範囲です。たとえば、2001 年 12 月 04 日から 2003 年 12 月 04 日までの日付を選択可能にし、この範囲外の日付を無効にします。
このプロパティは、パラメータとして 1 つのオブジェクトを受け入れます。このオブジェクトには、rangeStartrangeEnd の 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 のときにコントロールでハイライト表示されます。フォントの色を変更するには "color" スタイルを指定します。省略した場合、現在の日付テキストはこのコントロールのテキストスタイルを継承します。


version

static  version:String  

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


weekDayStyleDeclaration

weekDayStyleDeclaration:String  

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


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

<mx:Script>
        
<!--このイベントハンドラは DateChooser コントロールを初期化します-->   
function initDateChooser()
        {
meetingDC.displayedMonth = (new Date().getMonth()) + 1;
meetingDC.displayedYear  =  new Date().getFullYear();
        }
        
<!-- Displays date selected by the User-->
function displayDate(date)
        {
var tempdate;
            
if (date==null)
           {
selectedDate.text='';
           }
else
           {
selectedDate.text= "You chose to schedule the meeting on "
+ dateformatter.format(date);
           }
        }       

</mx:Script>

<mx:Panel title="Scheduler Panel" width="100%" height="100%" backgroundColor="#FFFFCC">

<mx:VBox width="100%" height="100%">

<mx:Label text="Schedule a meeting sometime next month"/>

<mx:HBox width="100%" height="100%">

<mx:VBox width="100%" height="100%">

<mx:Label text="Customized Date Chooser"/>

<mx:DateChooser firstDayOfWeek="1" id="meetingDC" initialize="initDateChooser()"
disabledDays="[0,6]" change="displayDate(event.target.selectedDate)"
width="100%" height="100%" selectionColor="#FFCCCC" rollOverColor="#CCFFCC"
headerColor="#FFCC66" dayNames="{mx.formatters.DateBase.defaultDayNamesShort}"
monthNames="{mx.formatters.DateBase.defaultMonthNamesLong}">

</mx:DateChooser>

</mx:VBox>

<mx:VBox>
<mx:Label text="Default Date Chooser"/>
<mx:DateChooser change="displayDate(event.target.selectedDate)"/>
</mx:VBox>

</mx:HBox>

<mx:Label color="#0066FF" id="selectedDate"/>

</mx:VBox>

</mx:Panel>

<mx:DateFormatter id="dateformatter" formatString="month:MM, day:DD, year:YYYY"/>

</mx:Application>