uitable

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

Описание

uit = uitable создает табличный компонент пользовательского интерфейса в текущей фигуре и возвращает Table Объект компонента пользовательского интерфейса. Если нет никакой доступной фигуры, MATLAB® вызывает figure функция, чтобы создать ту.

uit = uitable(Name,Value) задает значения свойств компонента таблицы UI, использующего один или несколько аргументов пары "имя-значение".

пример

uit = uitable(parent) составляет таблицу в заданном родительском контейнере. Родительский контейнер может быть фигурой, созданной с любым figure или uifigure функция или дочерний контейнер, такой как панель. Значения свойств для uitable варьируйтесь немного в зависимости от того, создано ли приложение с figure или uifigure функция. Для получения дополнительной информации см. Аргументы в виде пар имя-значение.

пример

uit = uitable(parent,Name,Value) задает родительский контейнер и одни или несколько значений свойств.

Примеры

свернуть все

Начиная в R2018a, можно отобразиться table данные массива в компоненте таблицы UI. Этот тип данных поддерживается только, когда компонент таблицы UI находится на рисунке, созданном с uifigure функция. App Designer использует этот тип фигуры для того, чтобы создать приложения.

Создайте табличный массив t путем вызова readtable функционируйте, чтобы считать данные из файла. Выберите четыре переменные и 15 строк от t.

t = readtable('patients.xls');
vars = {'Age','Systolic','Diastolic','Smoker'};
t = t(1:15,vars);

Создайте компонент таблицы UI и задайте t как данные.

fig = uifigure;
uit = uitable(fig,'Data',t);

Начиная в R2019a, можно отсортировать столбцы компонента таблицы UI, который имеет table данные массива сохранены в его Data свойство. Этот тип данных поддерживается только, когда компонент таблицы UI находится на рисунке, созданном с uifigure функция. App Designer использует этот тип фигуры для того, чтобы создать приложения.

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

Во-первых, создайте программный файл под названием tsunamisData.m. В программном файле:

  • Создайте a table массив путем вызова readtable функция.

  • Создайте поддающийся сортировке и доступный для редактирования компонент таблицы UI, чтобы отобразиться на рисунке. Сохраните table массив к Data компонента свойство.

  • Задайте DisplayDataChangedFcn коллбэк, который использует DisplayData свойство обновить график, когда пользователь столбцы видов или ячейки редактирований в компоненте таблицы UI.

function tsunamisData
t = readtable('tsunamis.xlsx');
vars = {'Year','MaxHeight','Latitude','Longitude'};
t = t(1:20,vars);

fig = uifigure;
fig.Position(3:4) = [822 360];

uit = uitable(fig);
uit.Data = t;
uit.ColumnSortable = [false true true true];
uit.ColumnEditable = true;
uit.Position(3) = 375;
uit.DisplayDataChangedFcn = @updatePlot;

ax = uiaxes(fig);
ax.Position(1) = 415;
ax.YLabel.String = 'Max Height';
x = t.Year;
y = t.MaxHeight;
area(ax,x,y)

    function updatePlot(src,event)
        t = uit.DisplayData;
        x = t.Year;
        y = t.MaxHeight;
        area(ax,x,y)
    end

end

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

Начиная в R2019b, можно разработать строки, столбцы или ячейки компонента таблицы UI использование uistyle и addStyle функции. Стили только поддерживаются, когда компонент таблицы UI находится на рисунке, созданном с uifigure функция. App Designer использует этот тип фигуры для того, чтобы создать приложения.

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

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

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

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

f = figure;
uit = uitable(f,'Data',randi(100,10,3),'Position',[20 20 262 204]);

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

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

f = figure;
uit = uitable(f);

Установите Data свойство заполнить данные как массив ячеек, который содержит смесь различных типов. Затем установите Position свойство настроить местоположение и размер таблицы, чтобы соответствовать данным.

d = {'Male',52,true;'Male',40,true;'Female',25,false};
uit.Data = d;
uit.Position = [20 20 258 78];

Установите ColumnName свойство изменить заголовки столбцов в описательные имена. Установите ColumnEditable свойство к true так, чтобы пользователи могли отредактировать данные в пользовательском интерфейсе. Когда пользователь изменяет значение в пользовательском интерфейсе, Data свойство обновляется, чтобы отразить то изменение.

uit.ColumnName = {'Gender','Age','Authorized'};
uit.ColumnEditable = true;

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

свернуть все

Родительский контейнер в виде фигуры, созданной с любым figure или uifigure функция или дочерний контейнер:

  • Панели, вкладки и группы кнопок могут быть контейнерами в любом типе фигуры.

  • Размещения сетки могут быть контейнерами, только в цифрах созданный с uifigure функция.

Аргументы в виде пар имя-значение

Пример: 'Data',[1 2 3; 4 5 6]

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в одинарных кавычках (' '). Можно задать несколько имен и аргументов пары значения как Name1,Value1,...,NameN,ValueN.

Можно установить Table Аргументы пары "имя-значение" использования свойств.

  • Для списка свойств, доступных для приложений, созданных с uifigure функционируйте или в App Designer, смотрите Свойства таблиц.

  • Для списка свойств, доступных для приложений, созданных с figure функционируйте, смотрите Свойства таблиц.

Введенный в R2008a