Приложения

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

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

А.5.6. Операции с блоками и связями

А.5.6.50. rdsSetBlockSetupFuncName – задать имя функции настройки

Функция rdsSetBlockSetupFuncName устанавливает текст пункта меню, вызывающего функцию настройки блока, а также позволяет выключить функцию настройки.

  void RDSCALL rdsSetBlockSetupFuncNameA(
    RDS_BHANDLE Block, // Блок
    RDSCSTR MenuName   // Текст пункта меню (UTF8)
  );
  void RDSCALL rdsSetBlockSetupFuncNameW(
    RDS_BHANDLE Block, // Блок
    RDSWCSTR MenuName  // Текст пункта меню (UTF16)
  );
  // Функция-псевдоним
  void RDSCALL rdsSetBlockSetupFuncName(
    RDS_BHANDLE Block, // Блок
    RDSXCSTR MenuName  // Текст пункта меню (кодировка по умолчанию)
  );

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

RDS_VBhS (для UTF8) или RDS_VBhWs (для UTF16)

Параметры

Block (RDS_BHANDLE)

Идентификатор блока.

MenuName (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку (char* или wchar_t*, в зависимости от версии функции), содержащую текст пункта меню, который будет вызывать функцию настройки блока. Передача NULL в этом параметре запретит вызов функции настройки. Передача указателя на пустую строку даст пункту меню название по умолчанию («настройка»).

Примечания

При вызове пользователем функции настройки модель блока обычно открывает окно для ввода параметров этого блока. Выбор пользователем пункта контекстного меню, соответствующего функции настройки (или двойной щелчок, если в параметрах блока задан вызов функции настройки по нему) генерирует событие RDS_BFM_SETUP. Функция rdsSetBlockSetupFuncName позволяет программно задать имя этого пункта контекстного меню или вообще отключить его.

Наличием функции настройки также управляет флаг параметров блока RDS_BDF_SETUPFUNC, который можно получить и установить функциями rdsGetBlockFlags и rdsSetBlockFlags соответственно.

См. также

RDS_BLOCKDESCRIPTION, rdsGetBlockDescription, rdsGetBlockFlags, rdsSetBlockFlags, RDS_BFM_SETUP.