Методы

• setDayCellFactory

  public final void setDayCellFactory​(Callback<DatePicker,​DateCell> value)

  Устанавливает значение свойства dayCellFactory.

  Описание свойства:

  Можно указать пользовательскую фабрику ячеек для настройки отдельных ячеек дней в всплывающем окне DatePicker. Для получения дополнительной информации о фабриках ячеек обратитесь к DateCell и Cell. Пример:

  
   final Callback<DatePicker, DateCell> dayCellFactory = new Callback<DatePicker, DateCell>() {
       public DateCell call(final DatePicker datePicker) {
           return new DateCell() {
               @Override public void updateItem(LocalDate item, boolean empty) {
                   super.updateItem(item, empty);
  
                   if (MonthDay.from(item).equals(MonthDay.of(9, 25))) {
                       setTooltip(new Tooltip("Happy Birthday!"));
                       setStyle("-fx-background-color: #ff4444;");
                   }
                   if (item.equals(LocalDate.now().plusDays(1))) {
                       // Tomorrow is too soon.
                       setDisable(true);
                   }
               }
           };
       }
   };
   datePicker.setDayCellFactory(dayCellFactory);
   

  Значение по умолчанию:

  null

• getDayCellFactory

  public final Callback<DatePicker,​DateCell> getDayCellFactory()

  Возвращает значение свойства dayCellFactory.

  Описание свойства:

  Можно указать пользовательскую фабрику ячеек для настройки отдельных ячеек дней в всплывающем окне DatePicker. Для получения дополнительной информации о фабриках ячеек обратитесь к DateCell и Cell. Пример:

  
   final Callback<DatePicker, DateCell> dayCellFactory = new Callback<DatePicker, DateCell>() {
       public DateCell call(final DatePicker datePicker) {
           return new DateCell() {
               @Override public void updateItem(LocalDate item, boolean empty) {
                   super.updateItem(item, empty);
  
                   if (MonthDay.from(item).equals(MonthDay.of(9, 25))) {
                       setTooltip(new Tooltip("Happy Birthday!"));
                       setStyle("-fx-background-color: #ff4444;");
                   }
                   if (item.equals(LocalDate.now().plusDays(1))) {
                       // Tomorrow is too soon.
                       setDisable(true);
                   }
               }
           };
       }
   };
   datePicker.setDayCellFactory(dayCellFactory);
   

  Значение по умолчанию:

  null

• dayCellFactoryProperty

  public final ObjectProperty<Callback<DatePicker,​DateCell>> dayCellFactoryProperty()

  Можно указать пользовательскую фабрику ячеек для настройки отдельных ячеек дней в всплывающем окне DatePicker. Для получения дополнительной информации о фабриках ячеек обратитесь к DateCell и Cell. Пример:

  
   final Callback<DatePicker, DateCell> dayCellFactory = new Callback<DatePicker, DateCell>() {
       public DateCell call(final DatePicker datePicker) {
           return new DateCell() {
               @Override public void updateItem(LocalDate item, boolean empty) {
                   super.updateItem(item, empty);
  
                   if (MonthDay.from(item).equals(MonthDay.of(9, 25))) {
                       setTooltip(new Tooltip("Happy Birthday!"));
                       setStyle("-fx-background-color: #ff4444;");
                   }
                   if (item.equals(LocalDate.now().plusDays(1))) {
                       // Tomorrow is too soon.
                       setDisable(true);
                   }
               }
           };
       }
   };
   datePicker.setDayCellFactory(dayCellFactory);
   

  Значение по умолчанию:

  null

  См. также:

  getDayCellFactory(), setDayCellFactory(Callback)

• chronologyProperty

  public final ObjectProperty<Chronology> chronologyProperty()

  Система календаря, используемая для анализа, отображения и выбора дат в элементе управления DatePicker.

  Значение по умолчанию возвращается из вызова Chronology.ofLocale(Locale.getDefault(Locale.Category.FORMAT)). Значение по умолчанию обычно IsoChronology, если явно не указано в Locale с помощью расширения календаря Locale. Установка значения в null восстановит систему календаря по умолчанию.

  См. также:

  getChronology(), setChronology(Chronology)

