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

Описания RDS

Приложения

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

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

А.5.31. Вспомогательный объект для панелей в окне подсистемы

А.5.31.3. Команда RDS_PAN_CAPTION – заголовок панели

# Приложения

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

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

#### А.5.31. Вспомогательный объект для панелей в окне подсистемы

##### А.5.31.3. Команда RDS_PAN_CAPTION – заголовок панели

Команда RDS_PAN_CAPTION устанавливает или возвращает заголовок панели.

Вызов команды для установки

      RDSCSTR sCaption= …  // Строка заголовка (UTF8)
      rdsSetObjectStrA(Panel,RDS_PAN_CAPTION,0,sCaption);

или

      RDSWCSTR sCaption= … // Строка заголовка (UTF16)
      rdsSetObjectStrW(Panel,RDS_PAN_CAPTION,0,sCaption);

или (через функцию-псевдоним)

      RDSXCSTR sCaption= … // Строка заголовка (кодировка по умолчанию)
      rdsSetObjectStr(Panel,RDS_PAN_CAPTION,0,sCaption);

Вызов команды для чтения

      RDSCSTR sCaption=rdsGetObjectStrA(Panel,RDS_PAN_CAPTION,0); // UTF8

или

      RDSWCSTR sCaption=rdsGetObjectStrW(Panel,RDS_PAN_CAPTION,0); // UTF16

или (через функцию-псевдоним)

      RDSXCSTR sCaption=rdsGetObjectStr(Panel,RDS_PAN_CAPTION,0); // Кодировка по умолчанию

Параметры и результат

Panel(RDS_HOBJECT)
  Идентификатор вспомогательного объекта-панели, ранее созданного функцией rdsPANCreate.
sCaption(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку с заголовком панели. При получении заголовка функция rdsGetObjectStr возвращает указатель на строку во внутренней памяти объекта, он будет действительным до следующего изменения заголовка.

Примечания

Эта команда управляет строкой, которая отображается в полосе заголовка панели. Если у панели нет рамки или полосы заголовка, строка заголовка отображаться не будет, но она все равно будет храниться во внутренней памяти объекта, и ее можно будет получать и устанавливать.

См. также

rdsPANCreate, rdsSetObjectStr, rdsGetObjectStr.