Приложения

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

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

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

А.5.6.53. rdsSetHintText – текст всплывающей подсказки

Функция rdsSetHintText передает в RDS текст всплывающей подсказки при вызове модели блока для запроса параметров этой подсказки.

  void RDSCALL rdsSetHintTextA(
    RDSCSTR HintString  // Текст подсказки (UTF8)
  );
  void RDSCALL rdsSetHintTextW(
    RDSWCSTR HintString // Текст подсказки (UTF16)
  );
  // Функция-псевдоним
  void RDSCALL rdsSetHintText(
    RDSXCSTR HintString // Текст подсказки (кодировка по умолчанию)
  );

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

RDS_VS (для UTF8) или RDS_VWs (для UTF16)

Параметр

HintString (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с текстом выводимой подсказки. Текст может состоять из нескольких строк, разделенных символом перевода строки «\n» (код 10). Передача в этом параметре значения NULL заблокирует вывод всплывающей подсказки.

Примечания

Эту функцию следует вызывать из функции модели блока в момент реакции на событие RDS_BFM_POPUPHINT. Вызов ее из любых других реакций будет игнорироваться. С помощью этой функции модель должна сообщить, какой именно текст нужно вывести во всплывающей подсказке в данный момент. В RDS не предусмотрены средства задания постоянной всплывающей подсказки, перед каждым ее выводом модель блока будет вызываться для реакции на событие RDS_BFM_POPUPHINT.

Пример

Пример использования функции rdsSetHintText приведен в §2.11 руководства программиста.

См. также

RDS_BFM_POPUPHINT.