TiledChartLayout Properties

Мозаичный внешний вид и поведение размещения графика

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

t = tiledlayout(2,2);
t.TileSpacing = 'compact';

Размещение

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

Размер сетки в виде вектора из формы [m n], где m количество строк и n количество столбцов. Можно установить это свойство только, когда все мозаики в размещении пусты. Когда вы устанавливаете это свойство, MATLAB® устанавливает TileArrangement свойство к 'fixed'.

Значение этого свойства может измениться автоматически для размещений, которые имеют TileArrangement набор свойств к 'flow'. Например, если родительский контейнер изменяет размер или количество осей в изменениях макета, обновления размера сетки, чтобы вместить те изменения.

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

Расположение мозаики, возвращенное как одно из этих значений:

  • 'fixed' — Размещение имеет постоянное число строк и столбцов, как определено GridSize свойство. m- n размещение с этим расположением мозаики может отобразиться до m*n plots.

  • 'flow' — Размещение имеет переменное количество строк и столбцов, которые могут отобразить любое количество графиков. Каждый раз вы вызываете nexttile, обратные течения размещения по мере необходимости, чтобы вместить новые оси при поддержании соотношения сторон примерно 4:3 для всех мозаик.

MATLAB устанавливает значение этого свойства к 'fixed' если вы вручную устанавливаете GridSize свойство.

Интервал мозаики в виде 'loose', 'compact', 'tight' или 'none'. Используйте это свойство управлять интервалом между мозаиками.

Эта таблица показывает, как каждое значение влияет на внешний вид 2- 2 размещение.

ЗначениеВнешний вид

'loose'

Tiled chart layout with 'loose' tile spacing.

'compact'

Tiled chart layout with 'compact' tile spacing.

'tight'

Tiled chart layout with 'tight' tile spacing.

'none'

Tiled chart layout with 'none' tile spacing.

Дополнение вокруг периметра размещения в виде 'loose', 'compact', или 'tight'. Размещение обеспечивает пробел для всех художественных оформлений, таких как подписи по осям, независимо от значения этого свойства.

Эта таблица показывает, как каждое значение влияет на внешний вид 2- 2 размещение.

ЗначениеВнешний вид

'loose'

Tiled chart layout with 'loose' padding.

'compact'

Tiled chart layout with 'compact' padding.

'tight'

Tiled chart layout with 'tight' padding.

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

ЗначениеОписание
'rowmajor'

Числа мозаики увеличиваются через строки, слева направо. Например, это изображение показывает упорядоченные по строкам индексы мозаики для размещения 2 на 2.

'columnmajor'

Числа мозаики увеличивают вниз столбцы. Например, это изображение показывает упорядоченные по столбцам индексы мозаики для размещения 2 на 2.

Метки

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

Text объект для разделяемого заголовка. Чтобы добавить разделяемый заголовок, установите String свойство Text объект. Чтобы изменить внешний вид заголовка, такой как стиль шрифта или цвет, устанавливают другие свойства. Например, создайте разделяемый заголовок для размещения 2 на 2, которое имеет полужирную толщину шрифта.

t = tiledlayout(2,2);
t.Title.String = 'My Title';
t.Title.FontWeight = 'bold';

В качестве альтернативы передайте TiledChartLayout возразите против title функция.

title(t,'My Title','FontWeight','normal')

Для полного списка свойств, которые можно задать, смотрите Text Properties.

Примечание

Text объект не содержится в Children свойство размещения, таким образом, это не может быть возвращено findobj функция.

Текстовый объект для разделяемого подзаголовка. Чтобы добавить подзаголовок, установите String свойство текстового объекта. Чтобы изменить его внешний вид, такой как угол шрифта, устанавливают другие свойства. Для полного списка смотрите Text Properties.

t = tiledlayout(2,2);
t.Subtitle.String = 'An Insightful Subtitle';
t.Subtitle.FontAngle = 'italic';

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

subtitle('An Insightful Subtitle','FontAngle','italic')

Или используйте title функция, и задает два входных параметра вектора символов и два выходных аргумента. Затем установите свойства на втором текстовом объекте, возвращенном функцией.

[tt,s] = title(t,'Clever Title','An Insightful Subtitle');
s.FontAngle = 'italic';

Примечание

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

Text объект для разделяемого x - подпись по осям. Чтобы добавить разделяемый x - подпись по осям, установите String свойство текстового объекта. Чтобы изменить внешний вид метки, такой как размер шрифта, устанавливают другие свойства. Например, создайте разделяемый x - подпись по осям со шрифтом с 14 точками для размещения 2 на 2.

t = tiledlayout(2,2);
t.XLabel.String = 'My x-Axis Label';
t.XLabel.FontSize = 14;

