Creating Context Menu / 创建上下文菜单项 / VC++, Windows, DLL, ATL, COM

创建上下文菜单项

1、新建一个ATL Project。

2、建议将Project Property中Linker – General - “Register Output” 设为no，C/C++ - “Code Generation” - “Runtime Library” 设为 /MTd。

3、在Solution Explorer中右键Add Class，选择ATL Simple Object。并在弹出的对话框中为该Class命名。

4、添加完成后建议Build一下Project，MIDL compiler将根据 .idl文件生成IIDs and CLSIDs。

5、（可选）在Solution Explorer中右键Add Resource导入图标资源。

6、切换到新增Class的 .h文件中，使其继承接口IShellExtInit和IContextMenu。并在 .cpp文件中，参照MSDN给出实现。

 // MyContextMenu.h : Declaration of the CMyContextMenu

 #pragma once
 #include "resource.h"       // main symbols

 #include "ContextMenuExample_i.h"
 #include <Shlobj.h>

 #if defined(_WIN32_WCE) && !defined(_CE_DCOM) && !defined(_CE_ALLOW_SINGLE_THREADED_OBJECTS_IN_MTA)
 #error "Single-threaded COM objects are not properly supported on Windows CE platform, such as the Windows Mobile platforms that do not include full DCOM support. Define _CE_ALLOW_SINGLE_THREADED_OBJECTS_IN_MTA to force ATL to support creating single-thread COM object's and allow use of it's single-threaded COM object implementations. The threading model in your rgs file was set to 'Free' as that is the only threading model supported in non DCOM Windows CE platforms."
 #endif

 using namespace ATL;

 // CMyContextMenu

 class ATL_NO_VTABLE CMyContextMenu :
     public CComObjectRootEx<CComSingleThreadModel>,
     public CComCoClass<CMyContextMenu, &CLSID_MyContextMenu>,
     public IDispatchImpl<IMyContextMenu, &IID_IMyContextMenu,
     &LIBID_ContextMenuExampleLib, /*wMajor =*/ , /*wMinor =*/ >,
     public IShellExtInit,
     public IContextMenu
 {
 public:
     CMyContextMenu()
     {
     }

 DECLARE_REGISTRY_RESOURCEID(IDR_MYCONTEXTMENU)

 BEGIN_COM_MAP(CMyContextMenu)
     COM_INTERFACE_ENTRY(IMyContextMenu)
     COM_INTERFACE_ENTRY(IDispatch)
     COM_INTERFACE_ENTRY(IShellExtInit)
     COM_INTERFACE_ENTRY(IContextMenu)
 END_COM_MAP()

     DECLARE_PROTECT_FINAL_CONSTRUCT()

     HRESULT FinalConstruct();

     void FinalRelease();

 public:
     // IShellExtInit Method
     HRESULT STDMETHODCALLTYPE Initialize(
         _In_opt_  PCIDLIST_ABSOLUTE pidlFolder,
         _In_opt_  IDataObject *pdtobj,
         _In_opt_  HKEY hkeyProgID);

     // IContextMenu Method
     HRESULT STDMETHODCALLTYPE QueryContextMenu(
         _In_  HMENU hmenu,
         _In_  UINT indexMenu,
         _In_  UINT idCmdFirst,
         _In_  UINT idCmdLast,
         _In_  UINT uFlags);

     HRESULT STDMETHODCALLTYPE InvokeCommand(
         _In_  CMINVOKECOMMANDINFO *pici);

     HRESULT STDMETHODCALLTYPE GetCommandString(
         _In_  UINT_PTR idCmd,
         _In_  UINT uType,
         _Reserved_  UINT *pReserved,
         _Out_writes_bytes_((uType & GCS_UNICODE) ? (cchMax * sizeof(wchar_t)) : cchMax) _When_(!(uType & (GCS_VALIDATEA | GCS_VALIDATEW)), _Null_terminated_)  CHAR *pszName,
         _In_  UINT cchMax);

 private:
     HBITMAP MenuIcon1;
     HBITMAP MenuIcon2;
     HBITMAP MenuIcon3;
     HBITMAP MenuIcon4;

 };

 OBJECT_ENTRY_AUTO(__uuidof(MyContextMenu), CMyContextMenu)

