Приложения

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