Ноу Інти, лекція, засоби документування у flash mx

Як зробити Reference

Кореневим елементом xml-документа, що розпізнається середовищем розробки Flash MX, є тег . Він може містити теги . . і .

Цей тег атрибутів не має, може містити теги і . тег в свою чергу так само може містити теги і . тег вкладених тегів не має. Вся інформація. яку несуть теги або . міститься в їх атрибутах.

тег відповідає за групу елементів (наприклад, на рис. 12.2 це папка Lift. а так само містяться в ній папки Methods і Properties).

Багато атрибути є загальними для тегів і . Перший з них - name. його значення - це ім'я папки або елемента, що відображається в панелі Actions і змісті References. Атрибут id використовує для гіперпосилань в References (докладніше див. Нижче). Щоб не плутатися, значення атрибутів id і name зазвичай роблять однаковими. Атрибут tiptext містить коротку інформацію про папку або об'єкті, яка відображається у вигляді tooltip (підказки) в панелі Actions або змісті References (рис. 12.3).

Крім того, у тега є булевский атрибут sort. за замовчуванням true. Якщо sort встановити рівним false. то вміст папки НЕ буде сортуватися за алфавітом, а буде виведено саме в тому порядку, в якому воно описано в xml-файлі.

Про специфічні для тега атрибутах text. type і object ми поговоримо в наступних параграфах.

текст References

У прикладі 12.2 наведено xml-початківець опису одного з методів класу Lift. На малюнку 12.4 показано, як це опис виглядає в панелі References.

Що саме писати в References - це, звичайно, вирішує програміст. Але краще дотримуватися стилю, в якому написані References для вбудованих об'єктів Flash MX. А саме, там повинні міститися такі пункти:

Схожі статті