15.3.3.2 Свойства рисунка

Свойства объектов figure (см. рисунок):

alphamap: def. 64×1 double

Прозрачность пока не реализована для объектов рисунка. alphamap не используется.

beingdeleted: {"off"} | "on"

busyaction: "cancel" | {"queue"}

Определяет, как Octave обрабатывает выполнение свойств обратного вызова этого объекта, когда он не может прервать выполнение обратного вызова другого объекта. Это актуально только в том случае, если объект обратного вызова, выполняющийся в данный момент, имеет свойство interruptible, установленное в "off". Свойство busyaction объекта прерывающего обратного вызова указывает, очередится ли прерывающий обратный вызов ("queue" (по умолчанию)) или будет отброшен ("cancel"). См. раздел обратных вызовов.

buttondownfcn: строка | обработчик функции, def. [](0x0)

Дополнительную информацию о написании функций обработчиков графики см. в разделе обратных вызовов.

children (только для чтения): вектор графических дескрипторов, def. [](0x1)

Графические дескрипторы дочерних элементов рисунка.

clipping: "off" | {"on"}

clipping не используется.

closerequestfcn: строка | обработчик функции, def. "closereq"

Функция, которая выполняется при удалении рисунка. См. функцию closereq.

Дополнительную информацию о написании функций обработчиков графики см. в разделе обратных вызовов.

color: цвет, def. [1 1 1]

Цвет фона рисунка. См. цвет.

colormap: N×3 матрица, def. 64×3 double

Матрица, содержащая цветовую карту RGB для текущей области.

createfcn: строка | обработчик функции, def. [](0x0)

Функция обратного вызова, выполняемая сразу после создания рисунка. Функция устанавливается с помощью свойства по умолчанию для корневого объекта, например, set (groot, "defaultfigurecreatefcn", 'disp ("figure created!")').

Дополнительную информацию о написании функций обработчиков графики см. в разделе обратных вызовов.

currentaxes: графический дескриптор, def. [](0x0)

Дескриптор графического объекта текущей области.

currentcharacter (только для чтения): def. ""

currentcharacter не используется.

currentobject (только для чтения): графический дескриптор, def. [](0x0)

currentpoint (только для чтения): двухэлементный вектор, def. [0; 0]

Матрица 1×2, которая хранит координаты точки, над которой находился указатель мыши при возникновении события мыши. Координаты X и Y заданы в единицах, определенных свойством units рисунка, и их начало находится в левом нижнем углу области построения.

События, которые устанавливают currentpoint, это

Нажата кнопка мыши

всегда

Кнопка мыши отпущена

только если определен обратный вызов рисунка windowbuttonupfcn

Указатель перемещался при нажатой кнопке мыши (перетаскивание)

только если определен обратный вызов рисунка windowbuttonmotionfcn

deletefcn: строка | обработчик функции, def. [](0x0)

Функция обратного вызова, выполняемая непосредственно перед удалением рисунка.

Дополнительную информацию о написании функций обработчиков графики см. в разделе обратных вызовов.

dockcontrols: {"off"} | "on"

dockcontrols не используется.

filename: строка, def. ""

Имя файла, используемого при сохранении рисунка.

graphicssmoothing: "off" | {"on"}

Используйте методы сглаживания для уменьшения видимости ступенчатых линий.

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

Если handlevisibility равно "off", дескриптор рисунка не отображается в свойстве "дети" его родителя.

hittest: "off" | {"on"}

Указывает, обрабатывает ли рисунок события мыши или передает их предкам объекта. При включении объект может реагировать на щелчки мыши, оценивая "buttondownfcn", отображая контекстное меню и, в конечном итоге, становясь корневым "currentobject". Это свойство актуально только в том случае, если объект может принимать щелчки мыши, что определяется свойством "pickableparts". См. свойство pickableparts.

integerhandle: "off" | {"on"}

Присваивает следующее меньшее неиспользуемое целое число в качестве номера рисунка.

interruptible: "off" | {"on"}

