C#)Windows Shell 编程系列5 - 获取图标

原文 C#)Windows Shell 编程系列5 - 获取图标

(本系列文章由柠檬的(lc_mtt)原创,转载请注明出处,谢谢~)

接上一节:(C#)Windows Shell 编程系列4 - 上下文菜单(iContextMenu)(二)嵌入菜单和执行命令

有关 PIDL

  PIDL亦有“绝对路径”与“相对路径”的概念。表示“相对路径”的PIDL(本文简称为“相对PIDL”)只有一个ITEMIDLIST结构的元素,用于标识相对于父文件夹的“路径”;表示“绝对路径”的PIDL(简称为“绝对PIDL”)有若干个ITEMIDLIST结构的元素,第一个元素表示外壳名字空间根文件夹(“桌面”)下的某一子文件夹A,第二个元素则表示文件夹A下的某一子文件夹B,其余依此类推。这样绝对PIDL就通过保存一条从“桌面”下的直接子文件夹或文件的绝对PIDL与相对PIDL是相同的,而其他的文件夹或文件的相对PIDL就只是其绝对PIDL的最后一部分了。

  为什么要说这些呢?因为有些函数,必须使用绝对PIDL,例如图标,如果不使用绝对PIDL,某些图标是无法正常获得的(驱动器、控制面板等)。

但使用 EnumObjects 获得的,仅仅是相对PIDL,如果通过相对PIDL获取绝对PIDL呢?我参考了开源项目 C# FileBrowser 中的 PIDL 类

C#)Windows Shell 编程系列5 - 获取图标
C#)Windows Shell 编程系列5 - 获取图标, newPidl, bytes.Length);
C#)Windows Shell 编程系列5 - 获取图标
C#)Windows Shell 编程系列5 - 获取图标            return newPidl;
C#)Windows Shell 编程系列5 - 获取图标        }
C#)Windows Shell 编程系列5 - 获取图标    }
C#)Windows Shell 编程系列5 - 获取图标}
C#)Windows Shell 编程系列5 - 获取图标

该类实现了 PIDL 的复制和结合功能。现在我们修改 ShellItem 类,使它带有父节点的 IShellFolder 以及提供获取绝对 PIDL 的属性:

C#)Windows Shell 编程系列5 - 获取图标private ShellItem m_ParentItem;
C#)Windows Shell 编程系列5 - 获取图标
C#)Windows Shell 编程系列5 - 获取图标public ShellItem ParentItem
C#)Windows Shell 编程系列5 - 获取图标{
C#)Windows Shell 编程系列5 - 获取图标    get { return m_ParentItem; }
C#)Windows Shell 编程系列5 - 获取图标    set { m_ParentItem = value; }
C#)Windows Shell 编程系列5 - 获取图标}
C#)Windows Shell 编程系列5 - 获取图标
C#)Windows Shell 编程系列5 - 获取图标/// <summary>
C#)Windows Shell 编程系列5 - 获取图标/// 绝对 PIDL
C#)Windows Shell 编程系列5 - 获取图标/// </summary>
C#)Windows Shell 编程系列5 - 获取图标public PIDL PIDLFull
C#)Windows Shell 编程系列5 - 获取图标{
C#)Windows Shell 编程系列5 - 获取图标    get
C#)Windows Shell 编程系列5 - 获取图标    {
C#)Windows Shell 编程系列5 - 获取图标        PIDL pidlFull = new PIDL(PIDL, true);
C#)Windows Shell 编程系列5 - 获取图标        ShellItem current = ParentItem;
C#)Windows Shell 编程系列5 - 获取图标        while (current != null)
C#)Windows Shell 编程系列5 - 获取图标        {
C#)Windows Shell 编程系列5 - 获取图标            pidlFull.Insert(current.PIDL);
C#)Windows Shell 编程系列5 - 获取图标            current = current.ParentItem;
C#)Windows Shell 编程系列5 - 获取图标        }
C#)Windows Shell 编程系列5 - 获取图标        return pidlFull;
C#)Windows Shell 编程系列5 - 获取图标    }
C#)Windows Shell 编程系列5 - 获取图标}

获取图标

言归正传,既然已经获得绝对 PIDL,那么获取图标就是很简单的事情了,我们使用的是 SHGetFileInfo 这个API:

C#)Windows Shell 编程系列5 - 获取图标[DllImport("shell32", EntryPoint = "SHGetFileInfo", ExactSpelling = false, 
C#)Windows Shell 编程系列5 - 获取图标    CharSet = CharSet.Auto, SetLastError = true)]
C#)Windows Shell 编程系列5 - 获取图标public static extern IntPtr SHGetFileInfo(
C#)Windows Shell 编程系列5 - 获取图标    IntPtr ppidl, 
C#)Windows Shell 编程系列5 - 获取图标    FILE_ATTRIBUTE dwFileAttributes, 
C#)Windows Shell 编程系列5 - 获取图标    ref SHFILEINFO sfi, 
C#)Windows Shell 编程系列5 - 获取图标    int cbFileInfo, 
C#)Windows Shell 编程系列5 - 获取图标    SHGFI uFlags);
C#)Windows Shell 编程系列5 - 获取图标
C#)Windows Shell 编程系列5 - 获取图标[DllImport("Shell32.dll", CharSet = CharSet.Auto)]
C#)Windows Shell 编程系列5 - 获取图标public static extern IntPtr SHGetFileInfo(
C#)Windows Shell 编程系列5 - 获取图标    string Path, 
C#)Windows Shell 编程系列5 - 获取图标    FILE_ATTRIBUTE fileAttributes, 
C#)Windows Shell 编程系列5 - 获取图标    out SHFILEINFO sfi, 
C#)Windows Shell 编程系列5 - 获取图标    int cbFileInfo, SHGFI flags);
C#)Windows Shell 编程系列5 - 获取图标

这里提供了一个重载,你可以选择是通过 PIDL 还是 路径 获取图标(如果是路径,那么仅仅能获取 文件夹/文件 的图标)。

C#)Windows Shell 编程系列5 - 获取图标, ref psfi, Marshal.SizeOf(psfi),
C#)Windows Shell 编程系列5 - 获取图标        SHGFI.ICON | SHGFI.PIDL | SHGFI.SMALLICON | SHGFI.SYSICONINDEX);
C#)Windows Shell 编程系列5 - 获取图标
C#)Windows Shell 编程系列5 - 获取图标    return psfi.iIcon;
C#)Windows Shell 编程系列5 - 获取图标}

大家也许会觉得奇怪,GetSmallIconIndex 返回的是 int ,到底要怎么使用?

其实没
错,GetSmallIconIndex 仅仅是返回该图标在系统图像列表(System
ImageList)的索引(Index)而已。我们只要获取系统图像列表的指针,再把它关联到你的 TreeView 或 ListView
,即可通过 Icon Index 来显示图标了。

C#)Windows Shell 编程系列5 - 获取图标, out shfi, Marshal.SizeOf(typeof(SHFILEINFO)),
C#)Windows Shell 编程系列5 - 获取图标    SHGFI.SYSICONINDEX | SHGFI.LARGEICON | SHGFI.USEFILEATTRIBUTES);
C#)Windows Shell 编程系列5 - 获取图标
C#)Windows Shell 编程系列5 - 获取图标//把系统 ImageList 关联到 TreeView 和 ListView
C#)Windows Shell 编程系列5 - 获取图标API.SendMessage(Tree1.Handle, API.TVM_SETIMAGELIST, API.TVSIL_NORMAL, m_ipSmallSystemImageList);
C#)Windows Shell 编程系列5 - 获取图标API.SendMessage(lvFile.Handle, API.LVM_SETIMAGELIST, API.LVSIL_NORMAL, m_ipLargeSystemImageList);

OK,我们修改以往的例子,就可以在 Tree 节点上显示图标了:

C#)Windows Shell 编程系列5 - 获取图标C#)Windows Shell 编程系列5 - 获取图标C#)Windows Shell 编程系列5 - 获取图标
C#)Windows Shell 编程系列5 - 获取图标ShellItem shellItem=new ShellItem(pidlSub, iSub, sItem);
C#)Windows Shell 编程系列5 - 获取图标int imgIndex = API.GetSmallIconIndex(shellItem.PIDLFull.Ptr);
C#)Windows Shell 编程系列5 - 获取图标TreeNode nodeSub = new TreeNode(name, imgIndex, imgIndex);
C#)Windows Shell 编程系列5 - 获取图标C#)Windows Shell 编程系列5 - 获取图标C#)Windows Shell 编程系列5 - 获取图标

(注:关于文中出现的一些结构体或常量,读者可以自行查阅 MSDN,精力有限实在不能一一说明。)

我们来看一下效果:

C#)Windows Shell 编程系列5 - 获取图标

事实上,这个代码改了很多,也涉及到下一节的部分内容,因此代码将在下一节中抛出...

上一篇:.NET Core微服务之路:文章系列和内容索引汇总 (v0.52)


下一篇:CART