Выбранная дата, заданная как datetime объект в области значений Limits свойство. Чтобы сделать выбранную дату неопределенной, задайте для этого свойства значение NaT.

Если заданное datetime объект содержит информацию о времени, в Value сохраняется только информация о дате свойство.

Пример: d = uidatepicker('Value',datetime('today'))

Типы данных: datetime

Текст-заполнитель, заданный как вектор символов или строковый скаляр. Заполнитель предоставляет краткий намек, чтобы описать ожидаемый вход. Текст отображается только когда Value свойство NaT.

Пример: 'aaaa/mm/dd'

Пределы выбора, заданные как 1 на 2 datetime массив. Второе значение в этом массиве должно быть позже первого значения. Значение по умолчанию [datetime(0000,1,1) datetime(9999,12,31)]. Это значение по умолчанию начинается с самой ранней возможной даты и заканчивается самой последней возможной датой, которая DatePicker поддерживает.

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

Пример: d = uidatepicker('Limits',[datetime('today') datetime(2050,1,1)])

Типы данных: datetime

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

В указанном формате должны использоваться допустимые идентификаторы букв, которые соответствуют Юникоду^® Язык разметки данных локали (LDML) стандарт для дат и времени. Для разделения полей можно включать небукву символы, такие как дефис, пространство, двоеточие или любые символы, отличные от ASCII.

Пример: d = uidatepicker('DisplayFormat','dd/MM/yy')

Примеры общих форматов

В этой таблице перечислены общие форматы отображения. Примеры показывают форматированный выход для даты, среда, 9 апреля 2014 года.

Все форматы даты и времени

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

Отключенные даты, заданные как m-на-1 datetime массив. Это свойство задает даты, которые недоступны для выбора в запущенном приложении.

Пример: d = uidatepicker('DisabledDates',datetime(2018,1,1)) отключается 1 января 2018 года.

The datetime массив не может содержать никаких NaT значения и даты должны сортироваться в порядке возрастания.

Для повторного включения всех ранее отключенных дат вызовите функцию NaT(0) чтобы создать пустую datetime массив:

d.DisabledDates = NaT(0);

Типы данных: datetime

Отключенные дни недели, указаны как одно из следующего:

Когда вы задаете имена дней с помощью массива ячеек или строкового вектора, код работает только в локаль, который вы записываете код. Чтобы заставить код работать в любом локали, задайте это свойство как вектор чисел.

Типы данных: double | cell | string

Название шрифта, заданная как поддерживаемая системой название шрифта. Шрифт по умолчанию зависит от конкретной операционной системы и локали.

Если указанный шрифт недоступен, то MATLAB^® использует лучшие шрифты из всех шрифтов, доступных в той системе, в которой работает приложение.

Пример: 'Arial'

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

Пример: 14

Толщина шрифта, заданный как одно из следующих значений:

Не все шрифты имеют полужирный шрифт вес. Поэтому установка полужирного шрифта веса может привести к нормальной толщине шрифта.

Угол шрифта, заданный как 'normal' или 'italic'. Установка значения свойства italic выбирает наклонную версию шрифта, если она доступна в системе пользователя приложения.

Цвет шрифта, заданный как триплет RGB, шестнадцатеричный цветовой код или один из опций, перечисленных в таблице.

Триплеты RGB и шестнадцатеричные цветовые коды полезны для определения пользовательских цветов.

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

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию, которые MATLAB использует во многих типах графиков.

Цвет фона, заданный как триплет RGB, шестнадцатеричный цветовой код или один из опций, перечисленных в таблице.

Триплеты RGB и шестнадцатеричные цветовые коды полезны для определения пользовательских цветов.

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

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию, которые MATLAB использует во многих типах графиков.

Состояние видимости, заданное как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

Чтобы ускорить запуск приложения, установите Visible свойство к 'off' для всех компонентов пользовательского интерфейса, которые не должны появляться при запуске.

Разрешить изменение поля редактирования, заданное как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

Установите это свойство на 'on' чтобы разрешить пользователю изменять дату в поле редактирования во время выполнения. The Enable свойство также должно быть установлено в 'on' чтобы разрешить изменения в поле редактирования.

Рабочее состояние, заданное как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

Подсказка, заданная как вектор символов, массив ячеек из векторов символов, строковые массивы или 1-D категориальный массив. Используйте это свойство для отображения сообщения при наведении указателя мыши на компонент во время выполнения. Подсказка отображается, даже когда компонент отключен. Чтобы отобразить несколько линии текста, задайте массив ячеек из векторов символов или строковые массивы. Каждый элемент массива становится отдельной строкой текста. Если вы задаете это свойство как категориальный массив, MATLAB использует значения в массиве, а не полный набор категорий.

Контекстное меню, заданное как ContextMenu объект, созданный с использованием uicontextmenu функция. Используйте это свойство для отображения контекстного меню при щелчке правой кнопкой мыши по компоненту.

Расположение и размер свернутого средства выбора дат относительно родительского контейнера, заданные как вектор формы [left bottom width height]. Эта таблица описывает каждый элемент в векторе.

Все измерения указаны в пикселях модулей.

Расположение и размер свернутого средства выбора дат относительно родительского контейнера, заданные как вектор формы [left bottom width height]. Это значение свойства идентично Position свойство.

Расположение и размер свернутого средства выбора дат относительно родительского контейнера, заданные как вектор формы [left bottom width height]. Это значение свойства идентично Position свойство.

