Общие свойства блока

Сведения о свойствах общих блоков

В этой таблице перечислены свойства, общие для всех Simulink® блоки, включая свойства коллбэка блоков (см. «Коллбэки для настраиваемого поведения модели»). Примеры команд, которые изменяют эти свойства, следуют за этой таблицей (см. Примеры настройки свойств блоков).

Общие свойства блока

СвойствоОписаниеЗначения

AncestorBlock

Имя библиотечного блока, с которым связан блок (для блоков с отключённой ссылкой).

вектор символов

AttributesFormatString

Текст аннотации блока (соответствует свойствам блока).

вектор символов

BackgroundColor

Блокируйте цвет фона.

значение цвета |<reservedrangesplaceholder0>

r, g, и b, - красные, зеленые, синие значения цвета в области значений от 0,0 до 1,0. Если задано, значение альфа (a) игнорируется.

Возможные значения цвета 'black', 'white', 'red', 'green', 'blue', 'cyan', 'magenta', 'yellow', 'gray', 'lightBlue', 'orange', 'darkGreen'.

BlockDescription

Описание блока показано в верхней части диалогового окна параметров блоков или инспектора свойств.

Символьный массив

BlockDiagramType

Возвращает model если он находится в открытой Диаграмме Simulink. Возвращает library если это библиотека Simulink.

'model' | 'library'

BlockType

Тип блока (только для чтения).

Символьный массив

BlockKeywords

Связывает одно или несколько ключевых слов с пользовательским библиотечным блоком.

вектор символов | строковый скаляр | строковые массивы

ClipboardFcn

Функция вызывается при копировании блока в буфер обмена (Ctrl + C) или при выборе Copy элемента меню.

функциональные | вектор символов

CloseFcn

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

функциональные | вектор символов

CommentedИсключить блок из симуляции.

{'off'} | 'on' | 'through'

CompiledBusType

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

Задайте порт или указатель на линию при использовании get_param. Для примера:

ports = get_param(gcb,'PortHandles');
feval(gcs,[],[],[],'compile');
bt = get_param(ports.Outport,'CompiledBusType')

См. раздел «Отображение информации о шине».

'NOT_BUS' | 'VIRTUAL_BUS' | 'NON_VIRTUAL_BUS'

CompiledIsActive

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

CompiledIsActive возвращает off если любое из следующих условий верно во время компиляции:

  • Блок является неактивным путем Inline Variant.

  • Блок является неактивным выбором Variant Subsystem.

  • Блок с комментариями находится в Subsystem блоке, который с комментариями.

  • Блок неактивен из-за условия, распространяемого из Variant Subsystem блока.

CompiledisActive возвращает off для неактивных вариантов и возвратов on для активных вариантов Подсистемы Вариантов.

'off' | 'on'

CompiledPortComplexSignals

Комплексность сигналов портов после обновления схемы. Перед запросом этого свойства необходимо скомпилировать модель. Для примера:

vdp([],[],[],'compile');
d = get_param(gcb,'CompiledPortComplexSignals');
vdp([],[],[],'term');
массив структур

CompiledPortDataTypes

Типы данных сигналов портов после обновления схемы. Перед запросом этого свойства необходимо скомпилировать модель. См. CompiledPortComplexSignals .

массив структур

CompiledPortDesignMin

Проектируйте минимум сигналов портов после обновления схемы. Перед запросом этого свойства необходимо скомпилировать модель. Для примера:

feval(gcs, [],[],[],'compile');
ports = get_param(gcb,'PortHandles');
min = get_param(ports.Outport, 'CompiledPortDesignMin')
feval(model, [],[],[],'term');
массив структур

CompiledPortDesignMax

Проектируйте максимальное количество сигналов портов во время компиляции. Перед запросом этого свойства необходимо скомпилировать модель. Для примера:

feval(gcs, [],[],[],'compile');
ports = get_param(gcb,'PortHandles');
max = get_param(ports.Outport, 'CompiledPortDesignMax')
feval(model, [],[],[],'term');
массив структур

CompiledPortDimensions

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

числовой массив

CompiledPortDimensionsMode

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

double номер. 0 указывает, что сигнал не имеет переменного размера. 1 указывает, что сигнал имеет переменный размер.

CompiledPortFrameData

Кадровый режим сигналов портов после обновления схемы. Перед запросом этого свойства необходимо скомпилировать модель.

массив структур

CompiledPortWidths

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

массив структур

CompiledSampleTime

Блочный шаг расчета после обновления схемы. Перед запросом этого свойства необходимо скомпилировать модель.

вектор [sample time, offset time]

или

камера {[sample time 1, offset time 1]; [sample time 2, offset time 2];..... [sample time n, offset time n]}

