ShellExecute使用详解

ShellExecute使用详解

ShellExecute命令

　　⑴　函数原型：

HINSTANCE ShellExecute(HWND hwnd, LPCTSTR lpOperation, LPCTSTR lpFile, LPCTSTR lpParameters, LPCTSTR lpDirectory, INT nShowCmd);

　　⑵　参数：

　　hwnd：指向父窗口的窗口句柄。

此窗口接收应用程序产生的任何信息框。

　　lpOperation：一个空结束的字符串地址，此字符串指定要执行的 *** 作。

下面的 *** 作字符串是有效的：

"open " 此函数打开由参数lpFile指定的文件，此文件可以是一个可执行文件或文档文件，也可是一个文件夹。

 
"print " 此函数打印由参数lpFile指定的文件，此文件应是一个文档文件，假如此文件是一个可执行文件，则打开此文件。

 
"explore " 此函数搜索由参数lpFile指定的文件夹，此文件应是一个文档文件，

　　　此参数可以为空。

这种情况下，函数用于打开由参数lpFile指定的文件。

　　lpFile：一个空结束的字符串地址，此字符串指定要打开或打印的文件或者是要打开或搜索的文件夹。

　　lpParameters：假如参数lpFile指定一个可执行文件，lpParameters则是一个空结束的字符串地址，此字符串指定要传递给应用程序的参数。

假如lpFile指定一个文档文件，lpParameters应为空。

　　lpDirectory：一个空结束的字符串地址，此字符串指定默认目录。

　　nShowCmd：假如lpFile指定一个可执行文件，nShowCmd表明应用程序打开时如何显示。

假如lpFile指定一个文档文件，nShowCmd应为空。

　　⑶　返回值：

　　若函数调用成功，则返回值大于32，否则为一个小于等于32的错误值。

　　说明：可以用此函数打开或搜索一个外壳文件夹。

打开文件夹可用下面任何一种形式：

ShellExecute(handle, NULL, path_to_folder, NULL, NULL, SW_SHOWNORMAL); 
　　 
　　或

ShellExecute(handle, "open ", path_to_folder, NULL, NULL, SW_SHOWNORMAL);

　　搜索文件夹，可用如下形式

ShellExecute(handle, "explore ", path_to_folder, NULL, NULL, SW_SHOWNORMAL);

有三个API函数可以运行可执行文件WinExec、ShellExecute和CreateProcess。

CreateProcess因为使用复杂，比较少用。

 
WinExec主要运行EXE文件。

如：WinExec('Notepad.exe Readme.txt', SW_SHOW);

ShellExecute不仅可以运行EXE文件，也可以运行已经关联的文件。

首先必须引用shellapi.pas单元：uses ShellAPI;

1.标准用法

　　ShellExecute函数原型及参数含义如下：

　　function ShellExecute(hWnd: HWND; Operation, FileName, Parameters,Directory: PChar; ShowCmd: Integer): HINST; stdcall;

　　●hWnd：用于指定父窗口句柄。

当函数调用过程出现错误时，它将作为Windows消息窗口的父窗口。

例如，可以将其设置为应用程序主窗口句柄，即Application.Handle，也可以将其设置为桌面窗口句柄（用GetDesktopWindow函数获得）。

　　●Operation：用于指定要进行的 *** 作。

其中“open” *** 作表示执行由FileName参数指定的程序，或打开由FileName参数指定的文件或文件夹；“print” *** 作表示打印由FileName参数指定的文件；“explore” *** 作表示浏览由FileName参数指定的文件夹。

当参数设为nil时，表示执行默认 *** 作“open”。

　　●FileName：用于指定要打开的文件名、要执行的程序文件名或要浏览的文件夹名。

　　●Parameters：若FileName参数是一个可执行程序，则此参数指定命令行参数，否则此参数应为nil或PChar(0)。

　　●Directory：用于指定默认目录。

　　●ShowCmd：若FileName参数是一个可执行程序，则此参数指定程序窗口的初始显示方式，否则此参数应设置为0。

　　若ShellExecute函数调用成功，则返回值为被执行程序的实例句柄。

若返回值小于32，则表示出现错误。

　　上述仅仅是ShellExecute函数的标准用法，下面将介绍它的特殊用法。

2.特殊用法

　　如果将FileName参数设置为“http:”协议格式，那么该函数将打开默认浏览器并链接到指定的URL地址。

若用户机器中安装了多个浏览器，则该函数将根据Windows 9x/NT注册表中http协议处理程序（Protocols Handler）的设置确定启动哪个浏览器。

　　格式一：http://网站域名。

