Table 属性

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

要避免用户在可编辑单元格中输入无效数据时显示警告或 NaN 值，可以编写一个 CellEditCallback 函数，将该数据转换为正确的类型。当用户编辑单元格时，Data 属性会更新。

指定表数组

在 App 设计工具中和使用 uifigure 函数创建的 App 中，您可以将 Data 属性指定为表数组。表数组为将表格数据存储为 MATLAB^® 变量提供了一种便捷方式。table、readtable 和 array2table 函数用于创建表数组。而 uitable 函数用于创建 Table UI 组件（App 的用户界面组件）。

当您以表数组的形式指定 Table UI 组件的 Data 属性时，MATLAB 会自动基于表数组中的值设置 Table UI 组件的格式：

有关显示表数组数据的详细信息，请参阅在 App 中格式化表格数据。

指定数值数组、逻辑数组、元胞数组、字符串数组或字符向量元胞数组

使用 ColumnFormat 属性指定数据的格式，数据可以是数值数组、逻辑数组、元胞数组、字符串数组或字符向量元胞数组。如果编辑了数据并导致数据的数据类型与 ColumnFormat 属性不匹配，MATLAB 会转换数据或显示警告。有关详细信息，请参阅 ColumnFormat 属性描述。

列名称，指定为下列值之一：

如果 Data 属性数组中的列数与 ColumnName 数组中的元素数不匹配，则生成表中的列数是这两个值中的较大者。

如果将 Data 属性指定为表数组，则默认列名称与表数组的 VariableNames 属性匹配。更改 Table UI 组件的 ColumnName 属性将更新 UI，但不会更新表数组中的变量名称。

示例: uit = uitable(uifigure,'ColumnName',{'Name';'Number'},'Data',{'Bob',5})

示例: uit = uitable(uifigure,'ColumnName',{'Name';[]},'Data',{'Bob',5})

表列的宽度，指定为 'auto' 或指定为由字符向量、字符串和数值组成的 1×n 元胞数组。在基于 uifigure 的 App 中，您还可以将列宽指定为 '1x' 或 'fit'。

如果用户在运行的 App 中以交互方式调整表列的大小，即使您稍后更新 ColumnWidth 属性，调整后的列宽仍会保留。

示例: uit = uitable(uifigure,'ColumnWidth','auto','Data',[1 2 3;4 5 6])

示例: uit = uitable(uifigure,'ColumnWidth','fit','Data',[1 2 3;4 5 6])

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

示例: uit = uitable(uifigure,'ColumnWidth',{'2x','1x','1x'},'Data',[1 2 3;4 5 6])

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

示例: uit = uitable(uifigure,'ColumnWidth',{'fit','1x','3x'},'Data',[1 2 3;4 5 6])

编辑列单元格的功能，指定为：

当用户编辑单元格时，Data 属性会更新。

示例: uit = uitable(uifigure,'Data',rand(10,3),'ColumnEditable',[false true true])

示例: uit = uitable(uifigure,'Data',rand(10,3),'ColumnEditable',false)

要使用户能够与包含复选框或弹出式菜单的表列中的控件进行交互，请将 ColumnEditable 属性设置为 true。

如果 Data 属性是一个表数组，则任何多列变量或包含不可编辑数据类型的变量，如 duration，在运行的 App 中都不可编辑，即使 ColumnEditable 属性是 true 也是如此。对于元胞数组中包含的混合数据类型的表数组变量，只要这些数据类型是可编辑的，则表数组变量在运行的 App 中也将是可编辑的。

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

当 ColumnRearrangeable 的值为 'on' 时，App 用户可以通过点击并拖动列标题来对表列重新排序。

重新排列 App 中的表列不会影响 Data 属性数组中的列。

示例：创建包含可重排的列的表

在 UI 图窗窗口中创建一个包含可重排的列的表。该表在列标题中显示一个可视指示符，表明用户可以点击并拖动列。

fig = uifigure;
uit = uitable(fig,"Data",magic(3),"ColumnRearrangeable",true);

要重排第一列和第二列，请点击列 1 标题中的拖动指示符，并将该列拖到列 2 的右侧。

