主要内容

NumericEditField属性

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

数字编辑字段是UI组件,允许用户在应用中键入数字值。属性控制数字编辑字段的外观和行为。使用点表示法来引用特定对象和属性:

无花果= uifigure;ef = uieditfield(无花果、“数字”);ef。值= 20;

价值

展开全部

编辑字段中的值指定为双精度编号。

当应用程序用户在编辑字段中键入或更改一个值时,该值是一个字符向量。当应用程序用户按下进入关键或改变焦点,MATLAB®将应用程序用户输入的值转换为双精度数字。

Matlab拒绝如果:

  • 它不能将字符向量转换为标量。

  • 取值为NaN、空或复数。

  • 该值是数学表达式,例如1 + 2

  • 值小于限制属性下限或大于上限。

当MATLAB拒绝应用程序用户输入的值时,将出现一个工具提示,描述了值要求。编辑字段文本立即恢复到先前的值,否ValueChangedFcn运行。

例子:10

最小和最大编辑字段值,指定为双元数字数组。第一个值必须小于第二个值。设置数组元素-inf.INF.分别指定没有最小值或最大值。

如果你改变限制这样价值小于新的下限,MATLAB集价值到新范围内的最低值。例如,假设限制[0 100]价值是20。如果限制改变到[100],包容,然后matlab套装价值到50。

同样,如果你改变了限制这样的价值大于新的上限,那么MATLAB集价值到新的上限(假设限制是包容性的)。

例子:[-inf 200]

例子:[-100正]

例子:(-100 200)

舍入应用用户输入的分数值,指定为'上''离开',或作为数字或逻辑1真正的)或0.)。的值'上'相当于真正的,'离开'相当于。因此,您可以将此属性的值用作逻辑值。该值存储为开/关类型的逻辑值matlab.lang.OnoffSwitchState.

  • '上'- MATLAB四舍五入的值,如果它的结果是一个有效值并执行ValueChangedFcn打回来。如果产生的值超出较低或较高限制,然后matlab轮到最接近的值落在限制然后执行回调。

  • '离开'- Matlab不在整个数字中围绕分数。

如果RoundFractionalValues财产价值发生变化'离开''上'以编程方式,Matlab适用于这些规则:

  • 如果舍入现有值会产生一个整数,该整数位于所指定的限制范围内限制性质,然后MATLAB舍入现有值。

  • 如果舍入现有值会产生小于下限的整数,则Matlab舍入现有值。

  • 如果舍入现有值会产生大于上限的整数,则Matlab舍入现有值。

  • 如果配置限制,则在范围内没有有效整数,则Matlab设置了RoundFractionalValues财产价值返回'离开'并显示错误消息。

值显示格式,指定为字符向量或字符串标量。MATLAB使用Sprintf.使用指定的格式显示值。

您可以将文本与格式操作符混合使用。例如:

numfield = uieditfield (“数字”'valuedisplayformat'' %。0.f MS/s');

生成的编辑字段如下所示:

当用户单击运行应用程序中的编辑字段时,字段显示没有文本的值。

有关支持的格式操作符的完整列表,请参见金宝appSprintf.

下限包容性,指定为'上''离开',或作为数字或逻辑1真正的)或0.)。的值'上'相当于真正的,'离开'相当于。因此,您可以将此属性的值用作逻辑值。该值存储为开/关类型的逻辑值matlab.lang.OnoffSwitchState.

  • '上'—取值必须大于或等于设置的下限。

  • '离开'—取值必须大于设置的下限。

上限包裹性,指定为'上''离开',或作为数字或逻辑1真正的)或0.)。的值'上'相当于真正的,'离开'相当于。因此,您可以将此属性的值用作逻辑值。该值存储为开/关类型的逻辑值matlab.lang.OnoffSwitchState.

  • '上'- 值必须等于或小于上限。

  • '离开'- 值必须小于上限。

例如,如果您希望输入的数字介于0和1之间,不包括0和1,请执行以下所有操作:

  • 设定限制财产价值[0 1]

  • 设定UpperLimitInclusive财产'离开'

  • 设定LowerLimitInclusive财产'离开'

字体和颜色

展开全部

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

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

例子:'arial'

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

例子:14

字体重量,指定为其中一个值:

  • '普通的'-由特定字体定义的默认重量

  • “大胆”- 比较厚的字符概述'普通的'

不是所有字体都有粗体字体粗体。因此,指定粗体字体粗细可以得到正常的字体粗细。

字体角度,指定为'普通的'“斜体”。将此属性设置为斜体如果App用户的系统上可用,请选择字体的倾斜版本。

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

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

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

  • 十六进制颜色代码是字符向量或以哈希符号开头的字符串标量()接着是三个或六个十六进制数字,可以从0.F。这些值不区分大小写。因此,颜色编码“# 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'

