Exponenta Banner
exponenta event banner

Свойства линии

Внешний вид и поведение линии диаграммы

развернуть все на странице

Line свойства управляют внешним видом и поведением Line объект. Изменяя значения свойств, можно изменять некоторые аспекты линейной диаграммы. Используйте точечную нотацию для запроса и задания свойств.

p = plot(1:10);
c = p.Color;
p.Color = 'red';

Линия

развернуть все

Цвет линии, определяемый как триплет RGB, шестнадцатеричный код цвета, имя цвета или короткое имя. Значение по умолчанию [0 0 0] соответствует черному.

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный цветовой код.

  • Триплет RGB - это трехэлементный вектор строки, элементы которого задают интенсивности красной, зеленой и синей составляющих цвета. Интенсивности должны находиться в диапазоне [0,1]; например, [0.4 0.6 0.7].

  • Шестнадцатеричный цветовой код - это символьный вектор или строковый скаляр, начинающийся с хэш-символа (#), за которыми следуют три или шесть шестнадцатеричных цифр, которые могут варьироваться от 0 кому F. Значения не чувствительны к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Можно также задать некоторые общие цвета по имени. В этой таблице перечислены параметры именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Имя цветаКраткое имяТриплет RGBШестнадцатеричный цветовой кодВнешность
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'НеприменимоНеприменимоНеприменимоБез цвета

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB ®, используемых на многих типах графиков.

Триплет RGBШестнадцатеричный цветовой кодВнешность
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Пример: 'blue'

Пример: [0 0 1]

Пример: '#0000FF'

Управлять тем, как Color установлено свойство, указанное как одно из следующих значений:

  • 'auto' - MATLAB управляет значением Color путем выбора цвета из ColorOrder свойства осей.

  • 'manual' - Вы управляете значением Color вручную, либо путем установки значения Color свойство непосредственно на объекте или путем включения цвета в LineSpec аргумент при вызове функции печати.

При изменении значения Color свойство вручную, MATLAB изменяет значение ColorMode свойство для 'manual'.

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

Стиль линииОписаниеРезультирующая линия
'-'Сплошная линия

'--'Пунктирная линия

':'Пунктирная линия

'-.'Пунктирная линия

'none'Без строкиБез строки

Управлять тем, как LineStyle установлено свойство, указанное как одно из следующих значений:

  • 'auto' - MATLAB управляет значением LineStyle путем выбора стиля линии из LineStyleOrder свойства осей.

  • 'manual' - Вы управляете значением LineStyle вручную, либо путем установки значения LineStyle свойство непосредственно на объекте или путем указания LineSpec аргумент при вызове функции печати.

При изменении значения LineStyle свойство вручную, MATLAB изменяет значение LineStyleMode свойство для 'manual'.

Ширина линии, заданная как положительное значение в точках, где 1 точка = 1/72 дюйма. Если линия имеет маркеры, то ширина линии также влияет на кромки маркера.

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

Индекс серии, указанный как целое число, большее или равное 0. Это свойство полезно для переназначения цветов, стилей линий или маркеров нескольких Line объекты, чтобы они совпадали друг с другом. По умолчанию SeriesIndex свойство Line объект - это число, соответствующее его порядку создания, начиная с 1.

MATLAB использует число для вычисления индексов для назначения цвета, стиля линии или маркеров при вызове функций печати. Индексы относятся к строкам массивов, хранящихся в ColorOrder и LineStyleOrder свойства осей.

MATLAB автоматически обновляет цвет, стиль линий или маркеры Line объект при изменении его SeriesIndexили при изменении ColorOrder или LineStyleOrder свойства на осях. Однако для того, чтобы изменения имели какой-либо эффект, должны быть выполнены следующие условия:

  • По крайней мере одно из следующих свойств Line объект имеет значение 'auto': ColorMode, LineStyleMode, или MarkerMode.

  • SeriesIndex свойство на Line объект больше, чем 0.

  • NextSeriesIndex свойство объекта axes больше, чем 0.

Стиль углов линий, указанный как 'round', 'miter', или 'chamfer'. Эта таблица иллюстрирует внешний вид различных значений.

'round''miter''chamfer'

Внешний вид 'round' вариант может выглядеть иначе, если Renderer свойство фигуры имеет значение 'opengl' вместо 'painters'.

Острые вертикальные и горизонтальные линии, указанные как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Резкость вертикальных и горизонтальных линий для устранения неравномерности внешнего вида.

  • 'off' - Не затачивать вертикальные или горизонтальные линии. Линии могут выглядеть неравномерными по толщине или цвету.

Если связанный рисунок имеет GraphicsSmoothing свойство имеет значение 'on' и Renderer свойство имеет значение 'opengl', то фигура применяет метод сглаживания к графикам. В некоторых случаях этот метод сглаживания может привести к тому, что вертикальные и горизонтальные линии окажутся неравномерными по толщине или цвету. Используйте AlignVertexCenters для устранения неравномерности внешнего вида.

Примечание

Необходимо иметь графическую карту, поддерживающую эту функцию. Чтобы проверить, поддерживается ли функция, вызовите rendererinfo функция. Если он поддерживается, rendererinfo возвращает значение 1 для info.Details.SupportsAlignVertexCenters.

Маркеры

развернуть все

Символ маркера, указанный как одно из значений, перечисленных в этой таблице. По умолчанию объект не отображает маркеры. Задание обозначения маркера добавляет маркеры в каждую точку данных или вершину.

СтоимостьОписание
'o'Круг
'+'Знак «Плюс»
'*'Звездочка
'.'Пункт
'x'Крест
'_'Горизонтальная линия
'|'Вертикальная линия
'square' или 's'Квадрат
'diamond' или 'd'Алмаз
'^'Треугольник, направленный вверх
'v'Треугольник, направленный вниз
'>'Прямоугольный треугольник
'<'Треугольник, указывающий влево
'pentagram' или 'p'Пятиконечная звезда (пентаграмма)
'hexagram' или 'h'Шестиконечная звезда (гексаграмма)
'none'Без маркеров

Управлять тем, как Marker установлено свойство, указанное как одно из следующих значений:

  • 'auto' - MATLAB управляет значением объекта Marker собственность.

  • 'manual' - Вы управляете значением Marker вручную, либо путем установки значения Marker свойство непосредственно на объекте или путем включения маркера в LineSpec аргумент при вызове функции печати.

При изменении значения Marker свойство вручную, MATLAB изменяет значение MarkerMode свойство для 'manual'.

Индексы точек данных, в которых отображаются маркеры, определяемые как вектор положительных целых чисел. Если индексы не указаны, MATLAB отображает маркер в каждой точке данных.

Примечание

Для просмотра маркеров необходимо также указать обозначение маркера.

Пример: plot(x,y,'-o','MarkerIndices',[1 5 10]) отображает маркер окружности в первой, пятой и десятой точках данных.

Пример: plot(x,y,'-x','MarkerIndices',1:3:length(y)) отображает перекрестный маркер каждые три точки данных.

Пример: plot(x,y,'Marker','square','MarkerIndices',5) отображает один квадратный маркер в пятой точке данных.

Размер маркера, заданный как положительное значение в точках, где 1 точка = 1/72 дюйма.

Цвет контура маркера, указанный как 'auto', триплет RGB, шестнадцатеричный цветовой код, имя цвета или короткое имя. Значение по умолчанию 'auto' использует тот же цвет, что и Color собственность.

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный цветовой код.

  • Триплет RGB - это трехэлементный вектор строки, элементы которого задают интенсивности красной, зеленой и синей составляющих цвета. Интенсивности должны находиться в диапазоне [0,1]; например, [0.4 0.6 0.7].

  • Шестнадцатеричный цветовой код - это символьный вектор или строковый скаляр, начинающийся с хэш-символа (#), за которыми следуют три или шесть шестнадцатеричных цифр, которые могут варьироваться от 0 кому F. Значения не чувствительны к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Можно также задать некоторые общие цвета по имени. В этой таблице перечислены параметры именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Имя цветаКраткое имяТриплет RGBШестнадцатеричный цветовой кодВнешность
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'НеприменимоНеприменимоНеприменимоБез цвета

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB, используемых на многих типах графиков.

Триплет RGBШестнадцатеричный цветовой кодВнешность
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Цвет заливки маркера, указанный как 'auto', триплет RGB, шестнадцатеричный цветовой код, имя цвета или короткое имя. 'auto' использует тот же цвет, что и Color свойства родительских осей. При указании 'auto' а поле графика осей невидимо, цвет заливки маркера - это цвет фигуры.

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный цветовой код.

  • Триплет RGB - это трехэлементный вектор строки, элементы которого задают интенсивности красной, зеленой и синей составляющих цвета. Интенсивности должны находиться в диапазоне [0,1]; например, [0.4 0.6 0.7].

  • Шестнадцатеричный цветовой код - это символьный вектор или строковый скаляр, начинающийся с хэш-символа (#), за которыми следуют три или шесть шестнадцатеричных цифр, которые могут варьироваться от 0 кому F. Значения не чувствительны к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Можно также задать некоторые общие цвета по имени. В этой таблице перечислены параметры именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Имя цветаКраткое имяТриплет RGBШестнадцатеричный цветовой кодВнешность
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'НеприменимоНеприменимоНеприменимоБез цвета

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB, используемых на многих типах графиков.

Триплет RGBШестнадцатеричный цветовой кодВнешность
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

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

развернуть все

Значения x, указанные как вектор.

  • Для 2-D линейных графиков, если значения x не указаны, MATLAB использует индексы YData в качестве значений x для графика. XData и YData должны иметь одинаковую длину.

  • Для 3-D линейных графиков, если значения x не указаны, MATLAB использует индексы ZData в качестве значений x для графика. XData, YData, и ZData должны иметь одинаковую длину.

Пример: [1:10]

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

Режим выбора для XData, указанное как одно из следующих значений:

  • 'auto' - использовать индексы значений в YData (или ZData для 3-D участков).

  • 'manual' - Использовать значения, заданные вручную. Чтобы задать значения, установите XData свойство или укажите входной аргумент X к функции печати.

Переменная, связанная с XData, указанный как символьный вектор или строка, содержащая имя переменной рабочей области MATLAB. MATLAB вычисляет переменную в базовой рабочей области для создания XData.

По умолчанию связанная переменная отсутствует, поэтому значение является пустым символьным вектором. ''. При связывании переменной MATLAB не обновляет XData значения немедленно. Для принудительного обновления значений данных используйте refreshdata функция.

Примечание

При изменении одного свойства источника данных на переменную, содержащую данные другого измерения, функция может создать предупреждение и не отображать график, пока не будут изменены все свойства источника данных на соответствующие значения.

Пример: 'x'

значения y, заданные как вектор. Для 2-D линейных графиков: XData и YData должны иметь одинаковую длину. Для 3-D линейных графиков: XData, YData, и ZData должны иметь одинаковую длину.

Пример: [1:10]

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

Переменная, связанная с YData, указанный как символьный вектор или строка, содержащая имя переменной рабочей области MATLAB. MATLAB вычисляет переменную в базовой рабочей области для создания YData.

По умолчанию связанная переменная отсутствует, поэтому значение является пустым символьным вектором. ''. При связывании переменной MATLAB не обновляет YData значения немедленно. Для принудительного обновления значений данных используйте refreshdata функция.

Примечание

При изменении одного свойства источника данных на переменную, содержащую данные другого измерения, функция может создать предупреждение и не отображать график, пока не будут изменены все свойства источника данных на соответствующие значения.

Пример: 'y'

Значения z для графика линии 3-D, заданные как вектор. XData, YData, и ZData должны иметь одинаковую длину.

Пример: [1:10]

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

Переменная, связанная с ZData, указанный как символьный вектор или строка, содержащая имя переменной рабочей области MATLAB. MATLAB вычисляет переменную в базовой рабочей области для создания ZData.

По умолчанию связанная переменная отсутствует, поэтому значение является пустым символьным вектором. ''. При связывании переменной MATLAB не обновляет ZData значения немедленно. Для принудительного обновления значений данных используйте refreshdata функция.

Примечание

При изменении одного свойства источника данных на переменную, содержащую данные другого измерения, функция может создать предупреждение и не отображать график, пока не будут изменены все свойства источника данных на соответствующие значения.

Пример: 'z'

Полярные данные координат

развернуть все

Угловые значения, заданные как вектор. ThetaData и RData должны быть векторами одинаковой длины.

Это свойство применяется только к линиям в полярных осях.

Режим выбора для ThetaData значение свойства, указанное как одно из следующих значений:

  • 'auto' - Автоматически выбрать значение.

  • 'manual' - использовать указанные значения. Чтобы задать значение, установите значение ThetaData свойство или укажите входной аргумент theta к функции печати.

Это свойство применяется только к линиям в полярных осях.

Переменная, связанная с ThetaData, заданный как вектор символов, содержащий имя переменной рабочей области MATLAB. MATLAB вычисляет переменную в базовой рабочей области для создания RData.

По умолчанию связанная переменная отсутствует, поэтому значение является пустым символьным вектором. ''. При связывании переменной MATLAB не обновляет ThetaData значения немедленно. Для принудительного обновления значений данных используйте refreshdata функция.

Примечание

При изменении одного свойства источника данных на переменную, содержащую данные другого измерения, функция может создать предупреждение и не отображать график, пока не будут изменены все свойства источника данных на соответствующие значения.

Это свойство применяется только к линиям в полярных осях.

Значения радиуса, заданные как вектор. ThetaData и RData должны быть векторами одинаковой длины.

Это свойство применяется только к линиям в полярных осях.

Переменная, связанная с RData, заданный как вектор символов, содержащий имя переменной рабочей области MATLAB. MATLAB вычисляет переменную в базовой рабочей области для создания RData.

По умолчанию связанная переменная отсутствует, поэтому значение является пустым символьным вектором. ''. При связывании переменной MATLAB не обновляет RData значения немедленно. Для принудительного обновления значений данных используйте refreshdata функция.

Примечание

При изменении одного свойства источника данных на переменную, содержащую данные другого измерения, функция может создать предупреждение и не отображать график, пока не будут изменены все свойства источника данных на соответствующие значения.

Это свойство применяется только к линиям в полярных осях.

Данные о географических координатах

развернуть все

Значения широты, заданные как вектор. LatitudeData и LongitudeData должны быть векторами одинаковой длины.

Это свойство применяется только к линиям в географических осях.

Переменная, связанная с LatitudeData, заданный как вектор символов, содержащий имя переменной рабочей области MATLAB. MATLAB вычисляет переменную в базовой рабочей области для создания LatitudeData.

По умолчанию связанная переменная отсутствует, поэтому значение является пустым символьным вектором. ''. При связывании переменной MATLAB не обновляет LatitudeData значения немедленно. Для принудительного обновления значений данных используйте refreshdata функция.

Примечание

При изменении одного свойства источника данных на переменную, содержащую данные другого измерения, функция может создать предупреждение и не отображать график, пока не будут изменены все свойства источника данных на соответствующие значения.

Это свойство применяется только к линиям в географических осях.

Значения долготы, заданные как вектор. LongitudeData и LatitudeData должны быть векторами одинаковой длины.

Это свойство применяется только к линиям в географических осях.

Переменная, связанная с LongitudeData, заданный как вектор символов, содержащий имя переменной рабочей области MATLAB. MATLAB вычисляет переменную в базовой рабочей области для создания LongitudeData.

По умолчанию связанная переменная отсутствует, поэтому значение является пустым символьным вектором. ''. При связывании переменной MATLAB не обновляет LongitudeData значения немедленно. Для принудительного обновления значений данных используйте refreshdata функция.

Примечание

При изменении одного свойства источника данных на переменную, содержащую данные другого измерения, функция может создать предупреждение и не отображать график, пока не будут изменены все свойства источника данных на соответствующие значения.

Это свойство применяется только к линиям в географических осях.

Легенда

развернуть все

Метка легенды, заданная как вектор символа или скаляр строки. Легенда не отображается, пока не будет вызван legend команда. Если текст не указан, то legend устанавливает метку с помощью формы 'dataN'.

Это свойство доступно только для чтения.

Элемент управления для включения или исключения объекта из легенды, возвращаемый как Annotation объект. Установить нижележащий IconDisplayStyle к одному из следующих значений:

  • 'on' - Включить объект в легенду (по умолчанию).

  • 'off' - не включать объект в легенду.

Например, чтобы исключить графический объект, go, из набора условных обозначений IconDisplayStyle свойство для 'off'.

go.Annotation.LegendInformation.IconDisplayStyle = 'off';

Можно также управлять элементами легенды с помощью legend функция. Укажите первый входной аргумент в качестве вектора включаемых графических объектов. Если в первом входном аргументе не указан существующий графический объект, он не отображается в легенде. Однако графические объекты, добавленные к осям после создания легенды, появляются в легенде. Рекомендуется создать легенду после создания всех графиков, чтобы избежать дополнительных элементов.

Интерактивность

развернуть все

Состояние видимости, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Просмотр объекта.

  • 'off' - Скрыть объект, не удаляя его. По-прежнему можно получить доступ к свойствам невидимого объекта.

Содержимое подсказки данных, указанное как DataTipTemplate объект. Можно управлять содержимым, появляющимся в подсказке данных, изменяя свойства нижележащего содержимого. DataTipTemplate объект. Список свойств см. в разделе Свойства DataTipTemplate.

Пример изменения подсказок по данным см. в разделе Создание подсказок по пользовательским данным.

Примечание

DataTipTemplate объект не возвращен findobj или findall, и он не копируется copyobj.

Контекстное меню, указанное как ContextMenu объект. Это свойство используется для отображения контекстного меню при щелчке объекта правой кнопкой мыши. Создайте контекстное меню с помощью команды uicontextmenu функция.

Примечание

Если PickableParts свойство имеет значение 'none' или если HitTest свойство имеет значение 'off', то контекстное меню не появляется.

Состояние выбора, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Выбрано. Если щелкнуть объект в режиме редактирования печати, то MATLAB задает его Selected свойство для 'on'. Если SelectionHighlight свойство также имеет значение 'on'затем MATLAB отображает дескрипторы выбора вокруг объекта.

  • 'off' - Не выбрано.

Отображение маркеров выбора при выборе, указанных как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Отображение дескрипторов выбора, когда Selected свойство имеет значение 'on'.

  • 'off' - Никогда не отображать дескрипторы выбора, даже когда Selected свойство имеет значение 'on'.

Отсечение объекта до пределов осей, указанных как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • Значение 'on' зажимает части объекта, находящиеся вне пределов осей.

  • Значение 'off' отображает весь объект, даже если его части выходят за пределы осей. Части объекта могут появляться за пределами осей, если при создании графика задать hold onзаморозить масштабирование оси, а затем создать объект таким образом, чтобы он был больше исходного графика.

Clipping свойство осей, содержащих объект, должно иметь значение 'on'. В противном случае это свойство не действует. Дополнительные сведения о режиме отсечения см. в разделе Clipping свойства осей.

Отзывы

развернуть все

Обратный вызов щелчком мыши, указанный как одно из следующих значений:

  • Дескриптор функции

  • Массив ячеек, содержащий дескриптор функции и дополнительные аргументы

  • Символьный вектор, являющийся допустимой командой или функцией MATLAB, которая вычисляется в базовой рабочей области (не рекомендуется)

Это свойство используется для выполнения кода при щелчке по объекту. Если это свойство задается с помощью дескриптора функции, MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:

  • Clicked object - доступ к свойствам нажатого объекта из функции обратного вызова.

  • Данные события - пустой аргумент. Замените его на символ тильды (~) в определении функции, чтобы указать, что этот аргумент не используется.

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

Примечание

Если PickableParts свойство имеет значение 'none' или если HitTest свойство имеет значение 'off', то этот обратный вызов не выполняется.

Функция создания объекта, заданная как одно из следующих значений:

  • Дескриптор функции.

  • Массив ячеек, в котором первый элемент является дескриптором функции. Последующие элементы в массиве ячеек являются аргументами для передачи функции обратного вызова.

  • Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.

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

Это свойство определяет функцию обратного вызова, выполняемую при создании объекта MATLAB. MATLAB инициализирует все значения свойств перед выполнением CreateFcn обратный вызов. Если не указать CreateFcn , то MATLAB выполняет функцию создания по умолчанию.

Установка CreateFcn свойство существующего компонента не оказывает никакого влияния.

Если это свойство указано как дескриптор функции или массив ячеек, можно получить доступ к объекту, создаваемому с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo для доступа к объекту.

Функция удаления объекта, заданная как одно из следующих значений:

  • Дескриптор функции.

  • Массив ячеек, в котором первый элемент является дескриптором функции. Последующие элементы в массиве ячеек являются аргументами для передачи функции обратного вызова.

  • Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.

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

Это свойство определяет функцию обратного вызова, выполняемую при удалении объекта MATLAB. MATLAB выполняет команду DeleteFcn обратный вызов перед уничтожением свойств объекта. Если не указать DeleteFcn , то MATLAB выполняет функцию удаления по умолчанию.

Если это свойство указано как дескриптор функции или массив ячеек, можно получить доступ к удаляемому объекту с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo для доступа к объекту.

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

развернуть все

Прерывание обратного вызова, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Это свойство определяет, можно ли прервать выполняющийся обратный вызов. Существует два состояния обратного вызова:

  • Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.

  • Обратный вызов с прерыванием - это обратный вызов, который пытается прервать выполняющийся обратный вызов.

Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов (если он существует). Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание.

  • Значение 'on' позволяет другим обратным вызовам прерывать обратные вызовы объекта. Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь, например, при наличии drawnow, figure, uifigure, getframe, waitfor, или pause команда.

    • Если выполняемый обратный вызов содержит одну из этих команд, MATLAB останавливает выполнение обратного вызова в этот момент и выполняет прерванный обратный вызов. MATLAB возобновляет выполнение выполняющегося обратного вызова после завершения прерванного обратного вызова.

    • Если выполняемый обратный вызов не содержит одну из этих команд, MATLAB завершает выполнение обратного вызова без прерывания.

  • Значение 'off' блокирует все попытки прерывания. BusyAction свойство объекта, владеющего прерывистым обратным вызовом, определяет, отбрасывается ли прерывистый обратный вызов или помещается в очередь.

Примечание

Прерывание и выполнение обратного вызова ведут себя по-разному в следующих ситуациях:

  • Если обратный вызов с прерыванием является DeleteFcn, CloseRequestFcn или SizeChangedFcn обратный вызов, то прерывание происходит независимо от Interruptible значение свойства.

  • Если выполняемый обратный вызов в данный момент выполняется waitfor функция, то прерывание происходит независимо от Interruptible значение свойства.

  • Timer объекты выполняются в соответствии с графиком независимо от Interruptible значение свойства.

Когда происходит прерывание, MATLAB не сохраняет состояние свойств или отображения. Например, объект, возвращенный gca или gcf при выполнении другого обратного вызова команда может измениться.

Очередь обратного вызова, указанная как 'queue' или 'cancel'. BusyAction определяет, как MATLAB обрабатывает выполнение прерывания обратных вызовов. Существует два состояния обратного вызова:

  • Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.

  • Обратный вызов с прерыванием - это обратный вызов, который пытается прервать выполняющийся обратный вызов.

Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов. Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание. Если прерывание не разрешено, то BusyAction свойство объекта, владеющего прерывистым обратным вызовом, определяет, отбрасывается он или помещается в очередь. Это возможные значения BusyAction свойство:

  • 'queue' - помещает обратный вызов с прерыванием в очередь, подлежащую обработке после завершения выполнения обратного вызова.

  • 'cancel' - не выполняет обратный вызов прерывания.

Возможность захвата щелчков мыши, указанных как одно из следующих значений:

  • 'visible' - Захват щелчков мыши при отображении. Visible свойство должно иметь значение 'on' и необходимо щелкнуть на части Line объект, имеющий определенный цвет. Нельзя щелкнуть деталь, для которой свойство цвета имеет значение 'none'. Если график содержит маркеры, то весь маркер можно щелкнуть, если кромка или заливка имеют определенный цвет. HitTest определяет, Line объект отвечает на клик или если это делает предок.

  • 'all' - Захват щелчков мыши независимо от видимости. Visible свойство может иметь значение 'on' или 'off' и вы можете щелкнуть часть Line объект, не имеющий цвета. HitTest определяет, Line объект отвечает на клик или если это делает предок.

  • 'none' - Не удается зафиксировать щелчки мыши. Щелкните значок Line объект передает щелчок по нему объекту под ним в текущем виде окна фигуры. HitTest свойство не имеет эффекта.

Ответ на зафиксированные щелчки мыши, указанный как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Запустить ButtonDownFcn обратный вызов Line объект. Если вы определили ContextMenu затем вызовите контекстное меню.

  • 'off' - Инициировать обратные вызовы для ближайшего предка Line объект, имеющий один из следующих объектов:

    • HitTest свойство имеет значение 'on'

    • PickableParts свойство имеет значение, которое позволяет предку фиксировать щелчки мыши

Примечание

PickableParts определяет, Line объект может захватывать щелчки мыши. Если он не может, то HitTest свойство не имеет эффекта.

Это свойство доступно только для чтения.

Состояние удаления, возвращаемое как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState.

MATLAB устанавливает BeingDeleted свойство для 'on' когда DeleteFcn обратный вызов начинает выполнение. BeingDeleted свойство остается установленным в значение 'on' до тех пор, пока объект-компонент больше не будет существовать.

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

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

развернуть все

Родитель, указан как Axes, PolarAxes, Group, или Transform объект.

Дети, возвращенные как пустые GraphicsPlaceholder массив или DataTip массив объектов. Это свойство используется для просмотра списка подсказок по данным, отображаемых на диаграмме.

Невозможно добавить или удалить дочерние элементы с помощью Children собственность. Чтобы добавить дочерний элемент в этот список, установите Parent имущества DataTip объект к объекту диаграммы.

Видимость дескриптора объекта в Children свойство родительского объекта, указанное как одно из следующих значений:

  • 'on' - Дескриптор объекта всегда виден.

  • 'off' - Дескриптор объекта всегда невидим. Этот параметр полезен для предотвращения непреднамеренных изменений другой функцией. Установите HandleVisibility кому 'off' для временного скрытия дескриптора во время выполнения этой функции.

  • 'callback' - Дескриптор объекта виден из обратных вызовов или функций, вызываемых обратными вызовами, но не из функций, вызываемых из командной строки. Этот параметр блокирует доступ к объекту в командной строке, но разрешает доступ к нему функциям обратного вызова.

Если объект не указан в списке Children свойства родительского объекта, то функции, которые получают дескрипторы объектов путем поиска в иерархии объектов или запроса свойств дескрипторов, не могут вернуть его. Примеры таких функций включают get, findobj, gca, gcf, gco, newplot, cla, clf, и close функции.

Дескрипторы скрытых объектов по-прежнему действительны. Установка корня ShowHiddenHandles свойство для 'on' перечисление всех дескрипторов объектов независимо от их HandleVisibility параметр свойства.

Идентификаторы

развернуть все

Это свойство доступно только для чтения.

Тип графического объекта, возвращаемого как 'line'. Это свойство используется для поиска всех объектов данного типа в иерархии печати, например, для поиска типа с помощью findobj.

Идентификатор объекта, заданный как вектор символа или скаляр строки. Можно указать уникальный Tag для использования в качестве идентификатора объекта. При необходимости доступа к объекту в другом месте кода можно использовать findobj для поиска объекта на основе Tag значение.

Пользовательские данные, указанные как любой массив MATLAB. Например, можно указать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Это свойство используется для хранения произвольных данных объекта.

Если вы работаете в App Designer, создайте открытые или частные свойства в приложении для совместного использования данных вместо использования UserData собственность. Дополнительные сведения см. в разделе Общий доступ к данным в приложениях App Designer.

Вопросы совместимости

развернуть все

Не рекомендуется начинать с R2020a

См. также

| | | | |

Темы

Представлен до R2006a

Документация MATLAB

Поддержка