Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

uitextarea

创建文本区域组件

说明

txa = uitextarea 在新图窗窗口中创建一个文本区域,并返回 TextArea 对象。MATLAB® 调用 uifigure 函数来创建该图窗。

示例

txa = uitextarea(parent) 在指定的父容器中创建文本区域。父容器可以是使用 uifigure 函数创建的 Figure 或其子容器之一。

示例

txa = uitextarea(___,Name,Value) 使用一个或多个 Name,Value 对组参数指定 TextArea 属性。可以将此选项与前面语法中的任何输入参数组合一起使用。

示例

全部折叠

fig = uifigure;
txa = uitextarea(fig);

创建一个已填充的文本区域。

fig = uifigure;
txa = uitextarea(fig,...
                'Value', {'First Name Last Name';...
                'Address 1'; 'Address 2';'City, State'; 'Postal Code'});

请注意,该文本区域包含一个滚动条,以便 App 用户查看邮编。

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

size = txa.Position(3:4)
size =

   150    60

增加文本区域的大小,以便显示邮编,而不需要使用滚动条。

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

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

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

fig = uifigure;
txa = uitextarea(fig);
txa.Position = [100 100 80 80];
txa.Value = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor.';

滚动到文本区域的底部。

scroll(txa,'bottom')

创建一个文本区域和两个标签。当 App 用户键入文本,并在文本区域外部点击时,将出现感谢 App 用户输入的标签。如果 App 用户删除该文本并在文本区域外部点击,表示感谢的文本将被删除。

请将以下代码保存到 MATLAB 路径中的 comments.m 中。以下代码将创建一个图窗窗口,其中包含两个标签和一个文本区域。当 App 用户键入文本并在文本区域外部点击时,ValueChangedFcn 回调将更新其中一个标签,显示感谢用户的文本。

function comments
% Create figure window and components

fig = uifigure('Position',[500 500 430 275]);

label1 = uilabel(fig,...
    'Position',[100 164 100 15],...
    'Text','Enter Comments:');

label2 = uilabel(fig,...
    'Position',[100 75 175 15],...
    'Text','');

textarea = uitextarea(fig,...
    'Position',[100 100 150 60],...
    'ValueChangedFcn',@(textarea,event) textEntered(textarea, label2));

% Create ValueChangedFcn callback
    function textEntered(textarea,label2)
        val = textarea.Value;
        label2.Text = '';
        % Check each element of text area cell array for text
        for k = 1:length(val)
            if(~isempty(val{k}))
                label2.Text = 'Thank you for your comments!';
                break;
            end
        end
    end
end

运行 comments,然后在文本区域字段中键入文本。在文本区域外部点击以触发该回调。

输入参数

全部折叠

父容器,指定为使用 uifigure 函数创建的 Figure 对象或其子容器之一:TabPanelButtonGroupGridLayout。如果不指定父容器,MATLAB 会调用 uifigure 函数创建新 Figure 对象充当父容器。

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

示例: 'Editable','off' 指定 App 用户不能更改文本区域的文本。

此处所列的属性只是可用属性中的一部分。有关完整列表,请参阅 TextArea 属性

值,指定为字符向量、字符向量元胞数组、字符串数组或一维分类数组。MATLAB 可以正确显示格式化文本,例如:

cellArrayText{1} = sprintf('%s\n%s', 'Line 1', 'Line 2')
cellArrayText{2} = sprintf('%s\n%s', 'Line 3', 'Line 4')
textarea = uitextarea('Value',cellArrayText);

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

如果文本区域的宽度不足以容纳文本,MATLAB 将对文本进行换行。

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

示例: {'Joseph Welford'; 'Mary Reilly'; 'Roberta Silberlicht'}

更改值后执行的回调,指定为下列值之一:

  • 函数句柄。

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

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

当用户更改文本并按 Tab 键或在文本区域外部点击时,将会执行此回调。如果以编程方式更改 Value 属性,将不会执行此回调函数。

此回调函数可以访问有关用户与文本区域的交互的特定信息。MATLAB 将 ValueChangedData 对象中的此信息作为第二个参数传递给回调函数。在 App 设计工具中,该参数名为 event。您可以使用圆点表示法查询对象属性。例如,event.PreviousValue 返回文本区域的上一个值。ValueChangedData 对象不可用于指定为字符向量的回调函数。

下表列出了 ValueChangedData 对象的属性。

属性
Value文本区域在 App 用户最近一次与它交互之后的值
PreviousValue文本区域在 App 用户最近一次与它交互之前的值
Source执行回调的组件
EventName'ValueChanged'

有关编写回调的详细信息,请参阅在 App 设计工具中编写回调

文本区域相对于父级的位置和大小,指定为向量 [left bottom width height]。此表介绍该向量中的每个元素。

元素说明
left父容器的内部左边缘与文本区域的外部左边缘之间的距离
bottom父容器的内部下边缘与文本区域的外部下边缘之间的距离
width文本区域的左右外部边缘之间的距离
height文本区域的上下外部边缘之间的距离

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

Position 值相对于父容器的可绘制区域。可绘制区域是指容器边框内的区域,不包括装饰元素(如菜单栏或标题)所占的区域。

示例: [100 100 100 90]

另请参阅

函数

属性

在 R2016a 中推出