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

Описания RDS

Приложения

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

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

А.5.8. Работа с окнами подсистем

А.5.8.20. rdsSetSystemWindowCaption – задать заголовок окна подсистемы

# Приложения

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

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

#### А.5.8. Работа с окнами подсистем

##### А.5.8.20. rdsSetSystemWindowCaption – задать заголовок окна подсистемы

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

      void RDSCALL rdsSetSystemWindowCaptionA(
        RDS_BHANDLE System, // Подсистема
        RDSCSTR Caption,    // Заголовок или NULL (UTF8)
        BOOL Temp           // Временный заголовок
      );
      void RDSCALL rdsSetSystemWindowCaptionW(
        RDS_BHANDLE System, // Подсистема
        RDSWCSTR Caption,   // Заголовок или NULL (UTF16)
        BOOL Temp           // Временный заголовок
      );
      // Функция-псевдоним
      void RDSCALL rdsSetSystemWindowCaption(
        RDS_BHANDLE System, // Подсистема
        RDSXCSTR Caption,   // Заголовок или NULL (кодировка по умолчанию)
        BOOL Temp           // Временный заголовок
      );

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

RDS_VBhSB (для UTF8) или RDS_VBhWsB (для UTF16)

Параметры

System(RDS_BHANDLE)
  Идентификатор подсистемы, заголовок окна которой задается (ее окно не обязательно должно быть открыто).
Caption(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку (char* или wchar_t*, в зависимости от версии функции) с заголовком окна. NULL в этом параметре указывает на необходимость вернуться к стандартному заголовку, то есть к имени подсистемы.
Temp(BOOL)
  TRUE – заголовок задается временно, если закрыть окно и открыть его снова он будет потерян. FALSE – заголовок задается постоянно, он будет запомнен в параметрах подсистемы и будет использоваться при каждом открытии окна (в том числе и после сохранения схемы).

Примечания

Обычно в заголовке окна подсистемы, на соответствующей ему кнопке панели окон и в соответствующем пункте меню «окна» отображается имя подсистемы или текст, заданный пользователем в ее параметрах. Функция rdsSetSystemWindowCaption позволяет программно изменить этот текст – постоянно (при Temp==FALSE) или временно (при Temp==TRUE).