主要内容

DatePicker属性

控制日期选择器的外观和行为

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

fig=UIFig;d=uidatepicker(图);d、 显示格式='M/d/yyyy';

日期选择器

全部展开

选定日期,指定为datetime对象的范围内的限制所有物若要使选定日期未指定,请将此属性设置为纳特

如果指定的datetime对象中包含时间信息,仅保留日期信息价值财产。

例子:d=uidatepicker('Value',datetime('today'))

数据类型:datetime

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

例子:“aaaa级/ mm / dd”

选择限制,指定为1 × 2datetime数组中。该数组中的第二个值必须晚于第一个值。默认值为[datetime(0000年1 1)datetime(9999、12、31)].此默认值从可能最早的日期开始,并在可能最晚的日期结束日期选择器金宝app支持。

在正在运行的应用程序中,日期选择器允许用户选择此属性定义的关闭间隔上的日期。如果间隔内存在禁用日期或禁用天数,则这些日期和天数将被排除。

例子:d = uidatepicker('Limits',[datetime('today') datetime(2050,1,1)])

数据类型:datetime

显示日期选择器文本字段的格式,指定为字符向量或字符串标量。默认格式取决于运行应用程序的系统的语言环境。

指定的格式必须使用与Unicode对应的有效字母标识符®日期和时间的区域设置数据标记语言(LDML)标准。要分隔字段,可以包含非字母字符,如连字符、空格、冒号或任何非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年 嗯月 dd日' 2014年 04月 09日
“嗯d, yyyy” 2014年4月9日

所有日期和时间格式

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

字母标识符 描述 显示
G 时代 总工程师
Y 年份,没有前导零。 2014
yy 年份,用最后两位数。 14
yyy,yyyy... Year,使用的数字至少与实例的数字一样多“是的” 2014年,“yyy”显示2014,而“yyyyy”显示02014
U,uu, ... ISO年份,一个数字表示年份。 2014
Q 四分之一,用一个数字 2.
QQ 四分之一,用两位数字 02
回调 季度,缩写 第二季
QQQQ 四分之一,全名 第二季度
M 月,数字,用一或两位数字 4.
毫米 月份,数字,使用两位数 04
月,缩写的名字 4月
月份,全名 4月
月,首字母大写 A.
W 每月的一周,使用一位数字 2.
D 一个月的一天,用一或两位数 9
dd 每个月的一天,用两位数表示 09
D 一年中的某一天,使用一位、两位或三位数字 99
DD 一年中的一天,用两位数表示 99
DDD 用三位数表示一年中的哪一天 099
E 星期几,数字,使用一位或两位数字 4.在美国,周日是一周的第一天
ee 星期几,数字,使用两位数 04
eee 天,缩写的名字 结婚
eeee 天,全名 周三
eeeee 日期,首字母大写 W

笔记

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

  • 如果用户在运行的应用程序中指定了一年中的一天,并且格式包含了这一天的标识符(D)公历年(Y),然后datetime可能无法正确读取年月日的数字。使用国际标准化组织年份(U代替Y

  • 使用一个或多个U字符而不是Y当处理接近零的年份时,用字符表示年份。

禁用日期,指定为m-by-1datetime大堆此属性指定在运行的应用程序中不可选择的日期。

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

这个datetime数组不能包含任何纳特值和日期必须按升序排序。

要重新启用所有以前禁用的日期,请调用NaT(0)要创建空的datetime数组:

d、 DisabledDates=NaT(0);

数据类型:datetime

一周的禁用天数,指定为以下日期之一:

  • 空数组[],这样就可以全天工作了。

  • [1,7]范围内的整数向量。这些数字对应于一周中的几天。例如3 [1]禁用星期日和星期二。

  • 字符向量的一维单元格数组,其中数组元素包含本地化的日名称。部分日期名称必须明确。例如{' F ', ' Sa '}禁用周五和周六。

  • 包含完整或部分本地化日名称的字符串向量。

使用单元格数组或字符串向量指定日期名称时,代码仅在编写代码的区域设置中起作用。要使代码在任何语言环境中工作,请将此属性指定为数字向量。

数据类型:|单间牢房|字符串

字体和颜色

全部展开

字体名称,指定为系统支持的字体名称。默认字体取决于特定的操作系统和金宝app区域设置。

如果指定的字体不可用,则用MATLAB®使用运行应用程序的系统上可用的字体中的最佳匹配。

例子:“天线”

字体大小,指定为正数。测量单位为像素。默认字体大小取决于特定的操作系统和区域设置。

例子:14

字体大小,指定为以下值之一:

  • “正常”-由特定字体定义的默认权重

  • “大胆”-较厚的字符轮廓比“正常”

并不是所有的字体都有粗体字体。对于没有指定的字体,请指定“大胆”结果显示正常的字体粗细。

字体角度,指定为“正常”“斜体”.不是所有字体都有斜体字体角度。对于没有指定的字体,请指定“斜体”结果显示正常的字体角度。

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

RGB三联体和十六进制颜色代码在指定自定义颜色时很有用。

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

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(#),然后是3个或6个十六进制数字,其范围可以是0F.这些值不区分大小写。因此,颜色是代码“# FF8800”,“#ff8800”,“# F80”,“#f80”它们是等价的。

或者,您可以通过名称指定一些常用颜色。此表列出了命名颜色选项、等效RGB三元组和十六进制颜色代码。

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

样品的颜色为红色

“绿色” ‘g’ (0 1 0) “#00FF00”

样品的颜色为绿色

“蓝” “b” (0 0 1) #0000FF"

蓝色样品

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

样品的颜色为青色

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

品红色样品

“黄色” “是的” [1 1 0] "FFFF00"

样品的颜色为黄色

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

样品的颜色为黑色

“白色” “w” [1 1 1] "FFFFFF"

白色样品

以下是MATLAB在许多类型的绘图中使用的默认颜色的RGB三联体和十六进制颜色代码。

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) "7E2F8E"

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)

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(#),然后是3个或6个十六进制数字,其范围可以是0F.这些值不区分大小写。因此,颜色是代码“# FF8800”,“#ff8800”,“# F80”,“#f80”它们是等价的。

或者,您可以通过名称指定一些常用颜色。此表列出了命名颜色选项、等效RGB三元组和十六进制颜色代码。

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

样品的颜色为红色

“绿色” ‘g’ (0 1 0) “#00FF00”

样品的颜色为绿色

“蓝” “b” (0 0 1) #0000FF"

蓝色样品

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

样品的颜色为青色

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

品红色样品

“黄色” “是的” [1 1 0] "FFFF00"

样品的颜色为黄色

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

样品的颜色为黑色

“白色” “w” [1 1 1] "FFFFFF"

白色样品

以下是MATLAB在许多类型的绘图中使用的默认颜色的RGB三联体和十六进制颜色代码。

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) "7E2F8E"

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

  • 如果将此属性设置为“开”,应用程序用户可以与组件进行交互。

  • 如果将此属性设置为“关闭”,组件显示为灰色,表明应用程序用户不能与它交互,并且它将不会触发回调。

