Приложения

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

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

А.5.2. Управление работой RDS и функции общего назначения

А.5.2.16. rdsChangeRegWinTitle – изменение названия немодального окна

Функция rdsChangeRegWinTitle меняет название (то есть текст в пункте меню «окна» и на панели окон) немодального окна, зарегистрированного функцией rdsRegisterWindow.

  void RDSCALL rdsChangeRegWinTitleA(
    HWND Handle,   // Дескриптор окна
    RDSCSTR Title  // Название окна (UTF8)
  );
  void RDSCALL rdsChangeRegWinTitleW(
    HWND Handle,   // Дескриптор окна
    RDSWCSTR Title // Название окна (UTF16)
  );
  // Функция-псевдоним
  void RDSCALL rdsChangeRegWinTitle(
    HWND Handle,   // Дескриптор окна
    RDSXCSTR Title // Название окна (кодировка по умолчанию)
  );

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

RDS_VHwS (для UTF8) или RDS_VHwWs (для UTF16)

Параметры

Handle (HWND)

Дескриптор немодального окна, ранее зарегистрированного функцией rdsRegisterWindow.

Title (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с новым названием этого окна, которое будет отображаться в соответствующем этому окну пункте меню «окна» и на соответствующей ему кнопке панели окон.

Примечания

После вызова этой функции текст на кнопке окна Handle и его название в меню «окна» меняются на строку Title. Если окно с дескриптором Handle ранее не регистрировалось в RDS функцией rdsRegisterWindow, эта функция не выполнит никаких действий. Если в параметре Title вместо указателя на строку будет передано значение NULL, названием окна станет пустая строка.

См. также

Сервисные функции со строковыми параметрами и результатом, rdsRegisterWindow, rdsUnregisterWindow, rdsRegWinActivateNotify.