主要内容

用户界面图属性

控件的UI图形外观和行为uifigure的应用程序

UI图形是用于在应用程序设计器中创建应用程序或使用uifigure函数。属性控制UI图形的外观和行为。使用点符号表示特定对象和属性:

fig=UIFig;图名称=‘我的应用程序’;

窗口外观

全部展开

背景色,指定为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] “#00FF00”

绿色样品

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

样品的颜色是蓝色的

“青色” “c” [0 1 1] “#00FFFF”

青色样本青色

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

品红色样品

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

颜色发黄的样品

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

样品的颜色为黑色

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

样品的颜色为白色

“没有” 不适用 不适用 不适用 没有颜色

以下是默认颜色的RGB三元组和十六进制颜色代码®用于许多类型的情节。

RGB值 十六进制色码 外观
[0 0.4470 0.7410] “#0072BD”

RGB三重态样本[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) "77AC30"

样品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],它看起来像深红色

窗样式,指定为以下样式之一:

  • “正常”-图形窗口独立于其他窗口,在显示图形时可以访问其他窗口。

  • “模态”-地物显示在所有具有正常窗口样式的现有地物窗口的顶部,只要顶部地物存在并保持模态,就无法访问这些地物窗口。但是,将显示在模式地物之后创建的任何新地物。

    当多模态窗口存在,最近创建的窗口保持在所有其他窗口的焦点和住宿,直到它变得不可见,或恢复到正常的窗口样式,或者被删除。当时,重点就回到窗口,最后不得不关注的焦点。

  • “alwaysontop”-图形显示在所有其他窗口的顶部,包括模态图形窗口和非matlab应用程序的窗口。其他的窗户还可以进去。

笔记

这些都是该系统的一些重要特征windowstyle.属性和一些推荐的最佳做法:

  • 当您创建UI窗口,始终指定windowstyle.财产。如果您还想设置调整位置属性,然后设置windowstyle.财产。

  • 你可以改变windowstyle.属性,包括当图形可见并包含子图形时。然而,在某些系统上,设置此属性可能会导致图形闪烁或消失和重新出现,这取决于系统对正常窗口和模态窗口的实现。要获得最佳的视觉效果,请设置windowstyle.在创建时间或数字是不可见的。

UI图形模态窗口样式行为

什么时候windowstyle.被设置为“模态”, UI图形窗口阻塞了在它之前创建的UI图形窗口中的键盘和鼠标交互看得见的属性设置为“上”例如,在本例中,图3是相对于图2的模态,图2是相对于图1的模态。

FIG1 = uifigure(“名字”“图1”); 图1.WindowsStyle=“模态”;图= uifigure (“名字”“图2”);FIG2.WindowStyle =“模态”;如果= uifigure (“名字”“图3”); 图3.窗口样式=“模态”
如果在图中的层次结构中存在模态和正常图的组合,则不保留模态层次结构。

与使用的模态数据不同数字函数创建的模态图形uifigure函数不会阻止访问使用图形函数或MATLAB桌面创建的图形。与MATLAB以外的应用程序窗口的交互也不会被阻塞。

打字Ctrl + C当模态图形有焦点时,使该图形恢复为“正常”windowstyle.属性设置。这允许用户在命令行输入。

ui数字windowstyle.属性设置为“模态”看得见的属性设置为“关”直到Matlab使它们可见,不模当地表现。因此,您可以隐藏一个模态窗口以供稍后重用,而不是销毁它。

模态图形不显示菜单子菜单、内置菜单或工具栏。但是,在模态图中创建菜单或更改windowstyle.属性设置为“模态”与菜单孩子的身影。的菜单对象存在,图形保留它们。如果重置了UI图windowstyle.财产“正常”,菜单显示。

