Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.35. Функции поддержки автоматической компиляции моделей

Описываются функции, обеспечивающие взаимодействие RDS с модулями автоматической компиляции моделей блоков (см. главу 3 руководства программиста).

А.5.35.1. rdscompAttachDifferentModel – замена имени подключаемой модели

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

  void RDSCALL rdscompAttachDifferentModelA(
    RDSCSTR NewModelName,    // Новое имя модели (UTF8)
    RDSCSTR NewAltModelName  // Новое альтернативное имя модели (UTF8)
  );
  void RDSCALL rdscompAttachDifferentModelW(
    RDSWCSTR NewModelName,   // Новое имя модели (UTF16)
    RDSWCSTR NewAltModelName // Новое альтернативное имя модели (UTF16)
  );
  // Функция-псевдоним
  void RDSCALL rdscompAttachDifferentModel(
    RDSXCSTR NewModelName,   // Новое имя модели (кодировка по умолчанию)
    RDSXCSTR NewAltModelName // Новое альтернативное имя модели (кодировка по умолчанию)
  );

Тип указателя на эту функцию

RDS_VSS (для UTF8) или RDS_VWsWs (для UTF16)

Параметры

NewModelName (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с новым именем модели.

NewAltModelName (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с новым альтернативным именем модели.

Примечания

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

Замена имени модели рассматривается в описаниях событий RDS_COMPM_CANATTACHBLK и RDS_COMPM_SAVEBLOCK и в §3.1 руководства программиста.

См. также

RDS_COMPM_CANATTACHBLK, RDS_COMPM_SAVEBLOCK.