Указывает, могут ли функции обратного вызова этого объекта прерываться другими функциями обратного вызова. По умолчанию interruptible равно "on", и обратные вызовы, использующие функции drawnow, figure, waitfor, getframe или pause, в конечном итоге прерываются. См. раздел обратных вызовов.

inverthardcopy: "off" | {"on"}

Заменяет цвет фона рисунка и области построения белым при печати.

keypressfcn: строка | обработчик функции, def. [](0x0)

Функция обратного вызова, выполняемая при нажатии клавиши, когда рисунок имеет фокус. Фактическую нажатую клавишу можно получить, используя второй аргумент 'evt' функции. Дополнительную информацию о написании функций обработчиков графики см. в разделе обратных вызовов.

keyreleasefcn: строка | обработчик функции, def. [](0x0)

С keypressfcn, функции обратного вызова клавиатуры. Эти функции обратного вызова вызываются при нажатии/отпускании клавиши соответственно. Функции вызываются с двумя входными аргументами. Первый аргумент содержит дескриптор вызывающего рисунка. Второй аргумент содержит структуру события, которая имеет следующие члены:

Character:

ASCII-значение клавиши

Key:

Строчное значение клавиши

Modifier:

Массив ячеек, содержащий строки, представляющие нажатые модификаторы с клавишей.

Дополнительную информацию о написании функций обработчиков графики см. в разделе обратных вызовов.

menubar: {"figure"} | "none"

Управление отображением панели меню рисунка в верхней части рисунка.

name: строка, def. ""

Имя, отображаемое в строке заголовка рисунка. Имя отображается справа от любого заголовка, определенного свойством numbertitle.

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

nextplot используется функциями высокого уровня построения графиков, чтобы решить, что делать с уже имеющимися областями построения на рисунке. См. функцию newplot.

number (только для чтения):

numbertitle: "off" | {"on"}

Отображает "Рисунок" вместе со значением числового дескриптора рисунка в строке заголовка рисунка.

outerposition: четырехэлементный вектор, def. [-1 -1 -1 -1]

Задает положение и размер рисунка, включая верхнюю панель меню и нижнюю строку состояния. Четыре элемента вектора — координаты левого нижнего угла и ширина и высота рисунка. См. свойство units.

paperorientation: "landscape" | {"portrait"}

Значение свойств papersize и paperposition зависит от paperorientation. Горизонтальные и вертикальные значения для papersize и paperposition меняют порядок, когда paperorientation переключается между "portrait" и "landscape".

paperposition: четырехэлементный вектор, def. [0.25000 2.50000 8.00000 6.00000]

Вектор [left bottom width height], определяющий положение и размер рисунка (в единицах paperunits) на странице печати. Положение [left bottom] определяет левый нижний угол рисунка на странице, а размер определяется [width height]. Для форматов вывода, которые не отображаются неявно на бумаге, width и height определяют размер изображения, а информация о позиции игнорируется. Установка paperposition также заставляет свойство paperpositionmode принять значение "manual".

paperpositionmode: "auto" | {"manual"}

Если paperpositionmode установлено в "auto", свойство paperposition автоматически вычисляется: напечатанный рисунок будет иметь тот же размер, что и на экране, и будет центрирован на странице вывода. Установка paperpositionmode в "auto" не изменяет значение свойства paperposition.

papersize: двухэлементный вектор, def. [8.5000 11.0000]

Вектор [width height] определяет размер бумаги для печати. Установка свойства papersize в значение, не связанное с одним из определенных papertypes и совместимое с установкой paperorientation, заставляет свойство papertype принять значение "<custom>". Если papersize установлено в значение, связанное с поддерживаемой papertype и совместимое с paperorientation, значение 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. Для paperunits со значением "pixels", преобразование между физическими единицами (например, "inches") и "pixels" зависит от свойства screenpixelsperinch корневого объекта.

parent: дескриптор графического объекта, по умолчанию 0

Дескриптор родительского графического объекта.

pickableparts (только для чтения): "all" | "none" | {"visible"}

pickableparts не используется.

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

