表数据，指定为以下类型的数组之一:

为了防止警告或南当用户在可编辑单元格中输入无效数据时显示的值，则写入CellEditCallback函数将数据转换为适当的类型。当用户编辑单元格时，数据属性更新。

指定一个表数组

类创建的应用程序uifigure函数时，可以指定数据属性作为表数组。表数组提供了一种方便的方法来存储作为MATLAB的表格数据^®变量。的表格，readtable,array2table函数创建表数组。相比之下，场上函数创建表格UI组件(应用程序的用户界面组件)。

当您指定数据的属性表格UI组件作为一个表数组，然后MATLAB设置的格式表格UI组件自动基于表数组中的值:

有关显示表数组数据的详细信息，请参见应用程序设计器应用程序中的表数组数据类型．

指定字符向量的数字、逻辑、单元格、字符串数组或单元格数组

使用ColumnFormat属性指定数值、逻辑、单元格或字符串数组或字符向量的单元格数组的数据的格式。类的数据类型与数据类型之间不匹配ColumnFormat属性，MATLAB转换数据或显示警告。看到可编辑列的数据显示在ColumnFormat属性描述以获取更多信息。

列名称，指定为以下值之一:

中的列数数据属性数组中的元素数目不匹配ColumnName数组，则结果表中的列数为两个值中较大的一个。

如果您指定数据属性作为表数组，则默认列名与VariableNames属性。改变了ColumnName的属性表格UI组件更新UI，但它不会更新表数组中的变量名。

例子:外的=场上(uifigure ColumnName,{“名称”,“数量”},“数据”,{“鲍勃”,5})

例子:外的=场上(uifigure ColumnName,{“名字”,[]},“数据”,{“鲍勃”,5})

表列的宽度指定为“汽车”或者作为1——- - - - - -n字符向量、字符串和数值的单元格数组。在uifigure基于应用程序，你可以额外指定列宽度为“1 x”或“健康”．

例子:uit = uitable(ufigure，'ColumnWidth'，'auto'，'Data'，[1 2 3;4 5 6])

例子:uit = uitable(ufigure，'ColumnWidth'，'fit'，'Data'，[1 2 3;4 5 6])

例子:uit = uitable(ufigure，'ColumnWidth'，{64,60,40}，'Data'，[1 2 3;4 5 6])

例子:外的=场上(uifigure ColumnWidth, {' 2 x ', ' 1 x ', ' 1 x '},“数据”,[1 2 3,4 5 6])

例子:uit = uitable(ufigure，'ColumnWidth'，{64，"auto"，40}，'Data'，[1 2 3;4 5 6])

例子:外的=场上(uifigure ColumnWidth,{‘配合’,‘1 x’,‘3 x’},“数据”,[1 2 3,4 5 6])

编辑列单元格的能力，指定为:

当用户编辑单元格时，数据属性更新。

例子:uit = uitable(ufigure，'Data'，rand(10,3)，'ColumnEditable'，[false true true])

例子:uit = uitable(ufigure，'Data'，rand(10,3)，'ColumnEditable'，false)

要使用户能够与包含复选框或弹出菜单的表列中的控件交互，请设置ColumnEditable财产真正的．

如果数据属性为表数组，则为多列或包含不可编辑数据类型的任何变量，如持续时间，在运行的应用程序中不能编辑ColumnEditable属性是真正的．在单元格数组中包含混合数据类型的表数组变量在运行的应用程序中是可编辑的，只要数据类型是可编辑的。

单元格显示格式，指定为空单元格数组或1 × -n字符向量的单元格数组。

时不要设置此属性数据属性包含表格数组中。有关更多信息，请参见应用程序设计器应用程序中的表数组数据类型．

此属性设置用于显示数字、逻辑、单元格或字符串数组以及字符向量数据类型的单元格数组的格式。单元格数组的元素对应于数据属性数组。如果不想为特定列指定显示格式，请指定[]对于这一列。如果未为列指定格式，MATLAB将根据单元格中数据的数据类型确定默认显示。

单元格数组的元素必须是表中描述的值之一。

弹出式菜单栏格式和各种数据类型的影响

如果ColumnFormat值定义了一个弹出菜单，初始值数据Value不一定是该菜单中的选项之一。最初的数据值显示，直到用户做出不同的选择。

