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

Описания RDS

Приложения

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

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

А.5.27. Вспомогательный объект для работы с текстом в формате INI-файла

А.5.27.16. Команда RDS_HINI_SAVEBLOCKTEXT – передать текст параметров блока в RDS

# Приложения

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