虽然表 UI 组件的 Data 属性没有更改，但 DisplayData 属性已更新为按照数据在表视图中的显示顺序存储数据。

tbl.Data

ans =

     8     1     6
     3     5     7
     4     9     2

tbl.DisplayData

ans =

     1     8     6
     5     3     7
     9     4     2

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

当 Data 属性包含 table 数组时，请不要设置此属性。有关详细信息，请参阅在 App 中格式化表格数据。

此属性设置数值数组、逻辑数组、元胞数组、字符串数组和字符向量元胞数组数据类型的显示格式。元胞数组的元素对应于 Data 属性数组中的列。如果您不希望指定特定列的显示格式，请为该列指定 []。如果不指定列的格式，则 MATLAB 根据单元格中数据的类型确定默认显示方式。

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

弹出式菜单 ColumnFormat 和各种数据类型的效果

如果 ColumnFormat 值定义弹出式菜单，则初始 Data 值不必是该菜单中的选项之一。初始 Data 值将一直显示，直到用户进行不同的选择。

例如，假设给定列的 Data 属性值对于所有行都是 'Choose'，并且 ColumnFormat 值指定具有选项 'group 1' 和 'group 2' 的弹出式菜单。当 MATLAB 创建表时，这些表单元格会显示 'Choose'，直到用户选择弹出式菜单中的某个项为止：

fig = uifigure;
myData = {'Andrew' 31 'Male' 'Choose'; ...
    'Bob' 41 'Male' 'Choose';  ...
    'Anne' 20 'Female' 'Choose'};
uit = uitable(fig, ...
    "Position", [100 150 380 100], ...
    "ColumnFormat",{[] [] [] {'group 1' 'group 2'}}, ...
    "ColumnEditable",true, ...
    "Data",myData);

可编辑列的日期显示

此表介绍各种数据类型如何显示特定 ColumnFormat 值。

行名称，指定为下列值之一：

如果 Data 属性数组中的行数与 RowName 数组中的元素数不匹配，则生成的表中的行数反映 Data 属性中的行数。

如果将 Data 属性指定为表数组，则默认行名称与表数组的 RowName 属性匹配。更改表 UI 组件的 RowName 属性将更新 UI，但不会更新表数组中的行名称。

示例: uit = uitable(uifigure,"RowName",{'Name';'Number'},"Data",{'Bob';5})

示例: uit = uitable(uifigure,"RowName",{'Name';[]},'Data',{'Bob';5})

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

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

示例: 'Arial'

基于 figure 的 App

对于在使用 figure 函数创建的 App 中的表，您还可以将字体名称指定为 'FixedWidth'。这样便会使用等宽字体，这种字体在任何区域设置中的显示效果都不错。使用的实际等宽字体取决于根对象的 FixedWidthFontName 属性。更改 FixedWidthFontName 属性会导致立即更新显示方式以使用新字体。

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

示例: 14

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

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

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

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

基于 figure 的 App

对于在使用 figure 函数创建的 App 中的表，FontUnits 的默认值为 'points'。

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

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

表的工作状态，指定为 'on'、'off' 或 'inactive'。Enable 属性控制 UI 组件是否响应按钮点击。有三个可能的值：

Enable 属性的值和按钮点击的类型共同确定 UI 的响应方式。

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

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

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

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

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

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

表背景色，指定为 RGB 三元组或由 RGB 三元组组成的 m×3 矩阵。RGB 三元组是行向量，用于指定颜色的红、绿和蓝分量的强度。强度必须处于范围 [0,1] 中。颜色名称无效。

当您希望表中各行按某种重复模式使用 m 种不同颜色进行着色时，请指定 m×3 矩阵。矩阵的每一行都必须是一个 RGB 三元组。当 RowStriping 属性为 'on' 时，MATLAB 使用矩阵的行。除非两个 RowStriping 均为 'on' 且 BackgroundColor 为 m×3 矩阵，否则不会对表背景隔行着色。

示例: uit = uitable(uifigure,"Data",rand(10,3),"BackgroundColor",[0.85 0.85 1])

示例: uit = uitable(uifigure,"Data",rand(10,3),"BackgroundColor",[1 1 1 ;0.85 0.85 1])