• getChronology

  public final Chronology getChronology()

  Возвращает значение свойства chronology.

  Описание свойства:

  Система календаря, используемая для анализа, отображения и выбора дат в элементе управления DatePicker.

  Значение по умолчанию возвращается из вызова Chronology.ofLocale(Locale.getDefault(Locale.Category.FORMAT)). Значение по умолчанию обычно IsoChronology, если явно не указано в Locale с помощью расширения календаря Locale. Установка значения в null восстановит систему календаря по умолчанию.

• setChronology

  public final void setChronology​(Chronology value)

  Устанавливает значение свойства chronology.

  Описание свойства:

  Система календаря, используемая для анализа, отображения и выбора дат в элементе управления DatePicker.

  Значение по умолчанию возвращается из вызова Chronology.ofLocale(Locale.getDefault(Locale.Category.FORMAT)). Значение по умолчанию обычно IsoChronology, если явно не указано в Locale с помощью расширения календаря Locale. Установка значения в null восстановит систему календаря по умолчанию.

• showWeekNumbersProperty

  public final BooleanProperty showWeekNumbersProperty()

  Определяет, должен ли всплывающий список DatePicker отображать столбец с номерами недель.

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

  См. также:

  isShowWeekNumbers(), setShowWeekNumbers(boolean)

• setShowWeekNumbers

  public final void setShowWeekNumbers​(boolean value)

  Устанавливает значение свойства showWeekNumbers.

  Описание свойства:

  Определяет, должен ли всплывающий список DatePicker отображать столбец с номерами недель.

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

• isShowWeekNumbers

  public final boolean isShowWeekNumbers()

  Возвращает значение свойства showWeekNumbers.

  Описание свойства:

  Определяет, должен ли всплывающий список DatePicker отображать столбец с номерами недель.

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

• converterProperty

  public final ObjectProperty<StringConverter<LocalDate>> converterProperty()

  Преобразует входной текст в объект типа LocalDate и наоборот.

  Если не задано приложением, класс кожи DatePicker установит преобразователь, основанный на DateTimeFormatter для текущего Locale и chronology. Этот форматер используется для анализа и отображения текущего значения даты. Установка значения в null восстановит преобразователь по умолчанию.

  Пример использования явного форматера:

  
   datePicker.setConverter(new StringConverter<LocalDate>() {
       String pattern = "yyyy-MM-dd";
       DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern(pattern);
  
       {
           datePicker.setPromptText(pattern.toLowerCase());
       }
  
       @Override public String toString(LocalDate date) {
           if (date != null) {
               return dateFormatter.format(date);
           } else {
               return "";
           }
       }
  
       @Override public LocalDate fromString(String string) {
           if (string != null && !string.isEmpty()) {
               return LocalDate.parse(string, dateFormatter);
           } else {
               return null;
           }
       }
   });
   

  Пример, который оборачивает форматер по умолчанию и обрабатывает исключения анализа:

  
     final StringConverter<LocalDate> defaultConverter = datePicker.getConverter();
     datePicker.setConverter(new StringConverter<LocalDate>() {
         @Override public String toString(LocalDate value) {
             return defaultConverter.toString(value);
         }
  
         @Override public LocalDate fromString(String text) {
             try {
                 return defaultConverter.fromString(text);
             } catch (DateTimeParseException ex) {
                 System.err.println("HelloDatePicker: "+ex.getMessage());
                 throw ex;
             }
         }
     });
   

  Базовый год по умолчанию для анализа входных данных, содержащих только две цифры для года, составляет 2000 (см. DateTimeFormatter). Это значение по умолчанию не подходит для ввода даты рождения. В следующем примере метод fromString() преобразователя модифицируется для поддержки двухзначного года для дат рождения до 99 лет в прошлом.

  
     @Override public LocalDate fromString(String text) {
         if (text != null && !text.isEmpty()) {
             Locale locale = Locale.getDefault(Locale.Category.FORMAT);
             Chronology chrono = datePicker.getChronology();
             String pattern =
                 DateTimeFormatterBuilder.getLocalizedDateTimePattern(FormatStyle.SHORT,
                                                                      null, chrono, locale);
             String prePattern = pattern.substring(0, pattern.indexOf("y"));
             String postPattern = pattern.substring(pattern.lastIndexOf("y")+1);
             int baseYear = LocalDate.now().getYear() - 99;
             DateTimeFormatter df = new DateTimeFormatterBuilder()
                         .parseLenient()
                         .appendPattern(prePattern)
                         .appendValueReduced(ChronoField.YEAR, 2, 2, baseYear)
                         .appendPattern(postPattern)
                         .toFormatter();
             return LocalDate.from(chrono.date(df.parse(text)));
         } else {
             return null;
         }
     }
   

  См. также:

  getConverter(), setConverter(StringConverter)

