15.3.3.9 Свойства диаграммы рассеяния

Свойства объектов scatter (см. диаграмма рассеяния):

Категории:

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

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

busyaction: "cancel" | {"queue"}

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

interruptible: "off" | {"on"}

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

Данные о цвете

cdata: scalar | matrix, def. [0 0.4470 0.7410]

Данные, задающие цвет объекта диаграммы рассеяния.

Если cdata — скалярный индекс текущей цветовой карты или триплет RGB, он задает цвет всех маркеров диаграммы рассеяния.

Если cdata — вектор N-by-1 с индексами или матрица N-by-3 (RGB), он задает цвет каждого из N маркеров диаграммы рассеяния.

cdatamode: {"auto"} | "manual"

Если cdatamode имеет значение "auto", для cdata задается цвет из colororder родительских осей, соответствующий seriesindex.

cdatasource: string, def. ""

Имя переменной рабочей области, содержащей данные, которые будут использоваться для свойства "cdata". Данные передаются в "cdata" с помощью функции refreshdata.

seriesindex: def. 1

Каждому объекту диаграммы рассеяния на одних и тех же осях назначается целое число, последовательно увеличивающееся на единицу. Оно соответствует индексу в colororder родительских осей, который используется, если для cdatamode задано значение "auto".

Данные координат

latitudedata: def. [](0x0)

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

latitudedatasource: def. ""

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

longitudedata: def. [](0x0)

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

longitudedatasource: def. ""

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

rdata: def. [](0x0)

Построение диаграмм рассеяния в полярных координатах для объектов диаграммы рассеяния пока не реализовано. rdata не используется.

rdatasource: def. ""

Построение диаграмм рассеяния в полярных координатах для объектов диаграммы рассеяния пока не реализовано. rdatasource не используется.

thetadata: def. [](0x0)

Построение диаграмм рассеяния в полярных координатах для объектов диаграммы рассеяния пока не реализовано. thetadata не используется.

thetadatasource: def. ""

Построение диаграмм рассеяния в полярных координатах для объектов диаграммы рассеяния пока не реализовано. thetadatasource не используется.

xdata: vector, def. [](0x0)

Вектор с координатами x объекта диаграммы рассеяния.

xdatasource: string, def. ""

Имя переменной рабочей области, содержащей данные, которые будут использоваться для свойства "xdata". Данные передаются в "xdata" с помощью функции refreshdata.

ydata: vector, def. [](0x0)

Вектор с координатами y объекта диаграммы рассеяния.

ydatasource: string, def. ""

Имя переменной рабочей области, содержащей данные, которые будут использоваться для свойства "ydata". Данные передаются в "ydata" с помощью функции refreshdata.

zdata: [] | vector, def. [](0x0)

Для трехмерных данных — вектор с координатами y объекта диаграммы рассеяния.

zdatasource: string, def. ""

Имя переменной рабочей области, содержащей данные, которые будут использоваться для свойства "zdata". Данные передаются в "zdata" с помощью функции refreshdata.

Создание/удаление

beingdeleted: {"off"} | "on"

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

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

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

Сведения о том, как писать функции-обработчики событий графики, см. в разделе «Обратные вызовы».

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

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

Сведения о том, как писать функции-обработчики событий графики, см. в разделе «Обратные вызовы».

Отображение

clipping: "off" | {"on"}

Если clipping имеет значение "on", диаграмма рассеяния обрезается по пределам родительских осей.

visible: "off" | {"on"}

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

Параметры легенды

annotation: def. [](0x0)

Переключение отображения элемента легенды из объекта диаграммы рассеяния пока не реализовано для таких объектов. annotation не используется.

displayname: def. ""

Текст элемента легенды, соответствующего этому объекту диаграммы рассеяния.

Внешний вид маркера

linewidth: scalar, def. 0.5000

Толщина линии границы маркеров.

marker: "*" | "+" | "." | "<" | ">" | "^" | "_" | "d" | "diamond" | "h" | "hexagram" | "none" | {"o"} | "p" | "pentagram" | "s" | "square" | "v" | "x" | "|"

См. свойство маркера объекта line.

markeredgealpha: scalar, def. 1

Уровень прозрачности заливки маркеров: значение 0 означает полную прозрачность, а значение 1 — сплошную заливку без прозрачности. Обратите внимание, что маркеры не сортируются от заднего плана к переднему, что может привести к неожиданным результатам при отображении слоёв прозрачных маркеров или их сочетании с другими прозрачными объектами.

markeredgecolor: {"none"} | {"flat"} | colorspec

Цвет границ маркеров. Значение "none" означает, что границы прозрачны, а "flat" — что используется значение из cdata. См. свойство markeredgecolor объекта line.

markerfacealpha: scalar, def. 1

Уровень прозрачности заливки маркеров: значение 0 означает полную прозрачность, а значение 1 — сплошную заливку без прозрачности. Обратите внимание, что маркеры не сортируются от заднего плана к переднему, что может привести к неожиданным результатам при отображении слоёв прозрачных маркеров или их сочетании с другими прозрачными объектами.

markerfacecolor: {{"none"}} | "flat" | "auto" | colorspec

Цвет заливки маркеров. Значение "none" означает, что заливка прозрачна, "flat" — что используется значение из cdata, а "auto" использует свойство color родительских осей. См. свойство markerfacecolor объекта line.

sizedata: [] | scalar | vector, def. [](0x0)

Размер области маркера. Скалярное значение применяется ко всем маркерам. Если cdata — вектор N-by-1, он задает цвет каждого из N маркеров диаграммы рассеяния.

sizedatasource: def. ""

Использование данных из переменных рабочей области для объектов диаграммы рассеяния пока не реализовано. sizedatasource не используется.

Взаимодействие с мышью

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

Сведения о том, как писать функции-обработчики событий графики, см. в разделе «Обратные вызовы».

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

Графический дескриптор объекта uicontextmenu, который в данный момент связан с этим объектом диаграммы рассеяния.

datatiptemplate: def. [](0x0)

Объекты подсказок с данными для объектов диаграммы рассеяния пока не реализованы. datatiptemplate не используется.

hittest: "off" | {"on"}

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

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

Указывает, будет ли диаграмма рассеяния принимать щелчки мышью. По умолчанию pickableparts имеет значение "visible", поэтому на щелчки мышью могут реагировать только видимые части диаграммы рассеяния или её дочерние объекты. Если pickableparts имеет значение "all", на щелчки мышью могут реагировать как видимые, так и невидимые части (или дочерние объекты). Если pickableparts имеет значение "none", щелчки мышью по объекту игнорируются и передаются любым объектам, расположенным под ним. Если объект настроен на приём щелчков мышью, способ их обработки определяется свойством "hittest". См. свойство hittest.

selected: {"off"} | "on"

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

selectionhighlight: "off" | {"on"}

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

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

tag: string, def. ""

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

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

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

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

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

Родительский объект/дочерние объекты

children (только для чтения): vector of graphics handles, def. [](0x1)

Дочерние объекты диаграмм рассеяния для объектов диаграммы рассеяния пока не реализованы. children не используется.

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

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

parent: graphics handle

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