Объект WshShell
1. Создание объекта
2. Свойства
2.1. CurrentDirectory
Возвращаемое значение: строка, путь к текущему каталогу.
Замечание: чтение и запись.
2.2. Environment
Возвращаемое значение: объект-коллекция «WshEnvironment», содержащая переменные среды. Необязательный параметр «Type» — строка, задаёт вид переменных. Возможные значения:
- «System» — переменные среды операционной системы (в Windows NT/2000 — это параметр по умолчанию).
- «User» — переменные среды пользователя.
- «Volatile» — временные переменные.
- «Process» — переменные среды текущего командного окна (в Windows 95/98/Me — это единственно возможный параметр).
Замечание: чтение и запись. В коллекцию можно добавлять элементы и удалять их.
2.3. SpecialFolders
Возвращаемое значение: объект-коллекция «SpecialFolders», содержащая пути к специальным папкам Windows. Некоторые специальные папки:
- AllUsersDesktop
- AllUsersStartMenu
- AllUsersPrograms
- AllUsersStartup
- Desktop
- Favorites
- Fonts
- MyDocuments
- NetHood
- PrintHood
- Programs
- Recent
- SendTo
- StartMenu
- Startup
- Template
Замечание: только чтение.
3. Методы
3.1. ExpandEnvironmentStrings
Назначение: возвращает значение переменной среды текущего командного окна.
- — строка, имя переменной. Должно быть окружено знаками «%».
3.2. Popup
Назначение: выводит на экран модальное окно сообщения.
— строка, текст сообщения.
- 0 — кнопка ОК.
- 1 — кнопки ОК и Отмена.
- 2 — кнопки Стоп, Повтор, Пропустить.
- 3 — кнопки Да, Нет, Отмена.
- 4 — кнопки Да и Нет.
- 5 — кнопки Повтор и Отмена.
- 16 — значок Stop.
- 32 — значок Question.
- 48 — значок Exclamation.
- 64 — значок Information.
Описание: возвращает целое значение, с помощью которого можно узнать, какая кнопка быля нажата пользователем. Возможные значения:
- -1 — таймаут.
- 1 — кнопка ОК.
- 2 — кнопка Отмена.
- 3 — кнопка Стоп.
- 4 — кнопка Повтор.
- 5 — кнопка Пропустить.
- 6 — кнопка Да.
- 7 — кнопка Нет.
3.3. SendKeys
Назначение: посылает одно или несколько нажатий клавиш в активное окно (имитация набора на клавиатуре).
- — строка, перечень клавиш в специальном формате.
Описание: каждая клавиша задаётся своим символом. Например, чтобы задать нажатие друг за другом клавиш А, Б и В, нужно указать в качестве параметра строку «АБВ». Некоторые специальные символы следует всегда задавать заключёнными в фигурные скобки. Перечень таких символов:
Задание неотображаемых символов и специальных клавиш:
Можно использовать скобки. Например, нажатие клавиш и при нажатом следует записывать как «+(GS)». Запись «+GS» приведёт к нажатию клавиши при нажатом , а затем клавиши уже без .
Задание нескольких нажатий: «
Метод не может быть использован для посылки нажатий клавиш в приложения MS-DOS.
3.4. Run
Назначение: создаёт новый независимый процесс, который запускает заданное приложение.
- — строка, командная строка запуска приложения.
- — необязательный, число. Определяет вид окна запускаемого приложения. Некоторые возможные значения:
- 0 — Не отображает окно.
- 1 — Активизирует и отображает окно.
- 2 — Активизирует окно и отображает его в свёрнутом виде.
- 3 — Активизирует окно и отображает его в максимизированном виде.
- — необязательный, булево (число). True — сценарий возобновит работу только после завершения вызванного процесса. False (по умолчанию) — управление передаётся сразу обратно в сценарий.
Описание: если параметр «WaitOnReturn» установлен в True, метод возвращает код выхода вызванного приложения. Иначе метод всегда возвращает ноль.
3.5. Exec
Назначение: создаёт новый дочерний процесс (т.е. процесс с теми же переменными среды), который запускает заданное консольное приложение. Возвращается объект «WshScriptExec», который позволяет контролировать ход выполнения запущенного приложения и обеспечивает доступ к потокам StdIn, StdOut и StdErr этого приложения.
- — строка, командная строка запуска приложения.
Описание: с помощью данного метода можно запускать и графические оконные приложения. В этом случае возвращаемый объект «WshScriptExec» полезен тем, что позволяет получить идентификатор запущенного процесса, который можно использовать, например, для активизации приложения с помощью метода AppActivate.
3.6. AppActivate
Назначение: активизирует указанное окно какого-либо приложения. Возвращает True в случае успеха и False в случае неудачи.
- — заголовок окна приложения или идентификатор процесса.
Описание: если в качестве параметра указан заголовок окна приложения, значение параметра сравнивается по очереди с заголовками окон всех запущенных приложений. Если не найдено ни одного точного совпадения, будет производиться поиск окна, заголовок которого начинается с указанной строки. Если и в этом случае не будет найдено ни одного подходящего окна, будет производиться поиск окна, заголовок которого заканчивается на указанную строку. Если будет найдено несколько подходящих окон, произойдёт активизация одного из них (произвольно).
3.7. RegDelete
Назначение: удаляет из реестра заданный параметр или раздел целиком.
- — строка, наименование параметра или раздела.
Описание: если «Name» оканчивается символом «\», метод удаляет ключ целиком, в противном случае удаляется параметр. Параметр «Name» должен начинаться с одного из корневых ключей:
- HKEY_CURRENT_USER — HKCU
- HKEY_LOCAL_MACHINE — HKLM
- HKEY_CLASSES_ROOT — HKCR
- HKEY_USERS — HKEY_USERS
- HKEY_CURRENT_CONFIG — HKEY_CURRENT_CONFIG
3.8. RegRead
Назначение: читает из реестра заданный параметр или значение по умолчанию для раздела.
- — строка, наименование параметра или раздела.
Описание: если «Name» оканчивается символом «\», метод считывает значение по умолчанию для раздела, в противном случае считывается параметр. Параметр «Name» должен начинаться с одного из корневых ключей:
- HKEY_CURRENT_USER — HKCU
- HKEY_LOCAL_MACHINE — HKLM
- HKEY_CLASSES_ROOT — HKCR
- HKEY_USERS — HKEY_USERS
- HKEY_CURRENT_CONFIG — HKEY_CURRENT_CONFIG
3.9. RegWrite
Назначение: записываает в реестр заданный параметр или раздел.
- — строка, наименование параметра или раздела.
- — значение параметра или значение для раздела по умолчанию.
- — необязательный, тип значения. Возможные значения: «REG_SZ», «REG_EXPAND_SZ», «REG_DWORD», «REG_BINARY». Если указано «REG_SZ» или «REG_EXPAND_SZ», параметр «Type» конвертируется в строку, если указано «REG_DWORD», параметр «Type» конвертируется в целое число, если указано «REG_BINARY», параметр «Type» должен быть целым числом.
Описание: если «Name» оканчивается символом «\», метод записывает раздел, в противном случае записывается параметр. Параметр «Name» должен начинаться с одного из корневых ключей:
- HKEY_CURRENT_USER — HKCU
- HKEY_LOCAL_MACHINE — HKLM
- HKEY_CLASSES_ROOT — HKCR
- HKEY_USERS — HKEY_USERS
- HKEY_CURRENT_CONFIG — HKEY_CURRENT_CONFIG
3.10. LogEvent
Назначение: протоколирует событие в журнале WindowsNT или в файле WSH.log. Возвращает True в случае успеха и False в противном случае.
- — число, тип сообщения. Возможные значения:
- 0 — SUCCESS
- 1 — ERROR
- 2 — WARNING
- 4 — INFORMATION
- 8 — AUDIT_SUCCESS
- 16 — AUDIT_FAILURE
- — строка, текст сообщения.
- — строка, название системы, в которой протоколируется событие (по умолчанию — локальная система), может задаваться только в Windows NT/2000/XP.
Описание: в Windows NT/200/XP события записываются в системном журнале, а в Windows 9x — в файле WSH.log, который находится в каталоге пользователей.
3.11. CreateShortcut
Назначение: возвращает объект «WshShortcut» или «WshURLShortcut», указывающий на ярлык .lnk или .url.
— строка, полный путь к создаваемому или изменяемому файлу ярлыка.
4. Объект WshScriptExec
4.1. Создание объекта
4.2. Свойства
4.2.1. ExitCode
Возвращаемое значение: код выхода, устанавливаемый дочерней задачей при завершении выполнения.
Замечание: только чтение.
4.2.2. ProcessID
Возвращаемое значение: идентификатор запущенного процесса (PID).
Замечание: только чтение.
4.2.3. Status
Возвращаемое значение: состояние запущенного процесса. Возможные значения:
- 0 — приложение запущено.
- 1 — приложение завершено.
Замечание: только чтение.
4.2.4. StdOut
Возвращаемое значение: объект «TextStream», соответствующий стандартному выходному потоку запущенной задачи.
Замечание: только чтение.
4.2.5. StdIn
Возвращаемое значение: объект «TextStream», соответствующий стандартному входному потоку запущенной задачи.
Замечание: только чтение.
4.2.6. StdErr
Возвращаемое значение: объект «TextStream», соответствующий стандартному потоку ошибок запущенной задачи.
Замечание: только чтение.
4.3. Методы
4.3.1. Terminate
Назначение: пытается закрыть приложение, посылая ему сообщение WM_CLOSE. Если это не срабатывает, задача завершается принудительно.
5. Объект WshShortcut
5.1. Создание объекта
5.2. Свойства
5.2.1. Arguments
Возвращаемое значение: строка, параметры командной строки программы, запускаемой ярлыком.
Замечание: чтение и запись.
5.2.2. Description
Возвращаемое значение: строка, описание в поле «Комментарий» («Comment») в свойствах ярлыка.
Замечание: чтение и запись.
5.2.3. FullName
Возвращаемое значение: строка, полный путь к файлу ярлыка.
Замечание: только чтение.
5.2.4. Hotkey
Возвращаемое значение: строка, содержащая названия горячих клавиш, разделённые знаком «+».
Замечание: чтение и запись.
5.2.5. IconLocation
Возвращаемое значение: строка, содержащая расположение иконки для ярлыка в формате «путь к файлу, индекс иконки». Индексы иконок начинаются с нуля.
Замечание: чтение и запись.
5.2.6. TargetPath
Возвращаемое значение: строка, содержащая путь к исполняемому файлу.
Замечание: чтение и запись.
5.2.7. WindowStyle
Возвращаемое значение: число, определяющее вид окна запускаемого приложения. Возможные значения:
- 1 — Стандартное окно.
- 3 — Максимизированное окно.
- 7 — Минимизированное окно.
Замечание: чтение и запись.
5.2.8. WorkingDirectory
Возвращаемое значение: строка, путь к рабочему каталогу ярлыка.
Объект WScript.Shell метод SendKeys — имитация нажатия клавиш
Всем привет, с вами автор блога scriptcoding.ru. Сегодня мы затронем такую тему как имитация нажатия клавиш программными средствами с помощью метода SendKeys класса WScript.Shell.
SendKeys – имитация нажатия клавиш – теоретические основы
Метод SendKeys, который позволяет имитировать нажатие клавиш и их комбинаций. Метод SendKeys объекта WScript.Shell является по своей природе слепым, так как он не позволяет указать то приложение, которому назначен ввод с клавиатуры, то есть, если мы сделаем попытку имитировать ввод фразы «привет мир», то она будет обрабатываться лишь тому приложениею, которое в данный момент являются активным. Если активным будет текстовый редактор – то в нем отобразится заданный текст, если антивирусная программа – то, скорее всего, никакой активности не произойдет.
Что бы использовать функцию Wscript SendKeys, нужно объявить переменную, которая будет хранить ссылку на объект WScript.Shell, а уже через эту переменную можно будет вызвать SendKeys.
Общая логика работы:
SendKeys (строка) – Видим, что мы в качестве аргумента должны передать строковое выражение, которое будет хранить имя клавиши или сочетание.
Что бы ввести просто символ или набор символов, мы всего-навсего прописываем их как строку, например: SendKeys(«привет мир»). Для ввода специальных клавиш (например, Enter, стрелки, функциональные клавиши и так далее), их название нужно заключить в фигурные скобки <>.
Ниже приведен список функциональных клавиш и их обозначение:
- BACKSPACE —
, или - BREAK —
- CAPS LOCK —
- DEL или DELETE —
или - СТРЕЛКА ВНИЗ —
- END —
- ENTER —
или
Если нужно указать сочетание специальных клавиш, то следует использовать следующие коды:
Также стоит помнить, что для ввода символов +, ^, %,
, (, ) , <, >, [, ] их также нужно заключить в фигурные скобки.
Если есть необходимость имитации нажатия клавиши несколько раз подряд, то после нее через пробел прописывается количество, например:
SendKeys – имитация нажатия клавиш – приступаем к программированию
Хорошо, с теорией разобрались, теперь давайте приступим к программированию. Давайте для начала рассмотрим следующий пример программного кода на языке vbscript:
Видим, что тут мы создали массив символов my_arr(16), их количество составляет 17, так как нумерация элементов массива начинается с нуля. Вы можете возразить, а зачем формировать массив, если все можно прописать в одном строковом значении ? Верно, но, цель сценария не просто отправить коды клавиш, а сделать задержку для каждого символа. Мы видим, что с помощью массива идет обработка каждого элемента, он передается методу SendKeys WScript Shell объекта, после идет задержка в 500 миллисекунд (WScript.Sleep 500), и так для каждого символа. Перед выполнением метода мы запускаем блокнот (WshShell.Run «Notepad.exe», 1) с помощью метода Run (подробно про метод Run я написал в статье «Объект WScript.Shell — метод Run»), поэтому, команды будут передаваться текстовому редактору. Как только все команды будут выполнены, появится сообщение (MsgBox «Конец теста!»), которое проинформирует, что сценарий завершил свою работу. На практике это выглядит так:
- Запускается блокнот
- Постепенно вводится текст «это»
- Делаем два раза имитацию нажатия клавиши Enter (
) - Постепенно вводится текст «простой»
- Нажимается два раза клавиша Enter (
) - Постепенно вводится текст «текст»
- Появляется сообщение «Конец теста!»
А вот аналогичный пример, но уже на языке jscript:
В примере на jscript я мог использовать более лаконичный стиль программирования для массива, но, решил этого не делать, что бы было наглядней видно, что и как. Важно, пока не появится сообщение о том, что сценарий выполнил работу, не переключатся на другие приложения , так как это может привести к неожиданным последствиям.
А вот еще один пример на vbscript :
В этом примере мы уже будем направлять с помощью метода SendKeys WScript Shell класса команды программе калькулятор – простая арифметика (100/2*0.5). В конце мы выполним имитацию нажатия комбинации клавиш «ALT + F4«, что бы закрыть калькулятор и выведем сообщение — » Операция выполнена! «. Далее мы снова попытаемся отправить в систему комбинацию «CTRL + ALT + DEL» (запуск диспетчера задач), но, ничего не выйдет, видимо эта комбинация не работает из-за соображений безопасности.
Ну и пример на языке jscript :
И так, давайте все подытожим… В этой статье мы рассмотрели функцию SendKeys класса WScript Shell, которая позволяет создавать имитацию нажатия клавиш, мы написали четыре программных кода – два на языке vbscript и два на языке jscript. Помним, что программный код работает под управлением сервера сценариев Windows Script Host.
Спасибо за внимание. Автор блога Владимир Баталий
Советую ещё почитать:
Режимы просмотра документа в Word 2007
- Класс Win32_BaseBoard — Информация о материнской плате
- Класс Win32_NetworkAdapter — Параметры сетевого адаптера
Работа со списками в Word 2007
- Объект Word Selection — выделить весь текст в ворде, свойства
9 комментариев к записи “Объект WScript.Shell метод SendKeys — имитация нажатия клавиш”
Здравствуйте.
Скажите пожалуйста, а как сымитировать нажатие клавиши Fn на ноутбуках? никак не могу найти ответа на данный вопрос.
Заранее спасибо.
К сожалению, средствами Windows Script Host этого не сделать, видимо, во времена разработки сервера WSH функциональная клавиша Fn еще не использовалась и возможности имитировать что то типа Fn+F7 нет. Ну, по крайней мере, я тоже ничего не нашел.
Скачайте программу ATNSOFT Key Manager (платная, но есть портативная взломанная). Или бесплатную AutoHotkey, но тут сложнее, если вообще получится.
Приветствую, Владимир!
Подскажи почему метод SendKeys не работает с русской раскладкой, только на английской. На русской получается какая-то белиберда. Все что связано с кодировкой уже перепробовал. ОС — 7.
Евгений, на самом деле, функция SendKeys работает и с русской раскладкой, просто есть такой изъян:
Допустим, мы передали функции русский символ «п», при русской раскладке функция вернет именно этот символ, но, если раскладка английская, то функция вернет символ «g». То есть, будет нажата та же клавиша, но в зависимости от раскладки, будет возвращаться тот символ, который к ней привязан.
Приветствую, Владимир! подскажите, как запустить клавишу пробел на повтор?
echo Chr(39)>%temp%\temp1.vbs
echo Chr(39)>%temp%\temp2.vbs
echo on error resume next > %temp%\temp.vbs
echo Set S = CreateObject(«Wscript.Shell») >> %temp%\temp.vbs
echo set FSO=createobject(«scripting.filesystemobject»)>>%temp%\temp.vbs
echo do >> %temp%\temp.vbs
echo wscript.sleep 200 >> %temp%\temp.vbs
echo s.sendkeys»
echo loop>> %temp%\temp.vbs
start %temp%\temp.vbs
start %temp%\temp1.vbs
start %temp%\temp2.vbs
А как прервать выполнение скрипта (например по нажатию Esc) ?
Здравствуйте Владимир,
Как имитировать нажатия на клавиши дополнительной цифровой клавиатуры Ctrl + Shift + Num-?
WshShell.SendKeys(«(^+
WshShell.SendKeys(«(^+
А у меня вместо английских букв выводится что попало.
Как сделать, что бы выводился текст английскими буквами?