主要内容

DatePicker属性

日期选择外观和行为控制

日期选择器允许用户从一个交互式日历选择日期。的uidatepicker函数创建一个日期选择在显示之前和设置所需的属性。通过改变属性值的一个日期选择器,您可以修改它的外观和行为的某些方面。使用点符号来引用一个特定的对象和属性:

无花果= uifigure;d = uidatepicker(图);d。D是playFormat = 'M/d/yyyy';

日期选择器

全部展开

选择日期,指定为一个datetime对象的范围内限制财产。所选日期不明,设置该属性NaT

如果指定的datetime对象包含时间信息,只有日期信息保存在价值财产。

例子:d = uidatepicker(“价值”,datetime('今天'))

数据类型:datetime

占位符文本,指定为一个特征向量或字符串标量。占位符提供了一个简短的提示来描述预期的输入。文本显示只有当价值属性是NaT

例子:“aaaa级/ mm / dd”

选择范围,指定为1×2datetime数组中。第二个值在这个数组必须晚于第一个值。默认值是[datetime(0000年1 1)datetime (9999、12、31)]。这个默认值是从最早的可能的最迟日期和结束日期DatePicker金宝app支持。

在运行应用程序,日期选择器允许用户选择闭区间上的日期由这个属性定义的。如果有残疾的日期或禁用天间隔内,那么这些日期和天被排除在外。

例子:d = uidatepicker(“限制”,[datetime(今天)datetime (2050、1、1)))

数据类型:datetime

显示格式的日期选择文本字段,指定为一个特征向量或字符串标量。默认的格式取决于系统的现场运行应用程序。

您所指定的格式必须使用有效的字母标识符对应于Unicode®语言环境数据标记语言(LDML)日期和时间的标准。单独的字段,您可以包括nonletter字符,如一个连字符,空间,冒号,或任何非ascii字符。

例子:d = uidatepicker (“DisplayFormat”、“dd / MM / yy”)

常见的例子的格式

此表列出了常见的显示格式。的例子显示格式化输出日期,星期三,2014年4月9日。

的价值格式 例子
“yyyy-MM-dd” 2014-04-09
“dd / MM / yyyy” 09/04/2014
“dd.MM.yyyy” 09.04.2014
“yyyy年MM月dd日” 2014年04月09日
“嗯d, yyyy” 2014年4月9日

所有的日期和时间格式

用这些字母标识符创建一个显示格式。第三列的表显示输出的日期,星期三,2014年4月9日。

字母标识符 描述 显示
G 时代 CE
y 年,没有前导零。 2014年
yy 一年,使用最后两位数。 14
,yyyy 至少一年,使用尽可能多的数字的实例“y” 2014年,“多”显示2014年,而“yyyyy”显示02014年
u,uu,…… ISO,一个数字指定。 2014年
季度,使用一个数字 2
QQ 季度,使用两个数字 02
回调 季度,缩写 第二季
QQQQ 季度,全名 第二季度
月,数值,使用一个或两个数字 4
毫米 月,数值,使用两个数字 04
月,缩写的名字 4月
月,全名 4月
月,大写首字母 一个
W 星期,使用一个数字 2
d 日,使用一个或两个数字 9
dd 日,使用两个数字 09年
D 天,使用一个,两个,三个数字 99年
DD 一天,使用两个数字 99年
DDD 使用三位数的 099年
e 星期,数值,使用一个或两个数字 4,星期日是一周的第一天
ee 天的星期,数值,使用两个数字 04
eee 天,缩写的名字 结婚
eeee 天,全名 周三
eeeee 天,大写首字母 W

