15.3.3.15 Свойства uicontrol

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

backgroundcolor: def. [0.9400 0.9400 0.9400]

beingdeleted: {"off"} | "on"

busyaction: "cancel" | {"queue"}

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

buttondownfcn: строка | обработчик функций, def. [](0x0)

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

callback: def. [](0x0)

cdata: def. [](0x0)

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

Графические дескрипторы дочерних элементов uicontrol.

clipping: "off" | {"on"}

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

createfcn: строка | обработчик функций, def. [](0x0)

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

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

deletefcn: строка | обработчик функций, def. [](0x0)

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

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

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

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

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

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

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

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

fontname: строка, def. "*"

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

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

fontsize: скаляр, def. 10

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

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

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

fontweight: "bold" | {"normal"}

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

foregroundcolor: def. [0 0 0]

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

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

hittest: "off" | {"on"}

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

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

interruptible: "off" | {"on"}

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

keypressfcn: def. [](0x0)

listboxtop: def. 1

max: def. 1

min: def. 0

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

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

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

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

position: def. [0 0 80 30]

selected: {"off"} | "on"

selectionhighlight: "off" | {"on"}

sliderstep: def. [0.010000 0.100000]

string: def. ""

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

tag: строка, def. ""

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

tooltipstring: def. ""

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

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

uicontextmenu: графический дескриптор, def. [](0x0)

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

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

userdata: Любые данные Octave, def. [](0x0)

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

value: def. 0

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

visible: "off" | {"on"}

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