Данные таблицы, указанные как числовой массив, логический массив или массив ячеек. Данные таблицы могут быть любого числового типа, logical, или char. Используйте массив ячеек для указания комбинации различных типов данных.

Табличные данные отображаются в формате, заданном ColumnFormat собственность. Если существует несоответствие между типом данных таблицы и значением ColumnFormat MATLAB ® преобразует данные или выводит предупреждение. См. разделColumnFormat описание свойства для получения дополнительной информации.

Чтобы предотвратить появление предупреждений при вводе недопустимых данных, запишите CellEditCallback для преобразования данных в соответствующий тип.

Если количество строк в Data массив свойств не соответствует количеству элементов в RowName массив, то число строк в результирующей таблице больше двух значений. То же самое верно, когда ColumnName свойство не соответствует количеству столбцов в Data массив свойств.

Пример: t = uitable('Data',rand(10,3))

Пример: t = uitable('Data',{'blue' 5 true; 'orange' 25 false})

Имена заголовков столбцов, указанные как одно из следующих значений:

Если количество столбцов в Data массив свойств не соответствует количеству элементов в ColumnName массив, то количество столбцов в результирующей таблице больше двух значений.

Пример: t = uitable('ColumnName',{'Name'; 'Number'},'Data',{'Bob' 5})

Пример: t = uitable('ColumnName',{'Name'; []},'Data',{'Bob' 5})

Пример: t = uitable('ColumnName',{'Name'; 'Telephone|Number'},'Data',{'Bob','555-1212'})

Ширина столбцов таблицы, указанная как 'auto' или в качестве 1около-n массив ячеек.

Каждый столбец в массиве ячеек соответствует столбцу в таблице. Значения представлены в единицах пикселей. При указании 'auto'затем MATLAB автоматически вычисляет ширину столбца, используя несколько факторов, одним из которых является ColumnName значение свойства.

Можно комбинировать фиксированную ширину столбцов и 'auto' ширины столбцов в массиве ячеек, или можно указать одно значение 'auto' для автоматического задания ширины всех столбцов.

Выбор параметра «Автоматическая ширина» в редакторе свойств таблицы имеет тот же эффект, что и установка параметра ColumnWidth свойство для 'auto'.

Пример: t = uitable('ColumnWidth','auto','Data',[1 2 3; 4 5 6])

Пример: t = uitable('ColumnWidth',{64 60 40},'Data',[1 2 3; 4 5 6])

Пример: t = uitable('ColumnWidth',{64 'auto' 40},'Data',[1 2 3; 4 5 6])

Возможность редактирования ячеек столбцов, указанных как:

Пример: t = uitable('Data',rand(10,3),'ColumnEditable',[false true true])

Пример: t = uitable('Data',rand(10,3),'ColumnEditable',false)

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

Формат отображения ячеек, указанный как пустой массив ячеек или 1около-n клеточный массив символьных векторов.

Это свойство определяет способ отображения данных в каждом столбце и ограничения для редактирования этих данных в интерфейсе пользователя. Элементы массива ячеек соответствуют столбцам в Data массив свойств. Если не требуется указывать формат отображения для определенного столбца, укажите [] для этой колонки. Если формат столбца не задан, MATLAB определяет отображение по умолчанию по типу данных в ячейке.

Элементы массива ячеек должны быть одним из значений, описанных в следующей таблице.

Влияние всплывающего меню ColumnFormat и различных типов данных

Если ColumnFormat значение определяет всплывающее меню, начальное Data значение не обязательно должно быть одним из параметров в этом меню. Начальная буква Data значение отображается до тех пор, пока пользователь не сделает другой выбор.

Например, предположим, что Data значение свойства для данного столбца 'Choose' для всех строк и ColumnFormat значение задает всплывающее меню с вариантами 'group 1' и 'group 2'. Когда MATLAB создает таблицу, эти ячейки таблицы отображаются 'Choose' пока пользователь не выберет пункт во всплывающем меню:

f = figure;
myData = {'Andrew' 31 'Male' 'Choose'; ...
          'Bob' 41 'Male' 'Choose';  ...
          'Anne' 20 'Female' 'Choose';};
t = uitable('Parent', f,...
            'Position', [25 25 334 78],...            
            'ColumnFormat',({[] [] [] {'group 1' 'group 2'}}),... 
            'ColumnEditable', true,...
            'Data', myData);

Отображение данных редактируемых столбцов

В этой таблице описывается отображение различных типов данных с конкретными ColumnFormat значения.

Например, в следующей таблице первый столбец (X-Data) остается выровненным, поскольку ColumnFormat значение для этого столбца равно 'char'.

Имена заголовков строк, указанные как одно из следующих значений:

Если количество строк в Data массив свойств не соответствует количеству элементов в RowName массив, то число строк в результирующей таблице больше двух значений.