• setConverter

  public final void setConverter​(StringConverter<LocalDate> value)

  Устанавливает значение свойства converter.

  Описание свойства:

  Преобразует входной текст в объект типа LocalDate и наоборот.

  Если не задано приложением, класс кожи DatePicker установит преобразователь, основанный на DateTimeFormatter для текущего Locale и chronology. Этот форматер используется для анализа и отображения текущего значения даты. Установка значения в null восстановит преобразователь по умолчанию.

  Пример использования явного форматера:

  
   datePicker.setConverter(new StringConverter<LocalDate>() {
       String pattern = "yyyy-MM-dd";
       DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern(pattern);
  
       {
           datePicker.setPromptText(pattern.toLowerCase());
       }
  
       @Override public String toString(LocalDate date) {
           if (date != null) {
               return dateFormatter.format(date);
           } else {
               return "";
           }
       }
  
       @Override public LocalDate fromString(String string) {
           if (string != null && !string.isEmpty()) {
               return LocalDate.parse(string, dateFormatter);
           } else {
               return null;
           }
       }
   });
   

  Пример, который оборачивает форматер по умолчанию и обрабатывает исключения анализа:

  
     final StringConverter<LocalDate> defaultConverter = datePicker.getConverter();
     datePicker.setConverter(new StringConverter<LocalDate>() {
         @Override public String toString(LocalDate value) {
             return defaultConverter.toString(value);
         }
  
         @Override public LocalDate fromString(String text) {
             try {
                 return defaultConverter.fromString(text);
             } catch (DateTimeParseException ex) {
                 System.err.println("HelloDatePicker: "+ex.getMessage());
                 throw ex;
             }
         }
     });
   

  Базовый год по умолчанию для анализа входных данных, содержащих только две цифры для года, составляет 2000 (см. DateTimeFormatter). Это значение по умолчанию не подходит для ввода даты рождения. В следующем примере метод fromString() преобразователя модифицируется для поддержки двухзначного года для дат рождения до 99 лет в прошлом.

  
     @Override public LocalDate fromString(String text) {
         if (text != null && !text.isEmpty()) {
             Locale locale = Locale.getDefault(Locale.Category.FORMAT);
             Chronology chrono = datePicker.getChronology();
             String pattern =
                 DateTimeFormatterBuilder.getLocalizedDateTimePattern(FormatStyle.SHORT,
                                                                      null, chrono, locale);
             String prePattern = pattern.substring(0, pattern.indexOf("y"));
             String postPattern = pattern.substring(pattern.lastIndexOf("y")+1);
             int baseYear = LocalDate.now().getYear() - 99;
             DateTimeFormatter df = new DateTimeFormatterBuilder()
                         .parseLenient()
                         .appendPattern(prePattern)
                         .appendValueReduced(ChronoField.YEAR, 2, 2, baseYear)
                         .appendPattern(postPattern)
                         .toFormatter();
             return LocalDate.from(chrono.date(df.parse(text)));
         } else {
             return null;
         }
     }
   

