15.3.3.11 Свойства света

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

beingdeleted: {"off"} | "on"

busyaction: "cancel" | {"queue"}

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

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

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

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

children не используется.

clipping: "off" | {"on"}

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

color: цветовое задание, по умолчанию [1 1 1]

Цвет источника света. См. colorspec.

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

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

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

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

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

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

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

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

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

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

hittest: "off" | {"on"}

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

interruptible: "off" | {"on"}

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

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

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

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

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

position: по умолчанию [1 0 1]

Положение источника света.

selected: {"off"} | "on"

selectionhighlight: "off" | {"on"}

style: {"infinite"} | "local"

Эта строка определяет, исходит ли свет от источника света на бесконечном расстоянии ("infinite") или от локального точечного источника ("local").

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

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

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

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

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

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

visible: "off" | {"on"}

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