ShellExecute函数介绍

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; {没有相关联的 应用程序 }
 
调用计算器
   ShellExecute(NULL,"open","calc.exe",NULL,NULL,SW_SHOWNORMAL);
调用 记事本
   ShellExecute(NULL,"open","NOTEPAD.EXE",NULL,NULL,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", NULL, NULL, SW_SHOWNORMAL);
   格式二:http://网站域名/网页文件名
        如:ShellExecute(Handle, "open"," http:// www.neu.edu.cn/default.htm",NULL,NULL, SW_SHOWNORMAL);
如果将FileName参数设置为“mailto:”协议格式,那么该函数将启动默认邮件客户程序,如Microsoft Outlook(也包括Microsoft Outlook Express)或Netscape Messanger。若用户机器中安装了多个邮件客户程序,则该函数将根据Windows 9x/NT注册表中mailto协议处理程序的设置确定启动哪个邮件客户程序。
   格式一:mailto
        如:ShellExecute(Handle,"open", "mailto:", NULL, NULL, SW_SHOWNORMAL);打开新邮件窗口。
   格式二:mailto:用户账号@邮件服务器地址
        如:ShellExecute(Handle, "open"," mailto:[email protected]", NULL, NULL, SW_SHOWNORMAL);打开新邮件窗口,
            并自动填入收件人地址。若指定多个收件人地址,则收件人地址之间必须用分号或逗号分隔开(下同)。
   格式三:mailto:用户账号@邮件服务器地址
        subject=邮件主题&body=邮件正文
        如:ShellExecute(handle, ‘open’, ‘ mailto:[email protected]?subject=Hello&Body=This is a test’,
            NULL, NULL, SW_SHOWNORMAL);打开新邮件窗口,并自动填入收件人地址、邮件主题和邮件正文。若邮件正文包括多行
            文本,则必须在每行文本之间加入换行 转义字符 %0a。
        例子(delphi):
        在一个 应用程序 调用c:\Project1.exe;
        ShellExecute(handle, 'open',"c:\Project1.exe",'字串内容',NULL, 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相同

 

 

 

你可能感兴趣的:(c,linux,C语言,ARM,Shellexecute)