例如，假设数据属性值为“选择”对于所有行，和ColumnFormat值指定选项为的弹出菜单“组1”而且“组2”．当MATLAB创建表时，这些表单元格将显示出来“选择”直到用户在弹出菜单中选择一个项目:

FIG = ufigure;myData = {'Andrew' 31 'Male' ' select ';．.．“鲍勃”41“男”“选择”;．.．“安妮”20“女”“选择”;};uit = uitable('Parent'， fig，…'Position'，[100 150 380 100]，…“ColumnFormat ',({[] [] [] {' 组1 ' '组2 '}}),……“ColumnEditable”,真的,… 'Data',myData);

可编辑列的数据显示

该表描述了各种数据类型如何以特定的方式显示ColumnFormat值。

行名，指定为以下值之一:

的行数数据属性数组中的元素数目不匹配RowName数组中的行数，则结果表中的行数反映数据财产。

如果您指定数据属性作为表数组，则默认行名与RowName属性。改变了RowName属性的表UI组件更新UI，但它不会更新表数组中的行名。

例子:外的=场上(uifigure RowName,{“名称”,“数量”},“数据”,{“鲍勃”;5})

例子:外的=场上(uifigure RowName,{“名字”,[]},“数据”,{“鲍勃”;5})

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

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

例子:“天线”

数字的应用程序

属性创建的应用程序中的表数字函数时，还可以将字体名称指定为“FixedWidth”．它使用固定宽度的字体，在任何地区看起来都很好。实际使用的固定宽度字体取决于FixedWidthFontName根对象的属性。改变了FixedWidthFontName属性导致立即更新显示以使用新字体。

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

例子:14

字体权重，指定为以下值之一:

并非所有字体都有粗体字体粗体。对于没有的字体，指定“大胆”结果显示正常字体粗细。

字体角度，指定为“正常”或“斜体”．不是所有字体都有斜体角度。对于没有的字体，指定“斜体”结果字体角度正常。

字体度量单位，指定为本表中的值之一。

数字的应用程序

属性创建的应用程序中的表数字函数，默认值为FontUnits是“点”．

可见状态，指定为“上”或“关闭”，或作为数字或逻辑1（真正的)或0（假)．值为“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState．

要使应用程序启动更快，请设置可见财产“关闭”用于所有不需要在启动时出现的UI组件。

表的运行状态，指定为“上”，“关闭”,或“不活跃”．的启用属性控制UI组件是否响应按钮单击。有三个可能的值:

的值启用属性和点击按钮的类型决定UI如何响应。

工具提示，指定为字符向量、字符向量的单元格数组、字符串数组或1-D分类数组。使用此属性可在用户在运行时将指针悬停在组件上时显示一条消息。即使禁用了组件，也会显示工具提示。若要显示多行文本，请指定字符向量的单元格数组或字符串数组。数组中的每个元素都成为一个单独的文本行。如果将此属性指定为分类数组，MATLAB将使用数组中的值，而不是全部类别集。

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

单元格文本颜色，指定为RGB三元组、十六进制颜色代码或表中列出的颜色选项之一。属性设置单元格文本颜色时ForegroundColor属性，它应用于表格UI组件中的所有单元格。

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

或者，您可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三元组和十六进制颜色代码。

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

表背景色，指定为RGB三元组或米RGB三元组的-by-3矩阵。RGB三元组是一个行向量，它指定颜色的红色、绿色和蓝色成分的强度。强度必须在这个范围内，[0, 1]．颜色名称无效。

指定一个米-by-3矩阵，当您希望表行的底纹遵循的重复模式时米不同的颜色。矩阵的每一行都必须是RGB三元组。MATLAB中使用行的矩阵当RowStriping属性是“上”．表背景没有条纹，除非两者都有RowStriping是“上”而且写成BackgroundColor是一个米3矩阵。

例子:uit = uitable(ufigure，'Data'，rand(10,3)，'BackgroundColor'，[0.85 0.85 1])

例子:uit = uitable(ufigure，'Data'，rand(10,3)，'BackgroundColor'，[1 1 1;0.85 0.85 1])

下表列出了特定颜色的RGB三元组。

交替行底纹，指定为“上”或“关闭”，或作为数字或逻辑1（真正的)或0（假)．值为“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState．

