exponenta event banner

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

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

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

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

СобственностьОписаниеЦенности

AncestorBlock

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

символьный вектор

AttributesFormatString

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

символьный вектор

BackgroundColor

Цвет фона блока.

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

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) или при выборе пункта меню Копировать.

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

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 если какое-либо из этих условий является верным во время компиляции:

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

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

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

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

CompiledisActive прибыль off для неактивных вариантов и возвратов on для активных вариантов исполнения Variant Subsystem.

'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

Описание блока. Задается в поле «Описание» на панели «Общие» диалогового окна «Свойства блока».

текст и маркеры

Diagnostics

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

 

DialogParameters

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

структура

DropShadow

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

{'off'} | 'on'

ExtModeLoggingSupported

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

{'off'} | 'on'

ExtModeLoggingTrig

Разрешить блоку действовать в качестве триггерного блока для загрузки сигнала внешнего режима.

{'off'} | 'on'

ExtModeUploadOptionВключите блок для загрузки данных сигнала во внешнем режиме, если флажок 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'. ( HideAutomaticNames параметр для модели также должен иметь значение 'on'.) Установить в значение 'off' для отображения имени, а также установки блока ShowName параметр для 'on'. Блоки, чьи ShowName параметр имеет значение 'off' скрыты независимо от этого параметра. Дополнительные сведения о взаимодействии параметров см. в разделе Скрытие или отображение имен блоков.{'on'} | 'off'

HiliteAncestors

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

 

InitFcn

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

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

Выражение MATLAB

InputSignalNames

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

массив ячеек

IntrinsicDialogParameters

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

структура

IOSignalStrings

Блокировать пути к объектам, подключенным к диспетчеру сигналов и областей. Программа Simulink сохраняет эти пути при сохранении модели.

список

IOType

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

 

IsStateOwnerBlock

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

'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

Функция, вызываемая при закрытии модели. 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

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

Выражение MATLAB

PauseFcn

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

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

PortConnectivity

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

  • Type

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

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

    • 'enable' если порт является разрешающим портом

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

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

    • 'ifaction' для экшн-портов

    • 'LConn#' для левого порта подключения, где # - номер порта

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

  • Position

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

  • SrcBlock

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

  • 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 Editor перед изменением размера холста. Поддерживаемые координаты находятся в диапазоне от -1073740824 до 1073740823 включительно. Положительные значения находятся справа от начала координат и вниз от него. Отрицательные значения находятся слева от начала координат и вверх от него.

PostSaveFcn

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

Выражение MATLAB

PreCopyFcn

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

PreDeleteFcn

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

PreSaveFcn

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

Выражение MATLAB

Priority

Указывает порядок выполнения блока относительно других блоков в той же модели. Задается в поле «Приоритет» на панели «Общие» диалогового окна «Свойства блока».

символьный вектор {''}

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. Задается полем «Тег» на панели «Общие» диалогового окна «Свойства блока».

символьный вектор {''}

Type

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

'block'

UndoDeleteFcn

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

Выражение MATLAB

UserData

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

{'[]'}

UserDataPersistent

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

'on' | {'off'}

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

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

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

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

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

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

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

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