15.3.3.2图形属性

figure对象的属性(详见图形):

类别:

外观 | 回调执行 | 创建/删除 | 显示 | 键盘交互 | 鼠标交互 | 对象标识 | 对象位置 | 父级对象/子级对象 | 打印/保存 | 未使用 

外观

广告
alphamap: def. 64-by-1 double

图形对象尚未实现透明度。alphamap未使用。

广告
color: colorspec, def. [1 1 1]

图形背景的颜色。详见颜色规格.

广告
colormap: n×3 matrix, def. 256-by-3 double

包含当前轴的RGB颜色图的矩阵。

广告
graphicssmoothing: "off" | {"on"}

使用平滑技术可以减少锯齿状线条的出现。

广告
name: string, def. ""

要显示在图形标题栏中的名称。名称显示在从numbertitle属性确定的任何标题的右侧

广告
numbertitle: "off" | {"on"}

显示"Figure"和图形标题栏中的数字图形句柄值。

广告

回调执行

广告
busyaction: "cancel" | {"queue"}

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

广告
interruptible: "off" | {"on"}

指定此对象的回调函数是否会被其他回调中断。默认情况下interruptible"on",然后在使用drawnow, figure, waitfor, getframepause函数之后被中断。详见回调部分 .

广告

创建/删除

广告
beingdeleted: {"off"} | "on"

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

广告
closerequestfcn: string | function handle, def. "closereq"

删除图形对象时执行的函数。详见closereq函数.

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

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

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

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

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

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

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

广告

显示

广告
visible: "off" | {"on"}

如果visible"off",该图形不会在屏幕上呈现。

广告
windowstate: "fullscreen" | "maximized" | "minimized" | {"normal"}

图形对象的窗口状态调整尚未实现。windowstate未使用。

广告
windowstyle: "docked" | "modal" | {"normal"}

图形的窗口样式。以下值之一:

normal

该窗口可以被取消选择,并且其他窗口可以被显示在该窗口的前面。

广告
modal

窗口将保持在所有正常数字之上,直到它被取消。

广告
docked

未实现。

广告

更改可见图形对象的模式可能会导致图形对象关闭和重新打开。

广告

键盘交互

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

当图形具有焦点时发生击键事件时执行的回调函数。可以使用函数的第二个参数“evt”检索实际按下的键。

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

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

具有keypressfcn,键盘回调函数。这些回调函数分别在按下/释放某个键时调用。这些函数是用两个输入参数调用的。第一个参数保存调用图形的句柄。第二个参数保存具有以下成员的事件结构体:

Character:

密钥的ASCII值

广告
Key:

密钥的小写值

广告
Modifier:

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

广告

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

广告
windowkeypressfcn: string | function handle, def. [](0x0)

当按下某个键并且图形具有焦点时执行的函数。

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

广告
windowkeyreleasefcn: string | function handle, def. [](0x0)

当释放键并且图形具有焦点时执行的函数。

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

广告

鼠标交互

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

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

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

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

广告
currentpoint (read-only): two-element vector, def. [0; 0]

一个1乘2的向量,用于保存鼠标事件发生时鼠标指针所在点的坐标。X和Y坐标的单位从图形定义units属性,它们的原点是打印区域的左下角。

设置的事件currentpoint

鼠标按下

总是

广告
鼠标松开

仅当图形的回调windowbuttonupfcn已定义

广告
在鼠标按下时指针移动(鼠标拖动)

仅当图形的回调windowbuttonmotionfcn已定义

广告
广告
hittest: "off" | {"on"}

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

广告
menubar: {"figure"} | "none"

控制图形菜单栏在图形顶部的显示。

广告
pointer: {"arrow"} | "botl" | "botr" | "bottom" | "circle" | "cross" | "crosshair" | "custom" | "fleur" | "hand" | "ibeam" | "left" | "right" | "top" | "topl" | "topr" | "watch"

与图形画布关联的鼠标指针形状的名称。当pointer"custom",形状从pointershapecdata属性中获取。

pointer在图形处于缩放、平移或旋转模式时没有效果。在这种情况下,Octave会自动使用适合该模式的指针形状。

广告
pointershapecdata: 16-by-16 or 32-by-32 Matrix, def. 16-by-16 double

定义自定义指针的m乘m矩阵。每个元素定义一个像素,其中元素(1,1)表示左上角的像素。值1为黑色,值2为白色,所有其他值均渲染为透明。

广告
pointershapehotspot: two-element vector, def. [1 1]

仅用于自定义指针pointershapehotspot定义中像素的行和列pointershapecdata用作指针位置。

广告
resize: "off" | {"on"}

控制是否可以通过使用鼠标拖动窗口边框和角来调整图形的大小。当resize"off"时鼠标交互被禁用,但图形仍然可以通过更改其大小来调整大小"position"属性

广告
resizefcn: string | function handle, def. [](0x0)

resizefcn已弃用。使用sizechangedfcn相反

广告
selected: {"off"} | "on"

属性指示是否选择此图形。

广告
selectionhighlight: "off" | {"on"}

如果selectionhighlight"on",则图形的选择状态在视觉上高亮显示。

广告
selectiontype: "alt" | "extend" | {"normal"} | "open"

最近一次鼠标单击的选择类型。

selectiontype根据所使用的鼠标按钮和键盘修饰符的组合,可以采用不同的值:

normal:

左键单击。

广告
alt:

右键单击或Ctrl+左键单击。

广告
extend:

按住Shift键的同时单击鼠标左键、单击鼠标中键或同时单击鼠标右键。

广告
open:

双击鼠标左键。

广告
广告
sizechangedfcn: string | function handle, def. [](0x0)

图形窗口大小更改时触发回调。

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

广告
toolbar: {"auto"} | "figure" | "none"

