uitable
Создайте табличный компонент пользовательского интерфейса
Синтаксис
Описание
uit = uitableTable Объект компонента пользовательского интерфейса. Если нет никакой доступной фигуры, MATLAB® вызывает figure функция, чтобы создать ту.
uit = uitable(Name,Value)
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);
Программно обновите табличные данные
Отобразитесь и программно обновитесь table данные массива в компоненте таблицы UI. (Этот тип данных поддерживается только, когда компонент таблицы UI находится на рисунке, созданном с uifigure функция. App Designer использует этот тип фигуры для того, чтобы создать приложения.)
Создайте табличный массив путем чтения в данных о цунами из файла и отобразите подмножество данных в компоненте таблицы UI.
t = readtable('tsunamis.xlsx'); vars = {'Year','MaxHeight','Validity'}; t = t(1:20,vars); fig = uifigure; uit = uitable(fig,'Data',t);
Обновите валидность цунами в первой строке путем редактирования Data свойство таблицы UI.
uit.Data.Validity(1) = {'definite tsunami'};
Преобразуйте максимальные данные о высоте от метров до ног путем доступа и изменения данных в MaxHeight столбец.
uit.Data.MaxHeight = uit.Data.MaxHeight*3.281;
Включите и ответ кода на интерактивное редактирование данных
Создайте приложение, которое позволяет пользователям сортировать и редактировать табличные данные, и это обновляет визуализацию данных, когда данные изменяются. (Интерактивная сортировка столбца поддерживается только, когда компонент таблицы UI находится на рисунке, созданном с uifigure функция. App Designer использует этот тип фигуры для того, чтобы создать приложения.)
Во-первых, создайте программный файл под названием tsunamisData.m. В программном файле:
Создайте a
tableмассив путем вызоваreadtableфункция.Создайте фигуру пользовательского интерфейса.
Создайте поддающийся сортировке и доступный для редактирования компонент таблицы UI, чтобы отобразиться на рисунке. Сохраните
tableмассив кDataкомпонентасвойство.Создайте пузырьковый график, чтобы визуализировать данные о цунами, где координаты пузыря представляют широту и долготу цунами, и размер пузыря представляет максимальную высоту.
Задайте
DisplayDataChangedFcnколлбэк, который используетDisplayDataсвойство обновить пузырьковую диаграмму, когда столбцы видов пользователя приложения или ячейки редактирований в компоненте таблицы UI.
function tsunamisData % Create table array t = readtable('tsunamis.xlsx'); vars = {'Latitude','Longitude','MaxHeight'}; t = t(1:20,vars); % Create UI figure fig = uifigure; fig.Position(3:4) = [722 360]; % Create table UI component uit = uitable(fig); uit.Data = t; uit.ColumnSortable = true; uit.ColumnEditable = [false false true]; uit.Position(3) = 290; uit.DisplayDataChangedFcn = @updatePlot; % Create bubble chart ax = uiaxes(fig); ax.Position(1) = 315; ax.XLabel.String = 'Longitude'; ax.YLabel.String = 'Latitude'; x = t.Longitude; y = t.Latitude; sz = t.MaxHeight; bubblechart(ax,x,y,sz) % Update the bubble chart when table data changes function updatePlot(src,event) t = uit.DisplayData; x = t.Longitude; y = t.Latitude; sz = t.MaxHeight; bubblechart(ax,x,y,sz) end end
Поддающиеся сортировке стрелки отображений столбца в заголовке, когда вы наводите своя мышь на него. Сортировка таблицы максимальной высотой цунами.
Отредактируйте максимальную высоту цунами во второй строке, чтобы быть 30 метров первым двойным кликом на ячейке таблицы и затем вводом новой высоты. Заметьте, как пузырьковая диаграмма обновляется в ответ.
Измените цвет определенных ячеек на основе данных
Начиная в 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 760 360]); uit = uitable(fig); uit.Position = [20 20 720 320]; uit.Data = tdata; uit.RowName = 'numbered';
Используйте ismissing функция, чтобы получить логический массив табличных элементов, которые содержат отсутствующие значения. Найдите индексы строки и столбца для элементов, которые имеют NaN значения. Наконец, создайте желтый стиль цвета фона и добавьте его в ячейки с NaN значения в компоненте таблицы UI.
styleIndices = ismissing(tdata); [row,col] = find(styleIndices); s = uistyle('BackgroundColor',[1 0.6 0.6]); addStyle(uit,s,'cell',[row,col]);
Программно доступ к табличному выбору
Начиная в R2021b, можно программно установить и запросить, какие табличные элементы выбраны и указывают, могут ли пользователи выбрать ячейки, строки или столбцы. (Программируемый выбор только поддерживается, когда компонент таблицы UI находится на рисунке, созданном с uifigure функция. App Designer использует этот тип фигуры для того, чтобы создать приложения.)
При использовании этой функции создайте приложение, которое автоматически отображает данные на графике по карте, когда пользователь выбирает его в таблице. Во-первых, создайте программный файл под названием selectTsunamis.m. В программном файле:
Загрузите данные о цунами путем вызова
readtableфункция.Создайте фигуру пользовательского интерфейса с компонентом таблицы UI и географической пузырьковой диаграммой в панели.
Сконфигурируйте компонент таблицы UI. Храните данные о цунами в
Dataсвойство, и позволило пользователям выбрать несколько строк путем установкиSelectionTypeиMultiSelectсвойства.Задайте
SelectionChangedFcnколлбэк, который обновляет пузырьковую диаграмму, когда пользователь приложения изменяет табличный выбор. Графики функций пузырь для каждой выбранной строки, где размер пузыря представляет максимальную высоту цунами.
function selectTsunamis % Load data T = readtable('tsunamis.xlsx'); vars = {'Latitude','Longitude','MaxHeight'}; T = T(1:20,vars); % Create UI components fig = uifigure('Position',[500 500 700 350]); tbl = uitable(fig,'Position',[20 20 250 300]); pnl = uipanel(fig,'Position',[285 20 400 300]); geobubble(pnl,[],[]); % Configure table tbl.Data = T; tbl.SelectionType = 'row'; tbl.Multiselect = 'on'; tbl.SelectionChangedFcn = @plotTsunami; % Plot tsunami data for each selected row function plotTsunami(src,event) rows = event.Selection; data = src.Data(rows,:); lat = data.Latitude; long = data.Longitude; ht = data.MaxHeight; geobubble(pnl,lat,long,ht); end end
Запустите selectTsunamis функция и выбор несколько строк таблицы удержанием Ctrl при нажатии. График обновляется с данными о цунами.
Программно прокрутите к строке таблицы
Начиная в R2021a, можно программно прокрутить к строке, столбцу или ячейке компонента таблицы UI использование scroll функция. (Программируемая прокрутка только поддерживается, когда компонент таблицы UI находится на рисунке, созданном с uifigure функция. App Designer использует этот тип фигуры для того, чтобы создать приложения.)
Считайте демонстрационные данные о пациентах в рабочую область как табличный массив. Затем создайте компонент таблицы UI, чтобы отобразить данные.
tdata = readtable('patients.xls'); vars = {'Age','Systolic','Diastolic','Smoker'}; tdata = tdata(1:40,vars); fig = uifigure; uit = uitable(fig,'Data',tdata); uit.RowName = 'numbered';
Прокрутите к двадцать пятой строке таблицы.
scroll(uit,'row',25)
Отобразите массив чисел
Создайте компонент таблицы 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;