15.3.3.6 Свойства текста

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

Категории:

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

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

busyaction: "cancel" | {"queue"}

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

interruptible: "off" | {"on"}

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

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

beingdeleted: {"off"} | "on"

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

createfcn: string | function handle, по умолчанию [](0x0)

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

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

deletefcn: string | function handle, по умолчанию [](0x0)

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

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

Отображение

clipping: "off" | {"on"}

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

visible: "off" | {"on"}

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

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

buttondownfcn: string | function handle, по умолчанию [](0x0)

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

contextmenu: graphics handle, по умолчанию [](0x0)

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

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, по умолчанию ""

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

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

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

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

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

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

extent (только для чтения): вектор из четырёх элементов

Вектор [x0 y0 width height], указывающий размер и положение текстовой строки.

horizontalalignment: "center" | {"left"} | "right"

Определяет горизонтальное положение точки, заданной свойством "position", относительно текста.

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

Вектор [X0 Y0 Z0], где X0, Y0 и Z0 указывают положение точки привязки текста, заданное свойствами verticalalignment и horizontalalignment.

rotation: скаляр, по умолчанию 0

Угол поворота отображаемого текста в градусах.

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

Задаёт единицу измерения или метод, применяемый к свойствам "position" и "extent". Вариант по умолчанию "data" использует те же единицы измерения и пределы, что и данные, отображённые на графике. Вариант "normalized" применяет безразмерную шкалу от 0 до 1 к пределам каждой оси отображаемых данных.

verticalalignment: "baseline" | "bottom" | "cap" | {"middle"} | "top"

Определяет вертикальное положение точки, заданной свойством "position", относительно текста. Обратите внимание: "top" и "bottom" выравниваются по краю текстового поля, а "cap" и "baseline" относятся к краям самого текста.

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

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

У текстовых объектов нет дочерних объектов. Свойство children не используется.

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

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

parent: графический дескриптор

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

Внешний вид текста

color: colorspec, по умолчанию [0 0 0]

Цвет текста. См. colorspec.

editing: {"off"} | "on"

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

fontangle: "italic" | {"normal"}

Управляет выбором между курсивным и обычным начертанием шрифта.

fontname: string, по умолчанию "*"

Название шрифта, используемого для отображения текста. При установке этого свойства механизм отображения текста выполняет поиск соответствующего шрифта в системе. Если такой шрифт не найден, текст отображается шрифтом без засечек по умолчанию (тем же, что и значение "*" по умолчанию).

Примечание по программированию: в системах, где FontConfig не используется изначально (во всех системах, кроме Linux), кэш шрифтов создаётся при установке Octave. После установки новых шрифтов необходимо вручную запустить system ("fc-cache -fv").

fontsize: скаляр, по умолчанию 10

Размер шрифта, используемого для отображения текста. См. свойство fontunits.

fontsmoothing: "off" | {"on"}

Управляет использованием сглаживания при отображении текста.

fontunits: "centimeters" | "inches" | "normalized" | "pixels" | {"points"}

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

fontweight: "bold" | {"normal"}

Управляет вариантом основного шрифта, используемого для отображения текста.

interpreter: "latex" | "none" | {"tex"}

Управляет способом интерпретации свойства "string". См. раздел «Использование свойства "interpreter"».

string: string, по умолчанию ""

Содержимое строки текстового объекта.

Внешний вид текстового поля

backgroundcolor: colorspec, по умолчанию "none"

Цвет фона. См. colorspec.

edgecolor: colorspec, по умолчанию "none"

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

linestyle: {"-"} | "--" | "-." | ":" | "none"

Стиль контура текстового поля. См. стили линий.

linewidth: скаляр, по умолчанию 0.5000

Ширина контура текстового поля.

margin: скаляр, по умолчанию 3

Отступы между границами фона и текстом. В настоящее время значение интерпретируется как число пикселей независимо от свойства "fontunits".