15.3.3.16 Свойства Uicontrol ¶

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

Категории: ¶

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

Внешний вид ¶

backgroundcolor: colorspec, def. [0.9400 0.9400 0.9400] ¶

Цвет фона этого объекта управления.

cdata: массив, def. [](0x0) ¶

Данные изображения, используемые для представления объекта управления, хранятся в виде RGB-массива M x N x 3.

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

Размер строковой строки, связанной с uicontrol, возвращается в виде [0 0 width height] (два первых элемента всегда равны нулю).

Для многострочных строк возвращаемые значения width и height указывают размер прямоугольника, охватывающего все строки.

foregroundcolor: colorspec, def. [0 0 0] ¶

Цвет текста для этого объекта управления. См. colorspec.

style: "checkbox" | "edit" | "frame" | "listbox" | "popupmenu" | {"pushbutton"} | "radiobutton" | "slider" | "text" | "togglebutton" ¶

Тип созданного объекта управления. Для получения полного описания доступных стилей управления, см. "uicontrol" функцию

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

busyaction: "cancel" | {"queue"} ¶

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

callback: строка, def. [](0x0) ¶

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

interruptible: "off" | {"on"} ¶

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

keypressfcn: строка | дескриптор функции, def. [](0x0) ¶

Функция, которая выполняется при нажатии клавиши и объект управления имеет фокус.

Дополнительную информацию о написании функций слушателей графики см. в разделе Обратные вызовы.

Параметры управления ¶

enable: "inactive" | "off" | {"on"} ¶

Устанавливает, активен ли этот объект управления или он затенён.

listboxtop: скаляр, def. 1 ¶

Индекс строкового параметра, который будет отображаться в верхней части элементов управления "listbox".

max: скаляр, def. 1 ¶

Максимальное значение управления, эффект которого на управление зависит от типа управления. Для элементов управления "checkbox", "togglebutton", и "radiobutton", значение "max" назначается свойству "value" при выборе объекта управления. Для элементов управления "slider", "max" определяет максимальное значение ползунка. Для элементов управления "edit" и "listbox", если Max - Min > 1, то элемент управления будет допускать ввод нескольких строк или выбор нескольких элементов списка, соответственно.

min: скаляр, def. 0 ¶

Минимальное значение управления, эффект которого на управление зависит от типа управления. Для элементов управления "checkbox", "togglebutton", и "radiobutton", значение "min" назначается свойству "value" при отсутствии выбора объекта управления. Для элементов управления "slider", "min" определяет минимальное значение ползунка. Для элементов управления "edit" и "listbox", если Max - Min > 1, то элемент управления будет допускать ввод нескольких строк или выбор нескольких элементов списка, соответственно.

sliderstep: двухэлементный вектор, def. [0.010000 0.100000] ¶

Дробный шаг, измеренный относительно диапазона Min - Max ползунка, на который перемещается ползунок при нажатии пользователем на объект. "sliderstep" задается в виде двухэлементного вектора, состоящего из [minor major], где "minor" - шаг для нажатия на стрелки ползунка, а "major" - шаг для нажатия внутри ползунка.

value: скаляр, def. 0 ¶

Числовое значение, связанное с текущим состоянием объекта управления, значение которого зависит от "стиля" объекта управления.

Создание/Удаление ¶

beingdeleted: {"off"} | "on" ¶

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

createfcn: строка | дескриптор функции, def. [](0x0) ¶

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

Дополнительную информацию о написании функций слушателей графики см. в разделе Обратные вызовы.

deletefcn: строка | дескриптор функции, def. [](0x0) ¶

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

Дополнительную информацию о написании функций слушателей графики см. в разделе Обратные вызовы.

Отображение ¶

clipping: "off" | {"on"} ¶

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

visible: "off" | {"on"} ¶

Если visible равно "off", uicontrol не отображается на экране.

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

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

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

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

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

hittest: "off" | {"on"} ¶

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

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

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

selected: {"off"} | "on" ¶

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

selectionhighlight: "off" | {"on"} ¶

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

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

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

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

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

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

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

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

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

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

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

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

Размер объекта управления, представленный вектором из четырех элементов [левый край, нижний край, ширина, высота].

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

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

Родитель/Потомки ¶

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

Дескрипторы графических объектов потомков uicontrol.

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

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

parent: дескриптор графического объекта ¶

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

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

fontangle: "italic" | {"normal"} ¶

Управление стилем шрифта (курсив или обычный).

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

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

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

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

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

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

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

fontweight: "bold" | {"normal"} ¶

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

horizontalalignment: {"center"} | "left" | "right" ¶

Устанавливает выравнивание текста по горизонтали внутри объекта uicontrol.

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

Текст, отображаемый вместе с объектом управления.

verticalalignment: "bottom" | {"middle"} | "top" ¶

Устанавливает выравнивание текста по вертикали внутри объекта uicontrol.