Описание пользователя

Глава 3. Использование стандартных модулей автокомпиляции

§3.7. Краткий перечень вводимых в модель описаний и реакций на события

§3.7.11. Прочие реакции

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

§3.7.11.1. Переименование блока

Это событие возникает при изменении имени блока пользователем через окно его параметров, а также при программном изменении имени блока при помощи функции rdsRenameBlock. Реакцию на него можно использовать для изменения имен каких-либо программно созданных объектов (например, динамических переменных), в которых имя блока используется для обеспечения уникальности имени объекта. При этом следует учитывать, что имя блока уникально только в пределах одной подсистемы, в разных подсистемах могут находиться блоки с одинаковыми именами.

Текст реакции на событие изменения имени блока вводится на вкладке «события» левой панели редактора модели: раздел «разное», подраздел «переименование блока». В классе блока для нее создается функция с именем rdsbcppBlockRename следующего вида:

  // Block rename
  void rdsbcppBlockClass::rdsbcppBlockRename(LPSTR OldBlockName)
  {
     … пользовательский текст реакции … 
  }

В параметре OldBlockName передается указатель на строку (char*) в кодировке UTF8 с именем блока до переименования.

При написании моделей блоков без использования модуля автокомпиляции этому событию соответствует константа RDS RDS_BFM_RENAME.