标签搜索

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

冰封一夏
2021-06-18 14:17:28 / 101 阅读 / 正在检测是否收录...

原文 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 类


using System;
using System.Collections.Generic;
using System.Text;
using System.Collections;
using System.Runtime.InteropServices;

namespace WinShell
{
    
public class PIDL
    
{
        
private IntPtr pidl = IntPtr.Zero;

        
public PIDL(IntPtr pidl, bool clone)
        
{
            
if (clone)
                
this.pidl = ILClone(pidl);
            
else
                
this.pidl = pidl;
        }


        
public PIDL(PIDL pidl, bool clone)
        
{
            
if (clone)
                
this.pidl = ILClone(pidl.Ptr);
            
else
                
this.pidl = pidl.Ptr;
        }



        
public IntPtr Ptr 
        

            
get return pidl; } 
        }


        
public void Insert(IntPtr insertPidl)
        
{
            IntPtr newPidl 
= ILCombine(insertPidl, pidl);

            Marshal.FreeCoTaskMem(pidl);
            pidl 
= newPidl;
        }


        
public void Free()
        
{
            
if (pidl != IntPtr.Zero)
            
{
                Marshal.FreeCoTaskMem(pidl);
                pidl 
= IntPtr.Zero;
            }

        }



        
private static int ItemIDSize(IntPtr pidl)
        
{
            
if (!pidl.Equals(IntPtr.Zero))
            
{
                
byte[] buffer = new byte[2];
                Marshal.Copy(pidl, buffer, 
02);
                
return buffer[1* 256 + buffer[0];
            }

            
else
                
return 0;
        }


        
private static int ItemIDListSize(IntPtr pidl)
        
{
            
if (pidl.Equals(IntPtr.Zero))
                
return 0;
            
else
            
{
                
int size = ItemIDSize(pidl);
                
int nextSize = Marshal.ReadByte(pidl, size) + (Marshal.ReadByte(pidl, size + 1* 256);
                
while (nextSize > 0)
                
{
                    size 
+= nextSize;
                    nextSize 
= Marshal.ReadByte(pidl, size) + (Marshal.ReadByte(pidl, size + 1* 256);
                }


                
return size;
            }

        }


        
public static IntPtr ILClone(IntPtr pidl)
        
{
            
int size = ItemIDListSize(pidl);

            
byte[] bytes = new byte[size + 2];
            Marshal.Copy(pidl, bytes, 
0, size);

            IntPtr newPidl 
= Marshal.AllocCoTaskMem(size + 2);
            Marshal.Copy(bytes, 
0, newPidl, size + 2);

            
return newPidl;
        }


        
public static IntPtr ILCombine(IntPtr pidl1, IntPtr pidl2)
        
{
            
int size1 = ItemIDListSize(pidl1);
            
int size2 = ItemIDListSize(pidl2);

            IntPtr newPidl 
= Marshal.AllocCoTaskMem(size1 + size2 + 2);
            
byte[] bytes = new byte[size1 + size2 + 2];

            Marshal.Copy(pidl1, bytes, 
0, size1);
            Marshal.Copy(pidl2, bytes, size1, size2);

            Marshal.Copy(bytes, 
0, newPidl, bytes.Length);

            
return newPidl;
        }

    }

}


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

private ShellItem m_ParentItem;

public ShellItem ParentItem
{
    
get return m_ParentItem; }
    
set { m_ParentItem = value; }
}


/// <summary>
/// 绝对 PIDL
/// </summary>

public PIDL PIDLFull
{
    
get
    
{
        PIDL pidlFull 
= new PIDL(PIDL, true);
        ShellItem current 
= ParentItem;
        
while (current != null)
        
{
            pidlFull.Insert(current.PIDL);
            current 
= current.ParentItem;
        }

        
return pidlFull;
    }

}


获取图标

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

[DllImport("shell32", EntryPoint = "SHGetFileInfo", ExactSpelling = false
    CharSet 
= CharSet.Auto, SetLastError = true)]
public static extern IntPtr SHGetFileInfo(
    IntPtr ppidl, 
    FILE_ATTRIBUTE dwFileAttributes, 
    
ref SHFILEINFO sfi, 
    
int cbFileInfo, 
    SHGFI uFlags);

[DllImport(
"Shell32.dll", CharSet = CharSet.Auto)]
public static extern IntPtr SHGetFileInfo(
    
string Path, 
    FILE_ATTRIBUTE fileAttributes, 
    
out SHFILEINFO sfi, 
    
int cbFileInfo, SHGFI flags);


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

/// <summary>
/// 获取小图标索引
/// </summary>

public static int GetSmallIconIndex(string strFilename)
{
    SHFILEINFO psfi 
= new SHFILEINFO();
    IntPtr ipIcon 
= SHGetFileInfo(strFilename, 0out psfi, Marshal.SizeOf(psfi),
        SHGFI.ICON 
| SHGFI.SMALLICON | SHGFI.SYSICONINDEX);

    
return psfi.iIcon;
}


public static int GetSmallIconIndex(IntPtr ipIDList)
{
    SHFILEINFO psfi 
= new SHFILEINFO();
    IntPtr ipIcon 
= SHGetFileInfo(ipIDList, 0ref psfi, Marshal.SizeOf(psfi),
        SHGFI.ICON 
| SHGFI.PIDL | SHGFI.SMALLICON | SHGFI.SYSICONINDEX);

    
return psfi.iIcon;
}


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

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

IntPtr m_ipSmallSystemImageList;
IntPtr m_ipLargeSystemImageList;

//获取系统 ImageList
SHFILEINFO shfi = new SHFILEINFO();

m_ipSmallSystemImageList 
= API.SHGetFileInfo(""0out shfi, Marshal.SizeOf(typeof(SHFILEINFO)),
    SHGFI.SYSICONINDEX 
| SHGFI.SMALLICON | SHGFI.USEFILEATTRIBUTES);

m_ipLargeSystemImageList 
= API.SHGetFileInfo(""0out shfi, Marshal.SizeOf(typeof(SHFILEINFO)),
    SHGFI.SYSICONINDEX 
| SHGFI.LARGEICON | SHGFI.USEFILEATTRIBUTES);

//把系统 ImageList 关联到 TreeView 和 ListView
API.SendMessage(Tree1.Handle, API.TVM_SETIMAGELIST, API.TVSIL_NORMAL, m_ipSmallSystemImageList);
API.SendMessage(lvFile.Handle, API.LVM_SETIMAGELIST, API.LVSIL_NORMAL, m_ipLargeSystemImageList);


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


ShellItem shellItem
=new ShellItem(pidlSub, iSub, sItem);
int imgIndex = API.GetSmallIconIndex(shellItem.PIDLFull.Ptr);
TreeNode nodeSub 
= new TreeNode(name, imgIndex, imgIndex);


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

我们来看一下效果:



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

9

评论

博主关闭了所有页面的评论