此属性控制表行的底纹模式。当RowStriping值设置为“上”,写成BackgroundColor矩阵指定以重复模式显示的行颜色。如果写成BackgroundColor矩阵只有一行，那么所有表行的底纹是相同的。

当RowStriping设置为“关闭”，然后在第一个颜色写成BackgroundColor矩阵定义了表格中所有行的底纹。

表的位置和大小，指定为窗体的四个元素向量[左下宽高]．该表描述了向量中的每个元素。

所有的测量单位都由单位财产。

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

表的位置和大小，指定为窗体的四个元素向量[左下宽高]．所有的测量单位都由单位财产。

属性值与位置而且OuterPosition属性值。

表的位置和大小，指定为窗体的四个元素向量[左下宽高]．所有的测量单位都由单位财产。

属性值与位置而且InnerPosition属性值。

度量单位，在本表中指定为其中一个值。

推荐值为:“像素”，因为大多数MATLAB应用程序构建功能以像素为单位测量距离。类创建的网格布局管理器，通过将表父化，可以创建一个根据父容器大小重新缩放的表uigridlayout函数。有关更多信息，请参见以编程方式布局应用程序．

数字的应用程序

属性创建的应用程序中的表数字函数，默认值为单位是“归一化”．

此外，您还可以指定单位作为“角色”．字符单位基于图形根对象的默认uicontrol字体:

要访问默认的uicontrol字体，请使用get(大的,“defaultuicontrolFontName”)或集(大的,“defaultuicontrolFontName”)．

单元格编辑回调函数，指定为以下值之一:

当应用程序用户更改表格单元格的内容时，使用此回调函数执行计算或验证输入。

这个回调函数可以访问关于用户与单元格交互的特定信息(比如单元格索引)。MATLAB将此信息传递到CellEditData对象作为回调函数的第二个参数。在App Designer中，这个参数被调用事件．可以使用点表示法查询对象属性。例如,事件。在dices返回选定单元格的索引。的CellEditData对象对于指定为字符向量的回调函数不可用。

属性的属性说明如下CellEditData对象。

当用户编辑一个表格单元格时，MATLAB执行以下步骤:

如果该值导致错误，且没有CellEditCallback函数，然后单元格数据恢复到以前的值，并且不显示错误。

有关编写回调函数的详细信息，请参见在应用程序设计器中编写回调．

按键回调函数，指定为以下值之一:

有关将回调属性值指定为函数句柄、单元格数组或字符向量的详细信息，请参见指定回调函数．

的ButtonDownFcncallback是当用户单击UI组件上的鼠标按钮时执行的函数。在以下情况下执行回调:

按下回调函数，指定为以下值之一:

有关将回调属性值指定为函数句柄、单元格数组或字符向量的详细信息，请参见指定回调函数．

属性时执行此回调函数表格对象具有焦点，用户按下一个键。如果没有为此属性定义函数，MATLAB将按键传递给父图。重复的按键保留焦点表格对象，该函数在每次按键时执行。如果用户几乎同时按下多个键，MATLAB将检测最后一次按下的按键。

如果将此属性指定为函数句柄(或包含函数句柄的单元格数组)，MATLAB将包含回调数据的对象作为第二个参数传递给回调函数。该对象包含下表中描述的属性。可以在回调函数中使用点表示法访问这些属性。

按修改键影响回调数据的方式如下:

您也可以查询CurrentCharacter属性，以确定用户按下了哪个字符。

键释放回调函数，指定为以下值之一:

有关将回调属性值指定为函数句柄、单元格数组或字符向量的详细信息，请参见指定回调函数．

属性时执行此回调函数表格对象具有焦点，用户释放一个键。

如果将此属性指定为函数句柄(或包含函数句柄的单元格数组)，MATLAB将包含回调数据的对象作为第二个参数传递给回调函数。该对象包含下表中描述的属性。可以在回调函数中使用点表示法访问这些属性。

按修改键影响回调数据的方式如下:

您也可以查询CurrentCharacter属性，以确定用户按下了哪个字符。

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息，请参见在应用程序设计器中编写回调．

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

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

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

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息，请参见在应用程序设计器中编写回调．

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

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

单元格选择回调函数，指定为以下值之一:

