函数使用笔记——ShellExecute

函数使用笔记——ShellExecute

API函数

　　ShellExecute的功能是运行一个外部程序（或者是打开一个已注册的文件、打开一个目录、打印一个文件等等），并对外部程序有一定的控制。有几个API函数都可以实现这些功能，但是在大多数情况下ShellExecute是更多的被使用的，同时它并不是太复杂。

原型参数

　　注意事项：使用该函数时，需添加该头文件：#include <shellapi.h>
　　ShellExecute函数原型及参数含义如下：

ShellExecute(
hWnd: HWND; 			{指定父窗口句柄}
Operation: PChar; 		{指定动作, 譬如: open、runas、print、edit、explore、find}
FileName: PChar; 		{指定要打开的文件或程序}
Parameters: PChar; 		{给要打开的程序指定参数; 如果打开的是文件这里应该是 nil}
Directory: PChar; 		{缺省目录}
ShowCmd: Integer 		{打开选项}
): HINST;

　　ShowCmd 参数可选值:

SW_HIDE = 0; 				{隐藏}
SW_SHOWNORMAL = 1; 			{用最近的大小和位置显示, 激活}
SW_NORMAL = 1;				{同 SW_SHOWNORMAL}
SW_SHOWMINIMIZED = 2; 		{最小化, 激活}
SW_SHOWMAXIMIZED = 3; 		{最大化, 激活}
SW_MAXIMIZE = 3; 			{同 SW_SHOWMAXIMIZED}
SW_SHOWNOACTIVATE = 4; 		{用最近的大小和位置显示, 不激活}
SW_SHOW = 5; 				{同 SW_SHOWNORMAL}
SW_MINIMIZE = 6; 			{最小化, 不激活}
SW_SHOWMINNOACTIVE = 7; 	{同 SW_MINIMIZE}
SW_SHOWNA = 8; 				{同 SW_SHOWNOACTIVATE}
SW_RESTORE = 9; 			{同 SW_SHOWNORMAL}
SW_SHOWDEFAULT = 10; 		{同 SW_SHOWNORMAL}
SW_MAX = 10; 				{同 SW_SHOWNORMAL}

返回值

　　执行成功会返回应用程序句柄
　　返回的HINSTANCE可以将它转换为一个整数(%d)，并比较它的值大于还是小于32或比较它的错误代码
　　返回值大于32表示执行成功
　　返回值小于32表示执行错误
　　返回值可能的错误有:

 = 0 							{内存不足}
ERROR_FILE_NOT_FOUND = 2; 		{文件名错误}
ERROR_PATH_NOT_FOUND = 3; 		{路径名错误}
ERROR_BAD_FORMAT = 11; 			{EXE 文件无效}
SE_ERR_SHARE = 26; 				{发生共享错误}
SE_ERR_ASSOCINCOMPLETE = 27; 	{文件名不完全或无效}
SE_ERR_DDETIMEOUT = 28; 		{超时}
SE_ERR_DDEFAIL = 29; 			{DDE 事务失败}
SE_ERR_DDEBUSY = 30; 			{正在处理其他 DDE 事务而不能完成该 DDE 事务}
SE_ERR_NOASSOC = 31; 			{没有相关联的应用程序}

例子

　　首先记得加上头文件<windows.h>

//调用计算器
ShellExecute(0,"open","calc.exe","","",SW_SHOWNORMAL);

　　如果是C++语言，可能会出现参数类型不兼容的情况，改为：

ShellExecute(0,(LPCWSTR)L"open",(LPCWSTR)L"CALC.EXE",(LPCWSTR)L"",(LPCWSTR)L"",SW_SHOWNORMAL);

或者

ShellExecute(0, _T("open"), _T("calc.exe"), _T(""), _T(""), SW_SHOWNORMAL);

（下同）

//调用记事本
ShellExecute(0,"open","NOTEPAD.EXE","","",SW_SHOWNORMAL);

●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函数的标准用法，下面将介绍它的特殊用法。

特殊用法

　　如果将FileName参数设置为“http:”协议格式，那么该函数将打开默认浏览器并链接到指定的URL地址。若用户机器中安装了多个浏览器，则该函数将根据Windows 9x/NT注册表中http协议处理程序（Protocols Handler）的设置确定启动哪个浏览器。
格式一：http://网站域名，如：

ShellExecute(Handle, "open", "http://www.neu.edu.cn", "", "", SW_SHOWNORMAL);

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