ContinueFcn

Функция вызывается при перезапуске симуляции (после паузы).

функциональные | вектор символов

CopyFcn

Функция вызывается при копировании блока. Для получения дополнительной информации см. Блок Коллбэка Параметров.

функциональные | вектор символов

DataTypeOverrideCompiled

Для внутреннего использования.

 

DeleteFcn

Функция вызывается при удалении блока. Для получения дополнительной информации см. Блок Коллбэка Параметров.

MATLAB® выражение

DestroyFcn

Функция вызывается, когда блок уничтожен. Для получения дополнительной информации см. Блок Коллбэка Параметров.

Выражение MATLAB

Description

Описание блока. Установите полем Описание (Description) на панели Общие (General) диалогового окна Свойства блока (Block Properties).

текст и лексемы

Diagnostics

Для внутреннего использования.

 

DialogParameters

Список имен/атрибутов специфичных для блока параметров для демаскированного блока или параметров маски для маскированного блока.

структура

DropShadow

Отобразите отбрасываемую тень.

{'off'} | 'on'

ExtModeLoggingSupported

Включите блок, чтобы поддержать загрузку данных сигнала в режим external mode (для примера с блоком возможностей).

{'off'} | 'on'

ExtModeLoggingTrig

Включите блок, чтобы действовать как триггерный блок для загрузки сигнала режима external mode.

{'off'} | 'on'

ExtModeUploadOptionВключите блок для загрузки данных сигнала во режим external mode, когда флажок Select all в диалоговом окне External Signal & Triggering не установлен. Значение log указывает, что блок загружает сигналы. Значение none указывает, что блок не загружает сигналы. Значение monitor в настоящее время не используется. Если установлен флажок Select all в диалоговом окне External Signal & Triggering, он переопределяет эту настройку параметра.{'none'} | 'log' | 'monitor'

FontAngle

Угол шрифта.

'normal' | 'italic' | 'oblique' | {'auto'}

FontName

Название шрифта.

Символьный массив

FontSize

Размер шрифта. Значение -1 указывает, что этот блок наследует размер шрифта, заданный DefaultBlockFontSize параметр модели.

реальные {'-1'}

FontWeight

Толщина шрифта.

'light' | 'normal' | 'demi' | 'bold' | {'auto'}

ForegroundColor

Цвет переднего плана значка блока.

значение цвета |'[r,g,b]' | '[r,g,b,a]'

r, g, и b, - красные, зеленые, синие значения цвета в области значений от 0,0 до 1,0. Значение изменяется, если оно слишком похоже на цвет холста (ScreenColor параметр). Использование get_param для возврата фактического значения. Если задано, значение альфа (a) игнорируется.

Возможные значения цвета 'black', 'white', 'red', 'green', 'blue', 'cyan', 'magenta', 'yellow', 'gray', 'lightBlue', 'orange', 'darkGreen'.

Handle

Указатель на блок.

реальный

HideAutomaticName

Укажите, отображения ли имя блока, заданное автоматически редактором Simulink Editor, в модели. Чтобы скрыть автоматические имена, используйте настройку по умолчанию 'on'. (The HideAutomaticNames параметр для модели также должен быть установлен в 'on'.) Установите значение 'off' отобразить имя, а также установить блок ShowName параметр в 'on'. Блоки, чьи ShowName параметр 'off' скрыты независимо от этого параметра. Дополнительные сведения о взаимодействии параметров см. в разделе «Скрыть или Отображение имена блоков».{'on'} | 'off'

HiliteAncestors

Для внутреннего использования.

 

InitFcn

Функция инициализации для блока. Создается на панели Callbacks диалогового окна Свойства модели (Model Properties). Для получения дополнительной информации смотрите Создание коллбэков модели.

На немаскированных блоках обновление схемы или выполнение симуляции вызывает эту функцию.

Выражение MATLAB

InputSignalNames

Имена входных сигналов.

массив ячеек

IntrinsicDialogParameters

Список имен/атрибутов специфичных для блока параметров (независимо от того, маскирован или демаскирован блок). Используйте вместо DialogParameters если вам нужны специфичные для блоков параметры для маскированных или демаскированных блоков.

структура

IOSignalStrings

Пути блоков к объектам, которые соединяются с Signal & Scope Manager. Программа Simulink сохраняет эти пути при сохранении модели.

список

IOType

Тип Signal & Scope Manager. Для внутреннего использования.

 

IsStateOwnerBlock

Указывает, является ли блок поддерживаемым блоком владельца состояния, который может использоваться с блоками State Reader и State Writer (только для чтения). См. State Reader и State Writer.