该回调函数在用户选择单元格时执行。该函数可以访问关于用户与单元格交互的特定信息(例如单元格索引)。MATLAB将此信息传递到CellSelectionChangeData对象作为回调函数的第二个参数。在App Designer中，这个参数被调用事件．可以使用点表示法查询对象属性。例如,事件。在dices返回选定单元格的索引。的CellSelectionChangeData对象对于指定为字符向量的回调函数不可用。

属性的属性说明如下CellSelectionChangeData对象。

有关编写回调函数的详细信息，请参见在应用程序设计器中编写回调．

回调中断，指定为“上”或“关闭”，或作为数字或逻辑1（真正的)或0（假)．值为“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState．

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

MATLAB在执行处理回调队列的命令时确定回调中断行为。这些命令包括drawnow，数字，uifigure，getframe，等待,暂停．

如果正在运行的回调不包含这些命令之一，则不会发生中断。MATLAB首先完成运行回调的执行，然后再执行中断回调。

如果正在运行的回调包含这些命令之一，则可中断属性决定是否发生中断:

回调队列，指定为“队列”或“取消”．的BusyAction属性决定MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:

的BusyAction属性仅在满足以下两个条件时确定回调排队行为:

在这些条件下，BusyAction拥有中断回调的对象的属性决定了MATLAB如何处理中断回调。的可能值BusyAction属性:

此属性是只读的。

删除状态，作为类型的on/off逻辑值返回matlab.lang.OnOffSwitchState．

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

的值BeingDeleted属性在查询或修改对象之前验证对象是否即将被删除。

成为当前对象的能力，指定为“上”或“关闭”，或作为数字或逻辑1（真正的)或0（假)．值为“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState．

父容器，指定为数字对象创建。uifigure函数，或者它的子容器之一:选项卡，面板，ButtonGroup,或GridLayout．如果没有指定容器，MATLAB将调用uifigure函数创建一个新的数字对象，该对象用作父容器。

表的子数组，返回为空数组。表对象没有子对象，因此设置此属性无效。

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

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

此属性是只读的。

图形对象的类型，返回为场上的．

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

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

如果您在应用程序设计器中工作，请在应用程序中创建公共或私有属性以共享数据，而不是使用用户数据财产。有关更多信息，请参见在应用设计器应用中共享数据．

此属性是只读的。

当前显示中的表数据，以表、数字、逻辑、单元格或字符串数组或字符向量的单元格数组形式返回。

如果要根据用户是否对表中的列进行排序或编辑单元格更新可视化，请使用此属性。

DisplayData对表列进行排序或编辑单元格时进行更新。如果用户不对列进行排序，则DisplayData中存储的值具有相同的内容数据财产。当用户编辑单元格时，数据而且DisplayData属性都会更新。

列排序功能，指定为:

例子:uit = uitable(ufigure，'Data'，rand(3)，'ColumnSortable'，[true true false]);

例子:uit = uitable(ufigure，'Data'，rand(5)，'ColumnSortable'，true);

如果数据属性包含单元格数组数据或具有单元格数组列的表数组数据，则只有具有数值数组或字符数组的统一数据类型的列，或具有字符向量的单元格数组的列在运行的应用程序中是可排序的ColumnSortable属性是真正的．

此属性是只读的。

控件创建的添加样式的配置uistyle函数，返回为n-by-3表数组。表数组的每一行都对应于当前应用于表UI组件的样式。连续添加的样式被赋予样式序号为n + 1．的目标而且TargetIndex列指定样式被添加到的表UI组件的部分。的风格列指定样式类名称。

类从表UI组件中删除样式，请使用此属性removeStyle函数。

示例:删除一个样式

首先，向表UI组件添加三种样式。

