5.2.1 Соглашения об именах элементов

На верх  Назад  Вперёд

Как упоминалось в предыдущем разделе, атрибут name тега element является иерархическим. Все уровни в иерархии обозначаются точкой (.) в атрибуте name.

Как показано в прошлом примере, для перечисляемого типа различные константы перечисления можно документировать, указав их имя как enumname.constname (имяперечислитиля.имяконстанты). Например, учитывая тип

Type
 MyEnum = (meOne,meTwo,meThree);

Различные значения перечисления можно документировать, используя имена элементов MyEnum.meOne, MyEnum.meTwo и MyEnum.meThree:

<element name="myenum.meOne">
</element>
<element name="myenum.meTwo">
</element>
<element name="myenum.meThree">
</element>

Обратите внимание, что регистр атрибута name не обязательно должен совпадать с регистром объявления.

Эта иерархическая структура может использоваться для всех непростых типов:

Значения типа перечисления.

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

Методы классов и объектов.

Свойства классов.

Аргументы функции и процедуры.

Результаты функции. Имя всегда является именем функции, за которым следует Result.