主要内容

编辑字段属性

控制编辑字段外观和行为

编辑字段是用于输入文本的UI组件。属性控制编辑字段的外观和行为。使用点符号表示特定对象和属性。

无花果= uifigure;ef = uieditfield(图);ef。Value = '新样本';

文本

全部展开

编辑字段中的文本,指定为字符向量或字符串标量。MATLAB®将文本显示为单行。如果要允许多行文本,请使用文本区域组件而不是编辑字段。

例子:“Hello world”

占位符文本在编辑字段中,指定为字符向量或字符串标量。占位符提供简短的提示来描述预期的输入。该文本仅显示价值财产是

例子:“输入文本”

编辑字段中的文本对齐,指定为“左”“对”, 或者'中央'这个alignment affects the display as the app user edits the edit field and how MATLAB displays the text in the app.

字体和颜色

全部展开

字体名称,指定为系统支持的字体名称。万博1manbetx默认字体取决于特定的操作系统和地区。

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

例子:“Arial”

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

例子:14.

字体重量,指定为以下值之一:

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

  • '胆大'-字符轮廓比“正常”

并不是所有的字体都有粗体字体。因此,指定粗体字体权重可能导致正常字体权重。

字体角度,指定为“正常”或者“斜体”。将此属性设置为斜体选择倾斜的字体版本,如果它是可用的应用程序用户的系统。

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

RGB三元组和十六进制颜色代码对于指定自定义颜色很有用。

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

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量()后跟三个或六个十六进制数字,其范围为0F这个values are not case sensitive. Thus, the color codes'#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] “#00FFFF”

“洋红” “我是 [1 0 1] “#FF00FF”

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

'黑色的' “k” [0 0 0] '#000000'

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

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

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

(0.8500 0.3250 0.0980) “# D95319”

(0.9290 0.6940 0.1250) “# EDB120”

[0.4940 0.1840 0.5560] “# 7 e2f8e”

(0.4660 0.6740 0.1880) "77AC30"

[0.3010 0.7450 0.9330] “#4DBEEE”

[0.6350 0.0780 0.1840] “# A2142F”

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

RGB三元组和十六进制颜色代码对于指定自定义颜色很有用。

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

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量()后跟三个或六个十六进制数字,其范围为0F这个values are not case sensitive. Thus, the color codes'#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] “#00FFFF”

“洋红” “我是 [1 0 1] “#FF00FF”

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

'黑色的' “k” [0 0 0] '#000000'

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

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

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

(0.8500 0.3250 0.0980) “# D95319”

(0.9290 0.6940 0.1250) “# EDB120”

[0.4940 0.1840 0.5560] “# 7 e2f8e”

(0.4660 0.6740 0.1880) "77AC30"

[0.3010 0.7450 0.9330] “#4DBEEE”

[0.6350 0.0780 0.1840] “# A2142F”

互动

全部展开

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

  • “上”- 显示对象。

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

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

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

将此属性与使能够属性值确定是否以及如何响应应用程序用户输入:

  • 要使编辑字段可编辑和关联的回调可触发,请设置两个使能够财产和零件可编辑属性值“上”

  • 要使编辑字段不可编辑,但文本易于阅读,请设置使能够属性值“上”可编辑属性值“关”

  • 要使编辑字段不可编辑并使文本变暗,请将这两个属性设置为“关”

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

将此属性与可编辑属性值确定是否以及如何响应应用程序用户输入:

  • 要使编辑字段可编辑和关联的回调可触发,请设置两个使能够财产和零件可编辑属性值“上”

  • 要使编辑字段不可编辑,但文本易于阅读,请设置使能够属性值“上”可编辑属性值“关”

  • 要使编辑字段不可编辑并使文本变暗,请将这两个属性设置为“关”

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

上下文菜单,指定为上下文菜单使用uicontextmenu功能。右键单击组件时,请使用此属性显示上下文菜单。

位置

全部展开

编辑字段相对于父字段的位置和大小,指定为向量[左下宽高].该表描述了向量中的每个元素。

要素 描述
父容器左内边缘到编辑字段左外边缘的距离
底部 从父容器的内部底部边缘到编辑字段的外部底部边缘的距离
宽度 编辑字段右侧和左侧外边之间的距离
高度 编辑字段顶部和底部外边缘之间的距离

所有的测量都以像素为单位。

位置值相对于可拉的区域父容器的。绘制区域是容器边界内的区域,不包括菜单栏或标题等装饰占据的区域。

例子:[150 130 100 22]

编辑字段的内部位置和大小,指定为[左下宽高].位置值相对于父容器。所有的测量都以像素为单位。此属性值与此属性相同位置财产。

此属性是只读的。

返回为的编辑字段的外部位置和大小[左下宽高].位置值相对于父容器。所有的测量都以像素为单位。此属性值与此属性相同位置财产。

布局选项,指定为aGridLayoutOptions对象。此属性为网格布局容器的子组件指定选项。如果组件不是网格布局容器的子组件(例如,它是图形或面板的子组件),则此属性为空,不起作用。但是,如果组件是网格布局容器的子组件,则可以通过设置属性GridLayoutOptions对象。

例如,此代码在其父网格的第三行和第二列中放置一个编辑字段。

g = uigrivlayout([4 3]);ef = Uieditfield(g);ef.layout.row = 3;ef.layout.column = 2;

