uitable

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

Синтаксис

uit = uitable
uit = uitable(Name,Value)
uit = uitable(parent)
uit = uitable(parent,Name,Value)

Описание

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

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

пример

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

пример

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

Примеры

свернуть все

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

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

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

Создайте пустой 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;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ax = uiaxes(uf);
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

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

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

свернуть все

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

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

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

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

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

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

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

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

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

Введенный в R2008a