Опции размещения, заданные как GridLayoutOptions объект. Это свойство задает опции для компонентов, являющихся дочерними элементами контейнеров размещения сетки. Если компонент не является дочерним элементом контейнера сетки размещения (для примера он является дочерним элементом рисунка или панели), то это свойство пустое и не имеет эффекта. Однако, если компонент является дочерним элементом контейнера размещения сетки, можно поместить компонент в нужную строку и столбец сетки путем установки Row и Column свойства на GridLayoutOptions объект.

Для примера этот код помещает средство выбора дат в третью строку и второй столбец родительской сетки.

g = uigridlayout([4 3]);
d = uidatepicker(g);
d.Layout.Row = 3;
d.Layout.Column = 2;

Чтобы программа выбора дат охватывала несколько строк или столбцов, задайте Row или Column свойство как двухэлементный вектор. Для примера эта программа выбора дат охватывает столбцы 2 через 3:

d.Layout.Column = [2 3];

Функция изменения значения, заданная как одно из следующего:

The ValueChangedFcn коллбэк выполняется, когда пользователь меняет дату, вводя текстовое поле или расширяя средство выбора даты и выбирая дату.

Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с средством выбора даты. MATLAB передает эту информацию в ValueChangedData объект как второй аргумент функции обратного вызова. В App Designer аргумент называется event. Вы можете получить свойства объекта с помощью записи через точку. Для примера, event.PreviousValue получает ранее выбранную дату. The ValueChangedData объект недоступен для функций обратного вызова, заданных как векторы символов.

В следующей таблице перечислены свойства ValueChangedData объект.

The ValueChangedFcn коллбэк не выполняется, когда пользователь повторно выбирает или повторно вводит текущую выбранную дату. Коллбэк также не выполняется, когда Value свойство изменяется программно.

Дополнительные сведения о создании коллбэков в App Designer см. в разделе Запись коллбэков в App Designer.

Функция создания объектов, заданная в качестве одного из следующих значений:

Дополнительные сведения об указании коллбэка как указателя на функцию, массива ячеек или вектора символов см. в разделе Запись коллбэков в App Designer.

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

Установка CreateFcn свойство в существующем компоненте не имеет никакого эффекта.

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

Функция удаления объектов, заданная в качестве одного из следующих значений:

Дополнительные сведения об указании коллбэка как указателя на функцию, массива ячеек или вектора символов см. в разделе Запись коллбэков в App Designer.

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

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

Прерывание коллбэка, заданное как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

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

Всякий раз, когда MATLAB вызывает коллбэк, этот коллбэк пытается прервать текущий коллбэк (если он существует). The Interruptible свойство объекта, имеющего текущий коллбэк, определяет, разрешено ли прерывание.

Постановка в очередь коллбэков, заданная как 'queue' или 'cancel'. The BusyAction свойство определяет, как MATLAB обрабатывает выполнение прерываний обратного вызова. Существует два состояния коллбэка:

Всякий раз, когда MATLAB вызывает коллбэк, этот коллбэк пытается прервать текущий коллбэк. The Interruptible свойство объекта, имеющего текущий коллбэк, определяет, разрешено ли прерывание. Если прерывание не разрешено, то BusyAction свойство объекта, имеющего прерывание обратного вызова, определяет, будет ли оно сброшено или помещено в очередь. Это возможные значения BusyAction свойство:

Это свойство доступно только для чтения.

Статус удаления, возвращенный как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState.

MATLAB устанавливает BeingDeleted свойство к 'on' когда DeleteFcn коллбэк начинает выполняться. The BeingDeleted свойство остается установленным на 'on' пока объект компонента не перестанет существовать.

Проверьте значение BeingDeleted свойство, чтобы убедиться, что объект не будет удален до запроса или изменения.

Родительский контейнер, заданный как Figure объект, созданный с использованием uifigure функция, или один из ее дочерних контейнеров: Tab, Panel, ButtonGroup, или GridLayout. Если контейнер не задан, MATLAB вызывает uifigure функция для создания нового Figure объект, который служит родительским контейнером.

Видимость указателя на объект, заданная как 'on', 'callback', или 'off'.

Это свойство контролирует видимость объекта в его родительский список дочерних элементов. Когда объект не отображается в родительский список дочерних элементов, он не возвращается с помощью функций, которые получают объекты, просматривая иерархию объектов или запрашивая свойства. Эти функции включают get, findobj, clf, и close. Объекты действительны, даже если они не видны. Если вы можете получить доступ к объекту, можно задать и получить его свойства, и передать его в любую функцию, которая работает с объектами.

Это свойство доступно только для чтения.

Тип графического объекта, возвращенный как 'uidatepicker'.

Идентификатор объекта, заданный как вектор символов или строковый скаляр. Можно задать уникальное Tag значение, которое служит идентификатором для объекта. Когда вам нужен доступ к объекту в другом месте вашего кода, вы можете использовать findobj функция для поиска объекта на основе Tag значение.

Пользовательские данные, заданные как любой массив MATLAB. Для примера можно задать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Используйте это свойство для хранения произвольных данных на объекте.

Если вы работаете в App Designer, создайте общие или частную собственность в приложении, чтобы делиться данными вместо использования UserData свойство. Для получения дополнительной информации см. раздел «Обмен данными в приложениях App Designer».