Приложения

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

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

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

Описываются функции управления слоями и конфигурациями слоев в подсистеме.

А.5.9.1. rdsAddLayer – добавить слой

Функция rdsAddLayer добавляет в подсистему слой с указанным именем.

  int RDSCALL rdsAddLayerA(
    RDS_BHANDLE System, // Подсистема
    RDSCSTR LayerName   // Имя слоя (UTF8)
  );
  int RDSCALL rdsAddLayerW(
    RDS_BHANDLE System, // Подсистема
    RDSWCSTR LayerName  // Имя слоя (UTF16)
  );
  // Функция-псевдоним
  int RDSCALL rdsAddLayer(
    RDS_BHANDLE System, // Подсистема
    RDSXCSTR LayerName  // Имя слоя (кодировка по умолчанию)
  );

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

RDS_IBhS (для UTF8) или RDS_IBhWs (для UTF16)

Параметры

System (RDS_BHANDLE)

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

LayerName (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку (char* или wchar_t*, в зависимости от версии функции) с именем добавляемого слоя.

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

Уникальный идентификатор добавленного слоя или −1, если слой с именем LayerName уже есть в подсистеме System.

Примечания

Эта функция добавляет слой с именем LayerName в подсистему System, если в ней еще нет слоя с таким именем. Новый слой добавляется во все конфигурации на самый верх (то есть объекты, размещенные на нем, будут перекрывать все остальные).

См. также

rdsSetLayerParams, rdsSetLayerPosition.