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'}

文本区域中的占位符文本，指定为字符向量或字符串标量。占位符提供简短的提示来说明预期的输入。仅当 Value 属性为 {''} 时，文本才会显示。

示例： 'Enter text'

文本区域中文本的对齐方式，指定为 'left' 、 'right' 或 'center' 。对齐方式影响 App 用户编辑文本区域时的显示方式，还影响 MATLAB 在 App 中显示文本的方式。

文字换行以适合组件宽度，指定为 'on' 或 'off' ，或者指定为数值或逻辑值 1 ( true ) 或 0 ( false )。值 'on' 等效于 true ， 'off' 等效于 false 。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

当组件的宽度小于要显示的文本的宽度时，使用此属性可防止文本在水平方向上被裁剪。

字体名称，指定为系统支持的字体名称。默认字体取决于具体操作系统和区域设置。

如果指定的字体不可用，MATLAB 将使用运行 App 的系统上的可用字体中的最佳匹配项。

示例： 'Arial'

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

示例： 14

字体粗细，指定为下列值之一：

并非所有字体都有加粗字体。对于非加粗字体，指定 'bold' 会得到普通字体。

字体角度，指定为 'normal' 或 'italic' 。并非所有字体都有倾斜字体角度。对于无斜体字体，指定 'italic' 后会使用常规字体角度。

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

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

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

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

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

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

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

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

可见性状态，指定为 'on' 或 'off' ，或者指定为数值或逻辑值 1 ( true ) 或 0 ( false )。值 'on' 等效于 true ， 'off' 等效于 false 。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

要使您的 App 更快地启动，请将不需要在启动时出现的所有 UI 组件的 Visible 属性设置为 'off' 。

文本区域的可编辑性，指定为 'on' 或 'off' ，或者指定为数值或逻辑值 1 ( true ) 或 0 ( false )。值 'on' 等效于 true ， 'off' 等效于 false 。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

此属性可与 Enable 属性值结合使用，以确定组件是否响应以及如何响应 App 用户的输入：

文本区域的工作状态，指定为 'on' 或 'off' ，或者指定为数值或逻辑值 1 ( true ) 或 0 ( false )。值 'on' 等效于 true ， 'off' 等效于 false 。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

此属性可与 Editable 属性值结合使用，以确定组件是否响应以及如何响应 App 用户的输入：

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

上下文菜单，指定为使用 uicontextmenu 函数创建的 ContextMenu 对象。使用此属性可在您右键点击组件时显示上下文菜单。

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

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

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

示例： [100 100 100 90]

文本区域的内部位置和大小，指定为 [left bottom width height] 。位置值相对于父容器。所有测量值都以像素为单位。此属性值等同于 Position 属性值。

此 属性 为只读。

文本区域的外部位置和大小，以 [left bottom width height] 形式返回。位置值相对于父容器。所有测量值都以像素为单位。此属性值等同于 Position 属性值。

布局选项，指定为 GridLayoutOptions 对象。此属性为网格布局容器的子级组件指定选项。如果组件不是网格布局容器的子级（例如，它是图窗或面板的子级），则此属性为空且不起作用。但是，如果组件是网格布局容器的子级，则可以通过在 GridLayoutOptions 对象上设置 Row 和 Column 属性，将组件放置在网格的所需行和列中。

例如，以下代码将一个文本区域放置在其父网格的第三行第二列中。

g = uigridlayout([4 3]);
tarea = uitextarea(g);
tarea.Layout.Row = 3;
tarea.Layout.Column = 2;

要使该文本区域跨多个行或列，请将 Row 或 Column 属性指定为二元素向量。例如，此文本区域跨列 2 到 3 ：

tarea.Layout.Column = [2 3];

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

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

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

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

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

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

此回调按照如下方式执行：

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

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

以下是 ValueChangingData 对象的属性：

TextArea 对象的 Value 属性在用户按下 Tab 键或在文本区域外点击之前不会更新。但是，您可以在用户仍在键入时通过查询 ValueChangingData 对象的 Value 属性来获取文本。

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

对象创建函数，指定为下列值之一：

有关将回调指定为函数句柄、元胞数组或字符向量的详细信息，请参阅 App 设计工具中的回调 。

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

对现有组件设置 CreateFcn 属性没有任何作用。

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

对象删除函数，指定为下列值之一：

有关将回调指定为函数句柄、元胞数组或字符向量的详细信息，请参阅 App 设计工具中的回调 。

此属性指定在 MATLAB 删除对象时要执行的回调函数。MATLAB 在销毁对象的属性之前执行 DeleteFcn 回调。如果不指定 DeleteFcn 属性，则 MATLAB 执行默认的删除函数。

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

回调中断，指定为 'on' 或 'off' ，或者指定为数值或逻辑值 1 ( true ) 或 0 ( false )。值 'on' 等效于 true ， 'off' 等效于 false 。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

此属性确定是否可以中断运行中回调。有以下两种回调状态要考虑：

每次执行处理回调队列的命令时，MATLAB 都会确定回调中断行为。这些命令包括 drawnow 、 figure 、 uifigure 、 getframe 、 waitfor 和 pause 。

如果运行中回调不包含上述命令之一，则不会发生中断。MATLAB 首先完成执行运行中回调，然后执行中断回调。

如果运行中回调确实包含上述命令之一，则由运行中回调所属对象的 Interruptible 属性来确定是否发生中断：