Пример: t = uitable('RowName',{'Name';'Number'},'Data',{'Bob';5})

Пример: t = uitable('RowName',{'Name';[]},'Data',{'Bob';5})

Возможность переупорядочивания столбцов таблицы, указанных как 'off' или 'on'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Это свойство позволяет пользователям изменить порядок столбцов таблицы (но не меток), щелкнув и перетащив заголовки столбцов.

Имя шрифта, указанное как имя поддерживаемого системой шрифта или 'FixedWidth'. Шрифт по умолчанию зависит от конкретной операционной системы и языка.

Чтобы использовать шрифт фиксированной ширины, который хорошо выглядит в любом языковом стандарте, укажите 'FixedWidth'. Фактически используемый шрифт фиксированной ширины зависит от FixedWidthFontName свойства корневого объекта. Изменение FixedWidthFontName приводит к немедленному обновлению отображения для использования нового шрифта.

Пример: 'Arial'

Размер шрифта, указанный как положительное число. FontUnits свойство определяет единицы измерения. Размер по умолчанию зависит от системы.

Пример: 12

Пример: 12.5

Вес шрифта, указанный как значение из следующей таблицы.

MATLAB использует FontWeight для выбора шрифта из доступных в системе. Не все шрифты имеют жирный вес. Поэтому задание полужирного веса шрифта может привести к нормальному весу шрифта.

Угол шрифта, указанный как 'normal' или 'italic'. MATLAB использует это свойство для выбора шрифта из доступных в системе. Установка для этого свойства значения 'italic' выбирает наклонную версию шрифта, если она доступна в системе.

Единицы шрифта, указанные как одно из значений из этой таблицы.

Состояние видимости, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

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

Рабочее состояние таблицы, указанное как 'on', 'off', или 'inactive'. Enable определяет, реагирует ли компонент пользовательского интерфейса на нажатие кнопки. Существует три возможных значения:

Значение Enable свойство и тип кнопки определяют реакцию пользовательского интерфейса.

Подсказка, заданная как символьный вектор, строковый скаляр или категориальный массив. Это свойство используется для отображения сообщения при наведении указателя на компонент во время выполнения. Подсказка не отображается, когда компонент отключен. Если это свойство указано как категориальный массив, MATLAB использует значения в массиве, а не полный набор категорий.

Для создания нескольких строк текста используйте sprintf для вставки новых символов строки ('\n') в вашем тексте. Например:

txt = sprintf('Line 1\nLine 2');

Затем установите Tooltip свойство к значению, возвращенному sprintf.

Контекстное меню, указанное как ContextMenu объект, созданный с помощью uicontextmenu функция. Это свойство используется для отображения контекстного меню при щелчке правой кнопкой мыши на компоненте.

Подсказка, заданная как символьный вектор, строковый скаляр или категориальный массив. Подсказка появляется при наведении курсора на компонент в приложении. Если это свойство указано как категориальный массив, MATLAB использует значения в массиве, а не полный набор категорий.

Цвет текста ячейки, указанный как триплет RGB, шестнадцатеричный код цвета или один из параметров цвета, перечисленных в таблице.

Триплеты RGB и шестнадцатеричные цветовые коды полезны для задания пользовательских цветов.

Можно также задать некоторые общие цвета по имени. В этой таблице перечислены параметры именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB, используемых на многих типах графиков.

Цвет фона, определяемый как триплет RGB или матрица m-на-3 триплетов RGB. Триплет RGB - это вектор строки, задающий интенсивности красного, зеленого и синего компонентов цвета. Интенсивности должны быть в диапазоне, [0,1]. Недопустимые имена цветов.

Укажите матрицу m-на-3, если требуется, чтобы затенение строк таблицы соответствовало повторяющемуся образцу из m различных цветов. Каждая строка матрицы должна быть триплетом RGB. MATLAB использует строки матрицы, когда RowStriping свойство - 'on'. Фон таблицы не чередуется, если только оба RowStriping является 'on' и BackgroundColor является матрицей m-на-3.

Пример: t = uitable('Data',rand(10,3),'BackgroundColor',[0.85 0.85 1])

Пример: t = uitable('Data',rand(10,3),'BackgroundColor',[1 1 1 ;0.85 0.85 1])

В следующей таблице перечислены триплеты RGB для определенных цветов.

Альтернативное затенение строки, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Это свойство управляет шаблоном затенения строк таблицы. Когда RowStriping установлено значение 'on', BackgroundColor матрица задает цвета строк для отображения в повторяющемся шаблоне. Если BackgroundColor матрица имеет только одну строку, то затенение одинаково во всех строках таблицы.

Когда RowStriping имеет значение 'off', то первый цвет в BackgroundColor матрица определяет затенение для всех строк в таблице.

