使用 Win32 API 查找图标资源中的图标数量

Question

我有一个 *.ico 文件，其中包含多个不同大小的图标，作为资源链接到我的可执行文件。我使用此资源通过

RegisterClassEx()

设置应用程序的图标，即：

wcx.hIcon = LoadIcon(hInstance, MAKEINTRESOURCE(IDI_ICON1));

除此之外，我还想将此资源中的所有单个图标转换为

ARGB

像素数组。这应该可以通过在

GetDIBits()

返回的位图上使用

GetIconInfo()

来实现。

但是，有一个问题：我需要找出

HICON

返回的

LoadIcon()

句柄中的图标数量以及它们的大小。我似乎没有找到一个 API 可以使用

HICON

句柄并告诉我其中实际有多少个图标以及它们的大小。

这是否可能以某种方式实现，或者我是否需要采取艰难的方式并自己解析 *.ico 资源？

Answer 1

最初的图标处理功能很古老。它们是在 16 位 Windows 中引入的，专为仅定义一种图标大小的系统而设计。因此，大多数这些功能都没有意识到不止一种图标大小的可能性。要获得资源中不同大小的图标，需要进行额外的工作。

遵循 ICO 文件格式，由图标目录和实际图标图像组成，图标资源也由两部分组成：类型

RT_GROUP_ICON

的图标目录和单个图标 (

RT_ICON

)。该目录由以下结构表示：

#pragma pack( push )
#pragma pack( 1 )
typedef struct 
{
    WORD            idReserved;   // Reserved (must be 0)
    WORD            idType;       // Resource type (1 for icons)
    WORD            idCount;      // How many images?
    GRPICONDIRENTRY idEntries[1]; // The entries for each image
} GRPICONDIR, *LPGRPICONDIR;
#pragma pack( pop )

和

#pragma pack( push )
#pragma pack( 1 )
typedef struct
{
    BYTE   bWidth;               // Width, in pixels, of the image
    BYTE   bHeight;              // Height, in pixels, of the image
    BYTE   bColorCount;          // Number of colors in image (0 if >=8bpp)
    BYTE   bReserved;            // Reserved
    WORD   wPlanes;              // Color Planes
    WORD   wBitCount;            // Bits per pixel
    DWORD  dwBytesInRes;         // how many bytes in this resource?
    WORD   nID;                  // the ID
} GRPICONDIRENTRY, *LPGRPICONDIRENTRY;
#pragma pack( pop )

可以使用以下代码检索图标组 ID 的图标目录：

typedef std::list<GRPICONDIRENTRY> IconDirectory;

IconDirectory GetIconDirectory( HMODULE hMod, WORD Id ) {
    HRSRC hRsrc = FindResourceW( hMod, MAKEINTRESOURCE( Id ), RT_GROUP_ICON );
    HGLOBAL hGlobal = LoadResource( hMod, hRsrc );
    GRPICONDIR* lpGrpIconDir = (GRPICONDIR*)LockResource( hGlobal );

    IconDirectory dir;
    for ( size_t i = 0; i < lpGrpIconDir->idCount; ++i ) {
        dir.push_back( lpGrpIconDir->idEntries[ i ] );
    }
    return dir;
}

根据图标目录中的信息，可以使用以下代码构建各个图标：

HICON LoadSpecificIcon( HMODULE hMod, WORD Id ) {
    HRSRC hRsrc = FindResourceW( hMod, MAKEINTRESOURCE( Id ), RT_ICON );
    HGLOBAL hGlobal = LoadResource( hMod, hRsrc );
    BYTE* lpData = (BYTE*)LockResource( hGlobal );
    DWORD dwSize = SizeofResource( hMod, hRsrc );

    HICON hIcon = CreateIconFromResourceEx( lpData, dwSize, TRUE, 0x00030000,
                                            0, 0, LR_DEFAULTCOLOR );
    return hIcon;
}

将所有部分放在一起，以下加载

explorer.exe

作为资源文件，检索 ID 为

101

的第一个图标组，并打印每个条目的图标目录中的信息。然后，它创建单独的图标并输出

xHotspot

和

yHotspot

数据。对于图标，热点位于中心：

void PrintIconDirEntry( const GRPICONDIRENTRY& DirEntry ) {
    _wprintf_p( L"ID: %04d; width=%02d; height=%02d; bpp=%02d\n",
                DirEntry.nID,
                DirEntry.bWidth, DirEntry.bHeight, DirEntry.wBitCount );
}

void PrintIconInfo( HICON hIcon ) {
    ICONINFO ii = { 0 };
    GetIconInfo( hIcon, &ii );
    _wprintf_p( L"xHotspot=%02d; yHotspot=%02d\n", ii.xHotspot, ii.yHotspot );
}

typedef std::list<GRPICONDIRENTRY>::const_iterator IconDirectoryCIt;

int _tmain(int argc, _TCHAR* argv[])
{
    HMODULE hMod = LoadLibraryExW( L"C:\\Windows\\system32\\explorer.exe",
                                   NULL, LOAD_LIBRARY_AS_IMAGE_RESOURCE );
    IconDirectory dir = GetIconDirectory( hMod, 101 );
    for ( IconDirectoryCIt it = dir.begin(); it != dir.end(); ++it ) {
        PrintIconDirEntry( *it );
        HICON hIcon = LoadSpecificIcon( hMod, it->nID );
        PrintIconInfo( hIcon );
        DestroyIcon( hIcon );
    }
    return 0;
}

总而言之：检索图标资源的所有图标大小和颜色变化涉及两个步骤：

1. 检索图标目录，其中包含图标组中所有图标的信息。
2. 迭代图标目录并使用

   CreateIconFromResourceEx

   构建各个图标。

参考资料：

• 图标格式的 MSDN 文档：Icons
• 旧的新事物：ICO 文件格式的演变，第 1 部分：单色的开始
• 旧的新事物：ICO 文件格式的演变，第 2 部分：现已彩色！
• 旧的新事物：ICO 文件格式的演变，第 3 部分：Alpha 混合图像
• 旧的新事物：ICO 文件格式的演变，第 4 部分：PNG 图像
• 旧的新事物：图标资源的格式
• 旧的新事物：如何覆盖默认的图标选择算法？