首页 诗词 字典 板报 句子 名言 友答 励志 学校 网站地图
当前位置: 首页 > 计算机考试 > 等级考试 > 复习指导 >

C++Builder创建上下文菜单扩展处理器(1)

2008-12-28 
Shell检查注册表,看看文件类型是否与一些上下文菜单handler相关联,如果是,shell会咨询这些handler是否添加额外的菜单项。

    当用户右击一个shell对象时,shell会显示它的上下文菜单。文件系统对象有大量的标准菜单项,如"剪切"和"拷贝",这些都是缺省的菜单项。如果对象是一个文件,是文件类的成员,就能够在注册表里指定附加的菜单项。Shell检查注册表,看看文件类型是否与一些上下文菜单handler相关联,如果是,shell会咨询这些handler是否添加额外的菜单项。

  上下文菜单handler是一种shell扩展handler,它添加命令到已有的上下文菜单中。上下文菜单handler都与特定的文件类相关联,并且在显示这类文件的成员的上下文菜单时调用。通过实现和注册这样一个handler,能够动态地添加菜单项到对象的上下文菜单上,从而为特殊的对象定制菜单。

  上下文菜单Handler的工作原理

  作为一种shell扩展handler,上下文菜单handler同所有其它handler一样, 是进程内COM 对象,即对象作为动态连接库 (DLL)实现。除了IUnknown接口外,上下文菜单还必须导出IShellExtInit和IContextMenu接口,作为选择,上下文菜单也能导出IContextMenu2和IContextMenu3,这些接口可以实现自画菜单项。

  IShellExtInit接口仅仅被shell用来初始化handler,主要的操作通过handler的IContextMenu接口进行。Shell首先调用IContextMenu::QueryContextMenu,传送一个HMENU句柄,这个方法用它来增加上下文菜单。如果用户亮选了这些新添加的某个命令项, IContextMenu::GetCommandString将被调用,以取得这条菜单的帮助信息,把它显示在资源管理器的状态条上。如果用户单击了handler的条目,shell调用IContextMenu::InvokeCommand,从而handler能够执行合适的操作。

  实现IContextMenu接口

  1、实现QueryContextMenu方法

  Shell通过调用IContextMenu::QueryContextMenu,允许handler把它的菜单项添加到菜单中。QueryContextMenu共有5个参数,各参数作用如下:

  1) Hmenu:HMENU类型,表示上下文菜单的句柄。

  2) IndexMenu:第一个被添加的菜单索引。

  3) IdCmdFirst:添加的菜单ID初值。

  4) idCmdLast:添加的菜单ID最大值。

  5) uFlags:与上下文菜单相关的状态标志,共有3种,如下:

  CMF_DEFAULTONLY 用户选择了缺省的命令,通常是通过双击对象产生。QueryContextMenu 在把控制返回给shell前不应该修改菜单。

  CMF_NODEFAULT 菜单没有缺省的条目,这个方法应该把它的命令加到菜单中。

  CMF_NORMAL 上下文菜单将被正常显示,这个方法应该把它的命令加到菜单中。

  必须注意的是,任何添加的菜单项的ID必须落在idCmdFirst和idCmdLast两个参数中间,通常,添加的第一个菜单项ID设为idCmdFirst,以后每添加一个菜单项,就把ID加1,这样,即使shell调用了不止一个handler,也可以确保菜单项的ID不超过idCmdLast和可能的ID最大值。

  在ID和idCmdFirst之间,菜单项ID的command offset(命令偏移)是不同的,应该保存handler添加到上下文菜单中的每个菜单项的offset,因为如果shell按顺序调用GetCommandString或者InvokeCommand,可以使用它来鉴别菜单项的ID.

  还应该为每一个添加的命令赋予一个verb.Verb是语言独立的字符串,当调用InvokeCommand时,常常用verb来代替偏移以鉴别命令。

  QueryContextMenu 方法使用InsertMenu或InsertMenuItem 添加新的菜单项,然后返回一个严格设置为SEVERITY_SUCCESS的HRESULT值,把它的值设置为被分配的最大的命令ID.例如,假如idCmdFirst是5,添加了3个菜单项,ID分别是5,7,8,则返回值应该是MAKE_HRESULT(SEVERITY_SUCCESS, 0, 8 - 5 + 1)。

  以下是一个QueryContextMenu实例:

  HRESULT __stdcall TAddContextMenuImpl::QueryContextMenu(HMENU hmenu,

  UINT indexMenu, UINT idCmdFirst, UINT idCmdLast, UINT uFlags)

  {

  if(!(CMF_DEFAULTONLY & uFlags))

  {

  InsertMenu(hmenu, indexMenu, MF_STRING | MF_BYPOSITION,idCmdFirst,

  _T("选择打开方式..."));

  return MAKE_HRESULT(SEVERITY_SUCCESS, FACILITY_NULL, 1);

  }

  return MAKE_HRESULT(SEVERITY_SUCCESS, 0, USHORT(0));

  }

  2、实现GetCommandString 方法

  如果用户高亮了一个handler添加的菜单项,shell将调用handler的GetCommandString方法。这个方法需要传递菜单项的偏移值(ID)、指定信息类型的标志、一个预留的参数、一个字符串缓冲区以及缓冲区的大小。

热点排行