---

15.3.3.11 光源属性¶

light 对象的属性（参见 light）：

分类：¶

回调执行 | 创建/删除 | 显示 | 照明 | 鼠标交互 | 对象标识 | 父/子对象

回调执行¶

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

定义当 Octave 无法中断另一个对象正在执行的回调时，如何处理此对象回调属性的执行。这仅在当前正在执行回调的对象的 interruptible 属性设置为 "off" 时才有意义。中断回调对象的 busyaction 属性指示该中断回调是排队等待（"queue"，默认值）还是被丢弃（"cancel"）。 参见 回调相关章节。

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

指定此对象的回调函数是否可以被其他回调中断。默认情况下 interruptible 为 "on"，使用 drawnow、figure、waitfor、getframe 或 pause 函数的回调最终会被中断。 参见 回调相关章节。

创建/删除¶

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

指示已有函数启动对象删除的属性。在对象消亡之前，beingdeleted 一直为 true。

createfcn: string | function handle, def. [](0x0) ¶

在 light 对象创建后立即执行的回调函数。通过设置根对象的默认属性来设定该函数，例如 set (groot, "defaultlightcreatefcn", 'disp ("light created!")')。

有关如何编写图形监听器函数的信息，参见 回调相关章节。

deletefcn: string | function handle, def. [](0x0) ¶

在 light 对象被删除之前立即执行的回调函数。

有关如何编写图形监听器函数的信息，参见 回调相关章节。

显示¶

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

如果 clipping 为 "on"，则灯光在其父坐标轴范围内被裁剪。

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

如果 visible 为 "off"，则灯光不在屏幕上渲染。

照明¶

color: 颜色规格（colorspec），默认值 [1 1 1] ¶

光源的颜色。参见 颜色规格（colorspec）。

position: 默认值 [1 0 1] ¶

光源的位置。

style: {"infinite"} | "local" ¶

此字符串定义光照是从无穷远光源发出的（"infinite"）还是从本地点光源发出的（"local"）。

鼠标交互¶

buttondownfcn: string | function handle, def. [](0x0) ¶

有关如何编写图形监听器函数的信息，参见 回调相关章节。

contextmenu: graphics handle, def. [](0x0) ¶

当前与此 light 对象关联的 uicontextmenu 对象的图形句柄。

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

指定此 light 对象是处理鼠标事件，还是将事件传递给其祖先对象。启用时，该对象可以通过执行 "buttondownfcn"、显示 uicontextmenu 以及最终成为根对象的 "currentobject" 来响应鼠标单击。此属性仅在对象可以通过 "pickableparts" 属性接受鼠标单击时才有意义。 参见 pickableparts 属性。

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

指定 light 对象是否接受鼠标单击。默认情况下 pickableparts 为 "visible"，只有 light 对象或其子对象的可见部分会对鼠标单击做出反应。当 pickableparts 为 "all" 时，可见和不可见部分（或子对象）都可能对鼠标单击做出反应。当 pickableparts 为 "none" 时，对象上的鼠标单击被忽略并传递给该对象下方的其他对象。当对象配置为接受鼠标单击时，"hittest" 属性将决定如何处理单击事件。 参见 hittest 属性。

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

指示此 light 对象是否被选中的属性。

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

如果 selectionhighlight 为 "on"，则 light 对象的选择状态会在视觉上高亮显示。

对象标识¶

tag: string, def. "" ¶

用于标记图形对象的用户自定义字符串。

type (read-only): string ¶

图形对象的类名。type 始终为 "light"。

userdata: 任意 Octave 数据，默认值 [](0x0) ¶

要与图形对象关联的用户自定义数据。

父/子对象¶

children (read-only): graphics handles 向量，默认值 [](0x0) ¶

light 对象没有子对象。children 未被使用。

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

如果 handlevisibility 为 "off"，则 light 对象的句柄在其父对象的 "children" 属性中不可见。

parent: graphics handle ¶

父图形对象的句柄。