Местоположение и размер, указанные как четырехэлементный вектор формы [left bottom width height]. В этой таблице описывается каждый элемент вектора.

Все измерения в единицах, указанных Units собственность.

Используйте Extent для определения правильного размера таблицы относительно данных. Установите width и height из Position к ширине и высоте Extent собственность. Помните, что если таблица имеет большие границы, это может привести к тому, что таблица выйдет за пределы правого или верхнего края родительского контейнера.

Пример: Задайте ширину и высоту для размещения размера данных

Можно комбинировать точечную нотацию и индексацию массива, если требуется изменить одно или два последовательных значения в Position вектор. Например, этот код задает ширину и высоту таблицы, соответствующие Extent таблицы:

t = uitable('Data',rand(10,3));
t.Position(3:4) = t.Extent(3:4);

Местоположение и размер, указанные как четырехэлементный вектор формы [left bottom width height]. Все измерения в единицах, указанных Units собственность.

Это значение свойства идентично значению Position и OuterPosition значения свойств.

Местоположение и размер, указанные как четырехэлементный вектор формы [left bottom width height]. Все измерения в единицах, указанных Units собственность.

Это значение свойства идентично значению Position и InnerPosition значения свойств.

Это свойство доступно только для чтения.

Размер охватывающего прямоугольника, возвращаемого в виде четырехэлементного вектора строки. Первые два элемента вектора всегда равны нулю. Третий и четвертый элементы представляют собой ширину и высоту прямоугольника, содержащего таблицу, соответственно. Все измерения в единицах, указанных Units собственность.

MATLAB определяет размер прямоугольника на основе текущего Data, RowName и ColumnName значения свойств. MATLAB оценивает значения ширины и высоты с использованием ширины столбца и строки. Предполагаемая протяженность может быть больше, чем цифра.

Рассмотрите возможность использования Extent значение свойства при указании значений ширины и высоты Position собственность.

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

MATLAB измеряет все единицы измерения из левого нижнего угла родительского объекта.

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

Порядок, в котором указывается Units и Position свойства имеют следующие эффекты:

Функция обратного вызова редактирования ячейки, заданная как одно из следующих значений:

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

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

Если это свойство указано как дескриптор функции (или массив ячеек, содержащий дескриптор функции), MATLAB передает CellEditData объект, содержащий данные события в качестве второго аргумента функции обратного вызова. Этот объект содержит свойства, описанные в следующей таблице. Эти свойства можно получить в функции обратного вызова с помощью точечной нотации.

Когда пользователь редактирует ячейку таблицы, MATLAB выполняет следующие шаги:

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

Пример: Анализ пользовательского ввода

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

function myui
    f = figure;
    myData = { 'A '  31; 'B'  41; 'C'  5; 'D' 2.6};
    t = uitable('Parent',f,...
                'Position', [25 25 700 200], ...
                'Data',myData,...
                'ColumnEditable', [false true], ...
                'CellEditCallback',@converttonum);
        function converttonum(hObject,callbackdata)
             numval = eval(callbackdata.EditData);
             r = callbackdata.Indices(1)
             c = callbackdata.Indices(2)
             hObject.Data{r,c} = numval; 
        end
end

При выполнении myui, можно изменить значение во втором столбце таблицы. В ответ converttonum выполняется функция обратного вызова. converttonum функция использует eval для оценки вводимых данных. Затем он устанавливает для данных ячейки значение numval. Например, при вводе pi или1+1, converttonum устанавливает значение ячейки таблицы в числовое представление входных данных. Из-за отсутствия ошибки при возврате converttonum функция, недопустимые выражения возвращают ошибку, и новое значение ячейки таблицы становится NaN.

Функция обратного вызова при выборе соты, заданная как одно из следующих значений:

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

Эта функция обратного вызова выполняется при выполнении пользователем одного из следующих действий:

Если это свойство указано как дескриптор функции (или массив ячеек, содержащий дескриптор функции), MATLAB передает CellSelectionChangeData объект, содержащий данные события в качестве второго аргумента функции обратного вызова. Этот объект содержит свойства, перечисленные в следующей таблице.

Кнопка - нажмите функцию обратного вызова, заданную как одно из следующих значений:

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

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

Нажмите на функцию обратного вызова, заданную как одно из следующих значений:

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

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

Если это свойство указано как дескриптор функции (или массив ячеек, содержащий дескриптор функции), MATLAB передает объект, содержащий данные обратного вызова, в качестве второго аргумента функции обратного вызова. Этот объект содержит свойства, описанные в следующей таблице. Эти свойства можно получить в функции обратного вызова с помощью точечной нотации.

Нажатие клавиш-модификаторов влияет на данные обратного вызова следующими способами:

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

Функция обратного вызова освобождения ключа, заданная как одно из следующих значений:

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