请注意

  • 运行应用程序接受编辑字段分隔的数字值,即使DisplayFormat包括单词。例如,如果被指定为月格式“嗯”,应用程序接受一个数字月如04一个月,但将显示名称等“4”

  • 如果用户指定了一个day-of-year应用程序,运行在数量和格式包含标识符的一天(D)和格雷戈里(y),然后datetime可能不读day-of-year数量正确。使用ISO (u在的地方y

  • 使用一个或多个u字符,而不是y字符来表示在处理去年同期数字接近于零。

禁用日期,指定为一个m×1datetime数组中。这个属性指定日期不运行应用程序可供选择。

例子:d = uidatepicker (DisabledDates, datetime(2018年,1,1))2018年1月1日禁用。

datetime无法不包含任何数组NaT值和日期必须按升序排序。

使再能所有之前禁用日期、电话NaT (0)创建一个空的datetime数组:

d。D是abledDates = NaT(0);

数据类型:datetime

残疾人的星期,指定为以下之一:

  • 空数组[]本周,这使得所有的日子。

  • 向量的整数范围(1、7)。这些数字对应的日子。例如,3 [1]禁用星期天和星期二。

  • 特征向量的一维单元阵列,阵列元素包含本地化名称。部分天名称必须是明确的。例如,{' F ', ' Sa '}禁用星期五和星期六。

  • 字符串向量包含全部或部分本地化名称。

当你使用一个细胞数组或字符串向量指定天的名字,代码只能在你编写代码的语言环境。使代码在任何地区工作,这个属性指定为一个向量的数字。

数据类型:|细胞|字符串

字体和颜色

全部展开

字体名称,指定为一个系统支持字体名称。金宝app默认字体取决于具体的操作系统和语言环境。

如果指定的字体不可用,然后用MATLAB®使用字体之间的最佳匹配的系统上可用的应用程序正在运行。

例子:“天线”

字体大小,指定为一个正数。测量的单位是像素。默认字体大小取决于具体的操作系统和语言环境。

例子:14

字体的体重,指定这些值之一:

  • “正常”违约重量所定义的特定的字体

  • “大胆”——厚字符轮廓“正常”

不是所有的字体都有一个大胆的字体的重量。字体不指定“大胆”结果在正常字体的重量。

字体角,指定为“正常”“斜体”。不是所有的字体斜体字体角。字体不指定“斜体”结果在正常字体角。

字体颜色、指定为一个RGB值,十六进制的颜色代码,或者表中列出的选项之一。

RGB三胞胎和十六进制颜色代码可用于指定自定义颜色。

  • 一个RGB值三元素行向量的元素指定强度的红色,绿色和蓝色的组件的颜色。强度必须在范围内[0,1];例如,(0.4 0.6 0.7)

  • 十六进制颜色代码是一个特征向量或一个字符串标量,始于一个散列符号(#)后面跟着三个月或六个十六进制数字,它的范围可以从0F。的值是不区分大小写的。因此,颜色代码“# FF8800”,“# ff8800”,“# F80”,“# f80”是等价的。

或者,您可以指定一些常见颜色的名字。此表列出了命名颜色选项,相当于RGB三胞胎,十六进制颜色代码。

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” (1 0 0) “# FF0000”

红色的示例

“绿色” “g” (0 1 0) “# 00 ff00”

样品的颜色绿色

“蓝色” “b” (0 0 1) “# 0000 ff”

样品的颜色蓝色

“青色” “c” (0 1 1) “# 00飞行符”

样品的颜色青色

“红色” “m” (1 0 1) “#”就

样品的颜色红色

“黄色” “y” (1 1 0) “# FFFF00”

样品的颜色黄色

“黑色” “k” (0 0 0) “000000 #”

样品的颜色黑色

“白色” “w” (1 1 1) “# FFFFFF”

样品的颜色白色

这是默认颜色的RGB三胞胎和十六进制颜色编码MATLAB使用在许多类型的情节。

RGB值 十六进制颜色代码 外观
[0 0.4470 - 0.7410) “# 0072 bd”

样本的RGB值(0 0.4470 - 0.7410),显示为深蓝色

(0.8500 0.3250 0.0980) “# D95319”

样本的RGB值(0.8500 0.3250 0.0980),它表现为暗橙

(0.9290 0.6940 0.1250) “# EDB120”

样本的RGB值(0.9290 0.6940 0.1250),它表现为暗黄色

(0.4940 0.1840 0.5560) “# 7 e2f8e”

样本的RGB值(0.4940 0.1840 0.5560),它表现为深紫色

(0.4660 0.6740 0.1880) “# 77 ac30”

样本的RGB值(0.4660 0.6740 0.1880),它表现为中绿色

(0.3010 0.7450 0.9330) “# 4 dbeee”

样本的RGB值(0.3010 0.7450 0.9330),它表现为浅蓝色

(0.6350 0.0780 0.1840) “# A2142F”

样本的RGB值(0.6350 0.0780 0.1840),它表现为深红色

背景颜色,作为一个RGB值,指定十六进制的颜色代码,或者颜色表中列出的选项之一。

RGB三胞胎和十六进制颜色代码可用于指定自定义颜色。

  • 一个RGB值三元素行向量的元素指定强度的红色,绿色和蓝色的组件的颜色。强度必须在范围内[0,1];例如,(0.4 0.6 0.7)

  • 十六进制颜色代码是一个特征向量或一个字符串标量,始于一个散列符号(#)后面跟着三个月或六个十六进制数字,它的范围可以从0F。的值是不区分大小写的。因此,颜色代码“# FF8800”,“# ff8800”,“# F80”,“# f80”是等价的。

或者,您可以指定一些常见颜色的名字。此表列出了命名颜色选项,相当于RGB三胞胎,十六进制颜色代码。

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” (1 0 0) “# FF0000”

红色的示例

“绿色” “g” (0 1 0) “# 00 ff00”

样品的颜色绿色

“蓝色” “b” (0 0 1) “# 0000 ff”

样品的颜色蓝色

“青色” “c” (0 1 1) “# 00飞行符”

样品的颜色青色

“红色” “m” (1 0 1) “#”就

样品的颜色红色

“黄色” “y” (1 1 0) “# FFFF00”

样品的颜色黄色

“黑色” “k” (0 0 0) “000000 #”

样品的颜色黑色

“白色” “w” (1 1 1) “# FFFFFF”

样品的颜色白色

这是默认颜色的RGB三胞胎和十六进制颜色编码MATLAB使用在许多类型的情节。

RGB值 十六进制颜色代码 外观
[0 0.4470 - 0.7410) “# 0072 bd”

样本的RGB值(0 0.4470 - 0.7410),显示为深蓝色

(0.8500 0.3250 0.0980) “# D95319”

样本的RGB值(0.8500 0.3250 0.0980),它表现为暗橙

(0.9290 0.6940 0.1250) “# EDB120”

样本的RGB值(0.9290 0.6940 0.1250),它表现为暗黄色

(0.4940 0.1840 0.5560) “# 7 e2f8e”

样本的RGB值(0.4940 0.1840 0.5560),它表现为深紫色

(0.4660 0.6740 0.1880) “# 77 ac30”

样本的RGB值(0.4660 0.6740 0.1880),它表现为中绿色

(0.3010 0.7450 0.9330) “# 4 dbeee”

样本的RGB值(0.3010 0.7450 0.9330),它表现为浅蓝色

(0.6350 0.0780 0.1840) “# A2142F”

样本的RGB值(0.6350 0.0780 0.1840),它表现为深红色

交互性

全部展开

可见性状态,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • “上”——显示对象。

  • “关闭”——隐藏对象没有删除它。你仍然可以访问一个看不见的UI组件的属性。

让你的应用程序启动更快,设置可见财产“关闭”对于所有UI组件,不需要在启动时出现。

允许编辑字段的变化,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

将此属性设置为“上”允许用户在运行时在编辑字段中更改日期。的启用属性必须设置“上”允许编辑字段的变化。

操作状态,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • 如果你设定这个属性“上”,应用程序用户可以与组件交互。

  • 如果你设定这个属性“关闭”,组件似乎黯淡,表明应用程序用户不能与它交互,而且它不会触发一个回调。

工具提示,指定为一个特征向量,单元阵列的特征向量,字符串数组,或一维分类数组。使用这个属性来显示一个消息当用户将鼠标悬停于指针组件在运行时。工具提示显示即使组件是禁用的。显示多行文本,指定一个单元阵列特征向量或一个字符串数组。数组中的每个元素,成为一个单独的行文本。如果指定这个属性作为分类数组,MATLAB使用数组中的值,而不是完整的类别。

指定为一个上下文菜单快捷菜单对象创建使用uicontextmenu函数。使用这个属性来显示一个上下文菜单,当你右键单击一个组件。

位置

全部展开

倒塌的日期选择器的位置和大小相对于父容器,指定为一个向量的形式(左底宽高)。此表描述向量中每个元素。

元素 描述
父容器的内部左边缘的距离外左边缘的日期选择器
的距离内底边缘父容器的外底日期选择器的边缘
宽度 左、右外边缘之间的距离的日期选择器
高度 距离顶部和底部日期选择器的外边缘

所有的测量都是在像素单元。

倒塌的日期选择器的位置和大小相对于父容器,指定为一个向量的形式(左底宽高)。这个属性值是相同的位置财产。

倒塌的日期选择器的位置和大小相对于父容器,指定为一个向量的形式(左底宽高)。这个属性值是相同的位置财产。

布局选项,指定为一个GridLayoutOptions对象。这个属性指定组件的选项的网格布局容器。如果组件不是孩子的网格布局容器(例如,它是一个孩子的图或面板),然后这个属性是空的,没有任何影响。然而,如果组件是一个孩子的网格布局容器,您可以将组件所需的行和列的网格通过设置属性GridLayoutOptions对象。

例如,这段代码的地方一个日期选择在第三行和第二列的网格。

3 g = uigridlayout ([4]);d = uidatepicker (g);d.Layout。行= 3;d.Layout。列= 2;

让日期选择跨越多个行或列,指定房地产作为一个双元素向量。例如,这个日期选择列2通过3:

d.Layout。列= [2 3];

回调

全部展开

改变函数值,指定为以下之一:

  • 一个处理函数。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 一个特征向量包含有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

ValueChangedFcn回调执行当用户更改日期输入文本字段或扩大日期选择器和选择一个日期。

这个回调函数可以访问特定用户的交互信息和日期选择器。MATLAB中传递这些信息ValueChangedData回调函数对象作为第二个参数。在应用程序设计,论证事件。可以使用点符号对象属性。例如,event.PreviousValue得到了先前选定的日期。的ValueChangedData对象不可用回调函数指定为特征向量。

下表列出的属性ValueChangedData对象。

财产 价值
价值 新选择的日期
PreviousValue 先前选定的日期
组件执行回调
EventName “ValueChanged”

ValueChangedFcn回调不执行当用户重新选择或输入当前选中日期。回调时也不执行价值通过编程方式属性更改。

有关创建回调的更多信息在应用程序设计师,看看回调程序设计师

对象创建函数,指定这些值之一:

  • 函数处理。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 特征向量包含一个有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

更多信息关于指定一个回调函数处理,细胞数组,或字符向量,明白了回调程序设计师

这个属性指定一个回调函数执行时MATLAB创建对象。MATLAB之前执行初始化所有的属性值CreateFcn回调。如果你不指定CreateFcn属性,然后MATLAB执行默认创建函数。

设置CreateFcn属性在一个现有的组件没有影响。

如果指定这个属性作为处理函数或细胞数组,您可以访问的对象被创建使用回调函数的第一个参数。否则,使用gcbo函数来访问该对象。

对象删除函数,指定这些值之一:

  • 函数处理。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 特征向量包含一个有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

更多信息关于指定一个回调函数处理,细胞数组,或字符向量,明白了回调程序设计师

这个属性指定一个回调函数执行时MATLAB删除对象。MATLAB执行DeleteFcn回调之前破坏对象的属性。如果你不指定DeleteFcn属性,然后MATLAB默认执行删除功能。

如果指定这个属性作为处理函数或细胞数组,您可以访问的对象被删除使用回调函数的第一个参数。否则,使用gcbo函数来访问该对象。

回调执行控制

全部展开

回调中断,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

这个属性决定了如果一个回调可以运行中断。有两种回调状态考虑:

  • 运行回调是当前执行的回调。

  • 打断回调是一个回调,试图中断正在运行的回调。

MATLAB决定调中断行为每当它执行一个命令队列处理回调。这些命令包括drawnow,,uifigure,getframe,等待,暂停

如果调不包含运行这些命令,然后没有中断发生。MATLAB首先完成执行运行回调,后来执行中断的回调。

如果跑回调也包含其中的一个命令,然后可中断对象的属性拥有运行调决定如果中断发生时:

  • 如果该值的可中断“关闭”,然后没有中断发生。相反,BusyAction对象的属性拥有打断调决定如果打断回调被丢弃或添加到队列的回调。

  • 如果该值的可中断“上”,然后中断发生。下次MATLAB处理回调队列,它停止运行的执行回调并执行中断的回调。打断调完成后,MATLAB简历执行回调。

请注意

回调中断和执行不同的行为在这些情况下:

  • 如果中断的回调DeleteFcn,CloseRequestFcn,或SizeChangedFcn回调,那么无论发生中断可中断属性值。

  • 如果运行目前执行的回调等待函数,那么无论发生中断可中断属性值。

  • 如果回调是由一个中断计时器对象,然后根据时间表不管回调执行可中断属性值。

请注意

当一个中断发生,MATLAB不保存属性或状态的显示。例如,返回的对象gcagcf执行命令时可能会改变另一个回调。

回调排队,指定为“队列”“取消”。的BusyAction属性决定了MATLAB如何处理中断的执行回调。有两种回调状态考虑:

  • 运行回调是当前执行的回调。

  • 打断回调是一个回调,试图中断正在运行的回调。

BusyAction属性决定了回调排队行为只有满足这两个条件:

在这种情况下,BusyAction对象的属性拥有打断调决定MATLAB如何处理中断的回调。这些都是可能的值的BusyAction属性:

  • “队列”——将中断处理回调在一个队列跑回调结束后执行。

  • “取消”——不执行中断回调。

这个属性是只读的。

删除状态,作为一个开/关返回逻辑值的类型matlab.lang.OnOffSwitchState

MATLAB设置BeingDeleted财产“上”DeleteFcn回调函数开始执行。的BeingDeleted房地产仍将“上”直到组件对象已不复存在。

检查的价值BeingDeleted属性来验证对象不会被删除之前查询或修改它。

父/子

全部展开

指定为一个父容器对象创建使用uifigure函数,或者它的一个孩子容器:选项卡,面板,ButtonGroup,或GridLayout。如果没有指定容器,MATLAB调用uifigure创建一个新的函数对象作为父容器。

指定为对象的可见性处理“上”,“回调”,或“关闭”

这个属性控制对象的可见性在其父母的孩子。当一个对象不可见的父母的孩子,它不是由函数返回获取对象通过搜索对象层次结构或查询属性。这些功能包括得到,findobj,clf,关闭。对象是有效的,即使他们是不可见的。如果您可以访问一个对象,你可以设置它的属性,并将其传递给任何函数来操作对象。

HandleVisibility价值 描述
“上” 对象总是可见的。
“回调” 对象是可见的在回调函数或函数调用回调,但不是在从命令行调用的函数。这个选项块访问对象的命令行,但是允许回调函数来访问它。
“关闭” 对象是无形的。这个选项是有用的防止意外更改UI被另一个函数。设置HandleVisibility“关闭”暂时隐藏对象在这个函数的执行。

标识符

全部展开

这个属性是只读的。

类型的图形对象,返回“uidatepicker”

对象标识符指定为一个特征向量或字符串标量。您可以指定一个唯一的标签价值作为一个对象的标识符。当你需要访问对象在您的代码,您可以使用findobj基于函数搜索对象标签价值。

用户数据,指定为任何MATLAB数组。例如,您可以指定一个标量、向量,矩阵,单元阵列,字符数组,表,或者结构。使用这个属性来存储任意数据对象。

如果你是在应用程序设计师工作,创建公共或私有属性的应用程序共享数据,而不是使用用户数据财产。有关更多信息,请参见在应用程序设计应用程序共享数据

版本历史

介绍了R2018a

全部展开