'off' | 'on'

LibraryVersion

Для связанного блока начальное значение этого свойства является ModelVersion библиотеки на момент создания ссылки. Значение обновляется с шагами в версии модели библиотеки.

вектор символов - {'1.1'}

LineHandles

Указатели на линии, соединенные с блоком.

структура

LinkData

Массив подробных сведений об изменениях в блоках внутри ссылки, которые различаются между параметризованной ссылкой и его библиотекой, с указанием имен блоков и значений параметров. Использование [] чтобы сбросить к депараметрированному, например, set_param(gcb,'linkData',[]).

массив ячеек

LinkStatus

Ссылка блока. Обновляет устаревшие связанные блоки при запросах с помощью get_param.

Смотрите Программно Управляемый Связанный Блок.

'none' | 'resolved' | 'unresolved' | 'implicit' | 'inactive' | 'restore' | 'propagate' | 'propagateHierarchy' | 'restoreHierarchy'

LoadFcn

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

Выражение MATLAB

MinMaxOverflowLogging_Compiled

Для внутреннего использования.

 

ModelCloseFcn

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

Выражение MATLAB

ModelParamTableInfo

Для внутреннего использования.

 

MoveFcn

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

Выражение MATLAB

Name

Имя блока или сигнала.

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

ports = get_param(gcb,'PortHandles');
set_param(ports.Outport(1), 'Name', 'NewName');

Кроме того, чтобы назвать выход сигнал блока, можно использовать SignalNameFromLabel.

вектор символов

NameChangeFcn

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

Выражение MATLAB

NamePlacement

Положение имени блока.

{'normal'} | 'alternate'

ObjectParameters

Имена/атрибуты параметров блока.

структура

OpenFcn

Функция вызывается при открытии этих Параметров блоков окна.

Выражение MATLAB

Orientation

Где блоковые грани.

{'right'} | 'left' | 'up' | 'down'

OutputSignalNames

Имена сигналов выхода.

массив ячеек

Parent

Имя системы, владеющей блоком.

вектор символов {'untitled'}

ParentCloseFcn

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

Выражение MATLAB

PauseFcn

Функция, вызываемая в паузе симуляции.

функциональные | вектор символов

PortConnectivity

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

  • Type

    Тип и/или номер порта. Значение этого поля может быть следующим:

    • n, где n - номер порта для портов данных

    • 'enable' если порт является портом включения

    • 'trigger' если порт является триггерным портом

    • 'state' для портов состояний

    • 'ifaction' для портов действий

    • 'LConn <reservedrangesplaceholder0>' для левого порта соединения, где # является номером порта

    • 'RConn <reservedrangesplaceholder0>' для правого порта соединения, где # - номер порта

  • Position

    Значение этого поля является двухэлементным вектором, [x y], который определяет положение порта.

  • SrcBlock

    Указатель на блок, соединенный с этим портом. Это поле имеет значение null для выходных портов и -1 для несвязанных входных портов. SrcBlock свойство является допустимым указателем на источник для блоков Variant Subsystem.

  • SrcPort

    Номер порта, подключенного к этому порту, начиная с нуля. Это поле имеет значение null как для выходных портов, так и для несвязанных входных портов.

  • DstBlock

    Указатель на блок, к которому подключен этот порт. Это поле имеет значение null для входных портов и содержит пустую матрицу 1 на 0 для несвязанных выходных портов.

  • DstPort

    Номер порта, к которому подключен этот порт, начиная с нуля. Это поле имеет значение null для входных портов и содержит пустую матрицу 1 на 0 для несвязанных выходных портов. Для блоков Simscape поле содержит указатели на порты.

массив структур

PortHandles

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

  • Inport

    Указатели на входные порты блока.

  • Outport

    Указатели на выходные порты блока.

  • Enable

    Указатель на порт включения блока.

  • Trigger

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

  • State

    Указатель на порт состояния блока.

  • LConn

    Указатели на левые порты соединения блока (для блоков, поддерживающих инструменты физического моделирования).

  • RConn

    Указатели на правые порты соединения блока (для блоков, поддерживающих инструменты физического моделирования).

  • Ifaction

    Указатель на порт действия блока.

  • Reset

    Указатель на порт сброса блока.

массив структур

PortRotationType

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

'default' | 'physical'

Ports

Вектор, который задает номер каждого вида порта, имеющегося в этом блоке. Порядок элементов вектора соответствует следующим типам портов:

  • Inport

  • Outport

  • Enable

  • Trigger

  • State

  • LConn

  • RConn

  • Ifaction

  • Reset

вектор

Position

Положение блока в окне модели.