窗口状态,指定为其中一个值:

  • “正常”-窗口以正常状态显示。

  • “最小化”-窗口已折叠,但仍可以执行命令以获取或设置其属性、添加子项或在窗口中创建绘图。

  • '最大化'-窗口填满屏幕。操作系统提供的最小化、恢复和关闭按钮出现在窗口的角落。如果窗口有处于正常状态的菜单,则它们将在此状态下存在。

  • '全屏'-窗口填满屏幕。但是,操作系统提供的最小化、恢复和关闭按钮是隐藏的。如果窗口有处于正常状态的菜单,则它们将在此状态下存在。

单击操作系统提供的最小化、最大化或还原按钮可设置的WindowState相应的财产。紧迫的Ctrl +季(窗户®和Linux®)或Ctrl + F +命令苹果系统)切换'全屏'状态在停靠地物或中设置此属性MATLAB在线™不支持。万博1manbetx

UI图形不能从全屏状态直接最小化。

位置和大小

全部展开

UI图形的位置和大小,不包括边框和标题栏,指定为表单的四元素向量[左下宽度]

该表描述了向量中的每个元素。

元素 描述
从主显示器左边缘到UI图形窗口左内边缘的距离。在具有多个监视器的系统上,此值可以为负值。
从主显示器到UI图窗口的内底部边缘的底部边缘的距离。这个值可以在具有多个监视器系统阴性。
宽度 UI图形的左右内边缘之间的距离。
高度 UI图形的顶部和底部内缘之间的距离。

测量单位,指定为本表中的一个值。

单位价值 描述
“像素”(默认)

像素。

在像素的距离是独立于Windows和系统分辨率的麦金塔电脑系统:

  • 在Windows系统上,像素为1/96英寸。

  • 麦金塔电脑系统中,像素是1/72英寸。

在Linux系统中,像素的大小是由您的系统分辨率决定。

“归一化” 这些单位相对于父容器进行标准化。容器的左下角映射到(0,0)和右上角地图(1,1)
“英寸” 英寸。
'厘米' 厘米。
“积分” 点。一点等于1/72英寸。

MATLAB测量从父对象的左下角的所有单位。

建议值为“像素”,因为大多数构建功能的MATLAB应用程序都是用像素来度量距离的。

此属性影响位置财产。如果你改变了单位属性,请考虑在完成计算后将其值返回为默认值,以避免影响采用默认值的其他函数。

你指定的顺序单位位置属性具有这些效果:

  • 如果指定单位之前位置属性,然后MATLAB设置位置使用你指定的单位。

  • 如果指定单位财产后位置属性,Matlab使用默认设置位置单位.然后,MATLAB将位置值转换为以指定的单位表示的等效值。

UI图形的位置和大小(不包括边框和标题栏),指定为窗体的四个元素向量[左下宽度].所有测量的单位均由单位财产。

此属性值与位置属性值。

可调整大小的UI图,指定为“上”“关”,或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,“关”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

当此属性设置为时“上”,则UI图形可调整大小。否则,它不可调整大小。

自动调整子节点的大小,指定为“上”“关”,或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,“关”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • “上”-子组件会在容器大小调整时自动调整大小。

  • “关”—子组件不调整大小。

自动复位儿童属性影响容器的直接子级,而不是嵌套容器中的子级。

要自定义调整大小行为,请设置自动复位儿童财产“关”并创建一个SizeChangedFcn容器的回调。有关更多信息,请参见在应用程序设计器中管理可调整大小的应用程序

要将应用的禁止调整大小,设置调整图中的财产“关”

策划

全部展开

彩色地图UIAxes内容,指定为-经过-3.定义的RGB(红、绿、蓝)三元组数组个人色彩。

