15.3.3.16 Свойства Uicontrol

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

Категории:

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

Внешний вид

backgroundcolor: colorspec, по умолчанию [0.9400 0.9400 0.9400]

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

cdata: массив, по умолчанию [](0x0)

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

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

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

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

foregroundcolor: colorspec, по умолчанию [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: строка, по умолчанию [](0x0)

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

interruptible: "off" | {"on"}

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

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

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

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

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

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

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

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

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

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

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

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

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

sliderstep: вектор из двух элементов, по умолчанию [0.010000 0.100000]

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

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

Числовое значение, связанное с текущим состоянием объекта управления; смысл значения зависит от «стиля» объекта управления.

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

beingdeleted: {"off"} | "on"

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

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

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

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

deletefcn: строка | дескриптор функции, по умолчанию [](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]

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

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.