ShellExecute(Handle, "open"," http://www.neu.edu.cn/default.htm","","",SW_SHOWNORMAL);

　　如果将FileName参数设置为“mailto:”协议格式，那么该函数将启动默认邮件客户程序，如Microsoft Outlook（也包括Microsoft Outlook Express）或Netscape Messanger。若用户机器中安装了多个邮件客户程序，则该函数将根据Windows 9x/NT注册表中mailto协议处理程序的设置确定启动哪个邮件客户程序。
格式一：mailto，如：

ShellExecute(Handle,"open", "mailto:", "", "", SW_SHOWNORMAL);//打开新邮件窗口

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

ShellExecute(Handle, "open"," mailto:who@mail.neu.edu.cn", "", "", SW_SHOWNORMAL);//打开新邮件窗口，并自动填入收件人地址。若指定多个收件人地址，则收件人地址之间必须用分号或逗号分隔开（下同）。

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

ShellExecute(handle, ‘open’, ‘ mailto:who@mail.neu.edu.cn？subject=Hello&Body=This is a test’,"", "", SW_SHOWNORMAL);//打开新邮件窗口，并自动填入收件人地址、邮件主题和邮件正文。若邮件正文包括多行文本，则必须在每行文本之间加入换行转义字符%0a。

例子(delphi):
在一个应用程序调用c:\Project1.exe;

ShellExecute(handle, 'open',"c:\Project1.exe",'字串内容',"", 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;

　　c++调用软件打开PDF文件，有如下方案：

	TCHAR Path[MAX_PATH];
	//char Path[MAX_PATH + 1] = { 0 };
	GetModuleFileName(NULL, (LPWSTR)Path, MAX_PATH);//得到应用程序的全路径 
	CString theAppPath = (CString)Path;
	CString theAppName = AfxGetApp()->m_pszAppName;
	theAppName += _T(".exe");
	int length1 = theAppPath.GetLength();
	int length2 = theAppName.GetLength();
	theAppPath.Delete(length1 - length2, length2);
	
	//使用IE浏览器打开PDF，可根据程序定位到想要的页数
	CString PathFile = _T("file:///") + theAppPath + _T("铁路线路修理规则.pdf#page=24");
	ShellExecute(NULL, _T("open"), _T("IEXPLORE"), PathFile, NULL, SW_SHOWMAXIMIZED);
	
	//使用Edge浏览器打开PDF，可根据程序定位到想要的页数
	CString PathFile = _T("file:///") + theAppPath + _T("铁路线路修理规则.pdf#page=28");
	ShellExecute(NULL, _T("open"), _T("MICROSOFTEDGE"), PathFile, NULL, SW_SHOWMAXIMIZED);
	
	//使用WPS打开PDF，可打开，根据用户的设置——可选择定位到上次阅读位置，或者定位到第一页
	CString PathFileWPS = theAppPath + _T("铁路线路修理规则.pdf");
	ShellExecute(NULL, _T("open"), _T("WPS"), PathFileWPS, NULL, SW_SHOWMAXIMIZED);
	
	//使用用户默认的软件打开PDF，默认定位到第一页（若默认的软件为WPS，则根据用户设置进行定位）
	CString PathFileDefault = _T("file:///") + theAppPath + _T("铁路线路修理规则.pdf");
	ShellExecute(NULL, _T("open"), PathFileDefault, NULL, NULL, SW_SHOWMAXIMIZED);

窗口可视命令

　　最后的那个参数，为窗口指定可视性方面的一个命令。
　　请用下述任何一个常数

SW_HIDE 			隐藏窗口，活动状态给另一个窗口
SW_MINIMIZE 		最小化窗口，活动状态给另一个窗口
SW_RESTORE 			用原来的大小和位置显示一个窗口，同时令其进入活动状态
SW_SHOW 			用当前的大小和位置显示一个窗口，同时令其进入活动状态
SW_SHOWMAXIMIZED 	最大化窗口，并将其激活
SW_SHOWMINIMIZED 	最小化窗口，并将其激活
SW_SHOWMINNOACTIVE 	最小化一个窗口，同时不改变活动窗口
SW_SHOWNA 			用当前的大小和位置显示一个窗口，不改变活动窗口
SW_SHOWNOACTIVATE 	用最近的大小和位置显示一个窗口，同时不改变活动窗口
SW_SHOWNORMAL 		与SW_RESTORE相同