Начало работы

1. Запустите Visual Studio.

2. Выберите Create a new project с типом проекта Class Library (.NET Framework).

3. Введите имя проекта. ВНИМАНИЕ! Имя проекта и библиотеки dll должны начинаться с префикса "Primo."

4. Выберите фреймворк .NET Framework 4.6.1.

5. Найдите в папке Primo Studio указанные ниже сборки и добавьте их в References проекта сборки:

   • LTools.Common.dll

   • LTools.Dto.dll

   • LTools.Enums.dll

   • LTools.Scripting.dll

   • LTools.SDK.dll

   • LTools.Office.dll

6. В менеджере зависимостей Visual Studio найдите сборки MS Office в Assemblies > Extensions. Для работы с Excel добавьте:

   • DevExpress.Docs.v20.1.dll

   • DevExpress.Spreadsheet.v20.1.Core.dll

   • DevExpress.Office.v20.1.Core.dll

   • Microsoft.Office.Interop.Excel (необходим установленный MS Office)

   Для работы с Word добавьте:

   • DevExpress.Docs.v20.1.dll

   • DevExpress.RichEdit.v20.1.Core.dll

   • DevExpress.Office.v20.1.Core.dll

   • Microsoft.Office.Interop.Word (необходим установленный MS Office)

   Для работы с Outlook добавьте:

   • Microsoft.Office.Interop.Outlook (необходим установленный MS Office)

   Для работы с Exchange добавьте:

   • Microsoft.Exchange.WebServices.dll

   Также добавьте стандартные сборки:

   • PresentationCore

   • PresentationFramework

   • System.Xaml

   • WindowsBase

   

7. Добавьте в проект компонент типа User Control (WPF) (Add > New Item...):

Этот элемент будет являться визуальной составляющей элемента Primo. Данные будущего элемента автоматически будут смаплены на DataContext этого контролла (пример приводится далее).

8. Создайте класс (Add > Class…). Этот класс будет являться code-behind нашего элемента.

9. Для создания элемента с синхронным поведением необходимо унаследовать класс LTools.Office.SDK.PrimoComponent*<UI>, где:

• UI – это имя вашего визуального компонента из шага 5.

• Вместо * нужно выбрать Excel, Word, Outlook либо Exchange, в зависимости от целевого использования. Пример: LTools.Office.SDK.PrimoComponentExcel.

Дальнейшие шаги

🔸 Далее все из LTools.SDK относится и к этому SDK, поскольку LTools.Office.SDK его наследует. Если вы уже работали с LTools.SDK и понимаете общий принцип, то рекомендуем сразу обратиться к разделу Дополнительные свойства, которым отличается LTools.Office.SDK от стандартного.

Если вы работете с SDK впервые, то изучите последовательно все разделы:

• Синхронный элемент;

• Элемент с тайм-аутом;

• Простой контейнер;

• Специальный контейнер;

• Расширенные свойства;

• Дополнительные свойства - относятся только к LTools.Office.SDK;

• Дополнительные методы;

• Кастомные свойства;

• Валидация ввода;

• Привязка данных к UI;

• Сборка и отладка;

• Упаковка и публикация.