主要内容

uitextarea

创建文本区域组件

描述

氨甲环酸= uitextarea在新图形窗口中创建文本区域并返回文本区域对象。MATLAB®调用uifigure函数创建图形。

例子

氨甲环酸= uitextarea (在指定的父容器中创建文本区域。父结点可以是数字创建使用uifigure函数或其子容器之一。

例子

氨甲环酸= uitextarea (___名称,值指定文本区域属性使用一个或多个名称,值对参数。将此选项与前面语法中的任何输入参数组合一起使用。

例子

全部折叠

无花果= uifigure;氨甲环酸= uitextarea组(图);

创建一个填充文本区域。

无花果= uifigure;氨甲环酸= uitextarea组(图,...“价值”,{“姓和名”...“地址1”《地址2》“城市、州”“邮政编码”});

请注意,文本区域包含一个滚动条,以便应用程序用户可以查看邮政编码。

确定文本区域的当前大小。

大小= txa.Position (3:4)
尺寸= 150 60

增加文本区域的大小,以便在不使用滚动条的情况下显示邮政编码。

txa.Position(3:4) = [155 75];

以编程方式滚动到文本区域的底部。

创建一个文本区域。为它指定一个大小和长文本。

无花果= uifigure;氨甲环酸= uitextarea组(图);酸。Position = [100 100 80 80];酸。值=“Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor。”

滚动到文本区域的底部。

滚动(酸“底”

创建一个文本区域和两个标签。当应用程序用户输入文本并点击文本区域之外的内容时,一个标签会感谢应用程序用户的输入。如果应用程序用户删除文本并单击文本区域之外的,感谢文本将被删除。

保存以下代码comments.m在MATLAB路径上。这段代码创建了一个包含两个标签和一个文本区域的图形窗口。当应用程序用户键入文本并单击文本区域以外的内容时,ValueChangedFcn回调会更新其中一个标签以感谢用户。

函数评论%创建图形窗口和组件无花果= uifigure (“位置”,[500 500 430 275]);label1 = uilabel(图,...“位置”,[100 164 100 15],...“文本”“输入评论:”);label2 = uilabel(图,...“位置”,[100 75 175 15],...“文本”'');textarea = uitextarea(图,...“位置”,[100 100 150 60],...“ValueChangedFcn”@(文本区域、事件)textEntered(文本区域,label2));%创建ValueChangedFcn回调函数text = textarea. value;label2。文本 |''检查文本区域单元格数组中的每个元素是否包含文本k = 1:长度(val)如果(~ isempty (val {k})) label2。文本 |“谢谢你的评论!”打破结束结束结束结束

运行评论,并在文本区域框中键入文本。在文本区域之外单击以触发回调。

输入参数

全部折叠

父容器,指定为数字使用uifigure函数或其子容器之一:选项卡面板ButtonGroup,或GridLayout.如果没有指定父容器,则MATLAB调用uifigure函数创建一个新的数字作为父容器的对象。

名称-值参数

指定可选的逗号分隔的对名称,值参数。的名字参数名和价值为对应值。的名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:“可编辑”、“关闭”指定应用程序用户不能更改文本区域的文本。

这里列出的属性是可用属性的子集。有关完整列表,请参见文本区域的属性

值,指定为字符向量、字符向量的单元格数组、字符串数组或1-D分类数组。MATLAB可以正确地渲染格式化的文本,如:

cellArrayText {1} = sprintf (“% s \ n % s”1号线的“第2行”) cellArrayText{2} = sprintf(“% s \ n % s”3号线的4号线的) textarea = uitextarea(“价值”, cellArrayText);

如果将此属性指定为类别数组,MATLAB将使用数组中的值,而不是全部类别集合。

如果文本不适合文本区域的宽度,MATLAB包装文本。

如果有太多的行显示在文本区域,MATLAB添加一个滚动条。

例子:{“约瑟夫结果”;“玛丽·赖利”;“罗伯塔Silberlicht”}

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

  • 一个处理函数。

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

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

当用户更改文本并按下按钮时,回调将执行选项卡或者在文本区域外单击。它不执行,如果价值属性以编程方式更改。

这个回调函数可以访问关于用户与文本区域交互的特定信息。MATLAB将这个信息传递到ValueChangedData对象作为回调函数的第二个参数。在App Designer中,参数被调用事件.可以使用点表示法查询对象属性。例如,事件。PreviousValue返回文本区域的前一个值。的ValueChangedData对象不可用于指定为字符向量的回调函数。

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

财产 价值
价值 应用程序用户最近一次与文本区域交互后的文本区域值
PreviousValue 文本区域在应用程序用户最近一次与之交互之前的值
执行回调的组件
EventName “ValueChanged”

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

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

  • 一个处理函数。

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

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

这个回调函数执行如下:

  • 当用户在文本区域中输入时,回调会重复执行。

  • 当用户按下选项卡或者在文本区域之外单击,则执行回调。

如果文本区域值以编程方式更改,则不会执行回调。

这个回调函数可以访问关于用户与文本区域交互的特定信息。MATLAB将这个信息传递到ValueChangingData对象作为回调函数的第二个参数。在App Designer中,参数被调用事件.可以使用点表示法查询对象属性。例如,事件。价值是文本区域中触发回调执行的值。的ValueChangingData对象不可用于指定为字符向量的回调函数。

这是ValueChangingData对象:

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

价值财产的文本区域对象在用户按下按钮之前不会更新选项卡或者在文本区域外单击。但是,您可以在用户仍在输入时通过查询价值财产的ValueChangingData对象。

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

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

元素 描述
父容器的左内边缘到文本区域的左外边缘的距离
父容器的内底边到文本区域的外底边的距离
宽度 文本区域左右外边缘之间的距离
高度 文字区域的上下外边缘之间的距离

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

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

例子:[100 100 100 90]

另请参阅

功能

属性

介绍了R2016a