Чтобы помочь с выравниванием блоков, положение, которое вы задаете, может отличаться от фактического положения блоков на несколько пикселей. Использование get_param для возврата фактической позиции.

вектор координат, в пикселях: [left top right bottom]

Этот источник является верхним левым углом холста Редактора Simulink перед любым изменением размеров холста. Поддерживаемые координаты находятся между -1073740824 и 1073740823 включительно. Положительные значения расположены справа от начала координат и вниз от него. Отрицательные значения - слева и вверх от источника.

PostSaveFcn

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

Выражение MATLAB

PreCopyFcn

Функция вызывается перед копированием блока. Для получения дополнительной информации см. Блок Коллбэка Параметров. Выражение MATLAB

PreDeleteFcn

Функция вызывается перед удалением блока. Для получения дополнительной информации см. Блок Коллбэка Параметров. Выражение MATLAB

PreSaveFcn

Функция вызывается до сохранения блока. Для получения дополнительной информации см. Блок Коллбэка Параметров.

Выражение MATLAB

Priority

Задает порядок выполнения блока относительно других блоков в той же модели. Установите полем Приоритет (Priority) на панели Общие (General) диалогового окна Свойства блока (Block Properties).

вектор символов {''}

ReferenceBlock

Имя библиотечного блока, с которой связан этот блок.

вектор символов {''}

RequirementInfo

Для внутреннего использования.

 

RTWData

Пользовательские данные, используемые программным обеспечением Simulink Coder™. Предназначен только для использования с пользовательскими записанными S-функциями. Для получения дополнительной информации см. раздел S-Function RTWdata (Simulink Coder).

 

SampleTime

Значение параметра шага расчета. Дополнительные сведения см. в разделе «Задание шага расчета».

вектор символов

Selected

Состояние выбора блока.

{'on'} | 'off'

ShowName

Отображение или скрытие имени блока.

Чтобы отобразить имя блока, заданное редактором Simulink (автоматические имена), установите блок 'HideAutomaticName' параметр в 'off' и ShowName на 'on'. Чтобы скрыть автоматическое имя блока, заданное редактором, задайте ShowName на 'on', HideAutomaticName на 'on', и HideAutomaticNames на модели, которая будет 'on'. Дополнительные сведения о взаимодействии параметров см. в разделе «Скрыть или Отображение имена блоков».

{'on'} | 'off'

SignalHierarchy

Если сигнал является шиной, возвращает имя и иерархию сигналов в шине (только для чтения).

Задайте порт или указатель на линию при использовании get_param. Для примера:

ports = get_param(gcb,'PortHandles');
feval(gcs,[],[],[],'compile');
sh = get_param(ports.Outport,'SignalHierarchy')

См. раздел «Отображение информации о шине».

значения отражают структуру заданного сигнала

StartFcn

Функция, вызываемая в начале симуляции.

Выражение MATLAB

StatePerturbationForJacobian

Размер возмущения состояния для использования во время линеаризации. Для получения дополнительной информации смотрите Изменение уровня возмущения блоков, возмущенных во время линеаризации (Simulink Control Design).

вектор символов

StaticLinkStatus

Ссылка блока. Не обновляет устаревшие связанные блоки при запросах с помощью get_param. См. также LinkStatus.

'none' | 'resolved' | 'unresolved' | 'implicit' | 'inactive' | 'restore' | 'propagate' | 'propagateHierarchy' | 'restoreHierarchy'

StopFcn

Функция, вызываемая при прекращении симуляции.

Выражение MATLAB

Tag

Текст, который появляется в метке блока, которую генерирует программное обеспечение Simulink. Установите полем Тег (Tag) на панели Общие (General) диалогового окна Свойства блока (Block Properties).

вектор символов {''}

Type

Тип объекта Simulink (только для чтения).

'block'

UndoDeleteFcn

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

Выражение MATLAB

UserData

Пользовательские данные, которые могут иметь любой тип данных MATLAB.

{'[]'}

UserDataPersistent

Состояние того, UserData или нет будет сохранено в файле модели.

'on' | {'off'}

Примеры настройки свойств блоков

Эти примеры иллюстрируют, как изменить общие свойства блоков.

Эта команда изменяет ориентацию блока Gain в mymodel система таким образом обращена в противоположном направлении (направо налево).

set_param('mymodel/Gain','Orientation','left')

Эта команда связывает OpenFcn коллбэк с блоком Gain в mymodel система.

set_param('mymodel/Gain','OpenFcn','my_open_cb')

Эта команда устанавливает Position свойство блока Gain в mymodel система. Ширина блока составляет 75 пикселей, высота - 25 пикселей.

set_param('mymodel/Gain','Position',[50 250 125 275])