Internet Explorer 编程简述(六)自定义浏览器上下文菜单

原创 2004年09月19日 21:45:00

关键字:WebBrowser, Internet Explorer, Custom Context Menu, ShowContextMenu, IDocHostUIHandler

1、概述
Internet Explorer提供了非常开发的接口,使开发人员不仅可以把其浏览器核心嵌入应用程序,还可以通过各种接口以实现更深层的控制。本文就将介绍对浏览器进行高级控制的话题之一——自定义上下文菜单。

2、最简单的情况
自定义的IE及WebBrowser的上下文菜单,最简单的方式就是在注册表的HKEY_CURRENT_USER/Software/Microsoft/Internet Explorer/MenuExt下添加自定义的键值,步骤如下:
1)添加一个新的键,其名称即为将来显示在上下文菜单中的菜单项名称,如:
 HKEY_CURRENT_USER/Software/Microsoft/Internet Explorer/MenuExt/&Google Search
2)将新增的键的默认值设置为一个包含脚本的网页的URL(或文件路径全名),该网页中的脚本将在用户点击上下文菜单中的“Google Search”后被浏览器执行。

3)在新增的键下还可以新建一个二进制值Contexts,用以指定我们新增的菜单项针对特定的网页对象是否出现,其取值可以是如下值的组合(逻辑或)

Context         Value
Default         0x1
Images          0x2
Controls        0x4
Tables          0x8
Text selection  0x10
Anchor          0x20

4)还可以建立一个DWORD类型的Flags项并将其值设置为0x01,这将使得前述脚本在一个模态窗口中执行,就好像是通过window.showModalDialog调用的,但不同的是在脚本中仍然可以访问window对象。
5)实例脚本如下:

通过修改注册表自定义菜单的方法适用于Internet Explorer和WebBrowser,也具有良好的扩展性。但我们如果希望执行的是不仅仅是脚本,二是自己的程序中代码,这种方法就不适用了。

3、使用完全自定义的菜单
1)
IDocHostUIhandler接口提供了一个ShowContextMenu方法,在需要显示上下文菜单之前,MSHTML引擎就会调用实现了IDocHostUIHandler接口的
宿主程序的ShowContextMenu方法。

HRESULTIDocHostUIHandler::ShowContextMenu(
    DWORD dwID,
    POINT *ppt,
    IUnknown *pcmdtReserved,
    IDispatch *pdispReserved
);

dwID参数的意义与Contexts的组合类似;ppt为菜单的弹出点屏幕坐标;pcmdtReserved接口指向IOleCommandTarget接口,可用于检测网页对象的状态和执行命令等操作。pdispReserved在IE5以上版本中指向的是网页对象的IDispatch接口,用以区分不同对象,比如我们可以这样来获得网页对象的指针:

IHTMLElement *pElem;
HRESULT hr;
hr = pdispReserved->QueryInterface(IID_IHTMLElement, (void**)pElem);
if(SUCCEEDED (hr)) {
    BSTR bstr;
    pElem->get_tagName(bstr);
    USES_CONVERSION;
    ATLTRACE("TagName:%s/n", OLE2T(bstr));
    SysFreeString(bstr);
    pElem->Release();
}

如果我们在该方法中返回S_OK,则告诉MSHTML我们将使用自己的菜单(界面),如果是S_FALSE,则弹出默认的菜单。

2)实现
原理清楚之后,实现起来非常简单,和弹出一般的菜单没什么两样,举例如下,显示主框架的“文件菜单”:

HRESULT CMyHtmlView::OnShowContextMenu(DWORD dwID, LPPOINT ppt, IUnknown * pcmdtReserved, IDispatch *)
{
  // 载入主菜单
  HMENU hMenuParent = ::LoadMenu( ::AfxGetInstanceHandle(), MAKEINTRESOURCE(IDR_MAINFRAME) );
  if (hMenuParent)
  {
    HMENU hMenu = ::GetSubMenu( hMenuParent, 0 ); // 取得“文件”子菜单
    if (hMenu)
    {
      // 显示菜单
      TrackPopupMenuEx( hMenu,
        TPM_LEFTALIGN | TPM_TOPALIGN,
        ppt->x,
        ppt->y,
        ::AfxGetMainWnd()->m_hWnd,
        NULL );
    }
    ::DestroyMenu( hMenuParent );
  }
  return S_OK;
}

