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

Описания RDS

Приложения

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

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

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

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

# Приложения

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