下表列出了某些颜色的 RGB 三元组。

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

此属性控制表行的着色模式。当 RowStriping 值设置为 'on' 时，BackgroundColor 矩阵指定行的颜色以某种重复模式显示。如果 BackgroundColor 矩阵只有一行，则所有表行的着色都相同。

当 RowStriping 设为 'off' 时，BackgroundColor 矩阵中的第一个颜色定义表中所有行的着色。

表的位置和大小，指定为 [left bottom width height] 形式的四元素向量。此表介绍该向量中的每个元素。

所有测量值都采用 Units 属性指定的单位。

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

表的位置和大小，指定为 [left bottom width height] 形式的四元素向量。所有测量值都采用 Units 属性指定的单位。

此属性值等同于 Position 和 OuterPosition 属性值。

表的位置和大小，指定为 [left bottom width height] 形式的四元素向量。所有测量值都采用 Units 属性指定的单位。

此属性值等同于 Position 和 InnerPosition 属性值。

测量单位，指定为下表中的值之一。

推荐值为 'pixels'，因为大多数 MATLAB App 构建功能都以像素为单位测量距离。您可以创建一个表，该表根据父容器的大小重新缩放，方法是将使用 uigridlayout 函数创建的一个网格布局管理器作为该表的父级。有关详细信息，请参阅Lay Out Apps Programmatically。

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

使用此回调函数可在 App 用户更改表单元格的内容时执行计算或验证输入。

此回调函数可以访问有关用户与单元格的交互的特定信息（例如单元格索引）。MATLAB 将 CellEditData 对象中的此信息作为第二个参量传递给回调函数。在 App 设计工具中，该参量名为 event。您可以使用圆点表示法查询对象属性。例如，event.Indices 返回所选单元格的索引。CellEditData 对象不可用于指定为字符向量的回调函数。

下表说明了 CellEditData 对象的属性。

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

如果值导致错误，且没有任何 CellEditCallback 函数，则单元格数据会还原为以前的值，并且不会显示任何错误。

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

按下鼠标按键回调函数，指定为下列值之一：

有关将回调属性值指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Specify a Callback Function。

ButtonDownFcn 回调是当用户在 UI 组件上点击鼠标按键时执行的函数。回调在以下情形下执行：

按键回调函数，指定为下列值之一：

有关将回调属性值指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Specify a Callback Function。

当 Table 对象获得焦点并且用户按下键时执行该回调函数。如果您没有为该属性定义函数，则MATLAB 向父图窗传递按键操作。重复按键操作会保留 Table 对象的焦点，并在每次发生按键操作时执行该函数。如果用户几乎在同一时间按下多个键，MATLAB 将检测最后一个按键的按键操作。

如果将该属性指定为函数句柄（或包含函数句柄的元胞数组），则 MATLAB 会将包含回调数据的对象作为第二个参量传递给回调函数。该对象包含下表中介绍的属性。您可以使用圆点表示法访问回调函数内的这些属性。

按修改键会以下列方式影响回调数据：

您还可以查询图窗的 CurrentCharacter 属性以确定用户按下的字符。

释放键回调函数，指定为下列值之一：

有关将回调属性值指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Specify a Callback Function。

当 Table 对象获得焦点并且用户释放键时执行该回调函数。

如果将该属性指定为函数句柄（或包含函数句柄的元胞数组），则 MATLAB 会将包含回调数据的对象作为第二个参量传递给回调函数。该对象包含下表中介绍的属性。您可以使用圆点表示法访问回调函数内的这些属性。

按修改键会以下列方式影响回调数据：

您还可以查询图窗的 CurrentCharacter 属性以确定用户按下的字符。

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

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

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

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

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

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

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

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

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

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

当用户选择单元格时，此回调函数执行。该函数可以访问有关用户与单元格的交互的特定信息（例如单元格索引）。MATLAB 将 CellSelectionChangeData 对象中的此信息作为第二个参量传递给回调函数。在 App 设计工具中，该参量名为 event。您可以使用圆点表示法查询对象属性。例如，event.Indices 返回所选单元格的索引。CellSelectionChangeData 对象不可用于指定为字符向量的回调函数。

下表说明了 CellSelectionChangeData 对象的属性。

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

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

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

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

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

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

回调排队，指定为 'queue' 或 'cancel'。BusyAction 属性决定 MATLAB 如何处理中断回调的执行。有以下两种回调状态要考虑：

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

在这些情况下，由中断回调所属对象的 BusyAction 属性确定 MATLAB 如何处理中断回调。以下是 BusyAction 属性的可能值：

此 属性 为只读。

删除状态，以 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值形式返回。

当 DeleteFcn 回调开始执行时，MATLAB 会将 BeingDeleted 属性设置为 'on'。BeingDeleted 属性将一直保持 'on' 设置状态，直到组件对象不再存在为止。

在查询或修改对象之前，请先检查其 BeingDeleted 属性的值，以确认它不是待删除项。

是否能够成为当前对象，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

父容器，指定为使用 uifigure 函数创建的 Figure 对象或其子容器之一：Tab、Panel、ButtonGroup 或 GridLayout。如果未指定容器，MATLAB 将调用 uifigure 函数以创建一个新 Figure 对象来充当父容器。

表的子级，以空数组形式返回。表对象没有子级，因此设置此属性没有任何作用。

对象句柄的可见性，指定为 'on'、'callback' 或 'off'。

此属性控制对象在其父级的子级列表中的可见性。当对象未显示在其父级的子级列表中时，通过搜索对象层次结构或查询属性来获取对象的函数不会返回该对象。这些函数包括 get、findobj、clf 和 close。对象即使在不可见时也有效。如果可以访问某个对象，则可以设置和获取其属性，并将其传递给针对对象进行运算的任意函数。

此 属性 为只读。

图形对象的类型，以 'uitable' 形式返回。

对象标识符，指定为字符向量或字符串标量。您可以指定唯一的 Tag 值作为对象的标识符。如果需要访问您代码中其他位置的对象，可以使用 findobj 函数基于 Tag 值搜索对象。

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

如果您在 App 设计工具中工作，请在该 App 中创建公共或私有属性以共享数据，而不是使用 UserData 属性。有关详细信息，请参阅在用 App 设计工具创建的 App 内共享数据。

此 属性 为只读。

当前显示中的表数据，返回为表、数值数组、逻辑数组、元胞数组、字符串数组或字符向量元胞数组。

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

MATLAB 在表列经过排序或重新排列或单元格经过编辑时更新 DisplayData。如果用户未对列进行排序或重新排列，则 DisplayData 的内容与 Data 属性中的值相同。当用户编辑单元格时，MATLAB 会更新 Data 和 DisplayData 属性。

示例：Data 和 DisplayData 之间的区别

用一些数据和可排序的列创建一个表 UI 组件。然后，按第一列中的值对表进行排序。

fig = uifigure;
tbl = uitable(fig,Data=[4 9; 7 1; 2 3],ColumnSortable=true);

查询表的 Data 属性和 DisplayData 属性。Data 属性返回在表排序前的原始表数据。

tbl.Data

ans =

     4     9
     7     1
     2     3

DisplayData 属性返回在 App 中显示的表数据。

tbl.DisplayData

ans =

     2     3
     4     9
     7     1

对列进行排序的能力，指定为：

示例: uit = uitable(uifigure,'Data',rand(3),'ColumnSortable',[true true false]);

示例: uit = uitable(uifigure,'Data',rand(5),'ColumnSortable',true);

如果 Data 属性包含元胞数组数据或具有元胞数组列的表数组数据，则只有具有一致数据类型的列才能在运行的 App 中排序。即使 ColumnSortable 属性为 true，具有不一致数据类型的元胞数组列也无法在运行的 App 中排序。

此 属性 为只读。

使用 uistyle 函数创建的所添加样式的配置，以 n×3 表数组形式返回。表数组的每一行对应于当前应用于表 UI 组件的一个样式。对连续添加的样式赋予 n+1 的样式顺序号。Target 和 TargetIndex 列指定样式所添加到的表 UI 组件部分。Style 列指定样式类名。

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

示例：删除样式

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

s1 = uistyle("BackgroundColor","yellow");
s2 = uistyle("BackgroundColor","red");
s3 = uistyle("FontColor","b","FontWeight","bold");