工具提示,指定为字符向量、字符向量单元格数组、字符串数组或一维分类数组。当用户在运行时将指针悬停在组件上时,使用此属性可显示消息。即使组件被禁用,工具提示也会显示。若要显示多行文本,请指定字符向量单元格数组TOR或字符串数组。数组中的每个元素都成为单独的文本行。如果将此属性指定为分类数组,则MATLAB使用数组中的值,而不是整个类别集。

上下文菜单,指定为快捷菜单使用uicontextmenu函数。在组件上单击右键时,使用此属性显示上下文菜单。

位置

全部展开

折叠日期选择器相对于父容器的位置和大小,指定为窗体的向量[左下角宽度高度].此表描述了向量中的每个元素。

元素 描述
左边 从父容器的左内边缘到日期选择器的左外边缘的距离
从父容器的内底边到日期选择器的外底边的距离
宽度 日期选择器左右外边缘之间的距离
高度 日期选择器上外缘和下外缘之间的距离

所有测量值均以像素为单位。

折叠日期选择器相对于父容器的位置和大小,指定为窗体的向量[左下角宽度高度].该属性值与位置财产。

折叠日期选择器相对于父容器的位置和大小,指定为窗体的向量[左下角宽度高度].该属性值与位置财产。

布局选项,指定为网格布局自动选项对象。此属性为网格布局容器的子组件指定选项。如果该组件不是网格布局容器的子组件(例如,它是图形或面板的子组件),则此属性为空且无效。但是,如果组件是网格布局容器的子级,则可以通过设置上的属性网格布局自动选项对象。

例如,这段代码将日期选择器放置在其父网格的第三行和第二列。

g=uigridlayout([4 3]);d=数据选择器(g);d、 布局。行=3;d、 布局。列=2;

要使日期选择器跨多行或多列,请指定属性为二元素向量。例如,这个日期选择器跨列2.通过3.:

d、 Layout.Column=[23];

回调

全部展开

值已更改的函数,指定为以下函数之一:

  • 一个处理函数。

  • 一种单元格数组,其中第一个元素是函数句柄。单元格数组中的后续元素是传递给回调函数的参数。

  • 包含有效MATLAB表达式(不推荐)的字符向量。MATLAB在基本工作空间中计算此表达式。

这个ValueChangedFcn当用户通过在文本字段中键入或通过展开日期选择器并选择日期来更改日期时,将执行回调。

此回调函数可以访问有关用户与日期选择器交互的特定信息ValueChangedData对象作为回调函数的第二个参数。在应用程序设计器中,调用该参数事件.你可以使用点符号来获得对象属性。例如,事件。PreviousValue获取以前选择的日期。这个ValueChangedData对象对指定为字符向量的回调函数不可用。

下表列出了ValueChangedData对象。

所有物 价值
价值 新选定日期
PreviousValue 先前选定的日期
执行回调的组件
EventName “ValueChanged”

