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

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

backgroundcolor: colorspec, def. "none"

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

beingdeleted: {"off"} | "on"

busyaction: "cancel" | {"queue"}

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

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

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

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

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

clipping: "off" | {"on"}

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

color: colorspec, def. [0 0 0]

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

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

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

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

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

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

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

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

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

edgecolor: colorspec, def. "none"

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

editing: {"off"} | "on"

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

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

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

fontangle: "italic" | {"normal"}

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

fontname: строка, def. "*"

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

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

fontsize: скаляр, def. 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". См. Использование свойства «interpreter».

interruptible: "off" | {"on"}

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

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

Стиль контура. См. Стили линий.

linewidth: скаляр, def. 0.5000

Ширина контура.

margin: скаляр, def. 3

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

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

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

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

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

position: вектор из трех элементов, def. [0 0 0]

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

rotation: скаляр, def. 0

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

selected: {"off"} | "on"

selectionhighlight: "off" | {"on"}

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

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

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

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

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

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

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

userdata: Любые данные Octave, def. [](0x0)

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

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

visible: "off" | {"on"}

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