Header_SetStateImageList 函数是用于在报头控件（Header Control）中设置状态图像列表的函数。该函数在 Commctrl.h 头文件中声明。

以下是 Header_SetStateImageList 函数的基本信息：
HIMAGELIST Header_SetStateImageList(
  HWND      hwnd,
  HIMAGELIST himl
);

参数说明：
  •  hwnd：报头控件的句柄。

  •  himl：要设置的状态图像列表的句柄。


该函数返回先前与报头控件关联的状态图像列表的句柄。如果之前没有关联状态图像列表，则返回 NULL。

状态图像列表是一个包含图像的列表，通常用于显示项的状态图标，例如复选框的选中状态。在报头控件中，状态图像列表可以用于显示各个项的状态图标。

以下是一个简单的示例代码，演示如何使用 Header_SetStateImageList 函数：
#include <windows.h>
#include <commctrl.h>

int main() {
    // 初始化 Common Controls
    INITCOMMONCONTROLSEX icex;
    icex.dwSize = sizeof(INITCOMMONCONTROLSEX);
    icex.dwICC = ICC_WIN95_CLASSES; // 或其他需要的标志
    InitCommonControlsEx(&icex);

    // 创建窗口
    HWND hwnd = CreateWindowEx(0, WC_HEADER, L"Header Control",
        WS_OVERLAPPEDWINDOW | WS_VISIBLE,
        100, 100, 400, 200,
        NULL, NULL, NULL, NULL);

    if (hwnd == NULL) {
        MessageBox(NULL, L"Window creation failed!", L"Error", MB_ICONERROR);
        return 1;
    }

    // 创建状态图像列表
    HIMAGELIST himlState = ImageList_Create(16, 16, ILC_COLOR32 | ILC_MASK, 2, 1);
    HICON hIcon1 = LoadIcon(NULL, IDI_INFORMATION);
    HICON hIcon2 = LoadIcon(NULL, IDI_WARNING);
    ImageList_AddIcon(himlState, hIcon1);
    ImageList_AddIcon(himlState, hIcon2);

    // 设置状态图像列表
    HIMAGELIST himlPrev = Header_SetStateImageList(hwnd, himlState);

    // 如果之前有关联的状态图像列表，需要释放它
    if (himlPrev != NULL) {
        ImageList_Destroy(himlPrev);
    }

    // 消息循环
    MSG msg;
    while (GetMessage(&msg, NULL, 0, 0)) {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }

    // 释放状态图像列表
    ImageList_Destroy(himlState);

    return 0;
}

在这个例子中，首先创建了一个包含两个图标的状态图像列表，然后通过 Header_SetStateImageList 函数将其与报头控件关联。最后，如果之前有关联的状态图像列表，需要释放它。


转载请注明出处：http://www.zyzy.cn/article/detail/24668/Win32 API/Commctrl.h/Header_SetStateImageList