• getConverter

  public final StringConverter<LocalDate> getConverter()

  Получает значение свойства конвертера.

  Описание свойства:

  Преобразует входной текст в объект типа LocalDate и обратно.

  Если не задано приложением, класс кожи DatePicker установит конвертер, основанный на DateTimeFormatter для текущего Locale и chronology. Этот форматировщик используется для разбора и отображения текущего значения даты. Установка значения в null восстановит конвертер по умолчанию.

  Пример использования явного форматировщика:

  
   datePicker.setConverter(new StringConverter<LocalDate>() {
       String pattern = "yyyy-MM-dd";
       DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern(pattern);
  
       {
           datePicker.setPromptText(pattern.toLowerCase());
       }
  
       @Override public String toString(LocalDate date) {
           if (date != null) {
               return dateFormatter.format(date);
           } else {
               return "";
           }
       }
  
       @Override public LocalDate fromString(String string) {
           if (string != null && !string.isEmpty()) {
               return LocalDate.parse(string, dateFormatter);
           } else {
               return null;
           }
       }
   });
   

  Пример, который оборачивает форматировщик по умолчанию и перехватывает исключения разбора:

  
     final StringConverter<LocalDate> defaultConverter = datePicker.getConverter();
     datePicker.setConverter(new StringConverter<LocalDate>() {
         @Override public String toString(LocalDate value) {
             return defaultConverter.toString(value);
         }
  
         @Override public LocalDate fromString(String text) {
             try {
                 return defaultConverter.fromString(text);
             } catch (DateTimeParseException ex) {
                 System.err.println("HelloDatePicker: "+ex.getMessage());
                 throw ex;
             }
         }
     });
   

  Базовый год по умолчанию для разбора входных данных, содержащих только две цифры для года, составляет 2000 (см. DateTimeFormatter). По умолчанию не подходит для ввода даты рождения. Следующий пример изменяет метод fromString() конвертера, чтобы разрешить двухзначный год для дат рождения до 99 лет назад.

  
     @Override public LocalDate fromString(String text) {
         if (text != null && !text.isEmpty()) {
             Locale locale = Locale.getDefault(Locale.Category.FORMAT);
             Chronology chrono = datePicker.getChronology();
             String pattern =
                 DateTimeFormatterBuilder.getLocalizedDateTimePattern(FormatStyle.SHORT,
                                                                      null, chrono, locale);
             String prePattern = pattern.substring(0, pattern.indexOf("y"));
             String postPattern = pattern.substring(pattern.lastIndexOf("y")+1);
             int baseYear = LocalDate.now().getYear() - 99;
             DateTimeFormatter df = new DateTimeFormatterBuilder()
                         .parseLenient()
                         .appendPattern(prePattern)
                         .appendValueReduced(ChronoField.YEAR, 2, 2, baseYear)
                         .appendPattern(postPattern)
                         .toFormatter();
             return LocalDate.from(chrono.date(df.parse(text)));
         } else {
             return null;
         }
     }
   

• getEditor

  public final TextField getEditor()

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

  Описание свойства:

  Редактор для DatePicker.

• editorProperty

  public final ReadOnlyObjectProperty<TextField> editorProperty()

  Редактор для DatePicker.

  См. также:

  getEditor()

• createDefaultSkin

  protected Skin<?> createDefaultSkin()

  Создаёт новый экземпляр стандартной кожи для этого элемента управления. Вызывается для создания кожи для элемента управления, если кожа не задана через CSS -fx-skin или не задана явно в подклассе с помощью setSkin(...).

  Переопределяет:

  createDefaultSkin в классе Control

  Возвращает:

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

• getClassCssMetaData

  public static List<CssMetaData<? extends Styleable,​?>> getClassCssMetaData()

  Возвращает:

  CssMetaData, связанная с этим классом, которая может включать CssMetaData его суперклассов.

• getControlCssMetaData

  public List<CssMetaData<? extends Styleable,​?>> getControlCssMetaData()

  Переопределяет:

  getControlCssMetaData в классе Control

  Возвращает:

  неизменяемый список свойств стиля CSS элементов управления

  С тех пор:

  JavaFX 8.0

• queryAccessibleAttribute

  public Object queryAccessibleAttribute​(AccessibleAttribute attribute,
                                         Object... parameters)

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

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

  Переопределяет:

  queryAccessibleAttribute в классе ComboBoxBase<LocalDate>

  Параметры:

  attribute - запрашиваемый атрибут

  parameters - необязательный список параметров

  Возвращает:

  значение запрашиваемого атрибута

  См. также:

  AccessibleAttribute