- •12. Объектная модель Word
- •12.1. Работа с документами
- •12.1.1. Создание нового документа
- •12.1.2. Открытие существующего документа
- •12.1.3. Закрытие документа
- •12.1.4. Сохранение документа
- •12.2. Работа с текстом в документах
- •12.2.1. Определение и выделение диапазонов в документах
- •12.2.2. Получение значений начала и завершения диапазона
- •12.2.3. Вставка текста в документы
- •12.2.4. Форматирование текста в документах
- •12.2.5. Поиск и замена текста в документах
- •12.2.6. Счетчик знаков в документе
- •12.3. Работа с таблицами
- •12.3.1. Создание таблиц в Word
- •12.3.2. Заполнение таблиц в свойствах документа
- •12.3.3. Добавление строк и столбцов в таблицы
- •12.3.4. Добавление текста в ячейку таблицы и его форматирование
12. Объектная модель Word
(http://msdn.microsoft.com/ru-ru/library/kw65a0we.aspx)
Объекты модели Word: – Application(Приложение); – Document(Документ); – Selection(Выбор); – Bookmark(Закладка); – Range(Диапазон).
Пример. Выбор параграфа документа.
Me.Paragraphs(1).Range.Select()
|
Рис.12.1. Объекты в иерархии объектной модели Word |
12.1. Работа с документами
(http://msdn.microsoft.com/ru-ru/library/bb157880.aspx)
Таблица 1. Основные методы, свойства и события класса Application(http://msdn.microsoft.com/ru-ru/library/microsoft.office.interop.word.application_members.aspx)
Имя |
Описание |
Методы |
|
Activate |
Активизирует указанный объект |
ChangeFileOpenDirectory |
Устанавливает папку, в которой Word ищет документы |
CheckGrammar |
Проверяет строку на наличие грамматических ошибок |
CheckSpelling |
Проверяет строку на наличие орфографических ошибок |
InchesToPoints |
Преобразует единицы измерения из дюймов в пункты (1 дюйм = 72 пункта) |
KeyString |
Возвращает строку, отражающую введенную комбинацию клавиш (например, CTRL+SHIFT+A) |
MillimetersToPoints |
Преобразует единицы измерения из миллиметров в пункты(1 мм = 2,835 пункта) |
NewWindow |
Открывает новое окно с тем же самым документом |
PicasToPoints |
Преобразует единицы измерения из пик в пункты(1 пика = 12 пунктов) |
PixelsToPoints |
Преобразует единицы измерения из пикселей в пункты |
PointsToCentimeters |
Преобразует единицы измерения из пунктов в сантиметры(1 см = 28,35 пункта) |
PointsToInches |
Преобразует единицы измерения из пунктов в дюймы(1 дюйм = 72 пункта) |
PointsToMillimeters |
Преобразует единицы измерения из пунктоввмиллиметры(1 мм = 2,835 пункта) |
PointsToPicas |
Преобразует единицы измерения из пунктов в пики(1 пика = 12 пунктов) |
PointsToPixels |
Преобразует единицы измерения из пикселей в пункты |
PrintOut |
Печать всего или части указанного документа |
Repeat |
Повторяет последнее действие один или более раз |
Run |
Выполняет макрос Visual Basic |
Свойства |
|
ActiveDocument |
Возвращает объект Document, представляющий активный документ |
ActiveWindow |
Возвращает объект Window, представляющий активное окно |
Application |
Возвращает объект Application, представляющий приложение Word |
CapsLock |
Определяет, включен ли режим CAPS LOCK: возвращает True – если этот режим включен, и False – если выключен |
Caption |
Возвращает или устанавливает текст заголовка для указанного документа или окна приложения |
CheckLanguage |
Определяет, обнаруживает ли Microsoft Word автоматически используемый Вами при вводе текста язык. True возвращается – в положительном случае, и False – в отрицательном. |
CommandBars |
Возвращает коллекцию CommandBars, представляющую строку меню и все панели инструментов в Word |
DefaultTableSeparator |
Возвращения или устанавливает символ, используемый для разделения текста на ячейки при его преобразовании в таблицу |
DisplayScrollBars |
Определяет, отображает ли Word полосу прокрутки (хотя бы в одном окне документа) |
DisplayStatusBar |
Определяет, отображена ли строка состояния |
Documents |
Возвращает коллекцию Documents, представляющую все открытые документы |
FontNames |
Возвращает объект FontNames, который включает названия всех доступных шрифтов |
Height |
Возвращает или устанавливает высоту активного окна документа |
Language |
Возвращает константу MsoLanguageID, представляющую язык, выбранный для пользовательского интерфейса Word |
LanguageSettings |
Возвращает объект LanguageSettings, содержащий информацию о языковых параметрах настройки в Word |
Left |
Возвращает или устанавливает целое число (Integer), представляющее позицию по горизонтали окна активного документа (для объекта Application), в пунктах |
MouseAvailable |
Определяет, имеется ли мышь, доступная для системы. Это свойство возвращает True – если есть мышь, доступная для системы, и False – если нет |
Name |
Возвращает или устанавливает имя указанного объекта |
NewDocument |
Возвращает объект NewFile, представляющий документ из списка в области задач «Создание документа» |
NormalTemplate |
Возвращает объект Template, представляющий шаблонNormal |
NumLock |
Возвращает состояние клавиши NUM LOCK. Возвращается True– если режим NUM LOCK включен, и False– если выключен |
Options |
Возвращает объект Options, представляющий прикладные параметры настройки в Word |
Parent |
Возвращает объект, который является родительским по отношению к указанному объекту |
Path |
Возвращает диск или Web-путь к указанному объекту |
Selection |
Возвращает объектSelection,представляющий выделенный диапазон или точку вставки |
ShowStartupDialog |
Определяет, будет ли отображена Область задач окна при запуске Word |
StartupPath |
Возвращает или устанавливает полный путь папки запуска, исключая конечный разделитель |
StatusBar |
Отображает указанный текст в строке состояния |
SynonymInfo |
Возвращает объект SynonymInfo, содержащий информацию из тезауруса о синонимах, антонимах или связанных словах и выражениях для указанного слова или фразы |
Tasks |
Возвращает коллекцию Tasks, представляющую все работающие приложения |
Templates |
Возвращает коллекцию Templates, представляющую все доступные шаблоны |
Top |
Возвращает или устанавливает целое число (Integer), представляющее позицию по вертикали окна активного документа (для объекта Application), в пунктах |
UsableHeight |
Возвращает максимальное значение (в пунктах), которое можно задать для высоты окна документа Word |
UsableWidth |
Возвращает максимальное значение (в пунктах), которое можно задать для ширины окна документа Word |
UserControl |
Определяет, были ли документ или приложение созданы или открыты пользователем |
Version |
Возвращает номер версии Word |
Visible |
Определяет, видим ли указанный объект. Это свойство возвращает True – если указанный объект является видимым, и False – если нет |
Width |
Возвращает или устанавливает ширину указанного объекта, в пунктах |
Windows |
Возвращает коллекцию Windows, представляющую все окна документов |
WindowState |
Возвращает или устанавливает состояние указанного окна документа или окна задачи |
События |
|
DocumentBeforeClose |
Происходит непосредственно перед закрытием любого открытого документа |
DocumentBeforePrint |
Происходит непосредственно перед печатью любого открытого документа |
DocumentBeforeSave |
Происходит непосредственно перед сохранением любого открытого документа |
DocumentChange |
Происходит после создания нового документа, открытия существующего документа или активизации другого документа |
DocumentOpen |
Происходит после открытия документа |
NewDocument |
Происходит после создания документа |
Quit |
Происходит при завершении работы Word |
WindowActivate |
Происходит после активации любого окна документа |
WindowDeactivate |
Происходит после дезактивации любого окна документа |
WindowSelectionChange |
Происходит после изменения выделения в активном окне документа |
Таблица 2. Основные методы, свойства и события класса Document(http://msdn.microsoft.com/ru-ru/library/microsoft.office.interop.word.document_members.aspx и http://msdn.microsoft.com/ru-ru/library/microsoft.office.tools.word.document_members.aspx)
Имя |
Описание |
Методы |
|
Activate |
Передает фокус документу |
AutoFormat |
Автоматически форматирует документ. Свойство Kindиспользуется для указания типа формата |
CheckGrammar |
Запускает проверку правописания и грамматики для документа |
CheckSpelling |
Запускает проверку правописания для документа |
Close |
Закрывает документ |
ClosePrintPreview |
Переходит из режима предварительного просмотра к предыдущему режиму. Исключение возникает, если документ не находится в режиме предварительного просмотра |
CopyStylesFromTemplate |
Копирует стили из указанного шаблона в документ |
CountNumberedItems |
Возвращает число маркированных или нумерованных элементов и полей LISTNUMв документе |
DetectLanguage |
Анализирует текст документа, чтобы определить язык, на котором написан текст |
DowngradeDocument |
Изменяет формат документа на формат документа Word 97-2003, чтобы его можно было редактировать в предыдущей версии Microsoft Word |
ExportAsFixedFormat |
Сохраняет документ в формате PDF или XPS |
GoTo |
Возвращает объект Microsoft.Office.Interop.Word.Range, представляющий начальное положение указанного элемента, например, страницы, закладки или поля |
ManualHyphenation |
Включает расстановку переносов в документе вручную, по одной строке. Пользователю предлагается принять или отклонить предложенные варианты переноса слов |
PresentIt |
Открывает Microsoft PowerPoint с загруженным документом |
PrintOut |
Выводит на печать целый документ или его часть |
PrintPreview |
Переключает в режим предварительного просмотра |
Range |
Возвращает объект Microsoft.Office.Interop.Word.Rangeв пределах указанных положений начального и конечного знака |
Redo |
Выполняет последнее действие, которое было отменено (обращает метод Undo) |
Repaginate |
Выполняет разбиение всего документа на страницы |
ResetFormFields |
Очищает все поля форм в документе, подготавливая форму для повторного заполнения |
RunAutoMacro |
Запускает автоматический макрос, хранящийся в документе |
Save |
Сохраняет документ. Если документ ранее не сохранялся, выводится диалоговое окно Сохранить как, в котором пользователь должен задать имя файла |
SaveAs |
Сохраняет документ с новым именем или форматом. Некоторые аргументы для данного метода соответствуют параметрам в диалоговом окне Сохранить как |
Select |
Выделяет весь документ |
SetDefaultTableStyle |
Задает стиль таблицы для использования во вновь созданных таблицах в документе |
Undo |
Отменяет последнее действие или последовательность действий, отображаемых в списке Отменить. Значениеtrueвозвращается, если действия были успешно отменены |
UndoClear |
Очищает список действий, которые можно отменить для документа. Соответствует списку элементов, который отображается при нажатии стрелки рядом с кнопкой Отменитьна панели инструментовСтандартная |
Unprotect |
Удаляет защиту документа |
WebPagePreview |
Отображает окно предварительного просмотра документа в том виде, как она будет выглядеть при сохранении в качестве веб-страницы |
Свойства |
|
ActiveWindow |
Возвращает объект Window, представляющий активное окно |
Application |
Возвращает объект Application, представляющий создателя документа |
AttachedTemplate |
Возвращает или задает коллекцию Template, в которой хранятся все шаблоны, присоединенные к документу |
AutoHyphenation |
Возвращает или задает значение, указывающее, включена ли функция автоматического переноса слов в указанном документе |
Background |
Возвращает или задает Shape, представляющий фоновое изображение в указанном документе |
Bookmarks |
Возвращает коллекцию Microsoft.Office.Interop.Word.Bookmarks, в которой хранятся все закладки в документе |
Characters |
Возвращает коллекцию Characters, в которой хранятся знаки в документе |
CommandBars |
Возвращает коллекцию CommandBars, представляющую строку меню и все панели инструментов в Word |
Comments |
Возвращает коллекцию Comments, в которой хранятся все примечания в документе |
Container |
Возвращает приложение-контейнер для документа |
Creator |
Возвращает приложение, в котором был создан документ |
DefaultExtension |
Получает расширение по умолчанию для данного объекта Document |
DefaultTableStyle |
Возвращает стиль таблицы, примененный ко всем вновь созданным таблицам в документе |
DefaultTabStop |
Возвращает или задает интервал в пунктах между позициями табуляции в документе |
Extension |
Получает настраиваемое расширение для данного объекта Document |
FormFields |
Возвращает коллекцию FormFields, хранящую все поля форм в документе |
FullName |
Возвращает имя документа, включая путь к диску или Web-путь |
GrammarChecked |
Возвращает или задает значение, указывающее, была ли для документа выполнена проверка грамматики |
GridDistanceHorizontal |
Возвращает или задает интервал по горизонтали между невидимыми линиями сетки, которые используются в документе Word при рисовании, перемещении или изменении размеров автофигур или знаков восточно-азиатских языков |
GridDistanceVertical |
Возвращает или задает интервал по вертикали между невидимыми линиями сетки, которые используются в Word при рисовании, перемещении или изменении размеров автофигур или знаков восточно-азиатских языков в документе |
HasPassword |
Возвращает значение, которое позволяет определить, требуется ли для открытия документа ввод пароля |
Hyperlinks |
Возвращает коллекцию Hyperlinks, хранящую все гиперссылки в документе |
HyphenateCaps |
Возвращает или задает значение, указывающее, можно ли переносить слова из прописных букв |
HyphenationZone |
Возвращает или задает ширину области переноса в пунктах |
JustificationMode |
Возвращает или задает интервал между знаками в документе |
LanguageDetected |
Возвращает или задает значение, указывающее, удалось ли приложению Word определить язык текста в документе |
ListParagraphs |
Возвращает коллекцию ListParagraphs, хранящую все нумерованные абзацы в документе |
Lists |
Возвращает коллекцию Lists, хранящую все форматированные списки в документе |
ListTemplates |
Возвращает коллекцию ListTemplates, в которой хранятся все форматы списков для документа |
Name |
Возвращает имя документа |
OMathFontName |
Возвращает или задает имя шрифта, используемого в документе для отображения формул |
OMathJc |
Возвращает или задает значение, определяющее выравнивание по умол-чанию (по левому краю, по правому краю или по центру) для формул |
OMaths |
Получает коллекцию объектов OMath в документе |
OpenEncoding |
Возвращает кодировку, используемую для открытия документа |
Paragraphs |
Возвращает коллекцию Paragraphs, хранящую все абзацы в документе |
Parent |
Возвращает родительский объект документа |
Password |
Задает пароль, который должен быть введен для открытия документа |
Path |
Возвращает путь к диску или Web-путь документа |
Saved |
Возвращает или задает значение, указывающее, не изменился ли документ со времени последнего сохранения |
SaveEncoding |
Возвращает или задает кодировку, используемую при сохранении документа |
SaveFormat |
Возвращает формат файла документа |
Sections |
Возвращает коллекцию Sections, хранящую разделы в документе |
Sentences |
Возвращает коллекцию Sentences, хранящую все предложения в документе |
Shapes |
Возвращает коллекцию Shapes, хранящую все объекты Shape в документе |
ShowGrammaticalErrors |
Возвращает или задает значение, указывающее, были ли граммати-ческие ошибки в документе помечены волнистой зеленой линией |
ShowRevisions |
Возвращает или задает значение, показывающее, отображаются ли на экране отслеженные изменения в документе |
ShowSpellingErrors |
Возвращает или задает значение, указывающее, подчеркивает ли приложение Microsoft Word орфографические ошибки в документе |
SnapToGrid |
Возвращает или задает значение, позволяющее определить, выполняется ли автоматическое выравнивание по невидимой сетке для автофигур и знаков восточно-азиатских языков при их рисовании, перемещении или изменении их размеров в документе |
SpellingChecked |
Возвращает или задает значение, указывающее, была ли выполнена проверка правописания в документе |
SpellingErrors |
Возвращает коллекцию ProofreadingErrors, в которой хранятся слова с орфографическими ошибками в документе |
Styles |
Возвращает коллекцию Stylesдля документа |
Tables |
Возвращает коллекцию Tables, хранящую все таблицы в документе |
TablesOfFigures |
Возвращает коллекцию TablesOfFigures, хранящую таблицы фигур в документе |
TrackRevisions |
Возвращает или задает значение, показывающее, отслеживаются ли изменения в документе |
Windows |
Возвращает коллекцию Windows, в которой хранятся все окна документа (например, Sales.doc:1 и Sales.doc:2) |
WritePassword |
Устанавливает пароль, необходимый для сохранения изменений в документе |
WriteReserved |
Возвращает значение, которое позволяет определить, защищен ли документ паролем на запись |
События |
|
ActivateEvent |
Происходит, когда документ становится активным окном |
BeforeClose |
Происходит непосредственно перед закрытием документа |
BeforePrint |
Происходит перед выводом документа на печать |
BeforeSave |
Возникает перед сохранением документа |
BuildingBlockInsert |
Происходит при вставке в документ стандартного блока |
CloseEvent |
Происходит при закрытии документа |
Deactivate |
Происходит, когда активный документ теряет фокус |
New |
Возникает при создании нового документа |
Open |
Возникает при открытии документа |
SelectionChange |
Возникает при изменении выделения в окне документа |
Startup |
Происходит после запуска документа и всех кодов инициализации в сборке |
WindowSize |
Возникает после перемещения окна документа или изменения его размеров |