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

Описания RDS

Приложения

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

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

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

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

# Приложения

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