Всплывающие подсказки Quick Info

Всплывающие подсказки quick info для объектов, свойств, методов и событий берутся из файлов платформы.

Подсказки можно создать и для собственных процедур, переменных, констант и т. д. Для этого поставьте комментарий сразу после объявления. Можно даже использовать простое HTML-форматирование!

sub blink(pat as string) 'Blinks the status LEDs.
'<br><b>pat</b>- the pattern to play.
'<br><font color=red>Do not set to NULL</font>
... 
void blink(string pat){ //Blinks the status LEDs.
//<br><b>pat</b>- the pattern to play.
//<br><font color=red>Do not set to NULL</font>
... 

В результате получится такая подсказка:

Снимок экрана пользовательской подсказки в TIDE.

Правила комментариев-подсказок

Комментарий должен находиться в той же строке, что и объявление или определение, либо в строке непосредственно под ним. Между объявлением или определением и началом комментария-подсказки не должно быть пустых строк.

Кроме того, в Tibbo BASIC между строками комментария-подсказки не должно быть пустых строк. В C однострочный («//») комментарий-подсказка не должен содержать пустых строк, а многострочные («/* */») комментарии пустые строки содержать могут.

Если комментарий-подсказка есть и в определении, и в объявлении, приоритет получает вариант из определения.

Использование HTML в подсказках

Чтобы украсить подсказки, можно использовать следующие теги (элементы) HTML:

  • Теги оформления: <b>, <i>, <big>, <small>, <s>, <u>, <font [color=color] [size=size] [face=face]>
  • Заголовки <h1>...<h6>
  • Перевод строки <br>
  • Комментарии: <!-- -->

Остальные теги (элементы) использовать нельзя. Большинство неподдерживаемых тегов просто игнорируется, но некоторые приводят к искажению выводимого текста.

Совет

Особенность HTML-движка TIDE: он требует ставить пробел перед закрывающим тегом в паре тегов.

Например, если написать «<b>Bold</b> text», вы получите «Boldtext». Запись «<b>Bold </b>text» даст правильный результат: «Bold text».

Исходный материал Tibbo обновлён 11 июля 2022Оригинал на docs.tibbo.com · Сообщить об ошибке