Объект Word Application - методы

В этой статье мы рассмотрим методы объекта 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.

Знаю, знаю, статья получилась довольно сухая – практически нет примеров Но ничего, в следующей статье мы быстренько пробежимся по некоторым свойствам, а потом еще попытаемся осилить коллекцию Documents и класс Document, без которых просто невозможно двигаться дальше.