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

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

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

Цвет области фона. См. colorspec.

beingdeleted: {"off"} | "on"

busyaction: "cancel" | {"queue"}

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

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

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

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

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

clipping: "off" | {"on"}

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

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

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

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

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

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

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

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

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

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

Цвет обводки области фона. См. colorspec.

editing: {"off"} | "on"

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

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

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

fontangle: "italic" | {"normal"} | "oblique"

Управление стилем шрифта (курсив или обычный).

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

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

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

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

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

fontsmoothing: "off" | {"on"}

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

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

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

fontweight: "bold" | {"normal"}

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

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

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

hittest: "off" | {"on"}

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

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

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

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

interruptible: "off" | {"on"}

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

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

Стиль обводки. См. Стили линий.

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

Ширина обводки.

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

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

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

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

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

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

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

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

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

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

selected: {"off"} | "on"

selectionhighlight: "off" | {"on"}

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

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

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

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

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

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

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

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

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

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

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

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

visible: "off" | {"on"}

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