　 如：ShellExecute(handle, ‘open’, http:// ;

www.neu.edu.cn’, nil, nil, SW_SHOWNORMAL);

　　格式二：http://网站域名/网页文件名。

　　如：ShellExecute(handle, ‘open’, http:// ;

www.neu.edu.cn/default.htm’,nil,nil,

SW_SHOWNORMAL);

　　如果将FileName参数设置为“mailto:”协议格式，那么该函数将启动默认邮件客户程序，如Microsoft Outlook（也包括Microsoft Outlook Express）或Netscape Messanger。

若用户机器中安装了多个邮件客户程序，则该函数将根据Windows 9x/NT注册表中mailto协议处理程序的设置确定启动哪个邮件客户程序。

　　格式一：mailto:

　　如：ShellExecute(handle,‘open’, ‘mailto:’, nil, nil, SW_SHOWNORMAL);打开新邮件窗口。

　　格式二：mailto:用户账号@邮件服务器地址

　　如：ShellExecute(handle, ‘open’,‘ mailto:[email protected]’, nil, nil, SW_SHOWNORMAL);打开新邮件窗口，并自动填入收件人地址。

若指定多个收件人地址，则收件人地址之间必须用分号或逗号分隔开（下同）。

　　格式三：mailto:用户账号@邮件服务器地址?subject=邮件主题＆body=邮件正文

　　如：ShellExecute(handle, ‘open’, ‘ mailto:[email protected]？subject=Hello＆Body=This is a test’, nil, nil, SW_SHOWNORMAL);打开新邮件窗口，并自动填入收件人地址、邮件主题和邮件正文。

若邮件正文包括多行文本，则必须在每行文本之间加入换行转义字符％0a。

例子(delphi):

在一个应用程序调用c:/Project1.exe;

ShellExecute(handle, 'open','c:/Project1.exe','字串内容',nil, SW_SHOWNORMAL);

在Project1.exe里可以调用:

procedure TForm1.FormCreate(Sender: TObject);

var i:integer;

begin

for i:=1 to paramcount do

if ParamStr(i)<>'' then showmessage(ParamStr(i));

end;

最后的那个参数，为窗口指定可视性方面的一个命令。

请用下述任何一个常数

SW_HIDE 隐藏窗口，活动状态给令一个窗口

SW_MINIMIZE 最小化窗口，活动状态给令一个窗口

SW_RESTORE 用原来的大小和位置显示一个窗口，同时令其进入活动状态

SW_SHOW 用当前的大小和位置显示一个窗口，同时令其进入活动状态

SW_SHOWMAXIMIZED 最大化窗口，并将其激活

SW_SHOWMINIMIZED 最小化窗口，并将其激活

SW_SHOWMINNOACTIVE 最小化一个窗口，同时不改变活动窗口

SW_SHOWNA 用当前的大小和位置显示一个窗口，不改变活动窗口

SW_SHOWNOACTIVATE 用最近的大小和位置显示一个窗口，同时不改变活动窗口

SW_SHOWNORMAL 与SW_RESTORE相同

-------------------------------------------------------------------------

始一个新的应用程序 
　　　ShellExecute(Handle, 'open', PChar('c:/test/app.exe'), nil, nil, SW_SHOW);

打开记事本，并打开一个文件(系统能识别记事本应用程序的路径，因此我们不必使用绝对路径） 
　　　ShellExecute(Handle, 'open', PChar('notepad'), PChar('c:/test/readme.txt'), nil, SW_SHOW);

打印一个文档 
　　　ShellExecute(Handle, 'print', PChar('c:/test/test.doc'), nil, nil, SW_SHOW);

　　　注意：可能你会看到word暂时的被打开，但它会自动关闭。

打开一个HTML页面 
　　　ShellExecute(Handle, 'open', PChar('http://bbs.e-0631.cn'), nil, nil, SW_SHOW);

你能通过一个已经注册的文件类型来打开应用程序 
　　　ShellExecute(Handle, 'open', PChar('c:/test/readme.txt'), nil, nil, SW_SHOW);

用windows Explorer 打开一个目录 
　　　ShellExecute(Handle, 'explore', PChar('c:/windows)', nil, nil, SW_SHOW);

运行一个DOS命令并立即返回 
　　　ShellExecute(Handle, 'open', PChar('command.com'), PChar('/c copy file1.txt file2.txt'), nil, SW_SHOW);

运行一个DOS命令并保持DOS窗口存在 
　　　ShellExecute(Handle, 'open', PChar('command.com'), PChar('/k dir'), nil, SW_SHOW);