Начало работы
-
Запустите Visual Studio.
-
Выберите Create a new project с типом проекта Class Library (.NET Framework).
-
Введите имя проекта. ВНИМАНИЕ! Имя проекта и библиотеки dll должны начинаться с префикса “Primo.”
-
Выберите фреймворк .NET Framework 4.6.1.
-
Найдите в папке Primo Studio указанные ниже сборки и добавьте их в References проекта сборки:
- LTools.Common.dll
- LTools.Dto.dll
- LTools.Enums.dll
- LTools.Scripting.dll
- LTools.SDK.dll
- LTools.Office.dll
-
В менеджере зависимостей 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;
- Сборка и отладка;
- Упаковка и публикация.