MyContextMenu.h

 // MyContextMenu.cpp : Implementation of CMyContextMenu

 #include "stdafx.h"
 #include "MyContextMenu.h"

 // CMyContextMenu

 HRESULT CMyContextMenu::FinalConstruct()
 {
     HINSTANCE hInstance = _AtlBaseModule.GetModuleInstance();
     MenuIcon1 = LoadBitmap(hInstance, MAKEINTRESOURCE(IDB_BITMAP1));
     MenuIcon2 = LoadBitmap(hInstance, MAKEINTRESOURCE(IDB_BITMAP2));
     MenuIcon3 = LoadBitmap(hInstance, MAKEINTRESOURCE(IDB_BITMAP3));
     MenuIcon4 = LoadBitmap(hInstance, MAKEINTRESOURCE(IDB_BITMAP4));

     return S_OK;
 }

 void CMyContextMenu::FinalRelease()
 {
     if (MenuIcon1 != NULL)
     {
         DeleteObject(MenuIcon1);
     }
     if (MenuIcon2 != NULL)
     {
         DeleteObject(MenuIcon2);
     }
     if (MenuIcon3 != NULL)
     {
         DeleteObject(MenuIcon3);
     }
     if (MenuIcon4 != NULL)
     {
         DeleteObject(MenuIcon4);
     }
 }

 HRESULT CMyContextMenu::Initialize(
     _In_opt_  PCIDLIST_ABSOLUTE pidlFolder,
     _In_opt_  IDataObject *pdtobj,
     _In_opt_  HKEY hkeyProgID) {
     HRESULT hr;
     UINT    nFileCount;

     FORMATETC fmt =
     {
         CF_HDROP,
         NULL,
         DVASPECT_CONTENT,
         -,
         TYMED_HGLOBAL
     };

     STGMEDIUM sm =
     {
         TYMED_HGLOBAL
     };

     hr = pdtobj->GetData(&fmt, &sm);

     if (FAILED(hr))
     {
         return hr;
     }

     // query quantity of selected files
     nFileCount = DragQueryFile((HDROP)sm.hGlobal, 0xFFFFFFFF, NULL, );

     if (nFileCount == ) // deal with only one file
     {
         // analyze selected file

     }
     else
     {
         hr = E_INVALIDARG;
     }

     ReleaseStgMedium(&sm);

     return hr;
 }

 // IContextMenu Method
 HRESULT CMyContextMenu::QueryContextMenu(
     _In_  HMENU hmenu,
     _In_  UINT indexMenu,
     _In_  UINT idCmdFirst,
     _In_  UINT idCmdLast,
     _In_  UINT uFlags) {

     UINT uCmdID = idCmdFirst;
     LPCWSTR text1 = TEXT("新增层叠菜单项1");
     LPCWSTR text2 = TEXT("新增菜单项2");
     LPCWSTR text3 = TEXT("新增菜单项3");
     LPCWSTR text4 = TEXT("新增菜单项4");
     // do nothing when flag includes CMF_DEFAULTONLY.
     if (uFlags & CMF_DEFAULTONLY)
     {
         return MAKE_HRESULT(SEVERITY_SUCCESS, FACILITY_NULL, );
     }
     InsertMenu(hmenu, indexMenu, MF_SEPARATOR | MF_BYPOSITION, , NULL);
     indexMenu++;
     HMENU hSubMenu = CreateMenu();
     if (hSubMenu)
     {
         InsertMenu(hSubMenu, , MF_STRING | MF_BYPOSITION, uCmdID++, text2);
         SetMenuItemBitmaps(hSubMenu, , MF_BYPOSITION, MenuIcon2, MenuIcon2);
         InsertMenu(hSubMenu, , MF_STRING | MF_BYPOSITION, uCmdID++, text3);
         SetMenuItemBitmaps(hSubMenu, , MF_BYPOSITION, MenuIcon3, MenuIcon3);
         InsertMenu(hSubMenu, , MF_STRING | MF_BYPOSITION, uCmdID++, text4);
         SetMenuItemBitmaps(hSubMenu, , MF_BYPOSITION, MenuIcon4, MenuIcon4);
         // InsertMenu(hSubMenu, 3, MF_SEPARATOR | MF_BYPOSITION, 0, NULL);//插入分隔线
     }
     InsertMenu(hmenu, indexMenu, MF_STRING | MF_POPUP | MF_BYPOSITION, (UINT_PTR)hSubMenu, text1);
     SetMenuItemBitmaps(hmenu, indexMenu, MF_BYPOSITION, MenuIcon1, MenuIcon1);
     indexMenu++;
     InsertMenu(hmenu, indexMenu, MF_SEPARATOR | MF_BYPOSITION, , NULL);
     indexMenu++;

     // inform the explorer how many menu item we have added
     return MAKE_HRESULT(SEVERITY_SUCCESS, FACILITY_NULL, uCmdID - idCmdFirst);
 }

 HRESULT CMyContextMenu::InvokeCommand(
     _In_  CMINVOKECOMMANDINFO *pici) {
     if ( != HIWORD(pici->lpVerb))
         return E_INVALIDARG;
     // get index of added menu item
     switch (LOWORD(pici->lpVerb))
     {
     case :
     {
         // 执行新增菜单项2触发的操作
         STARTUPINFO si = { sizeof(si) };
         PROCESS_INFORMATION pi;
         TCHAR szCommandLine[] = TEXT("notepad");
         BOOL bCreateRet = CreateProcess(NULL, szCommandLine, NULL, NULL, FALSE, , NULL, NULL, &si, &pi);

         break;
     }
     case :
     {
         // 执行新增菜单项3触发的操作
         STARTUPINFO si = { sizeof(si) };
         PROCESS_INFORMATION pi;
         TCHAR szCommandLine[] = TEXT("write");
         BOOL bCreateRet = CreateProcess(NULL, szCommandLine, NULL, NULL, FALSE, , NULL, NULL, &si, &pi);

         break;
     }
     case :
     {
         // 执行新增菜单项4触发的操作
         STARTUPINFO si = { sizeof(si) };
         PROCESS_INFORMATION pi;
         TCHAR szCommandLine[] = TEXT("cmd");
         BOOL bCreateRet = CreateProcess(NULL, szCommandLine, NULL, NULL, FALSE, , NULL, NULL, &si, &pi);

         break;
     }
     default:
     {
         return E_INVALIDARG;
         break;
     }
     }
     return S_OK;
 }

 HRESULT CMyContextMenu::GetCommandString(
     _In_  UINT_PTR idCmd,
     _In_  UINT uType,
     _Reserved_  UINT *pReserved,
     _Out_writes_bytes_((uType & GCS_UNICODE) ? (cchMax * sizeof(wchar_t)) : cchMax) _When_(!(uType & (GCS_VALIDATEA | GCS_VALIDATEW)), _Null_terminated_)  CHAR *pszName,
     _In_  UINT cchMax) {
     USES_CONVERSION;
     LPCTSTR szPrompt;
     // copy help info to cache when explorer ask
     if (uType & GCS_HELPTEXT)
     {
         switch (idCmd)
         {
         case :
             szPrompt = _T("新增菜单项2说明文字");
             break;
         case :
             szPrompt = _T("新增菜单项3说明文字");
             break;
         case :
             szPrompt = _T("新增菜单项4说明文字");
             break;
         default:
             //ATLASSERT(0);           // should never get here
             return E_INVALIDARG;
             break;
         }
         if (uType & GCS_UNICODE)
         {
             lstrcpynW((LPWSTR)pszName, T2CW(szPrompt), cchMax);
         }
         else
         {
             lstrcpynA(pszName, T2CA(szPrompt), cchMax);
         }
         return S_OK;
     }
     return E_INVALIDARG;
 }

7、在 .rgs文件中添加注册表信息，确保各GUID与 .idl文件中的一致。

 HKCR
 {
     NoRemove CLSID
     {
         ForceRemove {9C50C98F-E1FF-41CF-BD54-E9A3BBDDDEF8} = s 'MyContextMenu Class'
         {
             ForceRemove Programmable
             InprocServer32 = s '%MODULE%'
             {
                 val ThreadingModel = s 'Apartment'
             }
             TypeLib = s '{EB1C2F43-315D-4D8F-9A2A-70E67BE888E2}'
             Version = s '1.0'
         }
     }

     NoRemove *
     {
         NoRemove ShellEx
         {
             NoRemove ContextMenuHandlers
             {
                 ForceRemove MyContextMenu = s '{9C50C98F-E1FF-41CF-BD54-E9A3BBDDDEF8}'
             }
         }
     }
 }

8、Build Project 后打开cmd.exe，通过regsvr32命令注册或解注册生成的 .dll文件。

10、查看效果如下图所示。

——————————————————

本文为本人原创，如需转载请注明出处。

http://www.cnblogs.com/lantingji/p/5857380.html