Текущий раздел:

Описания RDS

Приложения

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

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

А.5.22. Общие функции вспомогательных объектов

А.5.22.1. Использование вспомогательных объектов RDS

# Приложения

## Приложение А. Функции, константы и структуры 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