В этой статье мы рассмотрим методы объекта Word Application, методов довольно много. В большинстве случаев данные методы представляют только теоретический интерес, так как не дают возможности создавать сам документ Word.
В статье я не буду приводить примеров кода, так как по сути, нечего показывать, вы и сами с легкостью сможете написть небольшой скрипт на языке VBScript или JScript, или просто добавить макрос в редактор VBA, и просмотреть, как работают Word Application методы.
Объект Word Application — Методы
Activate() — Активизирует указанный объект.
BuildKeyCode(Arg1, Arg2, Arg3, Arg4) — Возвращает уникальный номер для указанной комбинации клавиш. Обязательнм является только первый параметр (Arg1). Все параметры содержат значение константы WdKey.
KeyString(KeyCode, KeyCode2) — Возвращает строку комбинаций клавиш для указанных ключей, которые содержат значения константы WdKey (например, Ctrl + Shift + A). Обязательным является только первый параметр.
ChangeFileOpenDirectory(Path) — Устанавливает каталог, к которому Word будет обращаться при работе с документами. По умолчанию таким каталогом является “Мои документы”.
CheckGrammar(Str) — Проверяет строку на предмет грамматических ошибок. Вернет True, если строка не содержит ошибок. Word Application методы.
CheckSpelling(Str) — Проверяет строку на предмет орфографических ошибок. Вернет True, если строка не содержит ошибок.
CleanString(Str) — Удаляет непечатаемые символы (коды символов 1 — 29) и специальные символы из заданной строки или заменяет их пробелами (символ кода 32). Возвращает результат в виде обработанной строки.
GoBack() — Перемещение курсора назад по последним трем позициям, в которых происходило редактирование (аналогично нажатию Shift + F5), Word Application методы
GoForward() — Перемещение курсора вперед по последним трем позициям, в которых происходило редактирование.
Help(HelpType) – Метод Word Application отображает установленную информацию справки.
HelpType – Определяет параметры показа, содержит значение константы WdHelpType:
- WdHelp — 0 — Отображает диалоговое окно справки.
- wdHelpAbout — 1 — Отображает диалоговое окно «О программе Microsoft Word».
- wdHelpActiveWindow — 2 — Отображение справку, описывающую команду, связанную с активным просмотром или панелью.
- wdHelpContents — 3 — Отображает диалоговое окно справки.
- wdHelpExamplesAndDemos — 4 — Отображает «Примеры и демонстрации».
- wdHelpIndex — 5 — Отображает диалоговое окно справки.
- wdHelpKeyboard — 6 — Отображает справку по сочитаниям клавиш.
- wdHelpPSSHelp — 7 — Отображает информацию о поддержке продукта.
- wdHelpQuickPreview — 8 — Отображает быстрый просмотр.
- wdHelpSearch — 9 — Отображает диалоговое окно справки.
- wdHelpUsingHelp — 10 — Отображение список разделов справки, которые описывают, как использовать Справку.
- wdHelpIchitaro — 11 — Открывает файл справки для пользователей Ichitaro.
- wdHelpPE2 — 12 — Показывает справку по IBM Personal Editor 2.
- wdHelpHWP — 13 — Открывает файл справки для пользователей AreA хангыль.
ListCommands(ListAllCommands) — Создает новый документ, а затем вставляет в него таблицу, содержащую сочетания клавиш и описания методов.
ListAllCommands – Параметр содержит логическое значение, true – все команды, false – только основные команды.
Move(Left, Top) – Позиция окна задач или активного документа. Параметры определяют горизонтальную и вертикальную позицию. Word Application методы
NewWindow() — Открывает новое окно для текущего документа. Возвращает объект Window.
ShowClipboard() — Отображает Буфер обмена.
SubstituteFont(UnavailableFont, SubstituteFont) — Устанавливает варианты отображения шрифта.
UnavailableFont — Название шрифта, недоступного на вашем компьютере, который вы хотите сопоставить с другим шрифтом для отображения и печати.
SubstituteFont — Название шрифта, доступного на вашем компьютере, который вы хотите заменить недоступным шрифтом.
Quit(SaveChanges, OriginalFormat, RouteDocument) — выход Microsoft Word и, возможно, сохраняет или маршруты открытые документы.
SaveChanges — Определяет, сохранять ли сделанные изменения в документе. Значение константы WdSaveOptions:
- wdDoNotSaveChanges — 0 — Не сохранять сделанные изменения.
- wdPromptToSaveChanges — 2 — Запросить у пользователя, чтобы сохранить внесенные изменения.
- wdSaveChanges — 1 — Сохранить сделанные изменения автоматически без запроса пользователя.
OriginalFormat – Определяет параметры сохранения. Значения константы WdOriginalFormat:
- wdOriginalDocumentFormat — 1 — Оригинальный формат документа.
- wdPromptUser — 2 – Пользователю будет предложено выбрать формат документа.
- wdWordDocument — 0 – Формат документа Microsoft Word.
RouteDocument — True, чтобы направить документ на следующего получателя. Если документ не имеет маршрутизации, то аргумент игнорируется, Word Application методы.
ResetIgnoreAll() – снимает метку со всех фрагментов текста, которые помечены как «без проверки» в процессе проверки орфографии.
Resize(Width, Height) — Размеры окна приложения Word или указанного окна задач. Параметры определяют ширину и высоту окна.
Run(MacroName, varg1, … , varg30) – запуск указанного макроса Visual Basic. Обязательный только первый параметр.
MacroName — Имя макроса.
varg1 … varg30 – До 30 параметров, передаваемых макросу.
ScreenRefresh() – Метод включает обновление экрана в течении одной команды
KeyBoard(code) – Переключение раскладки клавиатуры, в качестве параметра (code) передается целое значение (например, 1033 – для русского языка, 1049 – для английского языка). Если вызвать метод без параметров, то будет возвращено текущее значение раскладки клавиатуры. Word Application метод.
OnTime(When, Name, Tolerance) – Устанавливает таймер для запуска макроса в указанное время.
When — Время, в которое нужно запустить макрос. Можно прописать строкой (“15:30”) или использовать функции работы со временем.
Name — Имя макроса.
Tolerance – Дополнительный параметр. Задает максимальное время в секундах, которое может пройти, прежде чем мкрос, который не успел запуститься будет отменен.
Следующие Word Application методы отвечают за преобразование измерительных величин.
CentimetersToPoints(Centimeters) — Преобразует сантиметры в пункты (1 см = 28,35 пункта).
InchesToPoints(Inches) — Преобразует дюймы в пункты (1 дюйм = 72 пункта).
LinesToPoints(Lines) — Преобразует линии в пункты (1 линия = 12 пунктов).
MillimetersToPoints(Millimeters) — Преобразует миллиметры в пункты (1 мм = 2,85 пункта).
PicasToPoints(Picas) — Преобразует пики в пункты (1 пик = 12 пунктов).
PixelsToPoints(Pixels, fVertical) — Преобразует пиксели в пункты.
fVertical – Дополнительный параметр, True – по вертикали, False – по горизонтали.
PointsToCentimeters(Points) — Преобразует пункты в сантиметры.
PointsToInches(Points) — Преобразует пункты в дюймы.
PointsToLines(Points) — Преобразует пункты в линии.
PointsToMillimeters(Points) — Преобразует пункты в миллиметры.
PointsToPicas(Points) — Преобразует пункты в пики.
PointsToPixels(Points, fVertical) — Преобразует пункты в пиксели.
События для Word Application — VBA
Объект Word Application предоставляет в распоряжение довольно много событий, но… изначально к ним нет доступа в редакторе VBA. Второй проблемой является то, что события Word Application VBA нельзя использовать в сценариях Windows Script Host, ну я такой лазейки не нашел.
Что бы появилась возможность работать с событиями данного класса в редакторе VBA, надо выполнить следующие действия:
- Создаем новый модуль класса, для этого в меню Insert выберите пункт Class Module.
- В окне редактора для созданного модуля пишем код:
Public WithEvents App As Word.Application
- Меняем в окне свойств значение свойства Name на EventClassModule
Все, теперь в редакторе кода в окне объектов появится объект App, который и предоставляет возможность работать с событиями Word Application в VBA.