fig = uifigure;
fig.Position = [100 100 520 220];
uit = uitable(fig);
uit.Data = rand(5);
uit.Position = [20 30 480 135];

addStyle(uit,s1,"row",[1 2 4 5]);
addStyle(uit,s2,"cell",[2 1; 4 2; 1 3; 1 5])
addStyle(uit,s3,"column",2);

当您查询 uit.StyleConfigurations 时，将返回一个 3×3 表数组。行样式首先添加到表 UI 组件中，因此它具有样式顺序号 1。行样式的 TargetIndex 值 {1×4 double} 表示添加该样式时指定了四行。类似地，第二个样式添加到了表中的四个单元格中。第三个样式添加到了第二列。

uit.StyleConfigurations

ans =

  3×3 table

         Target    TargetIndex                Style           
         ______    ____________    ___________________________

    1    row       {1×4 double}    [1×1 matlab.ui.style.Style]
    2    cell      {4×2 double}    [1×1 matlab.ui.style.Style]
    3    column    {[       2]}    [1×1 matlab.ui.style.Style]

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

removeStyle(uit,2)

表选择，指定为正整数、正整数向量或由正整数组成的 n×2 数组。使用此属性以编程方式设置表选择，或查询 App 用户选择的表元素。您可以指定的值的类型取决于 SelectionType 和 Multiselect 属性的值。

当 SelectionType 为 'row' 或 'column' 且 MultiSelect 为 'on' 时，您可以将 Selection 指定为行向量或列向量。但是，MATLAB 会转换值并将其存储为行向量。

Selection 和 DisplaySelection 之间的区别

Selection 和 DisplaySelection 属性都返回所选单元格的索引，但这些索引对应于表数据的不同配置，可用于不同目的。

如果用户不对表列进行排序或重新排列，这两个属性具有相同的值。

例如，用一些数据和可排序的列创建一个表 UI 组件。然后，按第一列中的值对表进行排序，并选择排序后的表的第一行。

fig = uifigure;
tbl = uitable(fig,Data=[4 9; 7 1; 2 3],ColumnSortable=true);

查询表的 Selection 属性和 DisplaySelection 属性。Selection 属性返回原始表数据中所选单元格的索引。

tbl.Selection

ans =

     3     1
     3     2

DisplaySelection 属性返回所显示的表数据中所选单元格的索引。

tbl.DisplaySelection

ans =

     1     1
     1     2

此 属性 为只读。

当前显示中的表所选内容，以正整数、正整数向量或由正整数组成的 n×2 数组形式返回。当所选内容出现在当前表显示中时，使用此属性查询 App 用户选择的表元素。

DisplaySelection 返回的值的类型取决于 SelectionType 和 Multiselect 属性的值。

Selection 和 DisplaySelection 之间的区别

Selection 和 DisplaySelection 属性都返回所选单元格的索引，但这些索引对应于表数据的不同配置，可用于不同目的。

如果用户不对表列进行排序或重新排列，这两个属性具有相同的值。

例如，用一些数据和可排序的列创建一个表 UI 组件。然后，按第一列中的值对表进行排序，并选择排序后的表的第一行。

fig = uifigure;
tbl = uitable(fig,Data=[4 9; 7 1; 2 3],ColumnSortable=true);

查询表的 Selection 属性和 DisplaySelection 属性。Selection 属性返回使用 Data 属性指定的原始表数据中所选单元格的索引。

tbl.Selection

ans =

     3     1
     3     2

DisplaySelection 属性返回所显示的表数据中所选单元格的索引。

tbl.DisplaySelection

ans =

     1     1
     1     2

表选择类型，指定为 'cell'、'row' 或 'column'。表选择类型指定在用户与表交互时 MATLAB 选择哪些表元素。例如，如果 SelectionType 是 'row'，并且 App 用户点击表的第二行中的单元格，则将选择整个第二行。

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

所选内容改变时的回调，指定为下列值之一：

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

