В этой статье мы рассмотрим методы объекта 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, без которых просто невозможно двигаться дальше.
Спасибо за внимание. Автор блога Владимир Баталий