Приложения
Приложение А. Функции, константы и структуры RDS
А.5. Сервисные функции и макросы RDS
А.5.27. Вспомогательный объект для работы с текстом в формате INI-файла
А.5.27.16. Команда RDS_HINI_SAVEBLOCKTEXT – передать текст параметров блока в RDS
Команда RDS_HINI_SAVEBLOCKTEXT передает в RDS текст, содержащийся в объекте, для добавления к сохраняемым параметрам блока при реакции модели этого блока на событие RDS_BFM_SAVETXT.
Вызов команды
rdsCommandObject(Ini,RDS_HINI_SAVEBLOCKTEXT);
или
int iNewLine= … // 1 – с новой строки, 0 – без новой строки rdsCommandObjectEx(Ini,RDS_HINI_SAVEBLOCKTEXT,iNewLine,NULL);
Параметры
- Ini (RDS_HOBJECT)
- Идентификатор вспомогательного объекта для работы с текстом, ранее созданного функцией rdsINICreateTextHolder.
- iNewLine (int)
- Целое значение, указывающее на необходимость добавить перед текстом объекта перевод строки (1) или передать текст в RDS без изменений (0). При вызове этой команды функцией rdsCommandObject перевод строки не добавляется.
Примечания
Эта команда передает сформированный а объекте текст в RDS, где он будет добавлен к сохраняемым в текстовом виде параметрам блока. Если на момент вызова команды RDS_HINI_SAVEBLOCKTEXT сохраняемый текст уже был сформирован вызовами функций, описанных в приложении А.5.10, текст из объекта Ini будет добавлен в конец этого текста.
Команду RDS_HINI_SAVEBLOCKTEXT можно вызывать только из модели блока в момент ее реакции на событие сохранения данных в текстовом виде RDS_BFM_SAVETXT. Во всех остальных случаях команда будет проигнорирована.
Пример
Пример использования команды RDS_HINI_SAVEBLOCKTEXT приведен в §2.8.5 руководства программиста.
См. также
rdsINICreateTextHolder, rdsCommandObject, rdsCommandObjectEx, RDS_BFM_SAVETXT.