Приложения

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

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

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

А.5.9.10. rdsSetLayerPosition – задать положение слоя в заданной конфигурации

Функция rdsSetLayerPosition устанавливает положение слоя в указанной конфигурации относительно других ее слоев.

  BOOL RDSCALL rdsSetLayerPosition(
    RDS_BHANDLE System,    // Подсистема
    int ConfigNum,         // Номер конфигурации
    int LayerId,           // Идентификатор слоя
    int PosType,           // Операция (RDS_SLP_*)
    int RefLayer           // Базовый слой
  );

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

RDS_BBhIII

Параметры

System (RDS_BHANDLE)

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

ConfigNum (int)

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

LayerId (int)

Идентификатор слоя, перемещаемого в указанной конфигурации.

PosType (int)

Как задается положение слоя (одна из констант RDS_SLP_*):

RDS_SLP_TOP	Переместить слой LayerId на самый верх (ближе всего к переднему плану).
RDS_SLP_BOTTOM	Переместить слой LayerId в самый низ (дальше всего от переднего плана).
RDS_SLP_BEFORE	Разместить слой LayerId непосредственно перед слоем RefLayer (LayerId будет ближе к переднему плану, чем RefLayer).
RDS_SLP_AFTER	Разместить слой LayerId непосредственно после слоя RefLayer (LayerId будет дальше от переднего плана, чем RefLayer).

RefLayer (int)

Идентификатор слоя, относительно которого позиционируется LayerId при PosType, равном RDS_SLP_BEFORE или RDS_SLP_AFTER (в остальных случаях значение этого параметра игнорируется).

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

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

Примечания

Конфигурации слоев в подсистеме (параметр ConfigNum) нумеруются с нуля, общее их число можно узнать из поля NumConfigs структуры RDS_EDITORPARAMETERS.

См. также

rdsSetLayerParams, RDS_EDITORPARAMETERS.