Вимоги: Використовуйте VSTO для розробки простого плагіна для Office, наприклад, отримання плагіна довжини китайських символів Word.
Модель об'єкта Word
Word пропонує сотні об'єктів для взаємодії. Ці об'єкти організовані в ієрархію, яка суворо відповідає інтерфейсу користувача. Об'єкт Application знаходиться на вершині ієрархії. Цей об'єкт представляє поточний екземпляр Word. Об'єкт Application містить об'єкти Document, Selection, Bookmark та Range. Кожен із цих об'єктів має низку методів і властивостей, які можна використовувати для маніпуляції та взаємодії з об'єктом.
Наступне зображення показує вигляд цих об'єктів у ієрархії моделі об'єктів Word.
Документації:Вхід за гіперпосиланням видно.
Об'єкт застосування
Об'єкт Application представляє додаток Word і є батьківським для всіх інших об'єктів. Його члени зазвичай застосовуються до Word загалом. Ви можете використовувати його властивості та методи для керування середовищем Word.
У проєкті VSTO можна отримати доступ до об'єкта ThisAddIn, використовуючи поля Application класу Application.
У проєкті на рівні документа об'єкт ThisDocument можна отримати за допомогою властивості Application класу Application.
Об'єкт документа
Об'єкт Document є центром програмування Word. Він представляє документ і весь його вміст. Коли ви відкриваєте документ або створюєте новий документ, створюється новий об'єкт Document, який додається до колекції Application об'єкта Documents. Документ із фокусом називається активним документом. Він представлений властивістю Application об'єкта ActiveDocument.
Коли ви створюєте проєкт на рівні документа, ви можете отримати доступ до члена ThisDocument, використовуючи клас Document, згенерований у проєкті. Об'єкт ThisDocument можна отримати за допомогою Me або цього ключового слова для коду в класі Document, або Globals.ThisDocument для коду поза класом ThisDocument.
Об'єкт вибору
Об'єкт Selection представляє поточну обрану область. Під час виконання дії в інтерфейсі користувача Word, наприклад, виділення тексту жирним, ви можете вибрати або виділити текст і застосувати форматування. Об'єкт Selection завжди присутній у документі. Якщо нічого не помічається, це вказує на точку вставки. Крім того, вибраний контент може містити кілька несуміжних блоків тексту.
Об'єкт дальності
Об'єкт Range представляє сусідні області документа і визначається початковими та кінцевими позиціями символів. Це не обмежується лише одним об'єктом Range. Ви можете визначити кілька об'єктів Range в одному документі. Об'єкти дальності мають такі характеристики:
- Він може містити лише окремі точки вставки, або може містити діапазон тексту або весь документ.
- Вона містить ненадруковані символи, такі як пробіли, вкладки та маркери абзаців.
- Це може бути область, представлена поточним обраним контентом, або область, що відрізняється від цього контенту.
- Він не видно в документі, на відміну від вибраного контенту, який завжди видно.
- Він не зберігається разом із документацією і існує лише під час виконання коду.
- Коли текст вставляється в кінці діапазону, Word автоматично розширює діапазон, включаючи вставлений текст.
Об'єкти контролю контенту (об'єкти контролю контенту)
ContentControl надає спосіб контролю введення та відтворення тексту та інших типів контенту в документі Word. ContentControl може відображати багато різних типів інтерфейсу, оптимізованих для використання в документах Word, таких як текстові елементи з кількома повідомленнями, вибір дат або комбо-бокси. Ви також можете використовувати ContentControl, щоб заборонити користувачам редагувати певні розділи документа або шаблону.
Visual Studio розширює об'єкт ContentControl на кілька різних елементів керування хостами. Поки об'єкт ContentControl відображає всі різні типи інтерфейсу, доступні для контролю контенту, Visual Studio надає окремий тип для кожного контролю контенту. Наприклад, ви можете використати RichTextContentControl для створення багатоповідомленого текстового контролю, або DatePickerContentControl для створення вибору дати. Ці хост-контролі поводяться подібно до нативних ContentControls, але також мають додаткові можливості зв'язування подій і даних.
Об'єкт закладки
Об'єкт Bookmark представляє сусідні області документа з початковими та кінцевими позиціями. Ви можете використовувати закладки, щоб позначити певне місце в документі, або як контейнер для китайської версії документа. Об'єкт закладки може містити точки вставки або бути розміром із весь документ. Закладка має такі характеристики, які відрізняють її від об'єктів Range:
- Ви можете називати закладки під час дизайну.
- Об'єкт закладки зберігається разом із документом, тому він не видаляється, коли код зупиняється або документ закривається.
- Отримайте доступ до властивості View, встановивши її на false або true.
- Visual Studio розширює об'єкт закладки, надаючи керування хостом закладки. Керування хостом закладок поводиться подібно до нативної закладки, але також має додаткові можливості зв'язування подій і даних. Ви можете прив'язати дані до керування закладкою в документі так само, як прив'язуєте дані до керування текстовим полем у Windows Form.
Створіть додаток Word VSTO
Після розуміння основних понять відкрийте VS 2022, щоб створити нову додаткову програму Word STO, як показано на рисунку нижче:
Створіть візуальну стрічку, як показано на наступному рисунку:
Двічі клацніть Ribbon1.cs, щоб відкрити, видаліть стандартну вкладку вкладки і перетягніть нову вкладку, як показано нижче:
Перетягніть групу та кнопку керування у вкладку нової вкладки, як показано нижче:
Подвійний клік на новоствореній кнопці, щоб створити подію кліку з наступним кодом:
(Кінець)
|
Опубліковано 30.04.2023 20:53:15
|
|
|
|
Орендодавець|
Опубліковано 30.04.2023 23:32:31
|
Опубліковано 02.05.2023 10:30:48