DateField  - AS3 Flex

Свойство data позволяет передавать значение в компонент при его использовании в средстве визуализации или в редакторе элементов. Привязка данных, как правило, используется для привязки поля свойства data к свойству данного компонента.

При использовании элемента управления в качестве средства визуализации или редактора вставных элементов Flex автоматически записывает текущее значение элемента в свойство selectedDate этого элемента управления.

Значением по умолчанию является null.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие dataChange .

Связанные элементы API

Названия дней недели для элемента управления DateChooser. Изменение этого свойства приводит к изменению меток дней в элементе управления DateChooser. Первым днем является воскресенье (с индексом 0). Остальные названия дней недели следуют в обычном порядке.

Значением по умолчанию является [ "S", "M", "T", "W", "T", "F", "S" ].

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие dayNamesChanged .

Дни недели, подлежащие деактивации. Деактивируются все даты в пределах месяца, соответствующие указанному дню. Это свойство незамедлительно изменяет пользовательский интерфейс элемента управления DateChooser. Элементы этого массива могут иметь значения от 0 (воскресенье) до 6 (суббота). Например, значение [0, 6] деактивирует воскресенье и субботу.

Значением по умолчанию является [].

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие disabledDaysChanged .

Позволяет деактивировать один или несколько дней.

Это свойство принимает массив объектов в качестве параметра. Каждый объект в этом массиве является объектом Date, который указывает один день, подлежащий деактивации; или объектом, содержащим одно или оба свойства rangeStart и rangeEnd, каждое из значений которых представляет собой объект Date. Значение этих свойств указывает границы диапазона дат. Если любое из значений опущено, диапазон рассматривается как неограниченный в соответствующем направлении. Если определено только свойство rangeStart, деактивируются все даты после указанной даты, включая дату rangeStart. Если определено только свойство rangeEnd, деактивируются все даты, предшествующие указанной дате, включая дату rangeEnd. Для деактивации одного дня используется отдельный объект Date в массиве, который указывает определенную дату. Значения времени при наличии заполняются нулями из объекта Date.

Например, требуется деактивировать следующие даты: 11 января 2006 г. в диапазоне от 23 января до 10 февраля 2006 г., а также 1 марта 2006 г. и все последующие даты.

disabledRanges="{[new Date(2006,0,11), {rangeStart:
      new Date(2006,0,23), rangeEnd: new Date(2006,1,10)},
      {rangeStart: new Date(2006,2,1)}]}"

При установке значения для этого свойства внешний вид элемента управления DateChooser незамедлительно изменяется, если деактивированные даты включены в свойства displayedMonth и displayedYear.

Значением по умолчанию является [].

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие disabledRangesChanged .

Используется со свойством displayedYear. Свойство displayedMonth указывает месяц, отображаемый в элементе управления DateChooser. Номера месяцев отсчитываются от нуля, таким образом, январь указывается как 0, а декабрь – как 11. При установке значения для этого свойства незамедлительно изменяется внешний вид элемента управления DateChooser. Значением по умолчанию является номер текущего месяца.

Значением по умолчанию является текущий месяц.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие displayedMonthChanged .

Используется со свойством displayedMonth. Свойство displayedYear определяет год, который отображается в элементе управления DateChooser. При установке значения для этого свойства незамедлительно изменяется внешний вид элемента управления DateChooser.

Значением по умолчанию является текущий год.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие displayedYearChanged .

Содержит ссылку на элемент управления DateChooser, который содержится в элементе управления DateField. Используемый класс можно определить с помощью dropdownFactory в том случае, если он расширяет DateChooser.

IFactory для создания экземпляра на основе DateChooser с целью использования в качестве определителя даты. Значением по умолчанию для DateChooser является IFactory.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие dropdownFactoryChanged .

День недели (от 0 до 6, где 0 является первым элементом массива dayNames), отображаемый в первом столбце элемента управления DateChooser. При установке значения для этого свойства изменяется порядок следования столбцов с названиями дней недели.

Значением по умолчанию является 0 (Sunday).

Формат отображаемой даты в текстовом поле. Это свойство может содержать любое сочетание значений ММ, DD, YY, YYYY, а также разделители и символы пунктуации.

Значением по умолчанию является "MM/DD/YYYY".

Функция для форматирования даты, отображаемой в текстовом поле элемента управления DateField. Если функция не указана, используется формат по умолчанию.

