Приложения

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

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

А.5.9. Работа со слоями

А.5.9.9. rdsSetLayerParams – задать параметры слоя в конфигурации

Функция rdsSetLayerParams устанавливает флаги видимости, разрешения редактирования и текущего слоя для слоя с указанным идентификатором в указанной конфигурации слоев.

  BOOL RDSCALL rdsSetLayerParams(
    RDS_BHANDLE System,    // Подсистема
    int ConfigNum,         // Номер конфигурации
    int LayerId,           // Идентификатор слоя
    BOOL Visible,          // Видимость
    BOOL Editable,         // Разрешенность
    BOOL Current           // Признак текущего
  );

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

RDS_BBhIIBBB

Параметры

System (RDS_BHANDLE)

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

ConfigNum (int)

Номер конфигурации слоев в подсистеме System или −1 для текущей конфигурации.

LayerId (int)

Идентификатор слоя.

Visible (BOOL)

Слой должен быть видимым (TRUE) или скрытым (FALSE).

Editable (BOOL)

Разрешить (TRUE) или запретить (FALSE) редактирование и реакции блоков на мышь для указанного слоя.

Current (BOOL)

TRUE – указанный слой нужно сделать текущий слоем конфигурации. FALSE – текущий слой конфигурации не изменится.

Возвращаемое значение

TRUE, если функция установила параметры указанного слоя, и FALSE, если конфигурации ConfigNum или слоя LayerId нет в подсистеме System.

Примечания

Конфигурации слоев в подсистеме (параметр ConfigNum) нумеруются с нуля, общее их число можно узнать из поля NumConfigs структуры RDS_EDITORPARAMETERS. Действие параметров функции Visible и Editable несколько отличается от параметра Current: если Visible и Editable устанавливают и сбрасывают соответствующие флаги слоя, то Current влияет на слой, только если в нем передано значение TRUE: в этом случае слой LayerId станет новым текущим слоем в конфигурации ConfigNum. Значение FALSE в параметре Current не заставит слой LayerId перестать быть текущим, если он им был – оно просто будет проигнорировано. Для того, чтобы LayerId перестал быть текущим слоем конфигурации, нужно сделать в ней текущим какой-либо другой слой.

См. также

rdsGetLayerParams, rdsSetLayerPosition, RDS_EDITORPARAMETERS.