VC++ ShellExecute 执行、运行一个外部程序函数功能详解:

ShellExecute

函数功能:
    ShellExecute 的功能是运行一个外部程序(或者是打开一个已注册的文件、打开一个目录、打印一个文件等等),并对外部程序有一定的控制。

函数简介:
    有几个 API 函数都可以实现这些功能,但是在大多数情况下 ShellExecute 是更多的被使用的,同时它并不是太复杂。

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

    ShellExecute(
        hWnd: HWND; {指定父窗口句柄}
        Operation: PChar; {指定动作, 譬如: open、print}
        FileName: PChar; {指定要打开的文件或程序}
        Parameters: PChar; {给要打开的程序指定参数; 如果打开的是文件这里应该是 nil}
        Directory: PChar; {缺省目录}
        ShowCmd: Integer {打开选项}
    ): HINST; {执行成功会返回应用程序句柄; 如果这个值 <= 32, 表示执行错误}
    //返回值可能的错误有: = 0 {内存不足}

参数含义:
    ●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,则表示出现错误。


函数返回值详解:

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

    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;           {没有相关联的应用程序}


ShowCmd 参数可选值:

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

    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}


特殊用法:

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

        打开 Url 格式为:ShellExecute(NULL, _T("open"), url, NULL, NULL, SW_SHOWNORMAL);

        示例一,打开指定域名:ShellExecute(NULL, "open", "http://www.baidu.com", NULL, NULL, SW_SHOWNORMAL);

        示例二,打开指定网址:ShellExecute(NULL, "open", "http://www.baidu.com/index.php", NULL, NULL, SW_SHOWNORMAL);

    B、如果将 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=hell,world!", nil, nil, SW_SHOWNORMAL);
        打开新邮件窗口,并自动填入收件人地址、邮件主题和邮件正文。若邮件正文包括多行文本,则必须在每行文本之间加入换行转义字符%0a。