'品红' 'M' (1 0 1) '#ff00ff'

'黄色的' “y” [1 1 0] “# FFFF00”

'黑色的' 'K' [0 0 0] '#000000'

'白色的' ' w ' [1 1] “# FFFFFF”

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

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)

  • 十六进制颜色代码是字符向量或以哈希符号开头的字符串标量()接着是三个或六个十六进制数字,可以从0.F。这些值不区分大小写。因此,颜色编码“# 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'

'品红' 'M' (1 0 1) '#ff00ff'

'黄色的' “y” [1 1 0] “# FFFF00”

'黑色的' 'K' [0 0 0] '#000000'

'白色的' ' w ' [1 1] “# FFFFFF”

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

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使用数组中的值,而不是完整的类别。

上下文菜单,指定为a上下文菜单使用的对象UIContextMenu.功能。右键单击组件时,请使用此属性显示上下文菜单。

位置

展开全部

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

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

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

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

例子:[150 130 100 22]

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

此属性是只读的。

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

编辑字段中的数字的水平对齐,指定为:

  • '正确的'- 编号在编辑字段的右侧对齐。

  • “左”-数字在编辑字段的左侧对齐。

  • '中央'-数字在编辑字段的中心对齐。

布局选项,指定为gridlayoutoptions.目的。此属性指定网格布局容器的子组件的选项。如果组件不是网格布局容器的子节点(例如,它是图形或面板的子项),则此属性为空,没有效果。但是,如果组件是网格布局容器的子节点,则可以通过设置该组件将组件放置在所需的行和网格列中柱子物业在gridlayoutoptions.目的。

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

g = uigrivlayout([4 3]);ef = Uieditfield(g,“数字”);ef.Layout.Row = 3;ef.Layout.Column = 2;

要使编辑字段跨多行或多列,请指定柱子属性作为双元素矢量。例如,此编辑字段跨栏列2通过3.

e . layout . column = [2 3];

回调

展开全部

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

  • 一个处理函数。

  • 其中第一元素是函数手柄的单元阵列。单元格数组中的后续元素是传递给回调函数的参数。

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

当用户更改编辑字段中的文本并按下时,将执行回调进入或单击“编辑”字段之外。如果编辑字段值以编程方式更改,则不会执行它。

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

下表列出了该属性valuechangeddata.目的。

财产 价值
价值 编辑字段的值后,应用程序用户与它最近的交互
inverionvalue. App用户最近与其交互之前的编辑字段的值
来源 执行回调的组件
EventName 'valuechanged'

有关写回调的更多信息,请参阅在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处理队列的下一个点,例如何时存在drawnow数字uifiguregetframe等待,或暂停命令。

    • 如果运行回调包含其中一个命令,则Matlab在该点处停止执行回调并执行中断回调。MATLAB在中断回调完成时执行运行回调。

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

  • 的值'离开'阻止所有中断尝试。这忙碌属性确定中断回调是被丢弃还是放入队列。

笔记

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

  • 如果中断回叫是deletefcn.CloseEquestfcn.SizeChangedFcn回调,则中断将发生,而不管可中断属性值。

  • 如果正在运行的回调当前正在执行等待功能,无论的内容都会发生中断可中断属性值。

  • 计时器无论如何,对象根据计划执行可中断属性值。

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

回调队列指定为'队列''取消'。这忙碌属性决定了MATLAB如何处理中断回调的执行。有两个回调状态需要考虑:

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

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

每当MATLAB调用一个回调函数时,该回调函数试图中断一个正在运行的回调函数。这可中断拥有运行回调的对象的属性确定是否允许中断。如果不允许中断,那么忙碌拥有中断回调的对象的属性确定它是被丢弃还是放入队列。这些是可能的值忙碌属性:

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

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

此属性是只读的。

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

Matlab设置了呈扭曲财产'上'当。。。的时候deletefcn.回调开始执行。这呈扭曲属性仍设置为'上'直到组件对象不再存在。

检查的值呈扭曲属性验证在查询或修改之前未删除对象是否即将删除。

父母/孩子

展开全部

父容器,指定为a数字使用的对象uifigure功能,或其中一个子容器:标签面板buttongroup.,或GridLayout。如果没有指定容器,MATLAB调用uifigure创建新的功能数字作为父容器的对象。

指定的对象句柄的可见性'上'“回调”,或'离开'

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

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

身份标识

展开全部

此属性是只读的。

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

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

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

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

也可以看看

职能

在R2016A介绍