ShellExec

Shellexec

Обзор

Shellexec - это консольное приложение, которое позволяет запускать программы (как текущего пользователя или администратора), открыть документы в связанных приложениях, просматривать веб -страницы в браузере по умолчанию и многое другое. Это «консольная обертка» для функции ShellexeCuteex.

Скачать

Скомпилированные двоичные файлы:

Shellexec_win64.zip (~ 96 кб)
Shellexec_win32.zip (~ 72 кб)

Использование

 ShellExec FILE [-o Operation] [-p Parameters] [-d Directory] [-s ShowCommand]   
[-w [finish|idle]] [-t TIME] [-hwnd WindowHandle] [-h] [-V] [--license] [--home] [--source]

Параметры

Варианты чувствительны к случаям. Варианты в квадратных скобках являются необязательными.

Основные варианты

-o , --operation=STR
Действие для выполнения. Действие по умолчанию открыто . См. Описание ниже.

-p , --params=STR
Если файл указывает исполняемый файл, этот параметр является строкой, которая указывает параметры, которые должны быть переданы в приложение.

-d , --directory=DIR
Рабочий каталог для действия.

-s , --show-cmd=STR
Этот параметр указывает, как приложение должно отображаться при его открытии. Команда Show по умолчанию SW_SHOWNORMAL . См. Описание ниже.

-w , --wait=[FOR]
закончить или бездействовать . По умолчанию: финиш . Если вы не указаете время ожидания в опции -t , будет использоваться Infinite ( -t=infinite ). См. Описание ниже.

-t , --wait-time=TIME
Интервал тайм -аута (для опции -w ). Доступные единицы времени: ms (миллисекунд), s (секунд), m (минуты), h (часы), d (дни). Если единица не указана, Milliseconds будут использоваться. Значение бесконечно не означает ограничения по времени.

-hwnd , --window-handle=INT
Ручка для родительского окна, используемого для отображения пользовательского интерфейса или сообщений об ошибках.

Информация

-h , --help
Показать помощь.

-V , --version
Показать версию приложения.

--license
Отображение лицензии программы.

--home
Открывает домашнюю страницу программы в браузере по умолчанию.

--source
Открывает страницу программы на GitHub с исходными файлами программы.

ФАЙЛ

Имя файла или каталог или URL или объект, на котором можно выполнить указанную операцию.

Операции

открыть
Открывает элемент, указанный параметром файла. Элемент может быть файлом, папкой или URL.

редактировать
Запускает редактор и открывает документ для редактирования. Если файл не является файлом документа, Shellexec не удастся.

исследовать
Исследует папку, указанную файлом.

находить
Инициирует поиск, начиная с каталога, указанного опции -d .

печать
Печатает файл, указанный файлом. Если файл не является файлом документа, программа не удается.

Рунас
Запускает приложение в качестве администратора. Управление учетной записью пользователя (UAC) предложат пользователю согласие запустить приложение REALETED или ввести учетные данные учетной записи администратора, используемой для запуска приложения.

характеристики
Отображает свойства файла или папки.

Дополнительная информация (LPoperation): https://docs.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-shellexecutew
Более подробная информация (LPVerb): https://docs.microsoft.com/en-us/windows/win32/api/shellapi/ns-shellapi-shellexecuteinfow

Показать команды

0 | SW_HIDE | Hide
Скрывает окно и активирует другое окно.

1 | SW_SHOWNORMAL | ShowNormal | SW_NORMAL | Normal
Активирует и отображает окно. Если окно минимизировано или максимизировано, система восстанавливает его до исходного размера и положения. Приложение должно указать этот флаг при отображении окна в первый раз.

2 | SW_SHOWMINIMIZED | ShowMinimized | Minimized
Активирует окно и отображает его как минимизированное окно.

3 | SW_SHOWMAXIMIZED | ShowMaximized | Maximized | Maximize
Активирует окно и отображает его как максимизированное окно.

4 | SW_SHOWNOACTIVATE | ShowNoActivate | NoActivate
Отображает окно в своем последнем размере и положении. Это значение аналогично SW_SHOWNORMAL, за исключением того, что окно не активируется.

5 | SW_SHOW | Show
Активирует окно и отображает его в его текущем размере и положении.

6 | SW_MINIMIZE | Minimize
Минимизирует указанное окно и активирует следующее окно верхнего уровня в порядке Z.

7 | SW_SHOWMINNOACTIVE | ShowMinNoActive | MinNoActive
Отображает окно как минимизированное окно. Это значение аналогично sw_showminimized, за исключением того, что окно не активируется.

8 | SW_SHOWNA | ShowNA
Отображает окно в его текущем размере и положении. Это значение аналогично SW_SHOW, за исключением того, что окно не активируется.

9 | SW_RESTORE | Restore
Активирует и отображает окно. Если окно минимизируется или максимизирован, система восстанавливает его до исходного размера и положения. Приложение должно указать этот флаг при восстановлении минимизированного окна.

10 | SW_SHOWDEFAULT | ShowDefault
Устанавливает состояние SHOW на основе значения SW_, указанного в структуре StartupInfo, переданной функции CreateProcess в программе, которая запустила приложение.

11 | SW_FORCEMINIMIZE | ForceMinimize
Минимизирует окно, даже если поток, который владеет окном, не отвечает. Этот флаг следует использовать только при минимизации окон из другого потока.

Дополнительная информация: https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-showwindow#parameters

Ждать

заканчивать
Подождите, пока программа работает (указанная в параметре файла) не завершит свою работу, или до тех пор, пока не истечет интервал тайм -аута (опция -t ).

праздный
Ожидает, пока указанная программа не завершит обработку своего начального ввода и ждет ввода пользователя без ввода, или до тех пор, пока не истечет интервал тайм -аута ( -t ).

Больше информации:
https://docs.microsoft.com/en-us/windows/win32/api/synchapi/nf-synchapi-waitforsingleobject
https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-waitforinputidle

Коды выхода

0 - успех
Любое другое значение - ошибка

Примеры

1. Запускает системный калькулятор:
   ShellExec calc

2. Открывает файл «Хост» в системном текстовом редакторе, Блокнот:
   ShellExec notepad -o runas -p "C:WindowsSystem32driversetchosts"

3. Отображает заданный веб -сайт в браузере по умолчанию:
   ShellExec https://example.com

4. Открывает файл "win.ini" в текстовом редакторе, связанном с файлами INI:
   ShellExec "C:Windowswin.ini"

5. Открывает файл JPG в графическом просмотре по умолчанию:
   ShellExec "D:picturesmy picture.jpg"

6. Открывает файл BAT для редактирования в редакторе по умолчанию и ожидает завершения программы:
   ShellExec "D:batch_filestest.bat" -o edit -w=finish

Лицензия

Общественный достояние.

Компиляция

Вам нужен Embarcadero delphi XE2 или более новее (бесплатная версия сообщества - это EOH).

Вам также нужно несколько единиц из библиотеки JPLIB.