例子:uifigure(“Colormap”,[1 0 1;0 0 1;1 1 0)将颜色贴图设置为三种颜色:洋红、蓝色和黄色。

MATLAB通过行数访问这些颜色。

轴内容的透明度图,指定为之间的值矢量01包含全部费用向量的大小可以是m×1或1×m。MATLAB通过向量中的索引访问alpha值。Alphamaps可以是任意长度。

鼠标指针

全部展开

指针符号,指定为下表中的值之一或“自定义”.的符号的外观是与操作系统相关的。

价值

结果符号(系统相关)

“箭”

“工字钢”

“十字”

'手表'(繁忙系统)

“托普”“botr”

“托普”“botl”

'圆圈'

“十字”

“芙蓉”

“左”“对”

“顶级”“底”

“手”

自定义指针符号

要创建自定义指针符号,请通过编程方式设置指针财产“自定义”并使用指针式CDATA属性来定义符号。请参阅指针式CDATA属性以获取更多信息。

限制

  • 指针符号值'圆圈'“十字”,“自定义”中不支持万博1manbetx微软的优势®web浏览器。

  • 的指针符号指针属性不显示在使用创建的HTML UI组件上uihtml函数。

自定义指针符号,指定为16 × 16矩阵(用于16 × 16像素指针)或32 × 32矩阵(用于32 × 32像素指针)。当您设置时,图将使用此指针符号指针财产“自定义”

矩阵中的每个元素定义指针中1像素的亮度级别,其中元素可以有以下值之一:

  • 1——黑色像素。

  • 2——白色像素。

  • -透明像素,这样底层屏幕显示通过。

元素(1,1)矩阵的值对应于指针左上角的像素。

指针的活动像素,指定为两个元素的向量。该向量包含表中特定元素的行和列索引指针式CDATA对应于所需活动像素的矩阵。的默认值[1 1]对应于指针左上角的像素。

如果指定的值超出指针式CDATA矩阵,则指针使用默认的活动像素[1 1]相反

该属性仅在指针属性设置为“自定义”

交互性

全部展开

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

  • “上”- 显示对象。

  • “关”-隐藏对象而不删除它。您仍然可以访问不可见的UI组件的属性。

要使应用程序启动更快,请设置看得见的财产“关”对于所有不需要在启动时出现的组件。

更改不可见容器的大小将触发SizeChangedFcn当它变得可见时回调。

改变这一点看得见的容器的属性不存在不是的值看得见的子组件的属性。即使隐藏容器会导致子组件被隐藏,也是如此。

目标轴在当前的UI图中,指定为UIAxes,或PolarAxes对象,或图形对象,如HeatmapChart

在所有UI图中,存在轴儿童的轴,总有一个电流轴。当前轴不必是最顶部的轴,并将轴设置为当前轴不会将其恢复在所有其他轴上。如果UI数字不包含轴,则获得(GCF,'Currentax')命令返回一个空数组。

查询Currentax属性获取当前坐标轴对象,如果坐标轴不存在,则无需强制创建。

当前对象,作为UI图形的子对象返回。MATLAB设置CurrentObject属性设置为在UI图中单击的最后一个对象。

单击以下对象HandleVisibility属性是“关”设置CurrentObject财产图形支架数组中。

当前点,返回为一个二元向量。向量包含(xy鼠标指针的)坐标,在从UI图的左下角的像素来测量。如果UI数字是可滚动的,该坐标从滚动区的左下角测量。可滚动区是通过滚动条的范围限定的区域。

当你做以下任何一件事时,坐标就会更新:

  • 在UI图中按下鼠标按钮。

  • 在UI图中按下它后释放鼠标按钮。

  • 按UI图中的鼠标按钮,然后释放它的UI图形之外。

  • 旋转UI图中的滚轮。

  • 在图内移动鼠标(不按任何按钮),只要WindowButtonMotionFcn财产不是空的。

如果UI图形有一个响应鼠标交互的回调,并且您触发回调的速度快于系统执行代码的速度,那么坐标可能不能反映指针的实际位置。相反,它们是回调开始执行时的位置。

如果使用电流点属性要绘制点,坐标值可能包含舍入错误。

当前字符,作为上次按下的键的字符返回。当用户按下键时,当UI图形有焦点时,此属性会更新。

鼠标选择类型,返回“正常”“扩展”'ALT',或'打开'.此属性提供关于在UI图形中发生的最后一次鼠标按钮按下的信息。

这个表列出了可能的选择值和产生这些值的用户操作。

价值

对应动作

“正常”

点击鼠标左键。

“扩展”

任何以下内容:

  • 转变- 单击鼠标左键。

  • 点击鼠标中键。

  • 单击鼠标的左右按钮。

'ALT'

下列任何一种:

  • 控制- 单击鼠标左键。

  • 点击鼠标右键。

'打开'

双击任何鼠标按钮。

滚动能力,指定为“关”“上”,或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,“关”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

将此属性设置为“上”启用容器内滚动。然而,还有其他要求:

  • 容器中的子组件必须占用比容器一次可以显示的更大的区域。

  • 不能装入容器的组件必须位于容器上方或右侧。不能滚动到容器下方或左侧的组件。

某些类型的图表和轴不支持可滚动容器。万博1manbetx但是,您可以将图表或轴放置在不可滚动的面板中,然后将面板放置在可滚动的容器中。有关更多信息,请参见在App Designer中显示图形

上下文菜单,指定为上下文菜单使用的对象uicontextmenu函数。当您右键单击UI图形时,使用此属性显示上下文菜单。

公共回调

全部展开

按钮向下回调,指定为以下值之一:

  • 一个处理函数。

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

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

当用户单击UI图形的空白区域时执行此回调。

有关将回调属性值指定为函数句柄,小区数组或字符向量的详细信息,请参阅在应用程序设计器中编写回调为程序创建的应用程序写回调

使用选择属性以确定用户是否按下修改器键。

对象创建功能,指定为这些值之一:

  • 函数句柄。

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

  • (不推荐)包含有效MATLAB表达字符向量。MATLAB评估在基工作区这个表达式。

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

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

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

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

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

  • 函数句柄。

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

  • (不推荐)包含有效MATLAB表达字符向量。MATLAB评估在基工作区这个表达式。

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

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

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

键盘回调

全部展开

按键回调,指定为以下值之一:

  • 一个处理函数。

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

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

当用户按下一个键时UI图形或子组件具有焦点,这个回调函数执行。按下接受键盘焦点(例如编辑字段)的部件上的键,除非该组件被禁用不执行回调。您可以通过设置禁用组件使能够可编辑的财产“关”。此外,您可以禁用桌子组件,而不是通过设置使能够财产“不活跃”

如果用户同时按下多个键,MATLAB会检测所有键。

KeyPressFCN.回调可以访问有关用户与键盘交互的特定信息。MATLAB通过在这个信息KeyData对象作为回调函数的第二个参数。的属性KeyData对象。

财产 描述
字符

按下一个或多个键后出现的字符。

按下某些键或修改键与Ctrl键可能会在此属性中返回无法打印的字符。

仅按某些键(例如CtrlAlt转变)不会生成字符数据。

改性剂

单元格数组,包含按下的修饰符键的名称,例如控制alt,或转移.如果没有按任何修改键,单元阵列是空的。

关键

按键,由按键上的小写标签或描述性单词(如)标识“空间”

按下键时具有焦点的对象。
EventName 键盘按键的

有关指定回调属性值和使用回调参数的详细信息,请参见在应用程序设计器中编写回调为程序创建的应用程序写回调

当前字符属性还返回字符信息。

键释放回调,指定为以下值之一

  • 一个处理函数。

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

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

当用户释放一个键,而UI图形或子组件有焦点时,执行此回调函数。在接受键盘焦点(例如编辑字段)的组件上释放一个键不会执行回调,除非该组件被禁用。您可以通过设置禁用组件使能够可编辑的财产“关”。此外,您可以禁用桌子组件,而不是通过设置使能够财产“不活跃”

这个回调函数可以访问到用户与键盘交互的具体信息。MATLAB通过在这个信息KeyData对象作为回调函数的第二个参数。的属性KeyData对象。

财产 描述
字符

与释放的一个或多个键相对应的字符。

某些键或键组合可能在此属性中返回不可打印的字符。

按下和释放单独的某些键(如CtrlAlt转变)不会生成字符数据。

改性剂

单元格数组,包含释放的修饰符键的名称,例如控制alt,或转移.如果没有释放修饰符键,则单元格数组为空。

关键

键释放,由密钥上的(小写)标签或诸如的描述性单词标识“空间”

对象,该对象在键被释放时具有焦点。
EventName “KeyRelease”

有关指定回调属性值和使用回调参数的详细信息,请参见在应用程序设计器中编写回调为程序创建的应用程序写回调

窗口回调

全部展开

关闭请求回调,指定为以下值之一:

  • 一个处理函数。

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

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

有关将回调属性值指定为函数句柄,小区数组或字符向量的详细信息,请参阅指定回调函数

当应用程序用户试图关闭应用程序时,MATLAB执行这个回调。例如,你可以编写回调来显示一个对话框,要求应用程序用户确认或取消关闭操作。

的默认值CloseEquestfcn.回调,'closereq',无条件删除图形,破坏窗口。

考虑调用删除函数关闭数字CloseEquestfcn.回调函数:

  • 在App Designer中,调用删除(应用)

  • 适用于以编程方式创建的应用程序,调用删除(f), 在哪里f数字对象。

如果CloseEquestfcn.回调函数不包含删除命令,MATLAB永远不会关闭该窗口。您可以随时拨打删除函数强制关闭窗口。

代码示例:CloseEquestfcn.显示对话框

此示例显示如何对关闭请求函数进行编码,以显示一个确认对话框,要求用户确认关闭操作。请将代码保存到系统上的可写文件夹中。

函数myClosereq(SRC,Event)选择= UIConfirm(SRC,“关闭这个数字?......确认关闭的);开关选择案件“好的”删除(SRC)案件“取消”返回结束结束

现在,创建一个人物,并指定myCloseReq对于CloseEquestfcn..请注意,函数句柄未明确地指的是任何输入参数,但函数声明包括两个输入参数。MATLAB在回调执行时自动传递这些参数。第一个参数是触发回调的UI组件,第二个参数为回调函数提供事件数据。

uifigure (“CloseRequestFcn”, @myCloseReq);

关闭图形窗口和显示确认对话框。

大小改变回调,指定为以下值之一:

  • 一个处理函数。

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

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

当容器的大小发生变化时(例如,当用户调整窗口的大小),定义这个回调函数来定制应用程序的布局。在其中,编写代码来调整位置子组件的属性。

笔记

SizeChangedFcn回调将不会执行,除非自动复位儿童此容器的属性设置为“关”.在App Designer中,你可以SizeChangedFcn通过选择容器并清除自动复位儿童复选框在“组件”选项卡中组件浏览器

SizeChangedFcn回调执行时间:

  • 这个容器第一次变得可见。

  • 在其尺寸变化时,此容器可见。

  • 这个容器在其大小改变后第一次变得可见。这种情况发生在容器不可见时大小发生变化,然后容器变为可见时。

定义A时要考虑的其他要点SizeChangedFcn回调函数:

  • 考虑延迟显示该容器,直到所有的变量SizeChangedFcn使用定义。这种做法可以防止SizeChangedFcn从返回错误回调。若要延迟显示容器,请设置其看得见的财产“关”.然后,设置看得见的财产“上”在定义变量之后SizeChangedFcn回调使用。

  • 如果你的应用程序包含嵌套容器,它们会由内而外调整大小。

  • 控件内访问正在调整大小的容器SizeChangedFcn,请参阅源对象(回调中的第一个输入参数)或使用gcbo函数。

替代方法来指定调整大小行为是创建一个GridLayout对象或使用App Designer中的自动回流选项。这些选项比SizeChangedFcn回调。但是,有一些优势SizeChangedFcn回调有这些选项。例如:

  • 调整组件到最小或您定义的最大尺寸。

  • 实现非线性调整大小行为,例如根据父容器的大小更改组件的大小。

窗口按钮下拉回调,指定为以下值之一:

  • 一个处理函数。

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

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

当用户单击时执行此回调:

  • UI图形的空白区域。

  • UI图中的一个UI组件。

  • 控件的UI图形中的图形对象万博1manbetx按钮向下财产。

例如,单击斧头对象触发器WindowButtonDownFcn回调。

如果用户单击a合适的组件时,回调不会执行,除非使能够属性设置为“关”“不活跃”

请参阅特定图形对象的属性列表,以确定它是否支持万博1manbetx按钮向下财产。看到图形对象属性用于图形对象的属性。

笔记

当用户单击时,回调执行uiaxes组件,即使uiaxes组件不支持万博1manbetx按钮向下财产。

有关将回调属性值指定为函数句柄,小区数组或字符向量的详细信息,请参阅在应用程序设计器中编写回调为程序创建的应用程序写回调

窗口按钮运动回调,指定为以下值之一:

  • 一个处理函数。

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

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

通常,只要用户在UI图形中移动指针,就会执行此回调函数。但是,如果用户单击并按住鼠标按钮并将指针移动到UI图形之外,则WindowButtonMotionFcn当指针位于UI图形之外时执行回调。

有关将回调属性值指定为函数句柄,小区数组或字符向量的详细信息,请参阅在应用程序设计器中编写回调为程序创建的应用程序写回调

窗口按钮上的回调,指定为以下值之一:

  • 一个处理函数。

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

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

当用户:

  • 在UI图形的空白区域释放鼠标按钮。

  • 在UI图中释放UI组件上的鼠标按钮。

  • 在支持该支持的UI图中的图形对象上释放鼠标按钮万博1manbetx按钮向下财产。

例如,释放鼠标上的按钮斧头对象触发器WindowButtonUpFcn回调。

如果用户在屏幕上释放鼠标按钮合适的组件时,回调不会执行,除非使能够属性设置为“关”“不活跃”

请参阅特定图形对象的属性列表,以确定它是否支持万博1manbetx按钮向下财产。看到图形对象属性用于图形对象的属性。

在UI图中,向上的按钮动作与向下的按钮动作相关联。当按下按钮的动作发生时,鼠标指针必须在UI图形内部,但当按下按钮的动作发生时,鼠标指针可以在图形外部。

笔记

控件上的鼠标按钮释放时执行回调uiaxes组件,即使uiaxes组件不支持万博1manbetx按钮向下财产。

有关将回调属性值指定为函数句柄,小区数组或字符向量的详细信息,请参阅在应用程序设计器中编写回调为程序创建的应用程序写回调

窗口按键回调,指定为以下值之一:

  • 一个处理函数。

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

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

当用户在UI图形或子组件具有焦点的情况下按键时,将执行此回调函数。如果用户几乎同时按下多个键,MATLAB将检测所有键。

这个回调函数可以访问到用户与键盘交互的具体信息。MATLAB通过在这个信息KeyData对象作为回调函数的第二个参数。的属性KeyData对象。

财产 描述
字符

按下一个或多个键后出现的字符。

按下某些键或修改键与Ctrl键可能会在此属性中返回无法打印的字符。

仅按某些键(例如CtrlAlt转变)不会生成字符数据。

改性剂

单元格数组,包含按下的修饰符键的名称,例如控制alt,或转移.如果没有按任何修改键,单元阵列是空的。

关键

按键,由按键上的小写标签或描述性单词(如)标识“空间”

按下键时具有焦点的对象。
EventName 键盘按键的

有关指定回调属性值和使用回调参数的详细信息,请参见在应用程序设计器中编写回调为程序创建的应用程序写回调

当前字符属性还返回字符信息。

窗口键释放回调,指定为以下值之一

  • 一个处理函数。

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

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

当用户释放一个键,而UI图形或子组件有焦点时,执行此回调函数。

这个回调函数可以访问到用户与键盘交互的具体信息。MATLAB通过在这个信息KeyData对象作为回调函数的第二个参数。的属性KeyData对象。

财产 描述
字符

与释放的一个或多个键相对应的字符。

某些键或键组合可能在此属性中返回不可打印的字符。

按下和释放单独的某些键(如CtrlAlt转变)不会生成字符数据。

改性剂

单元格数组,包含释放的修饰符键的名称,例如控制alt,或转移.如果没有释放修饰符键,则单元格数组为空。

关键

键释放,由密钥上的(小写)标签或诸如的描述性单词标识“空间”

对象,该对象在键被释放时具有焦点。
EventName “KeyRelease”

有关指定回调属性值和使用回调参数的详细信息,请参见在应用程序设计器中编写回调为程序创建的应用程序写回调

窗口滚动轮回调,指定为以下值之一:

  • 一个处理函数。

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

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

当用户在UI图形或其任何孩子具有焦点时,该回调执行当用户移动滚轮时。但是,其他对象可以捕获滚轮移动并干扰此回调的执行。

此回调对CurrentObject选择属性。

当用户旋转滚轮时,此回调可以访问特定的信息。MATLAB通过在这个信息滚轮数据对象作为回调函数的第二个参数。的属性滚轮数据对象。

财产

内容

VerticalScrollCount

一个正数或负数,表示滚轮点击的方向和次数。向下滚动将返回一个正数。向上滚动将返回一个负值。

垂直滚动计数是自上次执行回调以来发生的所有滚轮点击的总和。通常值为1-1.但是,滚动计数可以具有更大的幅度WindowScrollWheelFcn回调需要很长时间才能返回,或者如果用户快速旋转滚轮。

VerticalScrollAmount

的常数值3.

对象执行回调。

EventName “WindowScrollWheel”

有关指定回调属性值和使用回调参数的详细信息,请参见在应用程序设计器中编写回调为程序创建的应用程序写回调

例如:App for Changingx轴限制

这个例子展示了如何创建一个显示图形的应用程序。用户可以滚动来改变的限制x设在。将以下代码复制并粘贴到编辑器中并运行它。

函数scroll_wheel%演示如何使用WindowScrollWheelFcn属性f = uifigure (“WindowScrollWheelFcn”,@figScroll,“名字”“滚轮演示”);x = 0: .1:40;y = 4。* cos (x) / (x + 2);一个=轴(f);h =情节(x, y);标题(,'旋转滚动轮'函数figScroll(~,事件)如果事件。VerticalScrollCount > 0 xd = h.XData;公司= xd(结束)/ 20;x =[0。1:xd(结束)+公司);re_eval (x)ELSEIFevent.VerticalScrollCount<0 xd=h.XData;inc=xd(end)/20;%不要让xd=0x =[0。1:xd(结束)公司+ 1。);re_eval (x)结束结束函数Re_eval (x) y = 4.*cos(x)./(x+2);h.YData = y;h.XData = x;a.XLim = [0 x(end)];drawnow结束结束

注意,函数的句柄figScroll没有显式引用任何输入参数,但是函数声明包含两个输入参数。MATLAB在回调执行时自动传递这些参数。第一个参数是触发回调的UI组件,第二个参数为回调函数提供事件数据。

回调执行控制

全部展开

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

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

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

  • 中断回调是一个回调,它试图中断运行的回调。

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

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

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

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

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

笔记

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

  • 如果中断回调为deletefcn.CloseEquestfcn.,或SizeChangedFcn回调,则中断发生不管可中断属性值。

  • 如果正在运行的回调当前正在执行等待函数,则无论可中断属性值。

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

笔记

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

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

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

  • 中断回调是一个回调,它试图中断运行的回调。

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

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

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

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

此属性是只读的。

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

MATLAB设置BeingDeleted财产“上”当。。。的时候deletefcn.回调开始执行。的BeingDeleted属性仍然设置为“上”直至该组件对象不再存在。

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

家长/孩子

全部展开

此属性是只读的。

父对象,返回为根对象。

儿童数字对象,返回一个空图形支架或组件对象的一维数组。子组件可以是任何组件,不包括其他组件数字对象。

属性添加或删除子组件孩子们财产。使用此属性可查看子列表或对子列表重新排序。这个数组中的子元素的顺序反映了屏幕上组件的前后顺序(堆叠顺序)。

为了孩子添加到这个列表,设置父母属性的子组件数字对象。

对象句柄的可见性,指定为“关”“回调”,或“上”.属性的可见性数字对象在其父母的孩子列表中。默认值设置为“关”为了防止数字对象以避免成为当前图形(gcf),并防止函数对UI做出不必要的更改。

下表描述了设置每个值的效果:

可处理性值 描述
“关”

数字对象句柄在回调函数或在命令窗口中执行的函数中不可见。此外,对象句柄是:

  • 在图形根目录返回的列表中不可见孩子们Curratutigure.属性。

  • 通过功能不返回的访问通过搜索对象层次或查询对象属性的对象。这些功能包括:gcfgco收到findobjclf,关闭

此选项可防止从命令行调用的回调函数和函数从目标目标并对UI进行意外更改。

“回调”

数字对象句柄是可见的只有从回调或回调调用的函数中,而不是从命令窗口调用的函数内。此外,对象句柄是不是由图形根返回列表可见孩子们Curratutigure.属性。

此选项阻止访问在命令行的对象,但允许回调函数来访问它。

“上”

数字对象句柄总是可见的。

对象是有效的,即使它们的HandleVisibility属性设置为“关”.如果你可以访问一个对象,你可以设置和获取它的属性,并将它传递给任何操作对象的函数。

标识符

全部展开

该图中,指定为字符向量或标量的字符串的名称。

例子:uifigure(“名字”,“结果”)将图的名称设置为“结果”

在App Designer中,的名字属性是MATLAB应用程序的

图标源或文件,指定为字符向量、字符串标量或-经过-n-by-3真彩色图像数组。如果指定文件名,它可以是MATLAB路径上的图像文件名,也可以是图像文件的完整路径。如果您计划与他人共享应用程序,请将图像文件放在MATLAB路径上,以便于应用程序打包。

万博1manbetx支持的图像格式包括JPEG,PNG,GIF,和-经过-n-by-3真彩色图像数组。有关TrueColor图像阵列的更多信息,请参阅图像类型.GIF动画文件只显示第一帧。

如果没有足够的空间来显示图标完全在全尺寸,MATLAB缩小图像以适应。

例子:“程序”指定MATLAB路径上的图标文件。

例子:“C: \ \程序文件”指定图像文件的完整路径。

例子:fig=uifigure('Icon','peppers.png'))使用指定的图标图像文件的UI图。

此属性是只读的。

图中的数字,作为整数或空数组返回。您可以使用此值引用图形。例如,图(2)用a表示图形数量财产价值2当前的图。

如果IntegerHandle属性设置为“关”这个数量属性为空。

如果IntegerHandle“上”这个数量属性是一个整数。当您删除该数字时,MATLAB将为下一个数字重用该数字。

编号标题,指定为“关”“上”,或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,“关”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

当您将此属性设置为“上”,UI图的标题包括短语“图n”, 在哪里n是一个数字。

这两个NumberTitleIntegerHandle属性必须设置为“上”在标题中显示数字。

使用整数手柄,指定为“关”“上”,或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,“关”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

如果设置了IntegerHandle财产“上”,MATLAB查找现有图形未使用的最小整数值,并设置数量属性设置为该值。如果删除UI图形,MATLAB可以在新图形上重用其编号。

如果设置了IntegerHandle财产“关”, MATLAB不指定一个整数值给UI图形,它设置数量属性设置为空数组。

要显示在标题栏中的数字,无论是IntegerHandleNumberTitle必须设置为“上”

此属性是只读的。

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

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

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

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

介绍了R2016a