要使编辑字段跨多行或多列,请指定或者属性作为两元素向量。例如,此编辑字段跨越多个列2通过3.

f. layout . column = [2 3];

回调

全部展开

Value changed callback,指定为以下值之一:

  • 功能手柄。

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

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

当用户更改编辑字段中的文本并按下按钮时,将执行回调进来或在编辑字段外单击。如果编辑字段值以编程方式更改,则不会执行该命令。

此回调函数可以访问有关用户与编辑字段交互的特定信息值更改数据对象作为回调函数的第二个参数。在App Designer中,参数被调用事件.可以使用点表示法查询对象属性。例如,event.PreviousValue返回“编辑”字段的先前值。的值更改数据对象不可用于指定为字符向量的回调函数。

控件的属性如下表所示值更改数据对象。

财产 价值
价值 App用户最近与其交互后的编辑字段的值
先前值 应用程序用户最近与其交互之前编辑字段的值
来源 执行回调的组件
EventName “价值改变”

有关编写回调的更多信息,请参见在应用程序设计器中编写回调

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

  • 功能手柄。

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

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

这个回调函数执行如下:

  • 当用户在编辑字段中键入时,回调将重复执行。

  • 当用户按下进来,则执行回调。

如果编辑字段值以编程方式更改,则不会执行回调。

此回调函数可以访问有关用户与编辑字段交互的特定信息价值变化数据对象作为回调函数的第二个参数。在App Designer中,参数被调用事件.可以使用点表示法查询对象属性。例如,事件。价值是编辑字段中触发回调执行的值。这个价值变化数据对象不可用于指定为字符向量的回调函数。

这是价值变化数据目的:

财产 描述
价值 触发回调执行的值
来源 执行回调的组件
EventName 'valuechanging'

价值财产编辑菲尔德对象直到用户按下进来但是,您可以在用户按之前获取他们正在键入的文本进来通过查询价值财产价值变化数据对象。

有关编写回调的更多信息,请参见在应用程序设计器中编写回调

对象创建函数,指定为其中一个值:

  • 函数处理。

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

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

有关将回调作为函数句柄,小区阵列或字符向量的更多信息,请参阅在应用程序设计器中编写回调

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

设置创建FCN现有组件上的属性无效。

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

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

  • 函数处理。

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

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

有关将回调作为函数句柄,小区阵列或字符向量的更多信息,请参阅在应用程序设计器中编写回调

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

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

回调执行控制

全部展开

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

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

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

  • 打断callback是试图中断正在运行的回调的回调。

每当MATLAB调用回调时,该回调都会尝试中断正在运行的回调(如果存在)可中断属性决定是否允许中断。

  • 的值“上”允许其他回调中断对象的回调。中断发生在matlab处理队列的下一个点,例如何时存在drawnow图形Uifigure.GetFrame.等待, 或者暂停命令。

    • 如果正在运行的回调函数包含其中一个命令,那么MATLAB将在此时停止回调函数的执行,并执行中断回调函数。当中断回调完成时,MATLAB继续执行正在运行的回调。

    • 如果正在运行的回调函数不包含这些命令之一,那么MATLAB将在不中断的情况下完成回调函数的执行。

  • 的值“关”阻止所有中断尝试。的BusyAction拥有中断回调的对象的属性决定中断回调是否被丢弃或放入队列中。

请注意

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

  • 如果中断回调是一个删除FCN关闭请求FCN或者SizechangedFCN.回调,则中断发生不管可中断适当的价值。

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

  • 计时器对象根据计划执行,而不考虑可中断适当的价值。

发生中断时,MATLAB不保存属性或显示状态。例如,由此返回的对象gca或者gcf命令可能在执行另一个回调时更改。

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

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

  • 打断callback是试图中断正在运行的回调的回调。

当MATLAB调用回调时,回调试图中断正在运行的回调。的可中断拥有运行回调的对象的属性确定是否允许中断。如果不允许中断,则BusyAction拥有中断回调的对象的属性决定了它是被丢弃还是放入队列中。这些是可能的值BusyAction财产:

  • '队列'- 将中断回调在运行回调完成后在队列中进行处理。

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

此属性是只读的。

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

MATLAB设置被删除财产“上”删除FCN回调开始执行。的被删除属性仍然设置为“上”直到组件对象不再存在。

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

父母/孩子

全部展开

父容器,指定为数字使用Uifigure.函数或其子容器之一:标签面板按钮组, 或者GridLayout.如果没有指定容器,则MATLAB调用Uifigure.函数创建一个新的数字用作父容器的对象。

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

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

可处理性值 描述
“上” 该对象始终可见。
“回调” 对象在回调或由回调调用的函数中可见,但在从命令行调用的函数中不可见。这个选项阻止在命令行中访问对象,但允许回调函数访问它。
“关” 对象始终是不可见的。此选项对于防止其他函数对UI的意外更改非常有用。设定Huppervisibility.“关”在函数执行期间暂时隐藏对象。

标识符

全部展开

此属性是只读的。

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

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

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

如果您在App Designer中工作,请在应用程序中创建公共或私有属性以共享数据而不是使用用户数据属性。有关详细信息,请参阅在应用程序设计器应用程序中共享数据

介绍了R2016a