4、自定义标准上下文菜单
1)
原理
更多的时候我们希望能在浏览器原来菜单的基础上作一些修改,如删掉“查看源文件”,添加自己的菜单项,等等,而不是完全不要原始的菜单,怎么办呢?借助MSDN提供的例子,我们来看看:

HRESULT CBrowserHost::ShowContextMenu(DWORD dwID, POINT *ppt,IUnknown *pcmdTarget,IDispatch *pdispObject)
{
  #define IDR_BROWSE_CONTEXT_MENU 24641
  #define IDR_FORM_CONTEXT_MENU 24640
  #define SHDVID_GETMIMECSETMENU 27
  #define SHDVID_ADDMENUEXTENSIONS 53

  HRESULT hr;
  HINSTANCE hinstSHDOCLC;
  HWND hwnd;
  HMENU hMenu;

  CComPtr spCT;
  CComPtr spWnd;

  MENUITEMINFO mii = {0};
  CComVariant var, var1, var2;
  hr = pcmdTarget->QueryInterface(IID_IOleCommandTarget, (void**)&spCT);
  hr = pcmdTarget->QueryInterface(IID_IOleWindow, (void**)&spWnd);
  hr = spWnd->GetWindow(&hwnd);//取得浏览器窗口句柄
  hinstSHDOCLC = LoadLibrary(TEXT("SHDOCLC.DLL"));
  if (hinstSHDOCLC == NULL)
  {
    // Error loading module -- fail as securely as possible
    return;
  }
  hMenu = LoadMenu(hinstSHDOCLC, MAKEINTRESOURCE(IDR_BROWSE_CONTEXT_MENU));
  hMenu = GetSubMenu(hMenu, dwID);
  // Get the language submenu
  hr = spCT->Exec(&CGID_ShellDocView, SHDVID_GETMIMECSETMENU, 0, NULL, &var);
  mii.cbSize = sizeof(mii);
  mii.fMask = MIIM_SUBMENU;
  mii.hSubMenu = (HMENU) var.byref;
  // Add language submenu to Encoding context item
  SetMenuItemInfo(hMenu, IDM_LANGUAGE, FALSE, &mii);
  // Insert Shortcut Menu Extensions from registry
  V_VT(&var1) = VT_INT_PTR;
  V_BYREF(&var1) = hMenu;
  V_VT(&var2) = VT_I4;
  V_I4(&var2) = dwID;
  hr = spCT->Exec(&CGID_ShellDocView, SHDVID_ADDMENUEXTENSIONS, 0, &var1, &var2);
  // Remove View Source
  DeleteMenu(hMenu, IDM_VIEWSOURCE, MF_BYCOMMAND);//删除“查看源文件”菜单项
  // Show shortcut menu
  int iSelection = ::TrackPopupMenu(hMenu,
    TPM_LEFTALIGN | TPM_RIGHTBUTTON | TPM_RETURNCMD,//返回用户选择的菜单命令ID
    ppt->x,
    ppt->y,
    0,
    hwnd,
    (RECT*)NULL);
  // Send selected shortcut menu item command to shell
  LRESULT lr = ::SendMessage(hwnd, WM_COMMAND, iSelection, NULL);//发送到Internet Explorer_Server进行内部处理。
  FreeLibrary(hinstSHDOCLC);
  return S_OK;
}

从上面的例子我们看出,基本的方法就是根据“shdoclc.dll”文件中的菜单资源建立菜单,再通过来自pcmdTarget的IOlcCommandTarget接口获得“编码”菜单以及HKEY_CURRENT_USER/Software/Microsoft/Internet Explorer/MenuExt下的定义扩展菜单,然后以TPM_RETURNCMD标志调用TrackPopupMenu或TrackPopupMenuEx弹出菜单,并将返回的菜单命令ID教给浏览器窗口进行处理。这种方法可以调用许多通过浏览器无法直接调用的命令和对话框(参阅:《Internet Explorer 编程简述(五)调用IE隐藏的命令)。

所以,我们只需要在弹出菜单之前做一些自定义操作即可达到修改默认菜单的目的,如上面代码中就用删除了“查看源文件”菜单项。

