Объектная модель Microsoft Word организована аналогично объектной модели Microsoft Excel. На разных уровнях иерархии в приложении определено около 200 объектов, совокупность которых и определяет возможности MS Word, его свойства и поведение. Главным объектом этой иерархии является объект Application. Мы рассмотрим также объект Document, представляющий отдельный документ, и коллекцию Documents, объекты Range и Selection. Полное описание объектов приложения можно найти в справочной системе MS Word.
Объект Application
Объект Application определяет свойства и поведение приложения в целом. Он имеет более сотни элементов: свойств, методов и событий (см. статью «Application Object Members» справочной системы Microsoft Word). Как и в MS Excel, многие свойства и методы Application можно вызывать, не указывая имя этого объекта. Например, вместо Application.Documents.Add можно написать просто Documents.Add.
Из всех свойств объекта наиболее часто используются ActiveDocument и Selection, а также коллекция всех открытых документов Documents.
Работа с графическими объектами в Microsoft Word
Событий объект имеет довольно много. В табл. 12.28 приведены некоторые из них.
Таблица 12.28
Основные события объекта Application
Возникает перед закрытием документа
Возникает перед печатью документа
Docu merit BeforeSave
Возникает перед сохранением документа
Возникает при переходе к другому документу
Возникает перед открытием документа
Возникает при создании нового документа
Возникает, когда окно документа становится активным
Возникает перед закрытием приложения
Метод Quit объекта Application завершает работу Word. При выходе из приложения можно сохранить все открытые документы. В следующем примере мы сначала спрашиваем пользователя, нужно ли сохранять документы, и, если он ответит «Да», сохраняем их:
Ans = MgsBox(«Сохранить все документы», vbYesNo)
If Ans = vbYes Then Application.Quit SaveChanges:=wdSaveChanges
Объект Document и коллекция Documents
Когда запускается приложение MS Word, создается коллекция документов Documents, содержащая все открытые документы. Чтобы получить доступ к нужному документу в коллекции, достаточно указать его ключ (имя файла, хранящего документ) или его порядковый номер в коллекции. Каждый документ представляется объектом Document.
Основные методы коллекции Documents приведены в табл. 12.29.
Среди свойств объекта Document основной интерес представляют коллекции. Их довольно много (больше 30). Ос-
Таблица 12.29
Основные методы коллекции Documents
Создает новый пустой документ и добавляет его в коллекцию: Documents.Add
Открывает существующий документ и добавляет его в коллекцию:
Сохраняет все документы коллекции
Закрывает документы, сохраняя их, если в параметре задано сохранение, и удаляет из коллекции
новными коллекциями являются: Characters (символы), Words (слова), Statements (предложения), Paragraphs (абзацы), Sections (разделы), Tables (таблицы). Обратите внимание, что в Word нет специальных классов для символа, слова или предложения. Элементами коллекций Characters, Words и Statements являются объекты класса Range. Так как любую часть документа можно задать, указав первый и последний символы фрагмента текста, работа с текстом ведется через методы и свойства объекта Range.
Microsoft Word для начинающих от А до Я. Базовый курс видеоуроков по программе Ворд
Основные методы объекта Document приведены в табл. 12.30.
Таблица 12.30
Основные методы объекта Document
Возвращает объект Range, соответствующий заданным начальной и конечной позициям в документе. Так можно выделить первые 10 символов активного документа:
Выделяет содержимое документа
Сохраняет документ под новым именем или в другом формате:
ActiveDocument.SaveAs2 FileName:= «Doc2.rtf”, _
Закрывает документ. Так можно закрыть документ, не сохраняя:
Печатает весь документ или его часть
Источник: studme.org
Тема №3. Основные объекты Word подробно
3.1. Основные элементы объектной модели приложения Word
Приложение Word предоставляет в распоряжение пользователя объектную модель данных. Само приложение также построено по объектному принципу, и предоставляет пользователю множество элементов управления данными, которые состоят в отношении иерархии.
На верхней ступени объектной модели находится объект Application (Приложение). Ему непосредственно подчинены объекты нижнего уровня. Приложение является контейнером по отношению к дочерним объектам Document (Документ Word) Основные дочерние объекты приложения приведены в списке.
- Автотекст и автозамена.
- Лента как панель инструментов.
- Диалоги Word.
- Языки и словари.
- Конверторы файлов.
- Список шрифтов.
- Горячие клавиши.
- Набор параметров документа или приложения.
- Выделенная область.
- Шаблон.
- Окно приложения или документа.
- И другие.
Несколько определений
Инструменты управления приложением и данными
Источник: studfile.net
Общие сведения об объектной модели Word
Область применения:
Visual Studio
Visual Studio для Mac Visual Studio Code
При разработке решений Word в Visual Studio выполняется взаимодействие с объектной моделью Word. Эта объектная модель состоит из классов и интерфейсов, которые предоставляются в основной сборке взаимодействия для Word и определены в пространстве имен Microsoft.Office.Interop.Word .
Применимо к: Сведения в этом разделе относятся к проектам уровня документа и проектам надстроек VSTO для Word. Дополнительные сведения см. в разделе «Функции», доступные по Office приложению и типу проекта.
В этом разделе приводится краткий обзор объектной модели Word. Дополнительные сведения о всей объектной модели Word см. в документации по объектной модели Word.
Дополнительные сведения об использовании объектной модели Word для выполнения конкретных задач см. в следующих разделах.
- Работа с документами
- Работа с текстом в документах
- Работа с таблицами
Общие сведения об объектной модели Word
Word предоставляет сотни различных объектов, с которыми можно взаимодействовать. Они организованы в виде иерархии, которая точно соответствует пользовательскому интерфейсу. В верхней части иерархии находится объект Application . Этот объект представляет текущий экземпляр Word. Объект Application содержит объекты Document, Selection, Bookmarkи Range . Каждый из этих объектов содержит множество методов и свойств, к которым можно обращаться для работы с объектом и взаимодействия с ним.
На следующем рисунке показано одно представление этих объектов в иерархии объектной модели Word.
На первый взгляд объекты перекрываются друг с другом. Например, объекты Document и Selection являются элементами объекта Application , но объект Document также является элементом объекта Selection . Объекты Document и Selection содержат объекты Bookmark и Range . Перекрытие существует, так как для доступа к объекту одного и того же типа можно использовать различные способы. Например, вы применяете форматирование к объекту Range , но может потребоваться доступ к диапазону текущего выделения, конкретного абзаца, раздела или всего документа.
В следующих разделах кратко описываются объекты верхнего уровня и их взаимодействие друг с другом. К таким объектам относятся пять следующих объектов.
- Объект приложения
- объект документа;
- Объект Selection
- Range — объект
- Объект Bookmark Помимо объектной модели Word, проекты Office в Visual Studio предоставляют ведущие элементы и элементы управления ведущего приложения , расширяющие некоторые объекты из объектной модели Word. Поведение ведущих элементов и элементов управления ведущего приложения аналогично поведению объектов Word, однако они обладают дополнительными функциональными возможностями, такими как возможность привязки данных и дополнительные события. Дополнительные сведения см. в статье «Автоматизация Word» с помощью расширенных объектов и элементов управления ведущего приложения и элементов управления узлами.
Объект приложения
Объект Application представляет приложение Word и является родителем для всех других объектов. Обычно его элементы применяются к Word как к единому целому. Свойства и методы данного объекта можно использовать для управления средой Word.
В проектах надстройки VSTO для получения доступа к объекту Application можно использовать поле Application класса ThisAddIn . Дополнительные сведения см. в разделе «Программные надстройки VSTO».
В проектах на уровне документа для получения доступа к объекту Application можно использовать свойство Application класса ThisDocument .
объект документа;
Document – это центральный объект для программирования в Word. Он представляет документ и все его содержимое. При открытии существующего документа или создании нового документа вы создаете новый объект Document , который добавляется в коллекцию Documents объекта Application . Документ, который находится в фокусе, называется активным документом. Он представлен свойством ActiveDocument объекта Application .
Средства разработки Office в Visual Studio расширяют объект Document , предоставляя тип Document . Этот тип является ведущим элементом , который предоставляет доступ ко всем функциям объекта Document и добавляет дополнительные события, а также позволяет добавлять управляемые элементы управления.
При создании проекта на уровне документа для доступа к элементам Document можно использовать созданный класс ThisDocument в проекте. Для доступа к членам ведущего элемента Document можно использовать ключевые слова Me или this из кода в классе ThisDocument или Globals.ThisDocument из кода за пределами класса ThisDocument . Дополнительные сведения см. в разделе «Настройка на уровне документа программы». Например, для выделения первого абзаца в документе используйте следующий код.
this.Paragraphs[1].Range.Select();
Me.Paragraphs(1).Range.Select()
В проектах надстройки VSTO во время выполнения можно создавать ведущие элементы Document . Созданный ведущий элемент можно использовать для добавления элементов управления в связанный документ. Дополнительные сведения см. в статье «Расширение документов Word» и Excel книг в надстройках VSTO во время выполнения.
Объект Selection
Объект Selection представляет текущую выбранную область. При выполнении операции в пользовательском интерфейсе Word, например при выделении текста полужирным шрифтом, вы выбираете или выделяете текст, а затем применяете форматирование. Объект Selection всегда присутствует в документе. Если ничего не выбрано, данный объект представляет точку вставки. Кроме того, выделение может охватывать несколько блоков текста, которые не являются смежными.
Range — объект
Объект Range представляет непрерывную область в документе и определяется позициями начального и конечного символов. Объект Range не обязательно должен быть единственным. В одном документе можно определить несколько объектов Range . Объект Range имеет следующие характеристики.
- Он может включать в себя одну точку вставки, диапазон текста или весь документ.
- Он содержит непечатаемые символы, например пробелы, символы табуляции и знаки абзаца.
- Он может быть областью, представляемой текущим выделением, или может представлять область, отличную от текущего выделения.
- Он не отображается в документе (в отличие от выделения, которое отображается всегда).
- Он не сохраняется вместе с документом и существует только во время выполнения кода. При вставке текста в конец диапазона Word автоматически расширяет диапазон на объем вставленного текста.
Объекты элементов управления содержимым
ContentControl позволяет управлять вводом и представлением как текста, так и содержимого других типов, в документах Word. ContentControl может отображать несколько разных типов пользовательского интерфейса, которые оптимизированы для применения в документах Word, например элемент управления форматированным текстом, элемент выбора даты или поле со списком. ContentControl также можно использовать, чтобы пользователи не могли редактировать разделы документа или шаблона.
Visual Studio расширяет объект ContentControl до нескольких элементов управления ведущего приложения. В то время как объект ContentControl может отображать пользовательский интерфейс любого из типов, доступных для элементов управления содержимым, для всех таких элементов Visual Studio предоставляет отдельный тип. Например, для создания элемента управления форматированным текстом можно использовать RichTextContentControl , а для создания элемента выбора даты — DatePickerContentControl . Поведение этих элементов управления ведущего приложения аналогично поведению собственного элемента ContentControl, однако они имеют дополнительные события и возможности привязки данных. Дополнительные сведения см. в разделе «Элементы управления содержимым».
Объект Bookmark
Объект Bookmark представляет непрерывную область в документе с позициями начального и конечного символов. Закладки можно использовать, чтобы пометить расположение в документе или в качестве контейнера для текста в документе. Объект Bookmark может состоять из точки вставки или даже содержать целый документ. Объект Bookmark имеет следующие характеристики, которые отличают его от объекта Range .
- Во время разработки можно задать имя закладки.
- ОбъектыBookmark сохраняются вместе с документом. Следовательно, при остановке выполнения кода или закрытии документа они не удаляются.
- Закладки можно скрывать или делать видимыми, устанавливая значение ShowBookmarks класса View для свойства P:Microsoft.Office.Interop.Word.View.ShowBookmarks или T:Microsoft.Office.Interop.Word.View. Visual Studio расширяет объект Bookmark , предоставляя элемент управления ведущего приложения Bookmark . Поведение элемента управления ведущего приложения Bookmark аналогично поведению собственного элемента Bookmark, однако он имеет дополнительные события и возможности привязки данных. Для привязки данных к элементу управления закладками в документе можно использовать тот же способ, что и для привязки данных к элементу управления текстовым полем в форме Windows Forms. Дополнительные сведения см. в разделе «Элемент управления Закладка».
Использование документации по объектной модели Word
Полные сведения об объектной модели Word см. в справочнике по основной сборке взаимодействия (PIA) Word, а также в справочнике по объектной модели Visual Basic для приложений (VBA).
Справочник по основной сборке взаимодействия
В справочной документации по основной сборке взаимодействия Word описываются типы в основной сборке взаимодействия для Word. Эта документация доступна в следующем расположении: справочник по основной сборке взаимодействия Word 2010.
Дополнительные сведения о проектировании PIA Word, таких как различия между классами и интерфейсами в PIA, а также о реализации событий в PIA, см. в обзоре классов и интерфейсов в Office основных сборок взаимодействия.
Справочник по объектной модели VBA
В справочных документах по объектной модели VBA объектная модель Word описана в том виде, в котором она предоставляется коду VBA. Дополнительные сведения см. в справочнике по объектной модели Word 2010.
Все объекты и элементы в справочнике по объектной модели VBA соответствуют типам и участникам основной сборки взаимодействия Word. Например, объект Document в справочнике по объектной модели VBA соответствует Document объекту в Word PIA. Несмотря на то что в справочнике по объектной модели VBA содержатся примеры кода для большинства свойств, методов и событий, необходимо преобразовать код VBA в этом справочнике в код Visual Basic или Visual C#, если требуется использовать их в проекте Word, создаваемом с помощью Visual Studio.
См. также
- Office основных сборок взаимодействия
- Автоматизация Word с помощью расширенных объектов
- Работа с документами
- Работа с текстом в документах
- Работа с таблицами
- Общие сведения об элементах размещения и элементах управления узлами
- Программные ограничения элементов узла и элементов управления узлами
- Необязательные параметры в решениях Office
Источник: learn.microsoft.com