В качестве альтернативы передайте TiledChartLayout возразите против xlabel функция.

xlabel(t,'My x-Axis Label','FontSize',14)

Для полного списка свойств можно задать, видеть Text Properties.

Примечание

Text объект не содержится в осях Children свойство, таким образом, это не может быть возвращено findobj.

Text объект для разделяемого y - подпись по осям. Чтобы добавить разделяемый y - подпись по осям, установите String свойство текстового объекта. Чтобы изменить внешний вид метки, такой как размер шрифта, устанавливают другие свойства. Например, создайте разделяемый y - подпись по осям со шрифтом с 14 точками для размещения 2 на 2.

t = tiledlayout(2,2);
t.YLabel.String = 'My y-Axis Label';
t.YLabel.FontSize = 14;

В качестве альтернативы передайте TiledChartLayout возразите против ylabel функция.

ylabel(t,'My y-Axis Label','FontSize',14)

Для полного списка свойств можно задать, видеть Text Properties.

Примечание

Text объект не содержится в осях Children свойство, таким образом, это не может быть возвращено findobj.

Положение

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

Внешний размер и местоположение, включая поля для художественных оформлений такие заголовки и подписи по осям в виде четырехэлементного вектора из формы [left bottom width height]. Значения в векторе находятся в модулях, заданных Units свойство. Значение по умолчанию [0 0 1 1] включает целую внутреннюю часть контейнера.

  • left и bottom элементы задают расстояние от левого нижнего угла контейнера (обычно фигура, панель или вкладка) к левому нижнему углу внешнего контура положения.

  • width и height элементами являются внешние размерности контура положения.

В следующем размещении синий прямоугольник представляет OuterPosition свойство и красный прямоугольник представляют InnerPosition и Position свойства (которые имеют то же значение).

2-by-2 layout with a blue rectangle that surrounds the four axes and labels. A red rectangle surrounds the four plot boxes only.

Примечание

Установка этого свойства не оказывает влияния, когда родительским контейнером является TiledChartLayout.

Внутренний размер и местоположение, исключая поля для художественных оформлений такие заголовки и подписи по осям в виде четырехэлементного вектора из формы [left bottom width height]. Это свойство эквивалентно Position свойство.

Примечание

Установка этого свойства не оказывает влияния, когда родительским контейнером является TiledChartLayout.

Внутренний размер и местоположение, исключая поля для художественных оформлений такие заголовки и подписи по осям в виде четырехэлементного вектора из формы [left bottom width height]. Значения в векторе находятся в модулях, заданных Units свойство.

  • left и bottom элементы задают расстояние от левого нижнего угла контейнера (обычно фигура, панель или вкладка) к левому нижнему углу контура положения.

  • width и height элементами являются размерности контура положения. Для осей в 3-D представлении, Position свойство является наименьшим прямоугольником, который заключает оси.

В следующем размещении синий прямоугольник представляет OuterPosition свойство и красный прямоугольник представляют InnerPosition и Position свойства (которые имеют то же значение).

2-by-2 layout with a blue rectangle that surrounds the four axes and labels. A red rectangle surrounds the four plot boxes only.

Примечание

Установка этого свойства не оказывает влияния, когда родительским контейнером является TiledChartLayout.

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

  • 'outerposition'OuterPosition свойство остается постоянным, когда вы добавляете, удаляете, или художественные оформления изменения, такие как заголовок или подпись по осям. Если какие-либо позиционные корректировки необходимы, MATLAB настраивает InnerPosition свойство.

  • 'innerposition'InnerPosition свойство остается постоянным, когда вы добавляете, удаляете, или художественные оформления изменения, такие как заголовок или подпись по осям. Если какие-либо позиционные корректировки необходимы, MATLAB настраивает OuterPosition свойство.

Примечание

Установка этого свойства не оказывает влияния, когда родительским контейнером является TiledChartLayout.

Модули положения в виде одного из значений в этой таблице.

UnitsОписание
'normalized' (значение по умолчанию)Нормированный относительно родительского контейнера, который обычно является фигурой. Левый нижний угол фигуры сопоставляет с (0,0) и правый верхний угол сопоставляет с (1,1).
'inches''inches'.
'centimeters''centimeters'.
'characters'

На основе размера символа системного шрифта по умолчанию.

  • Ширина символов = ширина буквы x.

  • Высота символа = расстояние между базовыми линиями двух строк текста.

'points''points'. Один пункт равен 1/72 дюйма.
'pixels'

'pixels'.

  • На Windows® системы, пиксель является 1/96-м из дюйма.

  • В системах Macintosh пиксель составляет 1/72 дюйма.

  • На Linux® системы, размер пикселя определяется вашим системным разрешением.

