backgroundColor
* property.
* Valid values range from 0.0 to 1.0.
* @default 1.0
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="backgroundAlpha", type="Number", inherit="no")]
/**
* Background color of the DateChooser control.
*
* @default 0xFFFFF
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="backgroundColor", type="uint", format="Color", inherit="no")]
/**
* Alpha of the border.
* @default 1
*
* @langversion 3.0
* @playerversion Flash 10
* @playerversion AIR 1.5
* @productversion Flex 4
*/
[Style(name="borderAlpha", type="Number", inherit="no")]
/**
* Color of the border.
* The following controls support this style: Button, CheckBox,
* ComboBox, MenuBar,
* NumericStepper, ProgressBar, RadioButton, ScrollBar, Slider, and any
* components that support the borderStyle style.
* The default value depends on the component class;
* if not overridden for the class, the default value is 0xB7BABC
* for the Halo theme and 0x696969 for the Spark theme.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="borderColor", type="uint", format="Color", inherit="no")]
/**
* Bounding box thickness.
* Only used when borderStyle is set to "solid".
* @default 1
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="borderThickness", type="Number", format="Length", inherit="no")]
/**
* Visibility of the border.
*
* @default 1
*
* @langversion 3.0
* @playerversion Flash 10
* @playerversion AIR 1.5
* @productversion Flex 4
*/
[Style(name="borderVisible", type="Boolean", inherit="no")]
/**
* The alpha of the content background for this component.
*
* @langversion 3.0
* @playerversion Flash 10
* @playerversion AIR 1.5
* @productversion Flex 4
*/
[Style(name="contentBackgroundAlpha", type="Number", inherit="yes")]
/**
* Color of the content area of the component.
*
* @default 0xFFFFFF
*
* @langversion 3.0
* @playerversion Flash 10
* @playerversion AIR 1.5
* @productversion Flex 4
*/
[Style(name="contentBackgroundColor", type="uint", format="Color", inherit="yes")]
/**
* Radius of corners of the component.
*
* The default value for the Halo theme is 4.
* The default value for the Spark theme is 0.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="cornerRadius", type="Number", format="Length", inherit="no")]
/**
* Color of focus ring when the component is in focus
*
* @default 0x70B2EE
*
* @langversion 3.0
* @playerversion Flash 10
* @playerversion AIR 1.5
* @productversion Flex 4
*/
[Style(name="focusColor", type="uint", format="Color", inherit="yes")]
/**
* Colors of the band at the top of the DateChooser control.
* The default value is [ 0xE1E5EB, 0xF4F5F7 ].
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="headerColors", type="Array", arrayType="uint", format="Color", inherit="yes")]
/**
* Name of the style sheet definition to configure the text (month name and year)
* and appearance of the header area of the control.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="headerStyleName", type="String", inherit="no")]
/**
* Alpha transparencies used for the highlight fill of controls.
* The first value specifies the transparency of the top of the highlight and the second value specifies the transparency
* of the bottom of the highlight. The highlight covers the top half of the skin.
*
* @default [ 0.3, 0.0 ]
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="highlightAlphas", type="Array", arrayType="Number", inherit="no")]
/**
* Name of the class to use as the skin for the next month arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserMonthArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserNextMonthSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="nextMonthSkin", type="Class", inherit="no", states="up, over, down, disabled")]
/**
* Name of the class to use as the skin for the next month arrow
* when the arrow is disabled.
* The default value for the Halo theme is mx.skins.halo.DateChooserMonthArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserNextMonthSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="nextMonthDisabledSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the next month arrow
* when the user presses the mouse button down on the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserMonthArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserNextMonthSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="nextMonthDownSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the next month arrow
* when the user moves the mouse pointer over the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserMonthArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserNextMonthSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="nextMonthOverSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the next month arrow
* when the mouse pointer is not over the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserMonthArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserNextMonthSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="nextMonthUpSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the next year arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserYearArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserNextYearSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="nextYearSkin", type="Class", inherit="no", states="up, over, down, disabled")]
/**
* Name of the class to use as the skin for the next year arrow
* when the arrow is disabled.
* The default value for the Halo theme is mx.skins.halo.DateChooserYearArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserNextYearSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="nextYearDisabledSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the next Year arrow
* when the user presses the mouse button down on the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserYearArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserNextYearSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="nextYearDownSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the next Year arrow
* when the user moves the mouse pointer over the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserYearArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserNextYearSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="nextYearOverSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the next Year arrow
* when the mouse pointer is not over the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserYearArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserNextYearSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="nextYearUpSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the previous month arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserMonthArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserPrevMonthSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="prevMonthSkin", type="Class", inherit="no", states="up, over, down, disabled")]
/**
* Name of the class to use as the skin for the previous month arrow
* when the arrow is disabled.
* The default value for the Halo theme is mx.skins.halo.DateChooserMonthArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserPrevMonthSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="prevMonthDisabledSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the previous month arrow
* when the user presses the mouse button down over the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserMonthArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserPrevMonthSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="prevMonthDownSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the previous month arrow
* when the user holds the mouse pointer over the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserMonthArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserPrevMonthSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="prevMonthOverSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the previous month arrow
* when the mouse pointer is not over the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserMonthArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserPrevMonthSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="prevMonthUpSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the previous year arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserYearArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserPrevYearSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="prevYearSkin", type="Class", inherit="no", states="up, over, down, disabled")]
/**
* Name of the class to use as the skin for the previous Year arrow
* when the arrow is disabled.
* The default value for the Halo theme is mx.skins.halo.DateChooserYearArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserPrevYearSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="prevYearDisabledSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the previous Year arrow
* when the user presses the mouse button down over the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserYearArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserPrevYearSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="prevYearDownSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the previous Year arrow
* when the user holds the mouse pointer over the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserYearArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserPrevYearSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="prevYearOverSkin", type="Class", inherit="no")]
/**
* Name of the class to use as the skin for the previous Year arrow
* when the mouse button not over the arrow.
* The default value for the Halo theme is mx.skins.halo.DateChooserYearArrowSkin.
* The default value for the Spark theme is mx.skins.spark.DateChooserPrevYearSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="prevYearUpSkin", type="Class", inherit="no")]
/**
* Color of the highlight area of the date when the user holds the
* mouse pointer over a date in the DateChooser control.
*
* The default value for the Halo theme is 0xB2E1FF.
* The default value for the Spark theme is 0xCEDBEF.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="rollOverColor", type="uint", format="Color", inherit="yes")]
/**
* Name of the class to use as the skin for the
* highlight area of the date when the user holds the
* mouse pointer over a date in the DateChooser control.
*
* The default value for the Halo theme is mx.skins.halo.DateChooserIndicator.
* The default value for the Spark theme is mx.skins.spark.DateChooserRollOverIndicatorSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="rollOverIndicatorSkin", type="Class", inherit="no")]
/**
* Color of the highlight area of the currently selected date
* in the DateChooser control.
*
* The default value for the Halo theme is 0x7FCEFF.
* The default value for the Spark theme is 0xA8C6EE.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="selectionColor", type="uint", format="Color", inherit="yes")]
/**
* Name of the class to use as the skin for the
* highlight area of the currently selected date
* in the DateChooser control.
*
* The default value for the Halo theme is mx.skins.halo.DateChooserIndicator.
* The default value for the Spark theme is mx.skins.spark.DateChooserSelectionIndicatorSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="selectionIndicatorSkin", type="Class", inherit="no")]
/**
* Color of any symbol of a component. Examples include the check mark of a CheckBox or
* the arrow of a ScrollBar button.
*
* @default 0x000000
*
* @langversion 3.0
* @playerversion Flash 10
* @playerversion AIR 1.5
* @productversion Flex 4
*/
[Style(name="symbolColor", type="uint", format="Color", inherit="yes",)]
/**
* Color of the background of today's date.
*
* The default value for the Halo theme is 0x818181
* The default value for the Spark theme is 0xC6D0DB.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="todayColor", type="uint", format="Color", inherit="yes")]
/**
* Name of the class to use as the skin for the
* highlight area of today's date
* in the DateChooser control.
*
* The default value for the Halo theme is mx.skins.halo.DateChooserIndicator.
* The default value for the Spark theme is mx.skins.spark.DateChooserTodayIndicatorSkin.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="todayIndicatorSkin", type="Class", inherit="no")]
/**
* Name of the style sheet definition to configure the appearance of the current day's
* numeric text, which is highlighted
* in the control when the showToday property is true.
* Specify a "color" style to change the font color.
* If omitted, the current day text inherits
* the text styles of the control.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="todayStyleName", type="String", inherit="no")]
/**
* Name of the style sheet definition to configure the weekday names of
* the control. If omitted, the weekday names inherit the text
* styles of the control.
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Style(name="weekDayStyleName", type="String", inherit="no")]
//--------------------------------------
// Events
//--------------------------------------
/**
* Dispatched when a date is selected or changed.
*
* @eventType mx.events.CalendarLayoutChangeEvent.CHANGE
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
[Event(name="change", type="org.apache.royale.events.Event")]
/**
* Dispatched when the month changes due to user interaction.
*
* @eventType mx.events.DateChooserEvent.SCROLL
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
//[Event(name="scroll", type="mx.events.DateChooserEvent")]
/**
* The DateChooser control displays the name of a month, the year,
* and a grid of the days of the month, with columns labeled
* for the day of the week.
* The user can select a date, a range of dates, or multiple dates.
* The control contains forward and back arrow buttons
* for changing the month and year.
* You can let users select multiple dates, disable the selection
* of certain dates, and limit the display to a range of dates.
*
* The DateChooser control has the following default characteristics:
*| Characteristic | *Description | *
|---|---|
| Default size | *A size large enough to hold the calendar, and wide enough to display the day names | *
| Minimum size | *0 pixels | *
| Maximum size | *No limit | *
The <mx:DateChooser> tag inherits all of the tag attributes
* of its superclass, and adds the following tag attributes:
* <mx:DateChooser * Properties * allowDisjointSelection="true|false" * allowMultipleSelection="false|true" * dayNames="["S", "M", "T", "W", "T", "F", "S"]" * disabledDays="No default" * disabledRanges="No default" * displayedMonth="Current month" * displayedYear="Current year" * firstDayOfWeek="0" * maxYear="2100" * minYear="1900" * monthNames="["January", "February", "March", "April", "May", * "June", "July", "August", "September", "October", "November", * "December"]" * monthSymbol="" * selectableRange="No default" * selectedDate="No default" * selectedRanges="No default" * showToday="true|false" * yearNavigationEnabled="false|true" * yearSymbol="" * * Styles * backgroundColor="0xFFFFFF" * backgroundAlpha="1.0" * borderColor="0xAAB3B3" * borderThickness="1" * color="0x0B333C" * cornerRadius="4" * disabledColor="0xAAB3B3" * disabledIconColor="0x999999" * fillAlphas="[0.6, 0.4]" * fillColors="[0xFFFFFF, 0xCCCCCC]" * focusAlpha="0.5" * focusRoundedCorners"tl tr bl br" * fontAntiAliasType="advanced" * fontFamily="Verdana" * fontGridFitType="pixel" * fontSharpness="0" * fontSize="10" * fontStyle="normal|italic" * fontThickness="0" * fontWeight="normal|bold" * headerColors="[0xE1E5EB, 0xF4F5F7]" * headerStyleName="headerDateText" * highlightAlphas="[0.3, 0.0]" * horizontalGap="8" * iconColor="0x111111" * leading="2" * nextMonthDisabledSkin="DateChooserMonthArrowSkin" * nextMonthDownSkin="DateChooserMonthArrowSkin" * nextMonthOverSkin="DateChooserMonthArrowSkin" * nextMonthSkin = "DateChooserMonthArrowSkin" * nextMonthUpSkin="DateChooserMonthArrowSkin" * nextYearDisabledSkin="DateChooserYearArrowSkin" * nextYearDownSkin="DateChooserYearArrowSkin" * nextYearOverSkin="DateChooserYearArrowSkin" * nextYearSkin = "DateChooserYearArrowSkin" * nextYearUpSkin="DateChooserYearArrowSkin" * prevMonthDisabledSkin="DateChooserMonthArrowSkin" * prevMonthDownSkin="DateChooserMonthArrowSkin" * prevMonthOverSkin="DateChooserMonthArrowSkin" * prevMonthSkin = "DateChooserMonthArrowSkin" * prevMonthUpSkin="DateChooserMonthArrowSkin" * prevYearDisabledSkin="DateChooserYearArrowSkin" * prevYearDownSkin="DateChooserYearArrowSkin" * prevYearOverSkin="DateChooserYearArrowSkin" * prevYearSkin = "DateChooserYearArrowSkin" * prevYearUpSkin="DateChooserYearArrowSkin" * rollOverColor="0xEEFEE6" * rollOverIndicatorSkin="DateChooserIndicator" * selectionColor="0xB7F39B" * selectionIndicatorSkin="DateChooserIndicator" * textAlign="left|right|center" * textDecoration="none|underline" * textIndent="0" * todayColor="0x818181" * todayIndicatorSkin="DateChooserIndicator" * todayStyleName="todayStyle" * verticalGap="6" * weekDayStyleName="weekDayStyle" * * Events * change="No default" * scroll="No default" * /> ** * @see mx.controls.DateField * * @includeExample examples/DateChooserExample.mxml * * @langversion 3.0 * @playerversion Flash 9 * @playerversion AIR 1.1 * @productversion Flex 3 */ public class DateChooser extends UIComponent implements ILayoutParent, ILayoutView//implements IFocusManagerComponent, IFontContextComponent { //-------------------------------------------------------------------------- // // Constructor // //-------------------------------------------------------------------------- /** * Constructor. * * @langversion 3.0 * @playerversion Flash 9 * @playerversion AIR 1.1 * @productversion Flex 3 */ public function DateChooser() { super(); typeNames = "DateChooser"; } //-------------------------------------------------------------------------- // // Overridden properties // //-------------------------------------------------------------------------- //---------------------------------- // enabled //---------------------------------- /** * @private */ override public function get enabled():Boolean { trace("get enabled not implemented"); return true; } /** * @private */ override public function set enabled(value:Boolean):void { trace("set enabled not implemented"); } //-------------------------------------------------------------------------- // // Properties // //-------------------------------------------------------------------------- //---------------------------------- // dayNames //---------------------------------- [Bindable("dayNamesChanged")] [Inspectable(arrayType="String", defaultValue="null")] /** * The weekday names for DateChooser control. * Changing this property changes the day labels * of the DateChooser control. * Sunday is the first day (at index 0). * The rest of the week names follow in the normal order. * * @default [ "S", "M", "T", "W", "T", "F", "S" ]. * * @langversion 3.0 * @playerversion Flash 9 * @playerversion AIR 1.1 * @productversion Flex 3 */ public function get dayNames():Array { return DateChooserModel(model).dayNames; } /** * @private */ public function set dayNames(value:Array):void { DateChooserModel(model).dayNames = value; // dayNamesOverride = value; // // _dayNames = value != null ? // value : // resourceManager.getStringArray( // "controls", "dayNamesShortest"); // // // _dayNames will be null if there are no resources. // _dayNames = _dayNames ? _dayNames.slice(0) : null; // // dayNamesChanged = true; // // invalidateProperties(); } //---------------------------------- // disabledDays //---------------------------------- [Bindable("disabledDaysChanged")] [Inspectable(arrayType="Date")] /** * The days to disable in a week. * All the dates in a month, for the specified day, are disabled. * This property changes the appearance of the DateChooser control. * The elements of this array can have values from 0 (Sunday) to * 6 (Saturday). * For example, a value of
[ 0, 6 ]
* disables Sunday and Saturday.
*
* @default []
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
public function get disabledDays():Array
{
trace("get disabledDays not implemented.");
return null;
}
/**
* @private
*/
public function set disabledDays(value:Array):void
{
trace("set disabledDays not implemented");
// _disabledDays = value;
// disabledDaysChanged = true;
//
// invalidateProperties();
}
//----------------------------------
// disabledRanges
//----------------------------------
[Bindable("disabledRangesChanged")]
[Inspectable(arrayType="Object")]
/**
* Disables single and multiple days.
*
* This property accepts an Array of objects as a parameter.
* Each object in this array is a Date object, specifying a
* single day to disable; or an object containing either or both
* of the rangeStart and rangeEnd properties,
* each of whose values is a Date object.
* The value of these properties describes the boundaries
* of the date range.
* If either is omitted, the range is considered
* unbounded in that direction.
* If you specify only rangeStart,
* all the dates after the specified date are disabled,
* including the rangeStart date.
* If you specify only rangeEnd,
* all the dates before the specified date are disabled,
* including the rangeEnd date.
* To disable a single day, use a single Date object specifying a date
* in the Array. Time values are zeroed out from the Date
* object if they are present.
The following example, disables the following dates: January 11 * 2006, the range January 23 - February 10 2006, and March 1 2006 * and all following dates.
* *disabledRanges="{[ new Date(2006,0,11), {rangeStart:
* new Date(2006,0,23), rangeEnd: new Date(2006,1,10)},
* {rangeStart: new Date(2006,2,1)} ]}"
displayedYear property,
* the displayedMonth property specifies the month
* displayed in the DateChooser control.
* Month numbers are zero-based, so January is 0 and December is 11.
* Setting this property changes the appearance of the DateChooser control.
*
* The default value is the current month.
* * * @langversion 3.0 * @playerversion Flash 9 * @playerversion AIR 1.1 * @productversion Flex 3 */ public function get displayedMonth():int { return DateChooserModel(model).displayedMonth; // if (dateGrid && _displayedMonth != dateGrid.displayedMonth) // return dateGrid.displayedMonth; // else // return _displayedMonth; } /** * @private */ public function set displayedMonth(value:int):void { DateChooserModel(model).displayedMonth = value; // if (isNaN(value) || displayedMonth == value) // return; // // _displayedMonth = value; // displayedMonthChanged = true; // // invalidateProperties(); // // if (dateGrid) // dateGrid.displayedMonth = value; // if it's already this value shouldn't do anything } //---------------------------------- // displayedYear //---------------------------------- // [Bindable("scroll")] // [Bindable("viewChanged")] [Inspectable(category="General")] /** * Used together with thedisplayedMonth property,
* the displayedYear property specifies the year
* displayed in the DateChooser control.
* Setting this property changes the appearance of the DateChooser control.
*
* The default value is the current year.
* * @langversion 3.0 * @playerversion Flash 9 * @playerversion AIR 1.1 * @productversion Flex 3 */ public function get displayedYear():int { return DateChooserModel(model).displayedYear; // if (dateGrid) // return dateGrid.displayedYear; // else // return _displayedYear; } /** * @private */ public function set displayedYear(value:int):void { DateChooserModel(model).displayedYear = value; // if (isNaN(value) || displayedYear == value) // return; // // _displayedYear = value; // displayedYearChanged = true; // // invalidateProperties(); // // if (dateGrid) // dateGrid.displayedYear = value;// if it's already this value shouldn't do anything } //---------------------------------- // firstDayOfWeek //---------------------------------- [Bindable("firstDayOfWeekChanged")] [Inspectable(defaultValue="null")] /** * Number representing the day of the week to display in the * first column of the DateChooser control. * The value must be in the range 0 to 6, where 0 corresponds to Sunday, * the first element of thedayNames Array.
*
* Setting this property changes the order of the day columns. * For example, setting it to 1 makes Monday the first column * in the control.
* * @default 0 (Sunday) * * @langversion 3.0 * @playerversion Flash 9 * @playerversion AIR 1.1 * @productversion Flex 3 */ public function get firstDayOfWeek():Object { return DateChooserModel(model).firstDayOfWeek; } /** * @private */ public function set firstDayOfWeek(value:Object):void { DateChooserModel(model).firstDayOfWeek = Number(value); // firstDayOfWeekOverride = value; // // _firstDayOfWeek = value != null ? // int(value) : // resourceManager.getInt( // "controls", "firstDayOfWeek"); // // // firstDayOfWeekChanged = true; // // invalidateProperties(); } //---------------------------------- // fontContext //---------------------------------- //---------------------------------- // maxYear //---------------------------------- /** * @private * Storage for the maxYear property. */ private var _maxYear:int = 2100; /** * The last year selectable in the control. * * @default 2100 * * @langversion 3.0 * @playerversion Flash 9 * @playerversion AIR 1.1 * @productversion Flex 3 */ public function get maxYear():int { return _maxYear; } /** * @private */ public function set maxYear(value:int):void { if (_maxYear == value) return; _maxYear = value; } //---------------------------------- // minYear //---------------------------------- /** * @private * Storage for the minYear property. */ private var _minYear:int = 1900; /** * The first year selectable in the control. * * @default 1900 * * @langversion 3.0 * @playerversion Flash 9 * @playerversion AIR 1.1 * @productversion Flex 3 */ public function get minYear():int { return _minYear; } /** * @private */ public function set minYear(value:int):void { if (_minYear == value) return; _minYear = value; } //---------------------------------- // monthNames //---------------------------------- [Bindable("monthNamesChanged")] [Inspectable(arrayType="String", defaultValue="null")] /** * Names of the months displayed at the top of the DateChooser control. * ThemonthSymbol property is appended to the end of
* the value specified by the monthNames property,
* which is useful in languages such as Japanese.
*
* @default [ "January", "February", "March", "April", "May", "June",
* "July", "August", "September", "October", "November", "December" ]
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
public function get monthNames():Array
{
return DateChooserModel(model).monthNames;
}
/**
* @private
*/
public function set monthNames(value:Array):void
{
DateChooserModel(model).monthNames = value;
// monthNamesOverride = value;
//
// _monthNames = value != null ?
// value :
// resourceManager.getStringArray(
// "SharedResources", "monthNames");
//
// // _monthNames will be null if there are no resources.
// _monthNames = _monthNames ? monthNames.slice(0) : null;
//
// monthNamesChanged = true;
//
// invalidateProperties();
// invalidateSize();
}
//----------------------------------
// selectableRange
//----------------------------------
/**
* @private
* Storage for the selectableRange property.
*/
private var _selectableRange:Object;
/**
* @private
*/
private var selectableRangeChanged:Boolean = false;
[Bindable("selectableRangeChanged")]
/**
* Range of dates between which dates are selectable.
* For example, a date between 04-12-2006 and 04-12-2007
* is selectable, but dates out of this range are disabled.
*
* This property accepts an Object as a parameter.
* The Object contains two properties, rangeStart
* and rangeEnd, of type Date.
* If you specify only rangeStart,
* all the dates on and after the specified date are enabled.
* If you only specify rangeEnd,
* all the dates on and before the specified date are enabled.
* To enable only a single day in a DateChooser control,
* you can pass a Date object directly. Time values are
* zeroed out from the Date object if they are present.
The following example enables only the range * January 1, 2006 through June 30, 2006. Months before January * and after June do not appear in the DateChooser.
* *selectableRange="{{rangeStart : new Date(2006,0,1),
* rangeEnd : new Date(2006,5,30)}}"
Holding down the Control key when selecting the
* currently selected date in the control deselects it,
* sets the selectedDate property to null,
* and then dispatches the change event.
This property accepts an Array of objects as a parameter.
* Each object in this array has two date Objects,
* rangeStart and rangeEnd.
* The range of dates between each set of rangeStart
* and rangeEnd (inclusive) are selected.
* To select a single day, set both rangeStart and rangeEnd
* to the same date. Time values are zeroed out from the Date
* object if they are present.
The following example, selects the following dates: January 11 * 2006, the range January 23 - February 10 2006.
* *selectedRanges="{[ {rangeStart: new Date(2006,0,11),
* rangeEnd: new Date(2006,0,11)}, {rangeStart:new Date(2006,0,23),
* rangeEnd: new Date(2006,1,10)} ]}"
true, specifies that today is highlighted
* in the DateChooser control.
* Setting this property changes the appearance of the DateChooser control.
*
* @default true
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
public function get showToday():Boolean
{
return _showToday;
}
/**
* @private
*/
public function set showToday(value:Boolean):void
{
_showToday = value;
showTodayChanged = true;
// invalidateProperties();
}
//--------------------------------------------------------------------------
//
// Overridden methods: UIComponent
//
//--------------------------------------------------------------------------
//--------------------------------------------------------------------------
//
// Methods
//
//--------------------------------------------------------------------------
/**
* @private
* This method scrubs out time values from incoming date objects
*/
mx_internal function scrubTimeValue(value:Object):Object
{
if (value is Date)
{
return new Date(value.getFullYear(), value.getMonth(), value.getDate());
}
else if (value is Object)
{
var range:Object = {};
if (value.hasOwnProperty("rangeStart") && value.rangeStart is Date)
{
range.rangeStart = new Date(value.rangeStart.getFullYear(),
value.rangeStart.getMonth(),
value.rangeStart.getDate());
}
if (value.hasOwnProperty("rangeEnd") && value.rangeEnd is Date)
{
range.rangeEnd = new Date(value.rangeEnd.getFullYear(),
value.rangeEnd.getMonth(),
value.rangeEnd.getDate());
}
return range;
}
return null;
}
/**
* @private
* This method scrubs out time values from incoming date objects
*/
mx_internal function scrubTimeValues(values:Array):Array
{
var dates:Array = [];
for (var i:int = 0; i < values.length; i++)
{
dates[i] = scrubTimeValue(values[i]);
}
return dates;
}
//----------------------------------
// yearNavigationEnabled
//----------------------------------
/**
* @private
* Storage for the yearNavigationEnabled property.
*/
private var _yearNavigationEnabled:Boolean = false;
/**
* @private
*/
//private var yearNavigationEnabledChanged:Boolean = false;
[Bindable("yearNavigationEnabledChanged")]
[Inspectable(defaultValue="false")]
/**
* Enables year navigation. When true
* an up and down button appear to the right
* of the displayed year. You can use these buttons
* to change the current year.
* These button appear to the left of the year in locales where year comes
* before the month in the date format.
*
* @default false
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
public function get yearNavigationEnabled():Boolean
{
return _yearNavigationEnabled;
}
/**
* @private
*/
public function set yearNavigationEnabled(value:Boolean):void
{
_yearNavigationEnabled = value;
// yearNavigationEnabledChanged = true;
// invalidateProperties();
}
//--------------------------------------------------------------------------
//
// Overridden event handlers: UIComponent
//
//--------------------------------------------------------------------------
//--------------------------------------------------------------------------
//
// Event handlers
//
//--------------------------------------------------------------------------
override public function addedToParent():void
{
super.addedToParent();
// Load the layout bead if it hasn't already been loaded.
loadBeadFromValuesManager(IBeadLayout, "iBeadLayout", this);
dispatchEvent(new Event("initComplete"));
}
/**
* Returns the ILayoutHost which is its view. From ILayoutParent.
*
* @langversion 3.0
* @playerversion Flash 10.2
* @playerversion AIR 2.6
* @productversion Royale 0.8
* @royaleignorecoercion org.apache.royale.core.ILayoutHost
*/
public function getLayoutHost():ILayoutHost
{
return view as ILayoutHost;
}
}
}