2)问题
如果我们不仅仅是删除默认的菜单项或是修改了默认的菜单项,还添加了自己的菜单项,会出现什么情况呢?由于使用了类似于MFC中UpdateUI的机制,遇到不认识的CommandID,浏览器就会将其状态设置为Disabled,所以我们自己添加的菜单是无法被选择的。
可以想到,如果把菜单状态设置为Enabled,并通过TPM_RETURNCMD标志调用TrackPopupMenu或TrackPopupMenuEx,再把返回的命令ID教给合适的窗口(如主框架窗口)去处理不就行了。关键点就在于如何把菜单状态设置为Enabled。

3)实现
解决的办法是截获WM_INITMENUPOPUP消息,在菜单创建以后,尚未显示之前修改菜单项状态,那浏览器就没有办法了。截获WM_INITMENUPOPUP消息则可使用子类化(subclass)的技术,前面通过IOleWindow接口我们得到了浏览器窗口的句柄hwnd,则可以这样做:

HMENU g_hPubMenu = NULL;
WNDPROC g_lpPrevWndProc = NULL;

LRESULT CALLBACK CustomMenuWndProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
  if (uMsg == WM_INITMENUPOPUP)
  {
    if (wParam == (WPARAM) g_hPubMenu)
    {
      ::EnableMenuItem( 自定义的菜单命令ID, MF_ENABLED | MF_BYCOMMAND );
      ::CheckMenuItem( 自定义的菜单命令ID, MF_BYCOMMAND);
      return 0;
    }
  }
  return CallWindowProc(g_lpPrevWndProc, hwnd, uMsg, wParam, lParam);
}

HRESULT CMyHtmlView::OnShowContextMenu(DWORD dwID, LPPOINT ppt,
 LPUNKNOWN pcmdtReserved, LPDISPATCH pdispReserved)
{
//浏览器菜单句柄保存在g_hPubMenu中
......
// subclass浏览器窗口
g_lpPrevWndProc = (WNDPROC)::SetWindowLong(hwnd, GWL_WNDPROC, (LONG)CustomMenuWndProc);
//m_SubclassWnd.SubclassWindow( hwnd );//MFC中用此方法更简便

// Show shortcut menu
int iSelection = ::TrackPopupMenu(hSubMenu,
  TPM_LEFTALIGN | TPM_RIGHTBUTTON | TPM_RETURNCMD,
  ppt->x,
  ppt->y,
  0,
  hwnd,
  (RECT*)NULL);
// Unsubclass浏览器窗口
::SetWindowLong(hwnd, GWL_WNDPROC, (LONG)g_lpPrevWndProc);
g_lpPrevWndProc = NULL;
//m_SubclassWnd.UnsubclassWindow();

if (iSelection == 自定义的菜单命令ID )
{
  ::SendMessage( ::AfxGetMainWnd()->m_hWnd, WM_COMMAND, MAKEWPARAM(LOWORD(lResult), 0x0), 0 );
}
else
{
  LRESULT lr = ::SendMessage(hwnd, WM_COMMAND, iSelection, NULL);
}
......
}

在MFC中则更为方便,从CWnd继承一个窗口类,假设为CWebBrowserSubclassWnd,为CMyHtmlView添加一个CWebBrowserSubclassWnd类型的成员变量m_SubclassWnd,在子类化和去除子类化时调用m_SubclassWnd.SubclassWindow( hwnd )和m_SubclassWnd.UnsubclassWindow()即可。相应的WM_INITMENUPOPUP消息处理函数如下所示:

void CWebBrowserSubclassWnd::OnInitMenuPopup(CMenu* pPopupMenu, UINT nIndex, BOOL bSysMenu)
{
  CWnd::OnInitMenuPopup(pPopupMenu, nIndex, bSysMenu);

  pPopupMenu->EnableMenuItem( 自定义的菜单命令ID, MF_ENABLED | MF_BYCOMMAND );
  pPopupMenu->CheckMenuItem( 自定义的菜单命令ID, MF_BYCOMMAND);
}

下面的图片显示了将“文字大小”菜单项添加到“编码”菜单项的下面的效果。

