---

15.3.3.1 Root Properties ¶

Properties of the root graphics object:

Categories: ¶

Callback Execution | Command Window Display | Mouse Interaction | Object Identification | Parent/Children | Pointer Information | Screen Information | Unused

Callback Execution ¶

callbackobject (read-only): graphics handle, def. [](0x0) ¶

Graphics handle of the current object whose callback is executing.

Command Window Display ¶

commandwindowsize (read-only): two-element vector, def. [0 0] ¶

The number of columns and rows displayed in a newly created command window.

fixedwidthfontname: string, def. "Courier" ¶

Name of the fixed-width font that will be used for graphics objects when the "fontname" property is set to "FixedWidth".

Mouse Interaction ¶

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

Graphics handle of the uicontextmenu object that is currently associated to this root object.

Object Identification ¶

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

Graphics handle of the current figure.

tag: string, def. "" ¶

A user-defined string to label the graphics object.

type (read-only): string ¶

Class name of the graphics object. type is always "root".

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

User-defined data to associate with the graphics object.

Parent/Children ¶

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

Graphics handles of the root’s children.

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

The root object handle is always visible. Changing this setting to "callback" or "off" has no effect.

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

Root object has no parent graphics object. parent is always empty.

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

If showhiddenhandles is "on", all graphics objects handles are visible in their parents’ children list, regardless of the value of their handlevisibility property.

Pointer Information ¶

pointerlocation: two-element vector, def. [0 0] ¶

Global pointer location tracking is not yet implemented for root objects. pointerlocation is unused. pointerlocation for root objects will always be [0 0].

pointerwindow (read-only): graphics handle, def. 0 ¶

Pointer window tracking is not yet implemented for root objects. pointerwindow is unused. pointerwindow value for root objects will always be 0.

Screen Information ¶

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

Reports the width and height of connected monitors. Note: Octave only partially implements monitorpositions. Only information about the primary monitor is stored in monitorpositions which is the same information stored in the "screensize" property.

screendepth (read-only): double ¶

Color depth in bits per pixel of the display.

screenpixelsperinch (read-only): double ¶

The screen resolution of the primary display in units of pixels per inch.

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

Size of the primary display represented as the four-element vector [left, bottom, width, height].

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

The unit type used for the "monitorpositions", "pointerlocation", and "screensize" properties.

Unused ¶

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

beingdeleted is unused.

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

busyaction is unused.

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

buttondownfcn is unused.

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

clipping is unused.

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

createfcn is unused.

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

deletefcn is unused.

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

hittest is unused.

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

interruptible is unused.

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

pickableparts is unused.

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

selected is unused.

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

selectionhighlight is unused.

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

visible is unused.