15.3.3.17 Свойства uitable

Свойства объектов uitable (см. uitable):

Категории:

Внешний вид | Выполнение обратного вызова | Создание/удаление | Отображение | Взаимодействие с мышью | Идентификация объекта | Положение объекта | Родительский объект/дочерние объекты | Данные таблицы | Работа с таблицей | Внешний вид текста

Внешний вид

backgroundcolor: colorspec, по умолчанию: матрица double размера 2 на 3

Цвет фона таблицы, заданный в виде 3-элементного вектора RGB. Если backgroundcolor содержит несколько строк, цвета циклически повторяются, когда включено свойство "rowstriping".

foregroundcolor: colorspec, по умолчанию: [0 0 0]

Цвет текста данных в этой таблице. См. colorspec.

rowstriping: "off" | {"on"}

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

Выполнение обратного вызова

busyaction: "cancel" | {"queue"}

Определяет, как Octave обрабатывает выполнение свойств обратного вызова этого объекта, если не может прервать выполняющийся в данный момент обратный вызов другого объекта. Это имеет значение только в том случае, если для свойства interruptible объекта с выполняющимся обратным вызовом задано значение "off". Свойство busyaction объекта, вызывающего прерывание, указывает, будет ли прерывающий обратный вызов помещен в очередь ("queue" (по умолчанию)) или отброшен ("cancel"). См. раздел Обратные вызовы.

celleditcallback: строка, по умолчанию: [](0x0)

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

cellselectioncallback: строка, по умолчанию: [](0x0)

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

interruptible: "off" | {"on"}

Указывает, могут ли функции обратного вызова этого объекта прерываться другими обратными вызовами. По умолчанию interruptible имеет значение "on", и обратные вызовы, использующие функции drawnow, figure, waitfor, getframe или pause, в конечном итоге прерываются. См. раздел Обратные вызовы.

keypressfcn: строка, по умолчанию: [](0x0)

Строка, содержащая корректное выражение Octave, которое будет выполняться при каждом нажатии клавиши в этом объекте таблицы.

keyreleasefcn: по умолчанию: [](0x0)

Строка, содержащая корректное выражение Octave, которое будет выполняться при каждом отпускании клавиши в этом объекте таблицы.

Создание/удаление

beingdeleted: {"off"} | "on"

Свойство, указывающее, что функция инициировала удаление объекта. Значение beingdeleted равно true, пока объект не перестанет существовать.

createfcn: строка | дескриптор функции, по умолчанию: [](0x0)

Функция обратного вызова, выполняемая сразу после создания uitable. Функция задается с помощью свойства по умолчанию корневого объекта, например set (groot, "defaultuitablecreatefcn", 'disp ("uitable created!")').

Сведения о написании функций-слушателей графических объектов см. в разделе Обратные вызовы.

deletefcn: строка | дескриптор функции, по умолчанию: [](0x0)

Функция обратного вызова, выполняемая непосредственно перед удалением uitable.

Сведения о написании функций-слушателей графических объектов см. в разделе Обратные вызовы.

Отображение

clipping: "off" | {"on"}

Если clipping имеет значение "on", uitable обрезается по границам родительских осей.

visible: "off" | {"on"}

Если visible имеет значение "off", uitable не отображается на экране.

Взаимодействие с мышью

buttondownfcn: строка | дескриптор функции, по умолчанию: [](0x0)

Сведения о написании функций-слушателей графических объектов см. в разделе Обратные вызовы.

contextmenu: графический дескриптор, по умолчанию: [](0x0)

Графический дескриптор объекта uicontextmenu, в данный момент связанного с этим объектом uitable.

hittest: "off" | {"on"}

Указывает, обрабатывает ли uitable события мыши или передает их родительским объектам. Если параметр включен, объект может реагировать на щелчки мышью, вычисляя "buttondownfcn", отображая uicontextmenu и, в конечном итоге, становясь корневым "currentobject". Это свойство имеет значение только тогда, когда объект может принимать щелчки мышью; это определяется свойством "pickableparts". См. свойство pickableparts.

pickableparts: "all" | "none" | {"visible"}

