SHGetFileInfo

SHGetFileInfo是一个程序代码，意思是获得系统图标列表。

SHGetFileInfo介绍

SHGetFileInfo是一个程序代码，意思是获得系统图标列表。

SHGetFileInfo举例

1.获得系统图标列表：

//取得系统图标列表

uses

ShellAPI

var

ImageListHandle : THandle;

FileInfo: TSHFileInfo;

//小图标

ImageListHandle := SHGetFileInfo('C:',

0,

FileInfo,

SizeOf(FileInfo),

SHGFI_ SYSIConIND EX or SHGFI_SMALLICON);

//把图标列表同一个名叫ListView1的ListView控件的小图标关联。

SendMessage( ListView1.Handle, LVM_SETIMAGELIST, LVSIL_SMALL, ImageListHandle);

//大图标

ImageListHandle := SHGetFileInfo('C:',

0,

FileInfo,

SizeOf(FileInfo),

SHGFI_SYSIConINDEX or SHGFI_LARGEICON);

//把图标列表同一个名叫ListView1的ListView控件的大图标关联。

SendMessage(ListView1.Handle, LVM_SETIMAGELIST, LVSIL_NORMAL, ImageListHandle);

2.获得一个文件的显示名和图标

var

sfi: TSHFileInfo;

IconIndex : Integer;

//取图标的索引号等信息

SHGetFileInfo(PAnsiChar(FileName),

0,

sfi,

sizeof(TSHFileInfo),

ShellAPI.SHGFI_DISPLAYNAME or ShellAPI.SHGFI_TYPENAME or ShellAPI.SHGFI_LARGEICON or ShellAPI.SHGFI_ICON);

//显示名和图标在系统图标列表中的编号就分别在sfi.szDisplayName和sfi.iIcon中

SHGetFileInfo详析

SHGetFileInfo函数

function SHGetFileInfo(

LPCTSTRpszPath,

DWORDdwFileAttributes,

SHFILEINFO*psfi,

UINTcbFileInfo,

UINTuFlags

);

pszPath 参数:指定的文件名。

当uFlags的取值中不包含 SHGFI_PIDL时,可直接指定;

当uFlags的取值中包含 SHGFI_PIDL时pszPath要通过计算获得,不能直接指定;

dwFileAttributes参数:文件属性。

仅当uFlags的取值中包含SHGFI_USEFILEATTRIBUTES时有效,一般不用此参数;

SHFILEINFO结构定义如下：

typedef struct _SHFILEINFO

{

HICON hIcon;//文件的图标句柄

int iIcon;//图标的系统索引号

DWORD dwAttributes;//文件的属性值

char szDisplayName;//文件的显示名

char szTypeName;//文件的类型名

} SHFILEINFO;

此外，这个结构总是用于返回数据到调用程序， 并且从不需要初始化。唯一可以包含信息来影响函数行为的 是dwAttributes成员，在后面将进一步给出解释。显然， 驾驭SHGetFileInfo()函数各种行为的所有兴趣都集中在对 uFlags变量值的设置上。绝大多数情况下， 信息经由psfi缓冲返回，但也有些情况，回应可以有效地包含在函数的DWORD返回之中。

cbFileInfo 参数:psfi的比特值;

uFlags 参数:指明需要返回的文件信息标识符,常用的有以下常数:

SHGFI_ICON; //获得图标

SHGFI_DISPLAYNAME; //获得显示名

SHGFI_TYPENAME; //获得类型名

SHGFI_ATTRIBUTES; //获得属性

SHGFI_LARGEICON; //获得大图标

SHGFI_SMALLICON; //获得小图标

SHGFI_PIDL; // pszPath是一个标识符

SHGFI_USEFILEATTRIBUTES;//不会访问第一个参数所指定的文件，使函数认为在pszPath参数中传递的文件是存在的，此时，它可以获得扩展名，并且搜索注册表来得到图标和类型名信息。

此外，这个结构总是用于返回数据到调用程序，并且从不需要初始化。唯一可以包含信息来影响函数行为的是dwAttributes成员，在后面将进一步给出解释。显然，驾驭SHGetFileInfo()函数各种行为的所有兴趣都集中在对uFlags变量值的设置上。绝大多数情况下，信息经由psfi缓冲返回，但也有些情况，回应可以有效地包含在函数的DWORD返回之中。

函数SHGetFileInfo()的返回值也随uFlags的取值变化而有所不同。

可见通过调用SHGetFileInfo()可以由psfi参数得到文件的图标句柄。但要注意在uFlags参数中不使用SHGFI_PIDL时,SHGetFileInfo()不能获得“我的电脑”等虚似文件夹的信息。

应该注意的是，在调用SHGetFileInfo()之前，必须使用 CoInitialize 或者OleInitialize 初始化COM,否则表面上能够使用，但是会造成不安全或者丧失部分功能。例如，一个常见的例子：如果不初始化COM,那么调用该函数就无法得到.htm/.mht/.xml文件的图标。