Формирование текстового описателя элемента управления

Ссылка на пример на GitHub: TemplateXmlDesignerExtension.

  1. Создайте текстовый файл с расширением .xml, кодировкой UTF-8, и содержимым:

    <?xml version="1.0" encoding="utf-8" ?>
    <Controls>
      <Control Name="" DisplayName="" ControlGroupDisplayName=""> (1)
        <Properties> (2)
           <Property Type="" > (3)
        </Properties>
    
        <Events> (4)
           <Event Name="" ResourceKey=""> (5)
        </Events>
      </Control>
    </Controls>
    1 Описатель элемента управления.
    2 Свойства элемента управления.
    3 Здесь перечисляются все свойства элемента управления.
    4 События элемента управления.
    5 Здесь перечисляются все события элемента управления.
  2. Укажите основную информацию об элементе управления в атрибутах элемента Control.

    Name

    Название типа элемента управления — английский, без спецсимволов и пробелов.

    DisplayName

    Отображаемое в программе Конструктор Web-разметок название элемента управления. Если нужно использовать локализованное название, замените атрибут DisplayName на ResourceKey, и укажите в значении название локализованного ресурса.

    Добавить локализованные ресурсы можно с помощью предназначенного для этого расширения программы Конструктор Web-разметок.

    ControlGroupDisplayName

    Название группы, в которой будет отображаться элемент управления на панели Библиотека. Можно указать название существующей группы или новой группы.

    Если нужно использовать локализованное название, замените атрибут ControlGroupDisplayName на ControlGroupResourceKey, и укажите в значении название локализованного ресурса.

    AllowedOperations

    Название функции проверки. Необязательный атрибут.

  3. Перечислите свойства элемента управления в элементе Properties.

    Свойства обеспечивают возможность настройки элемента управления в программе Конструктор Web-разметок, и передаются в клиент при загрузке.

  4. Добавьте дочерний элемент Property.

  5. Укажите информацию о свойстве в аргументах элемента Property.

    Type

    Название типа свойства, зарегистрированного в программе Конструктор Web-разметок.

    Типы стандартных свойств перечислены в пункте Стандартные свойства и события элементов управления.

    DefaultValue

    Значение по умолчанию (необязательное).

  6. Перечислите события элемента управления в элементе Events.

  7. Добавьте дочерний элемент Event.

  8. Укажите информацию о событии в аргументах элемента Event.

    Name

    Название события. Названия стандартных событий перечислены в пункте Стандартные свойства и события элементов управления.

    DisplayName

    Отображаемое название события. Если нужно использовать локализованное название, замените атрибут DisplayName на ResourceKey, и укажите в значении название локализованного ресурса.

    DefaultValue

    Обработчик по умолчанию (необязательное).

    1. Сохраните файл .xml на сервер Web-клиента в папку Путь к директории с исполняемым файлом конструктора Web-разметок\Plugins.

  9. Перезапустите Конструктор Web-разметок.