首页 > 代码库 > Creating Icon Overlay Handlers
Creating Icon Overlay Handlers
创建图标标记 Handlers (续)
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、切换到新增 Class 的 .h 文件中,使其继承接口 IShellIconOverlayIdentifier。
1 // MyOverlay.h : Declaration of the CMyOverlay 2 3 #pragma once 4 #include "resource.h" // main symbols 5 6 7 8 #include "Example_i.h" 9 #include <ShlObj.h>10 11 12 13 #if defined(_WIN32_WCE) && !defined(_CE_DCOM) && !defined(_CE_ALLOW_SINGLE_THREADED_OBJECTS_IN_MTA)14 #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."15 #endif16 17 using namespace ATL;18 19 20 // CMyOverlay21 22 class ATL_NO_VTABLE CMyOverlay :23 public CComObjectRootEx<CComSingleThreadModel>,24 public CComCoClass<CMyOverlay, &CLSID_MyOverlay>,25 public IDispatchImpl<IMyOverlay, &IID_IMyOverlay, &LIBID_ExampleLib, 26 /*wMajor =*/ 1, /*wMinor =*/ 0>,27 public IShellIconOverlayIdentifier28 {29 public:30 CMyOverlay()31 {32 }33 34 DECLARE_REGISTRY_RESOURCEID(IDR_MYOVERLAY)35 36 37 BEGIN_COM_MAP(CMyOverlay)38 COM_INTERFACE_ENTRY(IMyOverlay)39 COM_INTERFACE_ENTRY(IDispatch)40 COM_INTERFACE_ENTRY(IShellIconOverlayIdentifier)41 END_COM_MAP()42 43 44 45 DECLARE_PROTECT_FINAL_CONSTRUCT()46 47 STDMETHOD(IsMemberOf)(THIS_ _In_ PCWSTR pwszPath, DWORD dwAttrib);48 STDMETHOD(GetOverlayInfo)(THIS_ _Out_writes_(cchMax) PWSTR pwszIconFile, 49 int cchMax, _Out_ int * pIndex, _Out_ DWORD * pdwFlags);50 STDMETHOD(GetPriority)(THIS_ _Out_ int * pIPriority);51 52 HRESULT FinalConstruct()53 {54 return S_OK;55 }56 57 void FinalRelease()58 {59 }60 61 public:62 63 64 65 };66 67 OBJECT_ENTRY_AUTO(__uuidof(MyOverlay), CMyOverlay)
6、根据 MSDN 实现该 Class。
1 // MyOverlay.cpp : Implementation of CMyOverlay 2 3 #include "stdafx.h" 4 #include "MyOverlay.h" 5 #include <WinBase.h> 6 #pragma comment(lib, "Kernel32.lib") 7 8 // CMyOverlay 9 10 STDMETHODIMP CMyOverlay::IsMemberOf(THIS_ _In_ PCWSTR pwszPath, DWORD dwAttrib)11 {12 if (_tcscmp(pwszPath, L"test") == 0)13 {14 return S_OK;15 }16 else17 {18 return S_FALSE;19 }20 }21 22 STDMETHODIMP CMyOverlay::GetOverlayInfo(23 THIS_ _Out_writes_(cchMax) PWSTR pwszIconFile, 24 int cchMax, 25 _Out_ int * pIndex,26 _Out_ DWORD * pdwFlags)27 {28 29 GetModuleFileNameW(_AtlBaseModule.GetModuleInstance(), pwszIconFile, cchMax);30 31 *pIndex = 0;32 33 *pdwFlags = ISIOI_ICONFILE | ISIOI_ICONINDEX;34 35 return S_OK;36 }37 38 STDMETHODIMP CMyOverlay::GetPriority(THIS_ _Out_ int * pIPriority)39 {40 *pIPriority = 0;41 42 return S_OK;43 }
7、在 .rgs 文件中添加注册表信息,确保各 GUID 与 .idl 文件中的一致。
1 HKCR 2 { 3 NoRemove CLSID 4 { 5 ForceRemove {29913677-1662-46C5-8645-16F84DA6F438} = s ‘MyOverlay Class‘ 6 { 7 ForceRemove Programmable 8 InprocServer32 = s ‘%MODULE%‘ 9 {10 val ThreadingModel = s ‘Apartment‘11 }12 TypeLib = s ‘{942F4DBB-4667-4767-A35B-52F32F623C63}‘13 Version = s ‘1.0‘14 }15 }16 }17 18 HKLM19 {20 NoRemove SOFTWARE21 {22 NoRemove Microsoft23 {24 NoRemove Windows25 {26 NoRemove CurrentVersion27 {28 NoRemove Explorer29 {30 NoRemove ShellIconOverlayIdentifiers31 {32 ForceRemove ‘ MyOverlay‘ = s ‘{29913677-1662-46C5-8645-16F84DA6F438}‘33 {34 }35 }36 }37 }38 }39 }40 }41 }
8、Build Project 后通过 cmd.exe 注册或解注册生成的 .dll 文件。重启 explorer.exe 后生效。
9、由于 slots 数量有限,检查在注册表中添加的子项是否在有效范围内(目前为前15个)。可采用在子项名称前添加空格的方式将其位置提前。
10、查看效果如下图所示。
参考网址:http://www.codeproject.com/Articles/7484/How-to-overlay-an-icon-over-existing-shell-objects
—————————————————————————————————————
本文为本人原创,如需转载请注明出处。
Creating Icon Overlay Handlers