5、新的问题
看完上面的代码,我们又自然地想到浏览器编程中的另一个问题,那就是“编码”菜单。我们指定,手动建立一个“编码”菜单是比较麻烦的事,而且很难做到与浏览器上下文菜单上的“编码”菜单一样的效果。何不使用上述的方法让浏览器自己建立“编码”菜单和处理相应的命令呢?

具体实现请看下一篇文章《Internet Explorer 编程简述(七)完美的“编码”菜单》


参考资料
MSDN:Adding Entries to the Standard Context Menu
MSDN:How To Adding to the Standard Context Menus of the WebBrowser Control
MSDN:IDocHostUIHandler::ShowContextMenu Method
BeginThread.com:Custom WebBrowser Context Menus

引用地址Internet Explorer 编程简述(六)自定义浏览器上下文菜单

如何禁用HTML页面的上下文菜单

提出问题:    VC知识库《在线杂志》第六期有一篇文章“VC6中使用CHtmlView在对话框控制中显示HTML文件”,很多读者来信说很喜欢这种功能。但是美中不足的是在对话框的HTML页面...
  • playboy1
  • playboy1
  • 2011年10月18日 15:36
  • 375

上下文菜单与上下文操作模式

长按ListView或GridView列表项删除某一条记录是一种上下文操作,即它是与某个特定屏幕视图(单个列表项)而非整个屏幕相关联的。在Honeycomb以前版本的设备上,上下文操作是在浮动上下文菜...
  • tw19911005
  • tw19911005
  • 2015年09月10日 22:20
  • 677

android开发之使用上下文菜单

android中的上下文菜单类似于PC上的鼠标右键单击,不同的是android上没有鼠标这一概念,更谈不上右键单击,在android中,一般是长按某个View,调出上下文菜单。与OptionsMenu...
  • u012702547
  • u012702547
  • 2015年10月27日 16:10
  • 7363

程序中上下文Context

之前学习Toast的时候关于Toast.makeText()方法的第一个参数做了简单说明,现在详细说明一下这个Context。 Context是一个抽象基类,通过它访问当前包的资源(getRes...
  • zhangbohun
  • zhangbohun
  • 2016年02月25日 14:23
  • 780

android菜单详解三:上下文菜单

创建一个上下文菜单 一个上下文菜单跟PC上的右键菜单类似.你应使用上下文菜单为用户界面上的某个部分提供动作选择功能.在Android中,一个上下文菜单会在用户长按一个界面条目时出现. 你可以为任何V...
  • u012721933
  • u012721933
  • 2016年04月01日 09:45
  • 387

Qt学习—qt上下文菜单显示

Qt学习—qt上下文菜单显示   Qwidget类及其子类都具有右键菜单响应功能,QWidget类提供了以下两个与右键菜单有关的函数: 1、 Qt::ContextMenuPolicy context...
  • GDUTLYP
  • GDUTLYP
  • 2015年12月30日 10:17
  • 1202

Django22-视图、上下文、中间件

我们用Django开发,比如做一个博客,我们需要做一个文章列表,文章详情页,这种需求是比较普遍的,所以Django中提供了Class-Based Views。 有时候我们想直接渲染一个模板,不得不写...
  • opera95
  • opera95
  • 2017年06月14日 21:00
  • 473

作用域--------上下文环境

除了全局作用域外,每个函数还能创建自己的作用域。作用域在函数定义时就已经确定了。而不是在函数调用时确定。 现在讲作用域和上下文环境放在一起,有助于了解作用域。var a = 10; var b = ...
  • cindy_rain
  • cindy_rain
  • 2016年02月25日 20:49
  • 590

android的上下文菜单和上下文操作模式

例如长按删除功能就是一种上下文操作,上下文操作与某个特定的屏幕视图(单个列表项)而非整个屏幕相关联 一:在res/menu下新建菜单资源文件 ...
  • jeffleo
  • jeffleo
  • 2016年03月09日 23:50
  • 604

菜单(四)给ListView的item添加上下文菜单

  • u011731233
  • u011731233
  • 2015年02月22日 23:32
  • 2318
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Internet Explorer 编程简述(六)自定义浏览器上下文菜单
举报原因:
原因补充:

(最多只允许输入30个字)