Приложения
Приложение А. Функции, константы и структуры RDS
А.5. Сервисные функции и макросы RDS
А.5.22. Общие функции вспомогательных объектов
Описываются функции общего назначения, использующиеся для работы с различными вспомогательными объектами RDS. Большинство команд вспомогательным объектам передается именно через эти функции.
А.5.22.1. Использование вспомогательных объектов RDS
Вспомогательные объекты RDS – это объекты, создаваемые различными сервисными функциями и принадлежащие блоку, модель которого вызвала эти функции создания. Вспомогательный объект будет существовать до тех пор, пока он не будет уничтожен функцией rdsDeleteObject или пока от блока, которому он принадлежит, не будет отключена модель. Вспомогательные объекты создаются для разных целей и выполняют различные функции, но их объединяет общий интерфейс взаимодействия с моделью блока: все объекты имеют идентификатор типа RDS_HOBJECT, и для передачи им различных параметров и команд и получения от них значений используются одни и те же сервисные функции, работающие с объектом через его идентификатор. Работа с каждым типом вспомогательного объекта имеет свои особенности: некоторые объекты способны отслеживать различные события, происходящие со схемой (например, объект, содержащий список блоков, может автоматически выбрасывать из списка удаляемые блоки), некоторые, в дополнение к общим функциям установки и получения значений, имеют набор специализированных функций. На данный момент в RDS поддерживаются следующие типы вспомогательных объектов:
| Назначение объекта | Функция создания |
|---|---|
| Редактирование и создание связи или шины | rdsCECreateEditor |
| Создание и поддержание в актуальном состоянии списка блоков и связей | rdsBCLCreateList |
| Разбор текста | rdsSTRCreateTextReader |
| Работа с текстом в формате INI-файлов Windows | rdsINICreateTextHolder |
| Создание модальных окон с различными полями ввода | rdsFORMCreate |
| Откат программных изменений параметров блока | rdsBEUCreate |
| Создание окна с индикатором выполнения (progress bar) | rdsPBARCreate |
| Работа с панелями в окне подсистемы | rdsPANCreate |
| Изменение структуры переменных блока | rdsVSCreateEditor |
| Работа с текстом в формате CSV (значения, разделенные запятыми) | rdsCSVCreate |