Тег - описание процедуры, функции, параметров и переменных использующихся в скрипте. Это встроенная в редактор возможность, позволяющая облегчить и ускорить написание скриптов. Информация из тега попадает в сплывающую подсказку автодополнения. Объем информации попадающей в автодополнение зависит от того, в каком месте оно вызывается.
Описание тегов:
Формат записи:
<doc [ <par ...> ][ <type ...> ][ Комментарий [ %Номер_параметра ] ] [ > ]
Описание тега <doc> заканчивается символом «>» или первой строкой не являющейся комментарием. Между тегом и определением функции могут располагаться только комментарии, иначе тег будет игнорироваться и не попадет и список автодополнения.
Формат записи:
<par [ [ Имя_Параметра | %Номер_параметра] As Тип_Парметра ] [ Коментарий [ %Номер_параметра ] ]>
Комментарий в теге <par> относится только к одному параметру. Если не указать имя или номер параметра, номера присваиваются автоматически по порядку определения параметра в теге.
Формат записи:
<type [As] Тип>
Если переменная имеет составной тип ( т.е. имеет свойства, например ITCSForm), то при вызове автодополнения будут доступны ее свойства.
В квадратных скобках указаны необязательные параметры.
Текст комментариев может состоять из нескольких строк.
Для вставки имени параметра в комментарий необходимо в комментарии указать порядковый номер параметра после знака «%».
Чтобы вставить в описание символ «<» или «>», необходимо написать требуемый символ два раза: «<<» или «>>».
Общий вид описания процедуры или функции:
'<doc
'<par [[ Параметр1 ] As Тип_Параметра ] [ Комментарий [ %Номер_Параметра ]]>
'<par As Тип_Параметра [ Комментарий [ %Номер_Параметра ]]>
'<par Комментарий [ %Номер_Параметра ] >
'<type [As] Возвращаемый_Тип>
'[ Комментарий к функции [ %Номер_Параметра ] ]
'>
Function Имя_Функции(Параметр1, Параметр2, Параметр3)
...
End Function
Пример:
'<doc
'<par As String Строка символов>
'<par As Integer Длина возвращаемой строки>
'<type String>
'Возвращает строку из %2 символов строки %1 начиная с первого символа
'>
Function GetLeftString(Str, Count)
GetLeftString = Left(Str, Count)
End Function
Отображение всплывающей подсказки при наведении курсора на функцию в окне автодополнения:
! См. также: