Internet Explorer 编程简述(十三)调用IE隐藏的命令(续)

——谨以怀念研究Internet Explorer编程的青春岁月

Posted by eagleboost on November 18, 2006

本文转载自我2006年在csdn发布的博客

1. 概述

在本系列五《调用IE隐藏的命令》中我们曾经从MSDN的一篇文章给出的ShowContextMenu范例入手,深入shdoclc.dll找到了藏于其中的浏览器上下文菜单资源,并以SendMessage发送WM_COMMAND消息到”Internet Explorer_Server“窗口以及其父窗口”Shell DocObject View“的方法完美实现了对“添加到收藏夹”对话框,“导入/导出向导”对话框等的调用,《自定义浏览器上下文菜单》和《完美的“编码”菜单》也运用了同样的技术。

这次,我们还是从ShowContextMenu范例入手,再次挖掘IE隐藏的命令——CGID_ShellDocView的命令。

2. 原理

完美的“编码”菜单》一文所用的技术,其关键在于从浏览器的文档接口查询得到IOleCommandTarget,进而调用CGID_ShellDocView命令组的命令CmdID_GetMimeSubMenu(27)实现将IE内置的编码菜单“拿来”使用。好了,既然CGID_ShellDocView是一个Command Group,那么CmdID_GetMimeSubMenu当然不会是惟一的一个,那为什么不尝试一下将其它可用的命令找出来呢。

3. 找命令

先为我们的任务定一个目标:找到那些传入简单Variant参数就能得到可观察的效果或输出参数的命令ID。像CmdID_GetMimeSubMenu(27)这类输出参数需要转换为一个HMENU才有意义的命令,如果没有MSDN的文档,我们只怕打破脑袋也想不出其中的含义,所以这类命令不在目标范围之内。 下面的函数简单地实现了对CGID_ShellDocView命令组命令的调用。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
HRESULT ExecShellDocViewCommand(LPDISPATCH lpDocDisp, UINT nCmdID)
{
  HRESULT hr = S_FALSE;
  IOleCommandTarget *pct;
  if ( lpDocDisp && SUCCEEDED(lpDocDisp->QueryInterface(IID_IOleCommandTarget, (void **)&pct)))
  {
    CComVariant vtIn;
    vtIn.vt = VT_EMPTY;
    CComVariant vtOut;
    hr = pct->Exec(&CGID_ShellDocView, nCmdID, OLECMDEXECOPT_DONTPROMPTUSER, &vtIn, &vtOut);
    pct->Release();
  }
  return hr;
}

4. 命令列表

总算功夫没有完全白费,经过多轮测试(费时费力不一定讨好的工作)之后找到了如下命令:

1) 编码菜单和文字大小菜单

1
2
#define SHDVID_SHOWMIMECSETMENU    1
#define SHDVID_SHOWFONTSIZEMENU    50

想不到吧,传入命令ID = 1,编码菜单居然弹出来了!但有些问题,由于vtIn.vt = VT_EMPTY,所以菜单弹出点在屏幕左上角(0, 0),不过我们倒发挥发挥“猜”的功夫,怎么传入一个POINT呢?先试试把一个POINT的指针强制转换一下传进去,不行;再试试Win32程序设计的风格,两个坐标一个放高位,一个放低位拼成一个长整数,再以VT_I4传入,这次成功了。所以我们写出下面的函数:

nCmdID当然就是上面两个值,分别表示显示编码菜单和文字大小菜单。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
HRESULT ShowShellDocViewMenu(LPDISPATCH lpDocDisp, POINT pt, UINT nCmdID)
{
  HRESULT hr = S_FALSE;
  IOleCommandTarget *pct;
  if ( lpDocDisp && SUCCEEDED(lpDocDisp->QueryInterface(IID_IOleCommandTarget, (void **)&pct)))
  {
    try
    {
      CComVariant vtIn;
      vtIn.vt = VT_I4;
      vtIn.lVal = MAKELONG(pt.x, pt.y);
      CComVariant vtOut;
      hr = pct->Exec(&CGID_ShellDocView, nCmdID, OLECMDEXECOPT_DONTPROMPTUSER, &vtIn, &vtOut);
    }
    catch (...) {
    }
    pct->Release();
  }
  return hr;
}

HRESULT ShowMimeSetMenu(LPDISPATCH lpDocDisp, POINT pt)
{
  return ShowShellDocViewMenu(lpDocDisp, pt, SHDVID_SHOWMIMECSETMENU);
}

HRESULT ShowFontSizeMenu(LPDISPATCH lpDocDisp, POINT pt)
{
  return ShowShellDocViewMenu(lpDocDisp, pt, SHDVID_SHOWFONTSIZEMENU);
}

