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: строка | обработчик функции, по умолчанию [](0x0) ¶

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

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

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

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

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

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

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

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

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

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

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

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

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

contextmenu: дескриптор графика, по умолчанию [](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: строка, по умолчанию "" ¶

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

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

Имя класса графического объекта. 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: цветовой спектр, по умолчанию [0 0 0] ¶

Цвет текста. См. цветовой спектр.

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

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

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

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

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

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

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

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

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

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

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

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

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

fontweight: "bold" | {"normal"} ¶

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

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

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

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

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

Внешний вид области текста ¶

backgroundcolor: цветовой спектр, по умолчанию "none" ¶

Цвет области фона. См. цветовой спектр.

edgecolor: цветовой спектр, по умолчанию "none" ¶

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

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

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

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

Ширина контура области текста.

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

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