pointer не используется.

pointershapecdata: по умолчанию 16x16 double

pointershapecdata не используется.

pointershapehotspot: по умолчанию [0 0]

pointershapehotspot не используется.

position: вектор из четырёх элементов, по умолчанию [300 200 560 420]

Определяет позицию и размеры области рисования графического объекта. Четыре элемента вектора — координаты левого нижнего угла и ширина и высота области. См. свойство единиц.

renderer: {"opengl"} | "painters"

Движок отрисовки, используемый для печати, когда renderermode равно "ручному". Установка renderer также принудительно задаёт свойство renderermode равным "manual".

renderermode: {"auto"} | "manual"

Управление автоматическим выбором или указанием движка отрисовки для печати свойством renderer. См. функцию печати.

resize: "off" | {"on"}

Управление возможностью изменения размера фигуры перетаскиванием границ и углов окна с помощью мыши. Если resize равно "off", взаимодействия с мышью отключены, но фигуру всё ещё можно изменять, изменяя её свойство "position".

resizefcn: строка | дескриптор функции, по умолчанию [](0x0)

resizefcn устарело. Используйте sizechangedfcn вместо него.

selected: {"off"} | "on"

selectionhighlight: "off" | {"on"}

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

sizechangedfcn: строка | дескриптор функции, по умолчанию [](0x0)

Обработчик событий, срабатывающий при изменении размера окна фигуры.

Информация о написании обработчиков графических событий приведена в разделе Обработчики событий.

tag: строка, по умолчанию ""

Пользовательская строка для маркировки графического объекта.

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

Управление отображением панели инструментов (в нижней части строки меню) и строкой состояния. При значении "auto" отображение зависит от значения свойства menubar.

type (только для чтения): строка

Имя класса графического объекта. type всегда равно "figure"

uicontextmenu: дескриптор графического объекта, по умолчанию [](0x0)

Дескриптор объекта uicontextmenu, который в настоящий момент ассоциирован с данным объектом figure.

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

Единица измерения, используемая для вычисления свойств position и outerposition.

userdata: Любые данные Octave, по умолчанию [](0x0)

Пользовательские данные, ассоциированные с графическим объектом.

visible: "off" | {"on"}

Если visible равно "off", фигура не отображается на экране.

windowbuttondownfcn: строка | дескриптор функции, по умолчанию [](0x0)

См. свойство windowbuttonupfcn.

windowbuttonmotionfcn: строка | дескриптор функции, по умолчанию [](0x0)

См. свойство windowbuttonupfcn.

windowbuttonupfcn: строка | дескриптор функции, по умолчанию [](0x0)

Для windowbuttondownfcn и windowbuttonmotionfcn, функции обратного вызова мыши. Эти функции обратного вызова вызываются, когда нажата, перетаскивается или отпускается кнопка мыши соответственно. При выполнении этих функций обратного вызова, свойство currentpoint содержит текущие координаты курсора.

Информация о написании обработчиков графических событий приведена в разделе Обработчики событий.

windowkeypressfcn: строка | дескриптор функции, по умолчанию [](0x0)

Функция, которая выполняется при нажатии клавиши, если фигура имеет фокус.

Информация о написании обработчиков графических событий приведена в разделе Обработчики событий.

windowkeyreleasefcn: строка | дескриптор функции, по умолчанию [](0x0)

Функция, которая выполняется при отпускании клавиши, если фигура имеет фокус.

Информация о написании обработчиков графических событий приведена в разделе Обработчики событий.

windowscrollwheelfcn: строка | дескриптор функции, по умолчанию [](0x0)

windowscrollwheelfcn не используется.

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

Стиль окна фигуры. Может принимать одно из следующих значений:

normal

Устанавливает стиль окна как немодальный.

modal

Устанавливает окно как модальное, чтобы оно оставалось поверх всех обычных фигур.

docked

Установка стиля окна как прикреплённого в настоящее время не прикрепляет окно.

Изменение режима видимой фигуры может привести к закрытию и повторному открытию фигуры.