---

15.3.3.16 控件属性¶

的属性uicontrol对象(详见uicontrol):

类别:¶

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

外貌¶

backgroundcolor:颜色规格,定义。[0.9400 0.9400 0.9400]¶

此控件对象的背景的颜色值。

cdata:数组,def。[](0x0)¶

用于表示控制对象的图像数据,存储为M x N x 3 RGB数组。

extent(只读):四元素向量¶

与表单中返回的uicontrol相关联的文本字符串的大小[0 0 width height](前两个元素始终为零)。

对于多行字符串,返回width和height指示包围所有线条的矩形的大小。

foregroundcolor:颜色规格,定义。[0 0 0]¶

此控件对象的文本的颜色值。详见颜色规格.

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

创建的控制对象的类型。有关可用控件样式的完整描述,详见"uicontrol"函数 

回调执行¶

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

定义Octave在无法中断另一个对象正在执行的回调时如何处理此对象回调属性的执行。只有当当前执行的回调对象具有interruptible属性设置为"off"这个busyaction中断回调对象的属性指示中断回调是否排队("queue"(默认))或已放弃("cancel").详见回调部分 .

callback:字符串,def。[](0x0)¶

一个从有效的Octave表达式组成的字符串,该表达式将在激活此控件时执行。

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

指定此对象的回调函数是否会被其他回调中断。默认情况下interruptible是"on"以及使用的回调drawnow,figure,waitfor,getframe或pause函数最终被中断。详见回调部分 .

keypressfcn:string |函数句柄,def。[](0x0)¶

当按下键并且控制对象具有焦点时执行的函数。

有关如何编写图形监听器函数的信息,详见回调部分 .

控件参数¶

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

设置此控制对象是活动的还是灰显的。

listboxtop:标量,def。1¶

将出现在“listbox”控件顶部的字符串参数的索引

max:标量,def。1¶

最大控制值,其对控制的影响取决于控制类型。对于"checkbox","togglebutton"和"radiobutton"控件"max"值被赋值给"value"属性。对于"slider"控制,"max"定义滑块的最大值。对于"edit"和"listbox"控件,如果Max - Min > 1,则控件将分别允许多个行条目或列表项选择。

min:标量,def。0¶

最小控制值,其对控制的影响取决于控制类型。对于"checkbox","togglebutton"和"radiobutton"控件"min"值被赋值给"value"属性。对于"slider"控制,"min"定义滑块的最小值。对于"edit"和"listbox"控件,如果Max - Min > 1,则控件将分别允许多个行条目或列表项选择。

sliderstep:双元素向量,def。[0.010000 0.100000]¶

分数步长,相对于Min - Max滑块的跨度,当用户单击对象时滑块移动。"sliderstep"被指定为从以下组成的双元素向量[minor major]这里的"minor"是用于单击滑块箭头的步长,以及"major"是在滑块中单击的步长。

value:标量,def。0¶

与控制对象的当前状态相关联的数值,其含义取决于控制对象的“样式”。

创建/删除¶

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

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

createfcn:string |函数句柄,def。[](0x0)¶

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

有关如何编写图形监听器函数的信息,详见回调部分 .

deletefcn:string |函数句柄,def。[](0x0)¶

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

有关如何编写图形监听器函数的信息,详见回调部分 .

显示¶

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

如果clipping是"on",uicontrol在其父轴限制中被剪裁。

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

如果visible是"off",uicontrol不会在屏幕上呈现。

鼠标交互¶

buttondownfcn:string |函数句柄,def。[](0x0)¶

有关如何编写图形监听器函数的信息,详见回调部分 .

contextmenu:图形句柄,def。[](0x0)¶

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

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

指定uicontrol是处理鼠标事件还是将其传递给对象的祖先。启用后,对象可以通过评估"buttondownfcn",显示uicontextmenu,并最终成为根"currentobject"。只有当对象可以接受从"pickableparts"属性详见pickableparts属性 .

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

指定uicontrol是否接受鼠标单击。默认情况下,pickableparts是"visible"并且只有uicontrol的可见部分或其子项可以对鼠标单击做出反应。当pickableparts是"all"可见和不可见部分(或子部分)都可能对鼠标点击做出反应。当pickableparts是"none"鼠标在该对象上的点击将被忽略,并传输到该对象下面的任何对象。当对象配置为接受鼠标单击时"hittest"属性将决定如何处理它们。详见hittest属性 .

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

属性指示是否选择此uicontrol。

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

如果selectionhighlight是"on",则uicontrol的选择状态在视觉上突出显示。

tooltipstring:字符串,def。""¶

鼠标指针悬停在控件对象上时出现在工具提示中的文本字符串。

对象标识¶

tag:字符串,def。""¶

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

type(只读):字符串¶

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

userdata:任何Octave数据,def。[](0x0)¶

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

对象位置¶

position:四元向量,def。[0 0 80 30]¶

控制对象的大小表示为四元素向量[左、下、宽、高]。

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

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

父级对象/子级对象¶

children(只读):图形控制柄的向量,def。[](0x1)¶

uicontrol子项的图形句柄。

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

如果handlevisibility是"off",uicontrol的句柄在其父项中不可见"children"属性

parent:图形句柄¶

父图形对象的句柄。

文本外观¶

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

控制字体是斜体还是普通字体。

fontname:字符串,def。"*"¶

用于文本呈现的字体的名称。设置此属性时,文本呈现引擎将在系统中搜索匹配的字体。如果没有找到,则使用默认的无衬线字体(与默认字体相同"*"价值

编程注意事项:在本机不使用FontConfig的系统上(除了Linux以外的所有系统),字体缓存是在安装Octave时构建的。你需要跑步system ("fc-cache -fv")安装新字体后手动操作。

fontsize:标量,def。10¶

用于文本呈现的字体大小。详见fontunits属性.

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

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

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

控制用于文本呈现的基本字体的变体。

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

指定uicontrol对象中文本的水平对齐方式。

string:字符串,def。""¶

与控件对象一起出现的文本。

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

指定uicontrol对象中文本的垂直位置。