使用实例:

    //执行一个新的应用程序
    ShellExecute(NULL, "open", "calc.exe", NULL, NULL, SW_SHOWNORMAL);    //调用计算器
    ShellExecute(NULL, "open", "NOTEPAD.EXE", NULL, NULL, SW_SHOWNORMAL); //调用记事本

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

    //打印一个 Word 文档
    ShellExecute(Handle, 'print', PChar('C:\word.doc'), nil, nil, SW_SHOW);
    注意:可能你会看到 Word 暂时的被打开,但它会自动关闭。

    //打开百度网站
    ShellExecute(Handle, 'open', PChar('http://www.baidu.com/'), nil, nil, SW_SHOW);

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

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

    //运行一个 DOS 命令并立即返回
    ShellExecute(Handle, 'open', PChar('cmd.exe'), PChar('/c echo hello, world!'), nil, SW_SHOW);

    //运行一个 DOS 命令并保持 DOS 窗口存在
    ShellExecute(Handle, 'open', PChar('cmd.exe'), PChar('/k echo hello, world!'), nil, SW_SHOW);

    //打开一个同系统程序相关连的文档
    ShellExecute(Handle, "open", "c:\abc.txt", NULL, NULL, SW_SHOWNORMAL);

    //打开一个指定网站、域名
    ShellExecute(Handle, "open", "http://www.google.com/", NULL, NULL, SW_SHOWNORMAL);
    ShellExecute(NULL, "open", "http://www.baidu.com", NULL, NULL, SW_SHOWNORMAL);

    //打开一个指定网址
    ShellExecute(NULL, "open", "http://www.baidu.com/index.php", NULL, NULL, SW_SHOWNORMAL);

    //激活相关程序,发送EMAIL
    ShellExecute(Handle, "open", "mailto:", nil, nil, SW_SHOWNORMAL);
    ShellExecute(Handle, "open", "mailto:[email protected]", nil, nil, SW_SHOWNORMAL);
    ShellExecute(Handle, "open", "mailto:[email protected]", NULL, NULL, SW_SHOWNORMAL);
    ShellExecute(Handle, "open", "mailto:[email protected]?subject=Hello&Body=hell,world!", nil, nil, SW_SHOWNORMAL);

    //用系统打印机打印文档
    ShellExecute(Handle, "print", "c:\abc.txt", NULL, NULL, SW_SHOWNORMAL);

    //用系统查找功能来查找指定文件
    ShellExecute(Handle, "find", "d:\nish", NULL, NULL, SW_SHOWNORMAL);

    VC++ ShellExecute 执行、运行一个外部程序函数功能详解,VC++ ShellExecute 执行、运行一个外部程序函数功能,VC++ ShellExecute 执行、运行一个外部程序函数详解,VC++ ShellExecute 执行、运行一个外部程序功能详解,VC++ ShellExecute 执行、运行一个外部程序函数,VC++ ShellExecute 执行、运行一个外部程序功能,VC++ ShellExecute 执行、运行一个外部程序详解,VC++ ShellExecute 执行、运行外部程序函数,VC++ ShellExecute 执行、运行外部程序功能,VC++ ShellExecute 执行、运行外部程序详解,VC++ ShellExecute 执行外部程序函数,VC++ ShellExecute 执行外部程序功能,VC++ ShellExecute 执行外部程序详解,VC++ ShellExecute 运行外部程序函数,VC++ ShellExecute 运行外部程序功能,VC++ ShellExecute 运行外部程序详解,VC++ ShellExecute 执行程序函数,VC++ ShellExecute 执行程序功能,VC++ ShellExecute 执行程序详解,VC++ ShellExecute 运行程序函数,VC++ ShellExecute 运行程序功能,VC++ ShellExecute 运行程序详解,VC++ ShellExecute 执行函数,VC++ ShellExecute 执行功能,VC++ ShellExecute 执行详解,VC++ ShellExecute 运行函数,VC++ ShellExecute 运行功能,VC++ ShellExecute 运行详解,VC++ ShellExecute 函数,VC++ ShellExecute 功能,VC++ ShellExecute 详解,VC++ ShellExecute,ShellExecute,运行一个外部程序,打开一个已注册文件,打开一个目录,打印一个文件,对外部程序有一定的控制,API 函数,ShellExecute原型,function ShellExecute(hWnd: HWND; Operation, FileName, Parameters,Directory: PChar; ShowCmd: Integer): HINST; stdcall;,hWnd: HWND; {指定父窗口句柄},Operation: PChar; {指定动作, 譬如: open、print},FileName: PChar; {指定要打开的文件或程序},Parameters: PChar; {给要打开的程序指定参数; 如果打开的是文件这里应该是 nil},Directory: PChar; {缺省目录},ShowCmd: Integer {打开选项},): HINST; {执行成功会返回应用程序句柄; 如果这个值 <= 32, 表示执行错误},//返回值可能的错误有: = 0 {内存不足},hWnd:用于指定父窗口句柄,Operation:用于指定要进行的操作,FileName:用于指定要打开的文件名,Parameters:命令行参数,Directory:用于指定默认目录,ShowCmd:程序窗口初始显示方式,返回值小于32则出现错误,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; {没有相关联的应用程序},ShowCmd 参数值,SW_HIDE 隐藏窗口,SW_MINIMIZE 最小化窗口,SW_RESTORE 用原来的大小和位置,SW_SHOW 用当前的大小和位置显示,SW_SHOWMAXIMIZED最大化窗口,SW_SHOWMINIMIZED最小化窗口,SW_SHOWMINNOACTIVE 最小化一个窗口,SW_SHOWNA 用当前的大小和位置显示一个窗口,SW_SHOWNOACTIVATE 用最近的大小和位置显示一个窗口,SW_SHOWNORMAL 与 SW_RESTORE 相同,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},ShellExecute(NULL, _T("open"), url, NULL, NULL, SW_SHOWNORMAL);,ShellExecute(NULL, "open", "http://www.baidu.com", NULL, NULL, SW_SHOWNORMAL);,ShellExecute(NULL, "open", "http://www.baidu.com/index.php", NULL, NULL, SW_SHOWNORMAL);,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=hell,world!", nil, nil, SW_SHOWNORMAL);,//执行一个新的应用程序,ShellExecute(NULL, "open", "calc.exe", NULL, NULL, SW_SHOWNORMAL);//调用计算器,ShellExecute(NULL, "open", "NOTEPAD.EXE", NULL, NULL, SW_SHOWNORMAL); //调用记事本,//打开记事本,并打开一个文本文件(系统能识别记事本应用程序的路径,因此我们不必使用绝对路径,ShellExecute(Handle, 'open', PChar('notepad'), PChar('c:\test.txt'), nil, SW_SHOW);,//打印一个 Word 文档,ShellExecute(Handle, 'print', PChar('C:\word.doc'), nil, nil, SW_SHOW);,注意:可能你会看到 Word 暂时的被打开,但它会自动关闭,//打开百度网站,ShellExecute(Handle, 'open', PChar('http://www.baidu.com/'), nil, nil, SW_SHOW);,//你能通过一个已经注册的文件类型来打开应用程序,ShellExecute(Handle, 'open', PChar('c:\readme.txt'), nil, nil, SW_SHOW);,//调用 windows Explorer 打开一个文件目录,ShellExecute(Handle, 'explore', PChar('c:\windows)', nil, nil, SW_SHOW);,//运行一个 DOS 命令并立即返回,ShellExecute(Handle, 'open', PChar('cmd.exe'), PChar('/c echo hello, world!'), nil, SW_SHOW);,//运行一个 DOS 命令并保持 DOS 窗口存在,ShellExecute(Handle, 'open', PChar('cmd.exe'), PChar('/k echo hello, world!'), nil, SW_SHOW);,//打开一个同系统程序相关连的文档,ShellExecute(Handle, "open", "c:\abc.txt", NULL, NULL, SW_SHOWNORMAL);,//打开一个指定网站、域名,ShellExecute(Handle, "open", "http://www.google.com/", NULL, NULL, SW_SHOWNORMAL);,ShellExecute(NULL, "open", "http://www.baidu.com", NULL, NULL, SW_SHOWNORMAL);,//打开一个指定网址,ShellExecute(NULL, "open", "http://www.baidu.com/index.php", NULL, NULL, SW_SHOWNORMAL);,//激活相关程序,发送EMAIL,ShellExecute(Handle, "open", "mailto:", nil, nil, SW_SHOWNORMAL);,ShellExecute(Handle, "open", "mailto:[email protected]", nil, nil, SW_SHOWNORMAL);,ShellExecute(Handle, "open", "mailto:[email protected]", NULL, NULL, SW_SHOWNORMAL);,ShellExecute(Handle, "open", "mailto:[email protected]?subject=Hello&Body=hell,world!", nil, nil, SW_SHOWNORMAL);,//用系统打印机打印文档,ShellExecute(Handle, "print", "c:\abc.txt", NULL, NULL, SW_SHOWNORMAL);,//用系统查找功能来查找指定文件,ShellExecute(Handle, "find", "d:\nish", NULL, NULL, SW_SHOWNORMAL);。

你可能感兴趣的:(Shellexecute)