这个ValueChangedFcn当用户重新选择或重新键入当前选择的日期时,回调不会执行。调用时,回调函数也不会执行价值通过编程方式属性更改。

有关在App Designer中创建回调的更多信息,请参阅在应用程序设计器中编写回调

对象创建函数,指定为以下值之一:

  • 函数句柄。

  • 单元格数组,其中第一个元素是函数句柄。cell数组中的后续元素是要传递给回调函数的参数。

  • 字符向量包含有效的MATLAB表达式(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在应用程序设计器中编写回调

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

设置CreateFcn属性对现有组件没有影响。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在创建的对象。否则,使用gcbo函数访问对象。

对象删除函数,指定为以下值之一:

  • 函数句柄。

  • 单元格数组,其中第一个元素是函数句柄。cell数组中的后续元素是要传递给回调函数的参数。

  • 字符向量包含有效的MATLAB表达式(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在应用程序设计器中编写回调

此属性指定MATLAB删除对象时要执行的回调函数DeleteFcn在销毁对象属性之前回调。如果未指定DeleteFcn属性,然后MATLAB执行一个默认删除函数。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问要删除的对象。否则,请使用gcbo函数访问对象。

回调执行控制

全部展开

回调中断,指定为“开”“关闭”,或数字或逻辑1.(真正的)或0(错误的).价值“开”相当于真正的,“关闭”相当于错误的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

此属性确定是否可以中断正在运行的回调。有两种回调状态需要考虑:

  • 这个运行Callback是当前正在执行的回调。

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

MATLAB在执行处理回调队列的命令时确定回调中断行为。这些命令包括刷新屏幕,数字,uifigure,getframe,等待,暂停

如果正在运行的回调不包含这些命令之一,则不会发生中断。MATLAB首先完成运行回调的执行,然后执行中断回调。

如果正在运行的回调函数确实包含这些命令之一,则打断拥有正在运行的回调的对象的属性决定中断是否发生:

  • 如果打断“关闭”,则不会发生中断。相反巴士行动拥有中断回调的对象的属性确定是放弃中断回调还是将其添加到回调队列。

  • 如果打断“开”,则中断发生。下次MATLAB处理回调队列时,它将停止执行正在运行的回调,并执行中断回调。中断回调完成后,MATLAB将继续执行正在运行的回调。

笔记

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

  • 如果中断回调为DeleteFcn,CloseRequestFcn,或SizeChangedFcn回调,则中断发生,而不考虑打断属性值。

  • 如果正在运行的回调函数正在执行等待函数,则不管打断属性值。

  • 如果中断回调由计时器对象,则回调将根据调度执行,而不管打断属性值。

笔记

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

回调排队,指定为“队列”“取消”.这个巴士行动属性确定MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:

  • 这个运行Callback是当前正在执行的回调。

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

这个巴士行动属性仅在满足以下两个条件时确定回调队列行为:

在这种情况下巴士行动属性决定了MATLAB如何处理中断回调。这些是可能的值巴士行动属性:

  • “队列”—将中断回调放入正在运行的回调执行完成后待处理的队列中。

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

此属性是只读的。

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

MATLAB设置BeingDeleted财产“开”DeleteFcn回调函数开始执行。这个BeingDeleted属性仍设置为“开”直到组件对象不再存在。

检查该值BeingDeleted属性,以验证在查询或修改对象之前不会删除该对象。

父/子

全部展开

父容器,指定为数字使用uifigure函数或其子容器之一:选项卡,面板,ButtonGroup,或网格布局. 如果未指定容器,MATLAB将调用uifigure函数创建一个新的数字作为父容器的对象。

对象句柄的可见性,指定为“开”,“回调”,或“关闭”

此属性控制对象在其父对象的子对象列表中的可见性。当对象在其父对象的子对象列表中不可见时,通过搜索对象层次结构或查询属性获取对象的函数不会返回该对象。这些功能包括得到,findobj,clf,.对象即使不可见也是有效的。如果你可以访问一个对象,你可以设置和获取它的属性,并将它传递给任何操作对象的函数。

HandleVisibility价值 描述
“开” 物体总是可见的。
“回调” 对象在回调或由回调调用的函数中可见,但在从命令行调用的函数中不可见。这个选项阻止在命令行中访问对象,但允许回调函数访问它。
“关闭” 物体在任何时候都是看不见的。这个选项对于防止其他函数对UI的意外更改非常有用。设置HandleVisibility“关闭”在执行该函数期间临时隐藏对象。

标识符

全部展开

此属性是只读的。

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

对象标识符,指定为字符向量或字符串标量。你可以指定一个唯一的标签值作为对象的标识符。当您需要访问代码中的其他地方的对象时,可以使用findobj函数以基于标签价值。

用户数据,指定为任何MATLAB数组。例如,可以指定标量、向量、矩阵、单元格数组、字符数组、表或结构。使用此属性可在对象上存储任意数据。

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

R2018a中引入