Эта функция обратного вызова выполняется при Table объект имеет фокус, и пользователь освобождает ключ.

Если это свойство указано как дескриптор функции (или массив ячеек, содержащий дескриптор функции), MATLAB передает объект, содержащий данные обратного вызова, в качестве второго аргумента функции обратного вызова. Этот объект содержит свойства, описанные в следующей таблице. Эти свойства можно получить в функции обратного вызова с помощью точечной нотации.

Нажатие клавиш-модификаторов влияет на данные обратного вызова следующими способами:

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

Функция создания компонента, заданная как одно из следующих значений:

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

Это свойство определяет функцию обратного вызова, выполняемую при создании компонента MATLAB. MATLAB инициализирует все значения свойств компонентов перед выполнением CreateFcn обратный вызов. Если не указать CreateFcn , то MATLAB выполняет функцию создания по умолчанию.

Используйте gcbo функция в вашей CreateFcn для получения создаваемого объекта компонента.

Установка CreateFcn свойство для существующего объекта-компонента не влияет.

Функция удаления компонента, заданная как одно из следующих значений:

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

DeleteFcn свойство определяет функцию обратного вызова, выполняемую при удалении компонента MATLAB (например, при закрытии окна пользователем). MATLAB выполняет команду DeleteFcn обратный вызов перед уничтожением свойств объекта компонента. Если не указать DeleteFcn , то MATLAB выполняет функцию удаления по умолчанию.

Используйте gcbo функция в вашей DeleteFcn для получения удаляемого объекта компонента.

Прерывание обратного вызова, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Interruptible определяет, можно ли прервать выполняющийся обратный вызов. Существует два состояния обратного вызова:

Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов (если он существует). Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание:

Пример, показывающий, как Interruptible и BusyAction свойства влияют на поведение программы.

Очередь обратного вызова указана как 'queue' (по умолчанию) или 'cancel'. BusyAction определяет, как MATLAB обрабатывает выполнение прерывания обратных вызовов. Существует два состояния обратного вызова:

BusyAction свойство источника обратного вызова прерывания определяет, как MATLAB обрабатывает его выполнение. BusyAction свойство имеет следующие значения:

Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов всегда пытается прервать выполнение обратного вызова. Interruptible свойство объекта, обратный вызов которого выполняется, определяет, разрешено ли прерывание. Если Interruptible имеет значение:

Пример, показывающий, как BusyAction и Interruptible свойства влияют на поведение программы.

Это свойство доступно только для чтения.

Состояние удаления, возвращаемое как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState.

MATLAB устанавливает BeingDeleted свойство для 'on' когда DeleteFcn обратный вызов начинает выполнение. BeingDeleted свойство остается установленным в значение 'on' до тех пор, пока объект-компонент больше не будет существовать.

Проверьте значение BeingDeleted для проверки того, что объект не будет удален перед запросом или изменением.

Возможность стать текущим объектом, указанным как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Родительский объект, указанный как Figure, Panel, ButtonGroup, или Tab объект. Это свойство используется для указания родительского контейнера при создании компонента пользовательского интерфейса или для перемещения существующего компонента пользовательского интерфейса в другой родительский контейнер.

Table потомков, возвращенных в виде пустого массива. Table объекты не имеют потомков. Установка этого свойства не влияет.

Видимость дескриптора объекта, указанного как 'on', 'callback', или 'off'.

Это свойство управляет видимостью дескриптора объекта в списке нижестоящих элементов родительского объекта. Если дескриптор не виден в списке нижестоящих элементов родительского элемента, он не возвращается функциями, получающими дескрипторы путем поиска в иерархии объектов или запроса свойств дескриптора. Эти функции включают get, findobj, gca, gcf, gco, newplot, cla, clf, и close. HandleVisibility свойство также управляет видимостью дескриптора объекта в родительском рисунке CurrentObject собственность. Дескрипторы остаются действительными, даже если они не видны. При наличии доступа к объекту можно задать и получить его свойства и передать его любой функции, которая работает с объектами.

Установка корня графики ShowHiddenHandles свойство для 'on' чтобы сделать видимыми все маркеры, независимо от их HandleVisibility значение. Этот параметр не влияет на их HandleVisibility значения.

Это свойство доступно только для чтения.

Тип графического объекта, возвращаемого как 'uitable'.

Идентификатор объекта, заданный как вектор символа или скаляр строки. Можно указать уникальный Tag для использования в качестве идентификатора объекта. При необходимости доступа к объекту в другом месте кода можно использовать findobj для поиска объекта на основе Tag значение.

Пользовательские данные, указанные как любой массив. Определение UserData может быть полезен для совместного использования данных в приложениях. Дополнительные сведения см. в разделе Совместное использование данных среди обратных вызовов.