Указывает, будет ли uitable принимать щелчки мышью. По умолчанию pickableparts имеет значение "visible", и на щелчки мышью могут реагировать только видимые части uitable или его дочерних объектов. Если pickableparts имеет значение "all", на щелчки мышью могут реагировать как видимые, так и невидимые части (или дочерние объекты). Если pickableparts имеет значение "none", щелчки мышью по объекту игнорируются и передаются объектам, расположенным под ним. Если объект настроен на прием щелчков мышью, способ их обработки определяется свойством "hittest". См. свойство hittest.

selected: {"off"} | "on"

Свойство указывает, выбран ли этот объект uitable.

selectionhighlight: "off" | {"on"}

Если selectionhighlight имеет значение "on", состояние выбора uitable визуально выделяется.

tooltipstring: строка, по умолчанию: ""

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

Идентификация объекта

tag: строка, по умолчанию: ""

Заданная пользователем строка для пометки графического объекта.

type (только для чтения): строка

Имя класса графического объекта. type всегда равно "uitable".

userdata: любые данные Octave, по умолчанию: [](0x0)

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

Положение объекта

extent (только для чтения): вектор из четырех элементов

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

position: вектор из четырех элементов, по умолчанию: [20 20 300 300]

Положение и размер таблицы. Четыре элемента вектора задают координаты левого нижнего угла, а также ширину и высоту фигуры. См. свойство units.

units: "centimeters" | "characters" | "inches" | "normalized" | {"pixels"} | "points"

Единица измерения, используемая для интерпретации свойства "position".

Родительский объект/дочерние объекты

children (только для чтения): вектор графических дескрипторов, по умолчанию: [](0x1)

Графические дескрипторы дочерних объектов uitable.

handlevisibility: "callback" | "off" | {"on"}

Если handlevisibility имеет значение "off", дескриптор uitable не отображается в свойстве "children" родительского объекта.

parent: графический дескриптор

Дескриптор родительского графического объекта.

Данные таблицы

columnformat: по умолчанию: {}(0x0)

Формат отображения числовых данных в каждом столбце. Допустимые форматы: "char", "logical", "numeric" или допустимый параметр формата функции format.

columnname: по умолчанию: "numbered"

Имена столбцов, заданные либо как "numbered", либо как строковый вектор ячеек размером 1 x N, содержащий имена для заголовков столбцов.

columnwidth: по умолчанию: "auto"

Параметр, задающий ширину каждого столбца. Допустимые значения: "auto", "fit", равномерно распределенные кратные значения, заданные как "1x", "2x" и т. д., либо вектор ячеек размером 1 x N, каждый элемент которого соответствует одному из N столбцов таблицы и содержит любое из перечисленных выше значений или фиксированную ширину в пикселях.

data: матрица, по умолчанию: [](0x0)

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

rowname: по умолчанию: "numbered"

Имена строк, заданные либо как "numbered", либо как строковый вектор ячеек размером N x 1, содержащий имена для заголовков строк.

Работа с таблицей

columneditable: логический вектор-строка, по умолчанию: [](0x0)

Логический индикатор, показывающий, доступны ли столбцы для редактирования. Это либо вектор размером 1 x N из логических значений, где true или false указывает, доступен ли соответствующий столбец для редактирования, либо пустой логический массив, означающий, что ни один столбец недоступен для редактирования.

enable: "off" | {"on"}

Задает, активен ли этот объект таблицы или отображается серым цветом.

rearrangeablecolumns: {"off"} | "on"

Указывает, разрешено ли перемещать столбцы щелчком и перетаскиванием их заголовков.

Внешний вид текста

fontangle: "italic" | {"normal"}

Задает, будет ли шрифт курсивным или обычным.

fontname: строка, по умолчанию: "*"

Название шрифта, используемого для отображения текста. При задании этого свойства механизм отображения текста ищет в системе соответствующий шрифт. Если шрифт не найден, текст отображается шрифтом без засечек, используемым по умолчанию (таким же, как значение "*" по умолчанию).

Примечание по программированию: в системах, изначально не использующих FontConfig (во всех системах, кроме Linux), кэш шрифтов создается при установке Octave. После установки новых шрифтов необходимо вручную запустить system ("fc-cache -fv").

fontsize: скаляр, по умолчанию: 10

Размер шрифта, используемого для отображения текста. См. свойство fontunits.

fontunits: "centimeters" | "inches" | "normalized" | "pixels" | {"points"}

Единицы измерения, используемые для интерпретации свойства "fontsize".

fontweight: "bold" | {"normal"}

Задает вариант базового шрифта, используемого для отображения текста.