控制工具栏(沿菜单栏底部)和状态栏的显示。设置为"auto"时,显示基于"menubar"属性的值。

广告
windowbuttondownfcn: string | function handle, def. [](0x0)

详见windowbuttonupfcn属性 .

广告
windowbuttonmotionfcn: string | function handle, def. [](0x0)

详见windowbuttonupfcn属性 .

广告
windowbuttonupfcn: string | function handle, def. [](0x0)

具有windowbuttondownfcnwindowbuttonmotionfcn,鼠标回调函数。当分别按下、拖动或释放鼠标按钮时,会调用这些回调函数。当执行这些回调函数时currentpoint属性保存光标的当前坐标。

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

广告
windowscrollwheelfcn: string | function handle, def. [](0x0)

当用户在该图上操作鼠标滚轮时执行的函数。该函数从两个输入参数调用。第一个参数保存调用图形的句柄。第二个参数保存具有以下成员的事件结构体:

VerticalScrollCount:

滚轮步数,向下滚动时通常为1,向上滚动时为-1。

广告
VerticalScrollAmount:

轮子步进应滚动的行数。此值始终为3。

广告
EventName:

事件名称"WindowScrollWheel".

广告

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

广告

对象标识

广告
currentaxes: graphics handle, def. [](0x0)

当前轴的图形对象的句柄。

广告
currentcharacter (read-only): def. ""

图形对象尚未实现对最后按下的键的跟踪。currentcharacter未使用。

广告
currentobject (read-only): graphics handle, def. [](0x0)

图中最近激活的图形对象的句柄。

广告
integerhandle: "off" | {"on"}

指定下一个最低的未使用整数作为数字。

广告
nextplot: {"add"} | "new" | "replace" | "replacechildren"

nextplot高级绘图函数使用它来决定如何处理图中已存在的轴。详见newplot函数 .

广告
number (read-only): double

当前数字的编号。

广告
tag: string, def. ""

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

广告
type (read-only): string

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

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

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

广告

对象位置

广告
dockcontrols: "off" | {"on"}

尚未为图形对象对象实现交互式图形对象停靠。dockcontrols未使用。

广告
innerposition: four-element vector, def. [300 200 560 420]

这里的"innerposition"属性与相同"position"属性 .

广告
outerposition: four-element vector, def. [-1 -1 -1 -1]

指定图形的位置和大小,包括顶部菜单栏和底部状态栏。向量的四个元素是左下角的坐标以及图形的宽度和高度。详见单位属性 .

广告
position: four-element vector, def. [300 200 560 420]

指定图形画布的位置和大小。向量的四个元素是左下角的坐标以及图形的宽度和高度。详见单位属性 .

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

用于计算的单位positionouterposition属性。

广告

父级对象/子级对象

广告
children (read-only): vector of graphics handles, def. [](0x1)

图形的子对象的图形句柄。

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

如果handlevisibility"off",图形对象的控制柄在其父对象中不可见"children"属性

广告
parent: graphics handle, def. 0

父图形对象的句柄。

广告

打印/保存

广告
filename: string, def. ""

保存绘图图形时使用的文件名。

广告
inverthardcopy: "off" | {"on"}

打印时,将图形和轴的背景色替换为白色。

广告
paperorientation: "landscape" | {"portrait"}

papersizepaperposition属性的值取决于paperorientation的水平和垂直值。papersizepaperposition反转顺序时,paperorientation"portrait""landscape"之间切换.

广告
paperposition: four-element vector, def. [1.3422 3.3191 5.8156 4.3617]

向量[left bottom width height]定义图形的位置和大小(inpaperunits单位)。位置[left bottom]定义页面上图形的左下角,大小从定义[width height]对于未隐含地呈现在纸上的输出格式,widthheight定义图像的大小并且忽略位置信息。背景paperposition也迫使paperpositionmode属性设置为"manual".

广告
paperpositionmode: {"auto"} | "manual"

如果paperpositionmode设置为"auto"这里的paperposition属性是自动计算的:打印的图形将与屏幕上的图形具有相同的大小,并将位于输出页面的中心。设置paperpositionmode"auto"不修改paperposition属性的值

广告
papersize: two-element vector, def. [8.5000 11.0000]

向量[width height]定义用于打印的纸张的尺寸。设置papersize属性转换为一个值,该值与定义的papertypes并且与paperorientation的设置一致,强制papertype属性转换为"<custom>"。如果papersize设置为支持的papertypepaperorientation的值,那么papertype值被修改为关联的值。

广告
papertype: "<custom>" | "a" | "a0" | "a1" | "a2" | "a3" | "a4" | "a5" | "arch-a" | "arch-b" | "arch-c" | "arch-d" | "arch-e" | "b" | "b0" | "b1" | "b2" | "b3" | "b4" | "b5" | "c" | "d" | "e" | "tabloid" | "uslegal" | {"usletter"}

用于打印输出的纸张的名称。papertype跟随papersize变化,同时保持与paperorientation属性的一致性

广告
paperunits: "centimeters" | {"inches"} | "normalized" | "points"

用于计算paperposition属性物理单元的单位(例如"inches")。取决于screenpixelsperinch根对象的属性。

广告
renderer: {"opengl"} | "painters"

用于打印的渲染引擎。只在renderermode"manual"时有效。设置renderer也迫使renderermode属性设置为"manual".

广告
renderermode: {"auto"} | "manual"

控制是自动选择用于打印的渲染引擎,还是从renderer属性中读取。详见打印函数 .

广告

未使用

广告
clipping: "off" | {"on"}

clipping未使用。

广告
pickableparts (read-only): "all" | "none" | {"visible"}

pickableparts未使用。

广告

版权所有 © 2024-2025 Octave中文网

ICP备案/许可证号:黑ICP备2024030411号-2