Main Content

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

addStyle

将样式添加到表 UI 组件

说明

示例

addStyle(uit,s) 将使用 uistyle 函数创建的样式添加到指定的表 UI 组件中。该样式将应用于整个表。该表必须是使用 uifigure 函数创建的图窗的父级,或其子容器之一的父级。

示例

addStyle(uit,s,target,targetIndex) 将样式添加到一个特定的行、列或单元格中。例如,addStyle(uit,s,'column',3) 将样式添加到指定表的第三列。

示例

全部折叠

在图窗中创建一个表 UI 组件。

fig = uifigure;
fig.Position = [500 500 520 200];

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

然后,使用 uistyle 函数创建一个红色斜体字体样式。使用 addStyle 函数将它添加到整个表。

s = uistyle('FontAngle','italic','FontColor','r');
addStyle(uit,s)

对表 UI 组件中包含缺失值的单元格设置样式。在本例中,为包含 NaN 值的单元格添加黄色背景色样式。

将海啸示例数据作为表数组读入工作区中。然后创建一个表 UI 组件来显示数据。

tdata = readtable('tsunamis.xlsx');
vars = {'Year','Month','Day','Hour', ...
        'MaxHeight','Cause','EarthquakeMagnitude'};
tdata = tdata(1:100,vars);

fig = uifigure('Position',[500 500 750 350]);
uit = uitable(fig);
uit.Position = [20 20 710 310];
uit.Data = tdata;
uit.RowName = 'numbered';

使用 ismissing 函数获取包含缺失值的表元素的逻辑数组。找到含有 NaN 值的元素的行和列下标。最后,创建一个黄色背景色样式并将它添加到表 UI 组件中包含 NaN 值的单元格中。

styleIndices = ismissing(tdata);
[row,col] = find(styleIndices);

s = uistyle('BackgroundColor','yellow');
addStyle(uit,s,'cell',[row,col]);

创建多个样式并将它们添加到表 UI 组件的不同部分。

创建一个包含表 UI 组件的图窗并显示表中的数值数据。找到表中其值小于零的元素的行和列下标,以便稍后设置这些单元格的样式。

fig = uifigure;
fig.Position = [500 500 720 230];

uit = uitable(fig);
uit.Data = randi([-20,20],7);
uit.Position = [20 30 680 185];

[row,col] = find(uit.Data < 0);

创建两个背景颜色样式和一个指定字体颜色和粗细的样式。为第 1 列、第 3 列和第 5 列添加青色背景颜色。将具有负值的单元格的字体设为红色和粗体以示强调。然后,将第 3 行和第 4 行的背景颜色设为绿色。最后,对第 7 列重复使用青色背景颜色。对于添加了同一类型的多个样式的单元格,最后添加的样式将成为单元格中显示的样式。

s1 = uistyle;
s1.BackgroundColor = 'cyan';
addStyle(uit,s1,'column',[1 3 5])

s2 = uistyle;
s2.FontColor = 'red';
s2.FontWeight = 'bold';
addStyle(uit,s2,'cell',[row,col])

s3 = uistyle;
s3.BackgroundColor = 'green';
addStyle(uit,s3,'row',[3 4])

addStyle(uit,s1,'column',7)

输入参数

全部折叠

表组件,指定为用 uitable 函数创建的 Table 对象。该 Table 对象必须是使用 uifigure 函数创建的图窗的父级,或其子容器之一的父级。

使用 uistyle 函数创建的样式对象。

样式目标,指定为 'row''column''cell''table'。使用此参数指示要应用样式的表部分的类型。

示例: addStyle(uit,s,'column',5) 将样式添加到 uit 的第五列。

示例: addStyle(uit,s,'cell',[3 7]) 将样式添加到第 3 行第 7 列的单元格。

样式目标索引,指定为下表中列出的值之一。可指定的值的类型取决于目标和表 UI 组件中使用的数据的类型。

目标支持的值示例结果
'row'

正整数。

4

将样式添加到具有对应行索引的行。

正整数向量

[3 8 9 12]

将样式添加到具有对应行索引的行。

'column'

正整数。

3

将样式添加到具有对应列索引的列。

正整数向量。

[1 2 7 14]

将样式添加到具有对应列索引的列。

'cell'

由正整数组成的 n×2 数组。

[2 4;5 9;13 27]

将样式添加到具有对应的行和列下标的单元格。

'table'

空字符向量。

''

将样式添加到整个表。

在其中的基础数据为 table 数组的表 UI 组件中,如果目标指定为 'column',则还会有其他选项。如果您想基于表数组中的变量名称将样式应用到某个列,请为 targetIndex 指定以下值。

目标支持的值示例
'column'

字符串标量。

将样式添加到具有对应变量名称的列。

"Torque"

字符串数组。

将样式添加到具有对应变量名称的列。

["Torque" "Mass"]

字符向量。

将样式添加到具有对应变量名称的列。

'Revenue'

一维字符向量元胞数组

将样式添加到具有对应变量名称的列。

{'Year','Expenses','Revenue'}

如果您基于单元格的值是否满足特定条件来设置单元格样式并且单元格可编辑,则可使用 CellEditCallback 函数重新计算满足指定条件的样式目标索引,并将新样式添加到将这些新单元格设置为 targetIndex 的表。

提示

  • 要查看已添加到表的样式的列表,请查询 StyleConfigurations 属性的值。

另请参阅

函数

属性

在 R2019b 中推出