Табличные данные, заданные как числовой массив, логический массив или массив ячеек. Данные таблицы могут быть любым числовым типом 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-by- n массив ячеек.

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

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

Выбор Auto Width в редакторе свойств таблицы имеет тот же эффект, что и установка 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-by- 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. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

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

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

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

Пример: 'Arial'

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

Пример: 12

Пример: 12.5

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

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

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

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

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

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

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

Значение Enable свойство и тип кнопки нажатия кнопки определять, как UI реагирует.

Подсказка, заданная как вектор символов, строковый скаляр или категориальный массив. Используйте это свойство для отображения сообщения при наведении указателя мыши на компонент во время выполнения. Подсказка не отображается, когда компонент отключен. Если вы задаете это свойство как категориальный массив, 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. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа 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 выполняется функция обратного вызова. The converttonum функция использует eval функция, чтобы вычислить ваш вход. Затем он устанавливает камере данные в значение numval. Для примера, если вы вводите pi или 1+1, а converttonum функция устанавливает значение камеры таблицы в числовое представление входа. Потому что нет никакой ошибки при проверке converttonum функция, недопустимые выражения возвращают ошибку, и новое значение камеры таблицы становится NaN.

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

Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».

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

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

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

Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».

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

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

Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».

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

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

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

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

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

Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».

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

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

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

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

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

Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».

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

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

Установка CreateFcn свойство существующего объекта компонента не имеет эффекта.

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

Для получения дополнительной информации об указании значения свойства коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Как задать значения свойств коллбэка».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пользовательские данные, заданные как любой массив. Определение UserData может быть полезным для обмена данными в приложениях См. Раздел «Обмен данными между коллбэками» для получения дополнительной информации.