---

15.3.3.17 表格对象属性¶

uitable 对象的属性（另请参阅 uitable）：

类别：¶

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

外观¶

backgroundcolor: colorspec, def. 2-by-3 double ¶

表格的背景颜色，指定为 3 元素 RGB 向量。如果 backgroundcolor 有多行，且 "rowstriping" 属性 开启，则颜色会循环重复使用。

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

此表中数据文本的颜色。另请参阅 颜色规格。

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

用于指示表格背景颜色是否对不同的行使用交替颜色的设置。颜色以重复模式从 "backgroundcolor" 属性 中选取。

回调执行¶

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

定义当 Octave 无法中断另一个对象正在执行的回调时，如何处理此对象回调属性的执行。这仅在当前正在执行回调的对象的 interruptible 属性设置为 "off" 时相关。中断回调对象的 busyaction 属性指示中断回调是排队（"queue"（默认））还是丢弃（"cancel"）。另请参阅 回调部分。

celleditcallback: string, def. [](0x0) ¶

一个由有效 Octave 表达式组成的字符串，每当表格单元格被编辑时执行。

cellselectioncallback: string, def. [](0x0) ¶

一个由有效 Octave 表达式组成的字符串，每当表格单元格被选中时执行。

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

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

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

当表格对象获得焦点时按下按键所执行的回调函数。函数的第一个参数是调用该回调的表格对象的句柄。第二个参数包含一个事件结构体，具有以下成员：

Character:

按键的 ASCII 值

Modifier:

一个元胞数组，包含表示按键时按下的修饰键的字符串。

Key:

按键的小写描述

Source:

执行回调函数的图形对象的句柄。

EventName:

"KeyPress"

关于如何编写图形监听器函数的信息，请参阅 回调部分。

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

当表格对象获得焦点时释放按键所执行的回调函数。函数的第一个参数是调用该回调的表格对象的句柄。第二个参数包含一个事件结构体，具有以下成员：

Character:

按键的 ASCII 值

Modifier:

一个元胞数组，包含表示按键时按下的修饰键的字符串。

Key:

按键的小写描述

Source:

执行回调函数的图形对象的句柄。

EventName:

"KeyRelease"

关于如何编写图形监听器函数的信息，请参阅 回调部分。

创建/删除¶

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

指示某个函数已启动删除该对象的属性。beingdeleted 设置为 true，直到对象不再存在为止。

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

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

关于如何编写图形监听器函数的信息，请参阅 回调部分。

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

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

关于如何编写图形监听器函数的信息，请参阅 回调部分。

显示¶

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

如果 clipping 为 "on"，则 uitable 在其父轴限制内被裁剪。

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

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

鼠标交互¶

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

关于如何编写图形监听器函数的信息，请参阅 回调部分。

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

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

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

指定 uitable 是处理鼠标事件还是将其传递给对象的祖先。启用时，对象可以通过执行 "buttondownfcn"、显示 uicontextmenu 并最终成为根对象的 "currentobject" 来响应鼠标点击。此属性仅在对象可以接受鼠标点击时相关，这由 "pickableparts" 属性决定。请参阅 pickableparts 属性。

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

指定 uitable 是否接受鼠标点击。默认情况下 pickableparts 为 "visible"，只有 uitable 的可见部分或其子对象可以对鼠标点击做出反应。当 pickableparts 为 "all" 时，可见和不可见部分（或子对象）都可能对鼠标点击做出反应。当 pickableparts 为 "none" 时，对象上的鼠标点击被忽略并传递给下面的任何对象。当对象配置为接受鼠标点击时，"hittest" 属性将决定如何处理它们。请参阅 hittest 属性。

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

指示此 uitable 是否被选中的属性。

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

如果 selectionhighlight 为 "on"，则 uitable 的选中状态会以视觉方式高亮显示。

tooltipstring: string, def. "" ¶

当鼠标指针悬停在表格对象上时，在工具提示中显示的文本字符串。

对象标识¶

tag: string, def. "" ¶

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

type (read-only): string ¶

图形对象的类名。type 总是 "uitable"。

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

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

对象位置¶

extent (read-only): four-element vector ¶

表示表格大小的 4 元素向量。数组的前两个元素始终为零，第三和第四个元素包含表格的高度和宽度。

position: four-element vector, def. [20 20 300 300] ¶

表格的位置和大小。向量的四个元素分别是左下角的 x、y 坐标以及宽度和高度。另请参阅 units 属性。

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

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

父级对象/子级对象¶

children (read-only): vector of graphics handles, def. [](0x0) ¶

uitable 子对象的图形句柄向量。

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

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

parent: graphics handle ¶

父图形对象的句柄。

表数据¶

columnformat: def. {}(0x0) ¶

每列数值数据的显示格式。有效格式包括 "char"、"logical"、"numeric"，或 format 函数 中的有效格式设置。

columnname: def. "numbered" ¶

列名指定为 "numbered" 或一个 1×N 元胞字符串向量，包含用于每一列标题的名称。

columnwidth: def. "auto" ¶

确定每列宽度的设置，有效选项包括："auto"、"fit"、指定为 "1x"、"2x" 等的均分倍数，或一个 1×N 元胞向量，其中每个元素对应 N 个表列之一，并包含上述字符串选项之一或以像素为单位指定的固定宽度。"1x" 属性尚未实现。

data: matrix, def. [](0x0) ¶

表中包含的数据，指定为二维数值数组、逻辑数组或元胞数组。

rowname: def. "numbered" ¶

行名指定为 "numbered" 或一个 N×1 元胞字符串向量，包含用于每一行标题的名称。

表操作¶

columneditable: logical row vector, def. [](0x0) ¶

指示列是否可编辑的逻辑指示符。由一个 1×N 的逻辑值向量组成，其中 true 表示对应列可编辑，false 表示不可编辑；或者一个空逻辑数组，表示没有列可编辑。

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

设置此表格对象是激活状态还是灰色禁用状态。

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

指示是否可以通过单击并拖动列标题来移动列。

文本外观¶

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

控制字体是斜体还是正常体。

fontname: string, def. "*" ¶

用于文本渲染的字体名称。设置此属性时，文本渲染引擎将在系统中搜索匹配的字体。如果未找到，则使用默认的无衬线字体（与默认的 "*" 值相同）。

编程说明：在本机不支持 FontConfig 的系统上（除 Linux 外的所有系统），字体缓存在安装 Octave 时构建。安装新字体后，您需要手动运行 system ("fc-cache -fv")。

fontsize: scalar, def. 10 ¶

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

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

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

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

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