DateEditor¶

Контрол DateEditor содержит всплывающий календарь, который позволяет пользователям выбирать дату. Редактор поддерживает несколько форматов отображения значения даты, отображаемого в поле редактирования.

dateeditor

Всплывающий календарь содержит заголовок навигации, используемый для просмотра по месяцам и годам. Кнопки "Сегодня" и "Очистить" помогают пользователям быстро выбрать сегодняшнюю дату и очистить текущее значение соответственно.

Основные функции контрола включают в себя:

Выбор даты в всплывающем календаре с помощью мыши.
Просматривайте месяцы и годы с помощью панели навигации.
Три вида календаря: просмотр по месяцам, просмотр по годам и просмотр по диапазону лет.
Встроенные кнопки "Сегодня" и "Очистить".
Ограничение доступного диапазона дат.
Множество форматов отображения выбранного значения даты в поле редактирования.

Выберите дату¶

Пользователь может выбрать дату, открыв всплывающее окно и выбрав дату в появившемся календаре.

Навигационный заголовок всплывающего календаря позволяет пользователю просматривать месяцы и годы:

DateEditor - select date

В коде вы можете указать дату или прочитать текущую выбранную дату с помощью свойства DateEditor.DateTime или DateEditor.EditorValue. Эти свойства синхронизированы. Они различаются типом значения: свойство DateTime имеет тип System.DateTime с возможностью обнуления, в то время как свойство EditorValue имеет тип object, как и во всех редакторах Eremex.

Настройка всплывающего календаря¶

Используйте следующие свойства для настройки календаря контрола DateEditor:

ShowToday — Возвращает или устанавливает, следует ли выделять сегодняшнюю дату в календаре.
NullValueButtonPosition — Возвращает или устанавливает, видна ли кнопка ('x') (очистить значение).
MinValue — Указывает минимально допустимую дату. Свойства MinValue и MaxValue позволяют указать диапазон значений, отображаемых в календаре.
MaxValue — Указывает максимально допустимую дату.

Пример - Как создать DateEditor¶

В следующем примере определяется DateEditor, устанавливается начальное значение и указывается допустимый диапазон дат.

xmlns:mxe="https://schemas.eremexcontrols.net/avalonia/editors"

<Window.DataContext>
    <local:MainViewModel/>
</Window.DataContext>

<mxe:DateEditor 
    DateTime="{Binding SelectedDate, Mode=TwoWay}" 
    MinValue="{Binding MinimumDate}" 
    MaxValue="{Binding MaximumDate}" />

using CommunityToolkit.Mvvm.ComponentModel;
using System.Collections.ObjectModel;

[ObservableObject]
public partial class MainViewModel
{
    [ObservableProperty]
    DateTime selectedDate = DateTime.Now;
    [ObservableProperty]
    DateTime minimumDate = DateTime.Now.AddDays(-15);
    [ObservableProperty] 
    DateTime maximumDate = DateTime.Now.AddDays(15);
}

Укажите формат отображения значения¶

Используйте свойство DisplayFormatString, чтобы задать формат отображения значения даты/времени, отображаемого в поле редактирования.

Предотвращение всплывающих окон в редакторах, доступных только для чтения¶

Дефолтное поведение любого Popup Editor заключается в том, чтобы разрешить пользователю открывать всплывающее окно редактора даже в режиме только для чтения, хотя он не может изменять значения ни через поле редактирования, ни через всплывающее окно. Чтобы отключить всплывающие окна для редакторов, доступных только для чтения, установите для свойства ShowPopupIfReadOnly значение false.

^* Эта страница была создана автоматически с помощью сервиса машинного перевода Яндекс Переводчик.