addStyle

Добавление стиля к компоненту пользовательского интерфейса таблицы

Описание

пример

addStyle(uit,s) добавляет стиль, созданный с помощью uistyle функция для заданного компонента пользовательского интерфейса таблицы. Стиль применяется ко всей таблице. Таблица должна быть родительской для рисунка, созданной с помощью uifigure функции или одному из дочерних контейнеров.

пример

addStyle(uit,s,target,targetIndex) добавляет стиль к определенной строке, столбцу или камере. Для примера, addStyle(uit,s,'column',3) добавляет стиль к третьему столбцу указанной таблицы.

Примеры

свернуть все

Создайте компонент пользовательского интерфейса таблицы на рисунке.

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)

Стиль камер в компоненте пользовательского интерфейса таблицы, которые содержат отсутствующие значения. В этом случае добавьте желтый стиль цвета фона к камерам, которые имеют NaN значения.

Считайте выборочные данные цунами в рабочую область как массив таблиц. Затем создайте компонент пользовательского интерфейса таблицы для отображения данных.

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 значения. Наконец, создайте желтый стиль цвета фона и добавьте его к камерам с NaN значения в компоненте пользовательского интерфейса таблицы.

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

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

Создать несколько стилей и добавить их в различные части компонента пользовательского интерфейса таблицы.

Создайте рисунок с компонентом пользовательского интерфейса таблицы и отобразите числовые данные в таблице. Найдите строку и столбец индексы для элементов таблицы со значением меньше нуля, чтобы можно было стилизовать эти камеры позже.

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)

Входные параметры

свернуть все

Компонент таблицы, заданный как Table объект, созданный с помощью uitable функция. The Table объект должен быть помечен как рисунок, созданный с помощью uifigure функции или одного из дочерних контейнеров.

Объект стиля, созданный с помощью uistyle функция.

Стиль цели, заданный как 'row', 'column', 'cell', или 'table'. Используйте этот аргумент для указания типа детали таблицы, к которой применяется стиль.

Пример: addStyle(uit,s,'column',5) добавляет стиль к пятому столбцу uit.

Пример: addStyle(uit,s,'cell',[3 7]) добавляет стиль к камере в строке 3, столбец 7.

Стиль целевого индекса, заданный как одно из значений, перечисленных в таблицах. Типы значений, которые можно задать, зависят от цели и типа данных, используемых в компоненте пользовательского интерфейса таблицы.

ЦельПоддерживаемые значенияПримерыРезультат
'row'

Положительное целое число.

4

Добавление стиля к строке с соответствующим индексом строк.

Вектор положительных целых чисел

[3 8 9 12]

Добавляет стиль к строкам с соответствующими индексами строк.

'column'

Положительное целое число.

3

Добавление стиля к столбцу с соответствующим индексом столбца.

Вектор положительных целых чисел.

[1 2 7 14]

Добавление стиля к столбцам с соответствующими индексами столбцов.

'cell'

n-by-2 массив положительных целых чисел.

[2 4;5 9;13 27]

Добавление стиля к камерам с соответствующими индексами строк и столбцов.

'table'

Пустой символьный вектор.

''

Добавление стиля ко всей таблице.

В таблице компоненты UI, в которых базовыми данными являются table массив, существуют дополнительные опции, когда цель задана как 'column'. Задайте эти значения для targetIndex если необходимо применить стиль к столбцу на основе имен переменных в массиве таблиц.

ЦельПоддерживаемые значенияПримеры
'column'

Строковый скаляр.

Добавление стиля к столбцу с соответствующим именем переменной.

"Torque"

Строковые массивы.

Добавление стиля к столбцам с соответствующими именами переменных.

["Torque" "Mass"]

Вектор символов.

Добавление стиля к столбцу с соответствующим именем переменной.

'Revenue'

1-D массивов ячеек из векторов символов

Добавление стиля к столбцам с соответствующими именами переменных.

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

Если вы укладываете камеры в зависимости от того, соответствует ли значение камер определенному условию, и ваши камеры можно редактировать, используйте CellEditCallback функция для пересчета целевых индексов стиля, соответствующих заданному условию, и добавления нового стиля к таблице, которая устанавливает эти новые камеры как targetIndex.

Совет

  • Чтобы увидеть список стилей, добавленных в таблицу, запросите значение StyleConfigurations свойство.

Введенный в R2019b