此回调函数可以访问有关用户与表的交互的特定信息，例如他们选择的元素。MATLAB 将 TableSelectionChangedData 对象中的此信息作为第二个参量传递给回调函数。在 App 设计工具中，此参量称为 event。您可以使用圆点表示法查询对象属性。例如，event.Selection 返回所选单元格、行或列索引。TableSelectionChangedData 对象不可用于指定为字符向量的回调函数。

下表说明了 TableSelectionChangedData 对象的属性。

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

当用户通过点击、使用箭头键或使用下列键盘快捷方式之一更改表选择时，表将执行 SelectionChangedFcn 回调。

连续选择选项：

不连续选择选项：

显示数据更改回调，指定为下列值之一：

当 DisplayData 更改时会执行此回调。当 App 用户执行以下操作之一时，便会出现这种情况：

如果您要了解导致 DisplayData 发生更改的用户交互信息，请使用此回调。如果您需要有关编辑过的单元格的特定信息，请创建 CellEditCallback。

此回调函数可以访问有关列是否经过排序或重新排列或单元格是否经过编辑的特定信息。MATLAB 将 DisplayDataChangedData 对象中的此信息作为第二个参量传递给回调函数。在 App 设计工具中，该参量名为 event。您可以使用圆点表示法查询对象属性。例如，event.InteractionColumn 返回 Data 中进行过交互的列的索引。DisplayDataChangedData 对象不可用于指定为字符向量的回调函数。

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

点击的函数，指定为下列值之一：

当用户点击表 UI 组件中的任意位置时，此回调函数执行。

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

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

下表列出了与表 UI 组件相关联的 InteractionInformation 对象的属性。

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

示例：点击表单元格时选择背景颜色

用一些数据创建一个表 UI 组件。指定一个名为 colorCells 的 ClickedFcn 回调函数，该函数在用户点击表时执行。在 colorCells 函数中：

要尝试此示例，请将代码保存在新脚本中并运行它。点击表中的一个单元格，并为该单元格选择背景颜色。

fig = uifigure;
t = uitable(fig);
t.Data = rand(5);
t.ClickedFcn = @colorCells;

function colorCells(src,event)
r = event.InteractionInformation.Row;
c = event.InteractionInformation.Column;
if ~isempty(r) && ~isempty(c)
    removeStyle(src)
    color = uisetcolor;
    s = uistyle(BackgroundColor=color);
    addStyle(src,s,"cell",[r c]);
    focus(src)
end
end

双击回调，指定为下列值之一：

当用户双击表 UI 组件中的任意位置时，此回调函数执行。

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

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

下表列出了与表 UI 组件相关联的 InteractionInformation 对象的属性。

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

示例：双击表单元格时选择背景颜色

用一些数据创建一个表 UI 组件。指定名为 colorCells 的 DoubleClickedFcn 回调函数，该函数在用户双击该表时执行。在 colorCells 函数中：

要尝试此示例，请将代码保存在新脚本中并运行它。双击表中的一个单元格，并为该单元格选择背景颜色。

fig = uifigure;
t = uitable(fig);
t.Data = rand(5);
t.DoubleClickedFcn = @colorCells;

function colorCells(src,event)
r = event.InteractionInformation.Row;
c = event.InteractionInformation.Column;
if ~isempty(r) && ~isempty(c)
    removeStyle(src)
    color = uisetcolor;
    s = uistyle(BackgroundColor=color);
    addStyle(src,s,"cell",[r c]);    
    focus(src)
end
end

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

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

g = uigridlayout([4 3]);
uit = uitable(g,'Data',rand(10,3));
uit.Layout.Row = 3;
uit.Layout.Column = 2;

要使该表跨多个行或列，请将 Row 或 Column 属性指定为二元素向量。例如，以下表跨列 2 到 3：

uit.Layout.Column = [2 3];

此 属性 为只读。

外围矩形的大小，以四元素行向量形式返回。向量的前两个元素始终为零。第三和第四个元素分别是围绕在表周围的矩形的宽度和高度。所有测量值都采用 Units 属性指定的单位。

MATLAB 基于当前 Data、RowName 和 ColumnName 属性值确定矩形的大小。MATLAB 使用列和行宽度估计宽度和高度值。估计范围可以大于图窗。

指定 Position 属性的宽度和高度值时，可以考虑使用 Extent 属性值。