Введение в API форм ввода

В данном разделе представлено описание API, предназначенного для работы с расширением «Интерактивные формы ввода данных». API позволяет расширить функциональность форм ввода за счёт создания собственных макросов, которые будут использоваться при работе с листами и табличными областями.

Подключение сборок

Для использования API форм ввода предварительно должно быть установлено само расширение «Интерактивные формы ввода данных». После установки в корневой папке репозитория будет создана папка «Компоненты», в которой будет доступен компонент форм ввода со следующим содержимым:

API форм ввода доступно для использования при создании макросов, которые в дальнейшем будут подключаться к пользовательским кнопкам. Создайте прикладной модуль и подключите следующие сборки из состава компонента форм ввода:

После этого в прикладном модуле будут доступны для использования классы, интерфейсы и перечисления, представленные в описании.

Структура прикладного макроса

Прикладной макрос должен быть реализован в глобальном пространстве имён и иметь следующую сигнатуру:

Sub <Name> (<Param>: IPrxReport);

End Sub;

или:

Function <Name> (<Param>: IPrxReport): <тип результата>;

End Function;

При нажатии на пользовательскую кнопку в параметре процедуры/функции будет доступен регламентный отчёт, связанный с формой ввода. Этот отчёт может быть передан в конструктор DataEntryForm.CreateByReport для создания экземпляра формы ввода и работы с ним в прикладном коде. Полученный экземпляр формы ввода приведите к интерфейсу IDataEntryForm для дальнейшей работы. После завершения работы для сохранения изменений вызовите один из доступных методов Save* интерфейса IDataEntryForm. По завершению работы всего прикладного макроса вызовите метод IDataEntryForm._Dispose для освобождения ресурсов.

См. также:

Формы ввода. Ядро