---

15.3.3.6 文本对象属性¶

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

类别：¶

回调执行 | 创建/删除 | 显示 | 鼠标交互 | 对象标识 | 对象位置 | 父级/子级 | 文本外观 | 文本框外观

回调执行¶

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) ¶

文本创建后立即执行的回调函数。通过使用根对象的默认属性设置此函数，例如：set (groot, "defaulttextcreatefcn", 'disp ("text created!")')。

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

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

在文本被删除之前立即执行的回调函数。

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

显示¶

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

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

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

如果 visible 为 "off"，则文本不会在屏幕上渲染。

鼠标交互¶

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

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

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

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

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

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

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

指定文本是否接受鼠标单击。默认情况下 pickableparts 为 "visible"，只有文本的可见部分或其子对象可以对鼠标单击做出反应。当 pickableparts 为 "all" 时，可见和不可见部分（或子对象）都可能对鼠标单击做出反应。当 pickableparts 为 "none" 时，文本无法响应鼠标单击。"hittest" 属性对鼠标单击的处理有最终决定权。

对象标识¶

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

与 buttondownfcn 相同。

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

如果 hittestarea 为 "on"，则文本对象的整个背景区域（而不仅仅是文本字形）用于鼠标单击命中测试。

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

与上面的 interruptible 相同。

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

控制当对象被选中时是否显示视觉突出显示效果。

tag: string, def. "" ¶

表示对象标签的用户定义字符串。

type: string, def. "text" ¶

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

userdata: Any data type, def. [](0x0) ¶

用户想要关联到此对象的任意数据。

对象位置¶

position: 3-element vector, def. [0, 0, 0] ¶

表示文本对象位置的向量。默认值 [0, 0, 0] 中，前两个元素给出 x 和 y 坐标，第三个元素给出 z 坐标。根据 "units" 属性的不同，坐标可以是数据坐标或归一化坐标。

positionmode: "data" | {"mannual"} ¶

此属性未使用。

rotation: scalar, def. 0 ¶

文本对象的角度（以度为单位）逆时针旋转。

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

用于解释 "position" 属性的单位。

父级/子级¶

children: vector of graphics handles, def. [](0x1) ¶

作为文本对象子级的图形对象的句柄向量。文本对象的子级可能包括其他文本对象、线条、补丁或图像。

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

文本对象的句柄。只读属性。

parent: graphics handle ¶

文本对象的父级句柄。文本对象的父级通常是坐标轴对象。

文本外观¶

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

文本的颜色。请参见 颜色规格。

displayname: string, def. "" ¶

在图形图例中使用的文本。

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

控制用于文本渲染的基础字体的倾斜变体。

fontname: string, def. "*" ¶

用于文本渲染的字体名称。当设置为 "*" 时，将使用默认字体。

fontsize: scalar, def. 10 ¶

用于文本渲染的字体大小。请参见 fontunits 属性。

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

控制在渲染文本时是否使用抗锯齿。

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

用于解释 "fontsize" 属性的单位。

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

控制用于文本渲染的基础字体的粗细变体。

interpreter: "latex" | "none" | {"tex"} ¶

控制 "string" 属性的解释方式。请参见 "interpreter" 属性的使用。

string: string, def. "" ¶

文本对象的字符串内容。

文本框外观¶

backgroundcolor: colorspec, def. "none" ¶

背景区域的颜色。请参见 颜色规格。

edgecolor: colorspec, def. "none" ¶

背景区域轮廓的颜色。请参见 颜色规格。

linestyle: {"-"} | "--" | "-." | ":" | "none" ¶

文本框轮廓的样式。请参见 线条样式。

linewidth: scalar, def. 0.5000 ¶

文本框轮廓的宽度。

margin: scalar, def. 3 ¶

背景区域边框与文本之间的边距。该值当前被解释为像素，与 "fontunits" 属性无关。