15.3.3.2 Свойства окна графиков ¶

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

Категории: ¶

Внешний вид | Выполнение обратного вызова | Создание/Удаление | Отображение | Взаимодействие с клавиатурой | Взаимодействие с мышкой | Идентификация объекта | Позиция объекта | Родитель/Дочерние элементы | Печать/Сохранение | Неиспользуемые

Внешний вид ¶

alphamap: def. 64-by-1 double ¶

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

color: colorspec, def. [1 1 1] ¶

Цвет фона окна графиков. См. colorspec.

colormap: N-by-3 matrix, def. 64-by-3 double ¶

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

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

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

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

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

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

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

Выполнение обратного вызова ¶

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

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

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

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

Создание/Удаление ¶

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

Свойство, указывающее, что функция инициировала удаление объекта. beingdeleted имеет значение true, пока объект не перестанет существовать.

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

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

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

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

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

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

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

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

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

Отображение ¶

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

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

windowstate: "fullscreen" | "maximized" | "minimized" | {"normal"} ¶

Настройка состояния окна пока не реализована для объектов figure. windowstate не используется.

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

Стиль окна окна графиков. Одно из следующих значений:

normal

Окно может быть неактивным, и другие окна могут быть отображены поверх него.

modal

Окно будет оставаться поверх всех обычных окон графиков до его закрытия.

docked

Не реализовано.

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

Взаимодействие с клавиатурой ¶

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

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

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

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

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

Character:

Значение ASCII клавиши

Key:

Маленькие буквы клавиши

Modifier:

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

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

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

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

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

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

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

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

Взаимодействие с мышкой ¶

buttondownfcn: строка | обработчик функций, по умолчанию [](0x0) ¶

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

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

Дескриптор объекта uicontextmenu, который в настоящее время связан с этим объектом Figure.

currentpoint (только для чтения): вектор из двух элементов, по умолчанию [0; 0] ¶

Вектор 1x2, содержащий координаты точки, над которой находился указатель мыши во время возникновения события мыши. Координаты 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: Матрица 16x16 или 32x32, по умолчанию 16x16 double ¶

Матрица m×m, определяющая пользовательский указатель. Каждый элемент определяет пиксель, при этом элемент (1,1) представляет верхний левый пиксель. Значение 1 окрашивается в черный цвет, 2 — в белый цвет, а все остальные значения отображаются как прозрачные.

pointershapehotspot: вектор из двух элементов, по умолчанию [1 1] ¶

Только для пользовательских указателей pointershapehotspot определяет строку и столбец пикселя в pointershapecdata, используемого как положение указателя.

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

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

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

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

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

Свойство указывает, выбрана ли эта фигура.

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

Если selectionhighlight равно "on", то состояние выбора фигуры визуально выделяется.

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

Тип выделения последнего щелчка мышью.

selectiontype может принимать различные значения в зависимости от комбинации нажатой кнопки мыши и модификаторов клавиатуры:

normal:

Левый щелчок.

alt:

Правый щелчок или Ctrl+Левый щелчок.

extend:

Shift+Левый щелчок, Средний щелчок или комбинированный Левый щелчок и Правый щелчок.

open:

Двойной левый щелчок.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

VerticalScrollCount:

Количество шагов колеса, обычно 1 при прокрутке вниз и -1 при прокрутке вверх.

VerticalScrollAmount:

Количество строк, на которое должно смещаться колесо при каждом шаге. Это значение всегда равно 3.

EventName:

Имя события, которое равно "WindowScrollWheel".

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

Идентификация объекта ¶

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

Дескриптор графического объекта текущей системы координат.

currentcharacter (только для чтения): по умолчанию "" ¶

Отслеживание последней нажатой клавиши пока не реализовано для объектов типа figure. currentcharacter не используется.

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

Дескриптор последнего активизированного графического объекта в окне figure.

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

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

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

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

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

Номер текущего окна figure.

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

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

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

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

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

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

Положение объекта ¶

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

Интерактивное прикрепление окон figure пока не реализовано для объектов figure. dockcontrols не используется.

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

Свойство "innerposition" такое же, как и свойство "position".

outerposition: вектор из четырёх элементов, по умолчанию [-1 -1 -1 -1] ¶

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

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

Определяет положение и размер области отрисовки окна figure. Четыре элемента вектора – координаты левого нижнего угла и ширина и высота области отрисовки. См. свойство units.

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

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

Родитель/Дочерние элементы ¶

children (только для чтения): вектор дескрипторов графических объектов, по умолчанию [](0x1) ¶

Дескрипторы графических объектов-потомков окна figure.

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

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

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

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

Печать/Сохранение ¶

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

Имя файла для сохранения графика.

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

Заменить цвет фона figure и осей на белый при печати.

paperorientation: "landscape" | {"portrait"} ¶

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

paperposition: вектор из четырёх элементов, по умолчанию [1.3422 3.3191 5.8156 4.3617] ¶

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

paperpositionmode: {"auto"} | "manual" ¶

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

papersize: вектор из двух элементов, по умолчанию [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. Преобразование из физических единиц (например, "inches") зависит от свойства screenpixelsperinch корневого объекта.

renderer: {"opengl"} | "painters" ¶

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

renderermode: {"auto"} | "manual" ¶

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

Неиспользуемые ¶

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

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

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

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