Приложения

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

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

А.5.2. Управление работой RDS и функции общего назначения

А.5.2.46. rdsSetSystemInt – установка целого системного параметра

Функция rdsSetSystemInt устанавливает целое значение для различных системных параметров.

  void RDSCALL rdsSetSystemInt(
    int Param,    // Идентификатор параметра
    int Value     // Значение параметра
  );

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

RDS_VII

Параметры

Param (int)

Идентификатор устанавливаемого параметра (одна из констант RDS_SSI*, см. ниже).

Value (int)

Значение устанавливаемого параметра.

Идентификаторы параметров

RDS_SSIFASTTEXTSAVE

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

0	Обычное сохранение в текстовом формате: ко всем строкам, переданным в RDS для записи, добавляются отступы слева, если это необходимо. Это значение параметр получает автоматически перед каждым вызовом блока для сохранения данных.
1	Быстрое сохранение – отступы не добавляются. Это значение имеет смысл устанавливать при сохранении больших объемов текста, чтобы повысить скорость сохранения за счет худшего форматирования получившегося файла схемы. Если не предполагается, что файл схемы будет корректироваться вручную, его форматирование не играет роли – на загрузку файлов в RDS оно не влияет.

RDS_SSIWAITCURSOR

Установить курсор мыши «песочные часы». Параметр может принимать одно из следующих значений:

1	Установить курсор «песочные часы», его внешний вид не будет зависеть от находящегося под ним элемента.
0	Вернуть предыдущий, использовавшийся до установки значения 1, вид курсора мыши.
−1	Немедленно установить обычный курсор мыши, его внешний вид будет зависеть от находящегося под ним элемента управления.

При каждом вызове функции rdsSetSystemInt с параметрами (RDS_SSIWAITCURSOR,1) RDS устанавливает курсор «песочные часы» (что обычно указывает на выполнение какой-либо длительной операции, во время которой пользователь не может работать с программой) и увеличивает внутренний счетчик. При вызове функции с параметрами (RDS_SSIWAITCURSOR,0) внутренний счетчик уменьшается, и, когда он достигнет нуля, RDS вернет курсору стандартную форму. Таким образом, пары вызовов установки/отмены «песочных часов» можно безопасно вкладывать друг в друга. Если необходимо немедленно вернуть курсору его обычную форму, следует вызвать функцию с параметрами (RDS_SSIWAITCURSOR,–1).

См. также

rdsGetSystemInt.