Все модули измеряются от нижнего левого угла родительского контейнера.

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

Если вы задаете Position и Units свойства как Name,Value пары при создании объекта, затем порядок вопросов спецификации. Например, чтобы установить положение в определенных модулях, затем необходимо установить Units свойство перед Position свойство.

Параметры макета в виде TiledChartLayoutOptions возразите или GridLayoutOptions объект. Используйте это свойство расположить вложенное размещение в его родительском размещении. Например, чтобы расположить размещение в другом мозаичном размещении графика, установите Tile и TileSpan свойства на TiledChartLayoutOptions объект.

Например, этот код положения layout2 в третью мозаику layout1.

layout1 = tiledlayout(2,2);
layout2 = tiledlayout(layout1,1,3);
layout2.Layout.Tile = 3;

Чтобы заставить вложенное размещение охватить несколько мозаик, задайте TileSpan свойство как двухэлементный вектор. Например, этот код охватывает layout2 через одну строку и два столбца мозаик.

layout2.Layout.TileSpan = [1 2];
Если вы заполняете все мозаики в обоих размещениях, составное размещение выглядит так:

2-by-2 layout with a nested 1-by-3 layout in the second row.

Чтобы поместить размещение в размещение сетки в рамках приложения, задайте это свойство как GridLayoutOptions объект. Для получения дополнительной информации о работе с размещениями сетки в приложениях, смотрите uigridlayout.

Если размещение не является дочерним элементом другого размещения (например, если это - дочерний элемент фигуры или панели), то это свойство пусто и не оказывает влияния.

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

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

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

По умолчанию нет никакой разделяемой панели инструментов, и каждый из отдельных объектов осей имеет свою собственную панель инструментов. Когда вы создаете разделяемую панель инструментов, панели инструментов на отдельных объектах осей становятся скрытыми. Если вы не хотите панелей инструментов на размещении, оставляете это свойство пустым и устанавливаете набор Visible свойство AxesToolbar возразите против 'off' поскольку каждый исключает.

t = tiledlayout(2,1);
ax = nexttile;
ax.Toolbar.Visible = 'off';

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

  • 'on' — Отобразите объект.

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

Коллбэки

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

Функция создания объекта в виде одного из этих значений:

  • Указатель на функцию.

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

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

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

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

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

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

Функция удаления объекта в виде одного из этих значений:

  • Указатель на функцию.

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

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

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

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

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

Контроль выполнения обратного вызова

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

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

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

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

  • Прерывающий обратный вызов — это обратный вызов, который пытается прервать текущий обратный вызов.

MATLAB определяет поведение прерывания коллбэка каждый раз, когда это выполняет команду, которая обрабатывает очередь коллбэка. Эти команды включают drawnow, figure, uifigure, getframe, waitfor, и pause.

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

Если рабочий коллбэк действительно содержит одну из этих команд, то Interruptible свойство объекта, который владеет рабочим коллбэком, определяет, происходит ли прерывание:

  • Если значение Interruptible 'off', затем никакое прерывание не происходит. Вместо этого BusyAction свойство объекта, который владеет прерыванием обратного вызова, определяет, отбрасывается ли прерывание обратного вызова или добавляется к очереди коллбэка.

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

Примечание

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

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

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

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

Примечание

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

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

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

  • Прерывающий обратный вызов — это обратный вызов, который пытается прервать текущий обратный вызов.

BusyAction свойство определяет поведение постановки в очередь коллбэка только, когда оба из этих условий соблюдают:

  • Рабочий коллбэк содержит команду, которая обрабатывает очередь коллбэка, такой как drawnow, figure, uifigure, getframe, waitfor, или pause.

  • Значение Interruptible свойством объекта, который владеет рабочим коллбэком, является 'off'.

При этих условиях, BusyAction свойство объекта, который владеет прерыванием обратного вызова, определяет, как MATLAB обрабатывает прерывание обратного вызова. Это возможные значения BusyAction свойство:

  • 'queue' — Помещает прерывание обратного вызова в очередь, чтобы быть обработанным после рабочего выполнения концов коллбэка.

  • 'cancel' — Не выполняет прерывание обратного вызова.

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

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

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

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

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

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

Родительский контейнер в виде FigureПанель, Tab, TiledChartLayout, или GridLayout объект.

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

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

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

  • 'on' — Указатель на объект всегда отображается.

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

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

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

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

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

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

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

Тип графического объекта, возвращенного как 'tiledlayout'.

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

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

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

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

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

Поведение изменяется в R2021a

Смотрите также

|

Введенный в R2019b