S1 = ustyle (“写成BackgroundColor”，“黄色”）;S2 = ustyle (“写成BackgroundColor”，“红色”）;S3 = ustyle (“FontColor”，“b”，“FontWeight”，“大胆”）;FIG = ufigure;fig.Position = [100 100 520 220];Uit =可使用(图);外的。数据= rand(5);外的。位置= [20 30 480 135];addStyle (s1,外的“行”，[1 2 4 5]);addStyle(外的,s2,“细胞”, (2 1;4 2;1 3;1 5]) addStyle(uit,s3，“列”2);

当你查询时外的。StyleConfigurations，返回一个3 × 3的表数组。行样式首先被添加到表UI组件，因此它是样式顺序号1．的TargetIndex值的值，{1×4双}，表示在添加样式时指定了四行。类似地，第二个样式被添加到表中的四个单元格中。第三个样式被添加到第二列。

外的。StyleConfigurations

ans = 3×3表目标TargetIndex风格  ______ ____________ ___________________________ 1行{1×4双}[1×1 matlab.ui.style。样式]2单元格{4×2 double} [1×1 matlab.ui.style.]风格] 3 column {[ 2]} [1×1 matlab.ui.style.Style]

通过指定样式订单号，删除添加到表中的第二个样式2．注意表UI组件是如何更新的。

removeStyle(外的,2)

表选择，指定为正整数、正整数的向量或n-by-2正整数数组。使用此属性可编程地设置表选择，或查询应用程序用户已选择的表元素。类型的值的类型取决于SelectionType而且多选属性。

当SelectionType是“行”或“列”而且多选是“上”，您可以指定选择作为行向量或列向量。但是，值总是转换为行向量并存储为行向量。

表选择类型，指定为“细胞”，“行”,或“列”．表选择类型指定了当用户与表交互时MATLAB选择哪些表元素。例如，如果SelectionType是“行”app用户点击表格第二行的单元格，这就选择了整个第二行。

多重元素选择，指定为“上”或“关闭”，或作为数字或逻辑1（真正的)或0（假)．值为“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState．

选择已更改的回调，指定为以下值之一:

当应用程序用户选择表的不同单元格、行或列时，使用此回调函数执行命令。

这个回调函数可以访问关于用户与表交互的特定信息，比如他们选择的元素。MATLAB将此信息传递到TableSelectionChangedData对象作为回调函数的第二个参数。在App Designer中，这个参数被称为事件．可以使用点表示法查询对象属性。例如,事件。选择ion返回选定的单元格、行或列索引。的TableSelectionChangedData对象对于指定为字符向量的回调函数不可用。

属性的属性说明如下TableSelectionChangedData对象。

有关编写回调函数的详细信息，请参见在应用程序设计器中编写回调．

表执行SelectionChangedFcn当用户通过单击、使用方向键或使用这些键盘快捷键之一选择表元素时，调用回调函数。

连续选择选项:

不连续的选择选项:

回调函数，指定为以下值之一:

函数时执行此回调DisplayData更改，因为用户要么编辑单元格，要么对表的列进行排序。

的用户交互信息，请使用此回调函数DisplayData改变。如果需要关于已编辑单元格的特定信息，请创建CellEditCallback代替。

这个回调函数可以访问有关列是否被排序或单元格是否被编辑的特定信息。MATLAB将此信息传递到DisplayDataChangedData对象作为回调函数的第二个参数。在App Designer中，这个参数被调用事件．可以使用点表示法查询对象属性。例如,事件。在teractionColumn返回在中与之交互的列的索引数据．的DisplayDataChangedData对象对于指定为字符向量的回调函数不可用。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息，请参见在应用程序设计器中编写回调．

布局选项，指定为GridLayoutOptions对象。此属性指定网格布局容器的子组件的选项。如果组件不是网格布局容器的子组件(例如，它是图形或面板的子组件)，则此属性为空，没有作用。但是，如果组件是网格布局容器的子元素，则可以将组件放置在网格的所需行和列中行而且列属性GridLayoutOptions对象。

例如，这段代码将一个表UI组件放在其父网格的第三行和第二列中。

G = uigridlayout([4 3]);Uit = uitable(g，“数据”3),兰德(10);unit . layout . row = 3;unit . layout . column = 2;

要使表跨多行或多列，请指定行或列属性作为两元素向量。例如，这个表跨列2通过3.：

unit . layout . column = [2 3];

此属性是只读的。

外接矩形的大小，作为一个四元素行向量返回。向量的前两个元素总是零。第三和第四个元素分别是包含表格的矩形的宽度和高度。所有的测量单位都由单位财产。

MATLAB根据电流确定矩形的大小数据，RowName而且ColumnName属性值。MATLAB使用列宽和行宽来估计宽度和高度值。估计的范围可以大于实际数字。

考虑使用程度上属性的宽度和高度值位置财产。

能够重新排列表列，指定为“关闭”或“上”，或作为数字或逻辑1（真正的)或0（假)．值为“上”等于真正的,“关闭”等于假．因此，您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState．

此属性提供了一种方法，允许用户通过单击并拖动列标题来重新排序表列(而不是标签)。