主要内容

EditField属性

控制编辑字段的外观和行为

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

无花果= uifigure;ef = uieditfield(图);ef。Value = 'New sample';

文本

全部展开

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

例子:'你好,世界'

编辑字段中的占位符文本,指定为字符向量或字符串标量。占位符提供了一个简短的提示来描述预期的输入。时,文本才显示价值属性是''

例子:'输入文本'

编辑字段内文本的对齐方式,指定为'剩下'“对”,或“中心”.当应用程序用户编辑编辑字段以及MATLAB如何在应用程序中显示文本时,对齐会影响显示。

字体和颜色

全部展开

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

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

例子:“天线”

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

例子:14

字体粗细,指定为以下值之一:

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

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

并非所有字体都有粗体的字体重量。因此,指定粗体的重量可以导致正常的字体重量。

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

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

RGB三联体和十六进制颜色代码用于指定自定义颜色。

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

  • 十六进制颜色码是一个以散列符号()后接3或6个十六进制数字,其范围可以是0F.这些值不区分大小写。因此,颜色编码“# FF8800”'#ff8800''#f80', 和“# f80”是等同的。

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

颜色名称 短名称 RGB值 十六进制颜色代码 外貌
“红色” “r” [1 0 0] “# FF0000”

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

“蓝” “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”

[0.8500 0.3250 0.0980] “# D95319”

[0.9290 0.6940 0.1250] '#edb120'

(0.4940 0.1840 0.5560) '#7e2f8e'

[0.4660 0.6740 0.1880] “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) '#a2142f'

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

RGB三联体和十六进制颜色代码用于指定自定义颜色。

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

  • 十六进制颜色码是一个以散列符号()后接3或6个十六进制数字,其范围可以是0F.这些值不区分大小写。因此,颜色编码“# FF8800”'#ff8800''#f80', 和“# f80”是等同的。

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

颜色名称 短名称 RGB值 十六进制颜色代码 外貌
“红色” “r” [1 0 0] “# FF0000”

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

“蓝” “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”

[0.8500 0.3250 0.0980] “# D95319”

[0.9290 0.6940 0.1250] '#edb120'

(0.4940 0.1840 0.5560) '#7e2f8e'

[0.4660 0.6740 0.1880] “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) '#a2142f'

交互性

全部展开

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

  • “上”—显示对象。

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

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

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

属性组合使用此属性启用属性值来确定组件是否以及如何响应应用程序用户的输入:

  • 要使编辑字段可编辑并可触发相关的回调,请设置启用财产和可编辑的属性值“上”

  • 要使编辑字段不可分以,但文本易于阅读,设置启用属性值对“上”可编辑的属性值对“关闭”

  • 要使编辑字段不可编辑和文本暗淡,请将属性设置为“关闭”

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

属性组合使用此属性可编辑的属性值来确定组件是否以及如何响应应用程序用户的输入:

  • 要使编辑字段可编辑并可触发相关的回调,请设置启用财产和可编辑的属性值“上”

  • 要使编辑字段不可分以,但文本易于阅读,设置启用属性值对“上”可编辑的属性值对“关闭”

  • 要使编辑字段不可编辑和文本暗淡,请将属性设置为“关闭”

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

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

位置

全部展开

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

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

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

位置值相对于可拉的区域父容器。可拉伸区域是容器边界内的区域,并且不包括装饰品(例如菜单栏或标题)所占用的区域。

例子:[150 130 100 22]

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

此属性是只读的。

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

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

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

G = uigridlayout([4 3]);ef = uieditfield (g);ef.Layout.Row = 3;ef.Layout.Column = 2;

要使编辑字段跨多行或多列,请指定作为一个二元向量的性质。例如,此编辑字段跨列2通过3.

ef.layout.column = [2 3];

回调

全部展开

值更改回调,指定为其中一个值:

  • 一个处理函数。

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

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

回调在用户更改编辑字段中的文本和按下时执行输入或在编辑字段外单击。如果编辑字段值以编程方式更改,则不会执行。

这个回调函数可以访问关于用户与编辑字段交互的特定信息。MATLAB通过一个ValueChangedData对象作为回调函数的第二个参数。在App Designer中,调用该参数事件.您可以使用点表示法查询对象属性。例如,事件。PreviousValue返回编辑字段的前一个值。的ValueChangedData指定为字符向量的回调函数不可用对象。

属性的属性如下表所示ValueChangedData对象。

财产 价值
价值 编辑字段的值后,应用程序用户与它最近的交互
PreviousValue 编辑字段在应用程序用户最近一次与之交互之前的值
执行回调的组件
eventName. “ValueChanged”

有关编写回调的更多信息,请参见在App Designer中编写回调

更改回调值,指定为其中一个值:

  • 一个处理函数。

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

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

这个回调执行如下:

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

  • 当用户按下时输入,执行回调。

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

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

这是ValueChangingData对象:

财产 描述
价值 触发回调执行的
执行回调的组件
eventName. “ValueChanging”

价值财产的EditField对象,直到用户按下输入关键。但是,您可以获得用户在按下按钮之前输入的文本输入通过查询价值财产的ValueChangingData对象。

有关编写回调的更多信息,请参见在App Designer中编写回调

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

  • 函数处理。

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

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在App Designer中编写回调

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

设置CreateFcn属性对现有组件不起作用。

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

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

  • 函数处理。

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

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在App Designer中编写回调

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

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

回调执行控制

全部展开

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

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

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

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

每当MATLAB调用一个回调函数时,该回调函数试图中断正在运行的回调函数(如果存在的话)。的中断拥有运行回调的对象的属性确定是否允许中断。

  • 的值“上”允许其他回调中断对象的回调。中断发生在MATLAB处理队列的下一个点,例如有一个drawn数字uifiguregetframe等待,或暂停命令。

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

    • 如果运行回调不包含其中一个命令,则matlab完成在不中断的情况下执行回调。

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

请注意

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

  • 如果中断回叫是DeleteFcnCloseRequestFcnSizeChangedFcn回调,那么无论的内容都会发生中断中断属性值。

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

  • 计时器对象按照时间表执行,而不管中断属性值。

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

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

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

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

每当MATLAB调用回调时,回调尝试中断运行的回调。的中断属性确定是否允许中断。如果不允许中断,那么BusyAction拥有中断回调的对象的属性确定是否丢弃或放入队列中。这些是可能的值BusyAction属性:

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

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

此属性是只读的。

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

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

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

父/子

全部展开

指定为数字对象创建的uifigure函数或它的一个子容器:选项卡控制板ButtonGroup,或网格布局.如果没有指定容器,Matlab会调用uifigure函数创建一个新的数字作为父容器的对象。

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

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

HandleVisibility价值 描述
“上” 对象总是可见的。
“回调” 从回调或通过回调调用的函数中可以看到该对象,但不是从命令行调用的函数中。此选项会阻止在命令行处访问对象,但允许回调函数访问它。
“关闭” 这个物体一直是看不见的。此选项用于防止另一个函数对UI进行意外更改。设置HandleVisibility“关闭”在该函数执行期间暂时隐藏该对象。

标识符

全部展开

此属性是只读的。

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

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

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

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

另请参阅

功能

介绍了R2016a