Функция принимает в качестве аргумента объект Date и возвращает строку в указанном формате, как показано ниже:

      public function formatDate(currentDate:Date):String {
          ...
          return dateString;
      }

Если пользователь может вводить дату в текстовое поле элемента управления DateField, а функция форматирования определена с помощью свойства labelFunction, необходимо указать функцию в свойстве parseFunction, которая преобразует входную текстовую строку в объект Date для использования элементом управления DateField, либо установить для свойства parseFunction значение null.

Значением по умолчанию является null.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие labelFunctionChanged .

Связанные элементы API

При использовании компонента в качестве средства визуализации или редактора вставных элементов Flex инициализирует свойство компонента listData с соответствующими данными из элемента управления List. Затем компонент может использовать свойство listData для инициализации свойства data средства визуализации или редактора вставных объектов.

Это свойство не устанавливается в MXML или ActionScript; Flex устанавливает его, когда компонент используется как средство визуализации или редактор вставных элементов.

Значением по умолчанию является null.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие dataChange .

Связанные элементы API

Последний год, который можно выбрать в элементе управления.

Значением по умолчанию является 2100.

Первый год, который можно выбрать в элементе управления.

Значением по умолчанию является 1900.

Имена месяцев, отображаемые в верхней области элемента управления. Свойство monthSymbol добавляется в конец значения, указанного свойством monthNames, которое рекомендуется использовать в таких языках, как японский.

Значением по умолчанию является [ "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" ].

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие monthNamesChanged .

Это свойство добавляется в конец значения, указанного свойством monthNames, для определения названий месяцев, отображаемых в верхней области элемента управления. В некоторых языках, например в японском, после названия месяца используется специальный символ.

Значением по умолчанию является "".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие monthSymbolChanged .

Функция, используемая для анализа даты, введенной в виде текста в области текстового поля элемента управления DateField, и возврата объекта Date в элемент управления. Если функция не указана, Flex использует функцию по умолчанию. Если установлено соответствующее значение для свойства parseFunction, оно, как правило, выполняет функцию, обратную указанной в свойстве labelFunction.

Функция принимает два аргумента и возвращает объект Date в элемент управления DateField, например:

      public function parseDate(valueString:String, inputFormat:String):Date {
          ...
          return newDate
      }

Здесь аргумент valueString содержит текстовую строку, введенную пользователем в текстовое поле, а аргумент inputFormat содержит формат строки. Так, если пользователь ограничен при вводе текстовой строки двумя символами для месяца, дня и года, то в аргумент inputFormat передается MM/DD/YY.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие parseFunctionChanged .

Связанные элементы API

Диапазон доступных для выбора дат. Например, можно выбрать дату между 04-12-2006 и 04-12-2007, но даты вне этого диапазона для выбора недоступны.

Это свойство принимает объект в качестве параметра. Объект содержит два свойства типа Date: rangeStart и rangeEnd. Если указано только значение для rangeStart, будут активированы все даты после указанной даты. Если указано только значение для rangeEnd, будут активированы все даты до указанной даты. Для активации только одной даты в элементе управления DateChooser можно передать объект Date напрямую. Значения времени при наличии заполняются нулями из объекта Date.

В следующем примере активирован только диапазон с 1 января 2006 года по 30 июня 2006 года. Месяцы до января и после июня не отображаются в DateChooser.

selectableRange="{{rangeStart : new Date(2006,0,1),
      rangeEnd : new Date(2006,5,30)}}"

Значением по умолчанию является null.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие selectableRangeChanged .

Дата, выбранная в элементе управления DateChooser. Использует в качестве параметра объект Date. Если входящий объект Date имеет значения времени, они заполняются нулями.

Нажатие клавиши Ctrl при выборе выделенной в данной момент даты приводит к снятию выделения, устанавливает свойство selectedDate в значение null, а затем отправляет событие change.

Значением по умолчанию является null.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие selectedDateChanged .

Значение true указывает, что текущая дата выделена в элементе управления DateChooser. При установке значения для этого свойства незамедлительно изменяется внешний вид элемента управления DateChooser.

Значением по умолчанию является true.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие showTodayChanged .

Активирует навигацию по годам. Если значение true, справа от года появляются кнопки для перехода вверх и вниз. Эти кнопки используются для изменения текущего года. В языках, в которых в формате даты год указывается перед месяцем, эти кнопки отображаются слева от года.

Значением по умолчанию является false.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие yearNavigationEnabledChanged .