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

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

Эта таблица приводит свойства, характерные для всех блоков Simulink®, включая свойства коллбэка блока (см. Коллбэки для Индивидуально настраиваемого Поведения Модели). Примеры команд, которые изменяют эти свойства, следуют этой таблице (см. Примеры Setting Block Properties).

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

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

AncestorBlock

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

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

AttributesFormatString

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

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

BackgroundColor

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

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

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

Возможными значениями цвета является 'black', 'white', 'red', 'green', 'blue'ГолубойПурпурный, 'yellow'серый, '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'OffsetTime' ]

или

ячейка {[sample time 1, offset time 1]; Размер шага 2, offset time 2]; Размер шага n, offset time n

ContinueFcn

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

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

CopyFcn

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

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

DataTypeOverrideCompiled

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

 

DeleteFcn

Функция вызвала, когда блок удален. Смотрите Параметры Коллбэка Блока для деталей.

Выражение MATLAB®

DestroyFcn

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

Выражение MATLAB

Description

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

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

Diagnostics

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

 

DialogParameters

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

структура

DropShadow

Отобразите падающую тень.

{'off'} | 'on'

ExtModeLoggingSupported

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

{'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

FontAngle .

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

FontName

FontName .

массив символов

FontSize

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

действительный {'-1'}

FontWeight

FontWeight .

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

ForegroundColor

Основной цвет значка блока.

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

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

Возможными значениями цвета является 'black', 'white', 'red', 'green', 'blue'ГолубойПурпурный, 'yellow'серый, 'lightBlue', 'orange', 'darkGreen'.

Handle

Блокируйте указатель.

действительный

HideAutomaticName

Задайте, отображается ли имя блока, данное автоматически Редактором Simulink, в модели. Чтобы скрыть автоматические имена, используйте настройку по умолчанию 'on'. (HideAutomaticNames параметр для модели должен также быть установлен на 'on'.) Набор к 'off' отобразить имя, и также установить блок ShowName параметр к 'on'. Блоки, чей ShowName параметром является 'off' скрыты независимо от этой установки. Для получения дополнительной информации о том, как параметры взаимодействуют, видят, Скрываются или Имена блока Отображения.{'on'} | 'off'

HiliteAncestors

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

 

InitFcn

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

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

Выражение MATLAB

InputSignalNames

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

cellArray

IntrinsicDialogParameters

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

структура

IOSignalStrings

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

список

IOType

Менеджер Signal & Scope тип. Для внутреннего пользования.

 

IsStateOwnerBlock

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

'off' | 'on'

LibraryVersion

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

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

LineHandles

Указатели линий соединяются с блоком.

структура

LinkData

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

cellArray

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

Функция вызвала, когда это диалоговое окно Block Parameters открывается.

Выражение MATLAB

Orientation

Где блок стоит.

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

OutputSignalNames

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

cellArray

Parent

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

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

ParentCloseFcn

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

Выражение MATLAB

PauseFcn

Функция зашла в паузу симуляции.

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

PortConnectivity

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

  • Type

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

    • n, где n количество порта для портов данных

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

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

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

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

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

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

  • Position

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

  • SrcBlock

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

  • SrcPort

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

  • DstBlock

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

  • DstPort

    Количество порта, с которым этот порт соединяется, запускающийся в нуле. Это поле является пустым для входных портов и содержит пустую матрицу 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 на Общей панели диалогового окна 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, генерирует. Установите Полем метки на Общей панели диалогового окна 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])