这样一来,菜单的Enable/Disable状态不需要我们来维护,命令也不需要我们来转发,系列七《完美的“编码”菜单》这篇文章也许可以删掉了,因为文中的代码可以简化为下面的样子,更改文字大小也只需要一行代码就能实现。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
void CMainFrame::OnDropDown( NMHDR* pNotifyStruct, LRESULT* pResult )
{
  NMTOOLBAR* pNMToolBar = ( NMTOOLBAR* )pNotifyStruct;

  CMenu menu;
  CMenu* pPopup = 0;

  CRect rc;
  ::SendMessage(pNMToolBar->hdr.hwndFrom, TB_GETRECT, pNMToolBar->iItem, (LPARAM)&rc);
  rc.top = rc.bottom;
  ::ClientToScreen( pNMToolBar->hdr.hwndFrom, &rc.TopLeft() );
  Cpoint pt(rc.left, rc.top);

  LPDISPATCH lpDispatch = GetHtmlDocument();//获得文档指针

  switch ( pNMToolBar->iItem )
  {
    case ID_VIEW_ENCODE://“编码”按钮
      ShowMimeSetMenu(lpDispatch, pt);
      break;
    case ID_VIEW_FONTSIZE://“文字大小”按钮
      ShowFontSizeMenu(lpDispatch, pt);
      break;
  }

  *pResult = TBDDRET_DEFAULT;
}

2) Location URL

1
#define SHDVID_GETLOCATIONURL    20

调用这个命令获得的返回参数是BSTR类型,其值是网页的Location URL

3) 文档当前的代码页codepage

1
#define SHDVID_GETCODEPAGE    23

调用这个命令可以得到当前网页的编码类型,比如936(简体中文),1200Unicode)等。

Code Value(Codepage) Alphabet
DIN_66003 20106 IA5(German)
NS_4551-1 20108 IA5(Norwegian)
SEN_850200_B 20107 IA5(Swedish)
_autodetect 50932 Japanese(AutoSelect)
_autodetect_kr 50949 Korean(AutoSelect)
big5 950 ChineseTraditional(Big5)
csISO2022JP 50221 Japanese(JIS-Allow1byteKana)
euc-kr 51949 Korean(EUC)
gb2312 936 ChineseSimplified(GB2312)
hz-gb-2312 52936 ChineseSimplified(HZ)
ibm852 852 CentralEuropean(DOS)
ibm866 866 CyrillicAlphabet(DOS)
irv 20105 IA5(IRV)
iso-2022-jp 50220 Japanese(JIS)
iso-2022-jp 50222 Japanese(JIS-Allow1byteKana)
iso-2022-kr 50225 Korean(ISO)
iso-8859-1 1252 WesternAlphabet
iso-8859-1 28591 WesternAlphabet(ISO)
iso-8859-2 28592 CentralEuropeanAlphabet(ISO)
iso-8859-3 28593 Latin3Alphabet(ISO)
iso-8859-4 28594 BalticAlphabet(ISO)
iso-8859-5 28595 CyrillicAlphabet(ISO)
iso-8859-6 28596 ArabicAlphabet(ISO)
iso-8859-7 28597 GreekAlphabet(ISO)
iso-8859-8 28598 HebrewAlphabet(ISO)
koi8-r 20866 CyrillicAlphabet(KOI8-R)
ks_c_5601 949 Korean
shift-jis 932 Japanese(Shift-JIS)
unicode 1200 UniversalAlphabet
unicodeFEFF 1201 UniversalAlphabet(Big-Endian)
utf-7 65000 UniversalAlphabet(UTF-7)
utf-8 65001 UniversalAlphabet(UTF-8)
windows-1250 1250 CentralEuropeanAlphabet(Windows)
windows-1251 1251 CyrillicAlphabet(Windows)
windows-1252 1252 WesternAlphabet(Windows)
windows-1253 1253 GreekAlphabet(Windows)
windows-1254 1254 TurkishAlphabet
windows-1255 1255 HebrewAlphabet(Windows)
windows-1256 1256 ArabicAlphabet(Windows)
windows-1257 1257 BalticAlphabet(Windows)
windows-1258 1258 VietnameseAlphabet(Windows)
windows-874 874 Thai(Windows)
x-euc 51932 Japanese(EUC)
x-user-defined 50000 UserDefined

4) 证书对话框

1
#define SHDVID_SSLSTATUS    33

在浏览https的网站时,浏览器的状态栏应显示“锁”图标,表示该页面使用了xxx位的SSL加密,双击该图标即可显示该站点的证书信息。这个命令ID就用来显示站点的证书对话框,当然对于没有加密的页面,调用的结果会显示“该类文档没有安全证书”。

5) 安全区域设置对话框

1
#define SHDVID_ZONESTATUS    35

与上面类似,当浏览器在不同的Zone之间切换时,状态栏应显示图标和文字以表示当前站点所处的Security Zone,双击改栏则显示安全区域属性页,用户可修改安全区域的设置。该命令ID可显示此对话框。

6) 管理加载项对话框

1
#define SHDVID_MANAGEADDONS    78

该命令ID显示“管理加载项”对话框

7) “阻止下载文件”信息栏

1
#define SHDVID_INFOBAND_DOWNLOADFILE    81

在浏览器窗口上方显示“阻止下载文件”的信息栏,也许会有什么用……

8) “低权限模式”信息栏

1
#define SHDVID_INFOBAND_PROTECTEDMODE    108

显示信息栏,表示Internet Explorer以低权限模式运行,也许会有什么用……

9) IE7.0的“不完全”平滑缩放

1
#define SHDVID_ZOOM    113

调用该命令在IE7.0中使得网页按125%的缩放比例显示,其它的比例我没有试验成功。IE7.0的缩放比IE6有了很大改进,新的插值算法使得图片放大时平滑得多,至于如何调用IE7.0的缩放功能,此处按下不表,且待下回分解。

参考资料

MSDN: 《WebBrowser Customization (Part 2)》(原链接已失效)