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

Описания RDS

Приложения

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

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

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

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

# Приложения

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