以下是 ListView_MapIndexToID 函数的一般格式:
UINT ListView_MapIndexToID(
HWND hwnd,
int i
);
- 参数 hwnd 是列表视图控件的句柄。
- 参数 i 是要映射的项的索引。
函数返回与指定项关联的标识符(ID)。如果未关联标识符或发生错误,返回值为 0。
这个函数通常用于与分组(grouping)相关的列表视图控件,其中每个项都可以关联一个唯一的标识符(ID)。
以下是一个简单的示例代码,演示如何使用 ListView_MapIndexToID 函数:
#include <windows.h>
#include <commctrl.h>
int main() {
// 初始化 Common Controls Library
INITCOMMONCONTROLSEX icex;
icex.dwSize = sizeof(INITCOMMONCONTROLSEX);
icex.dwICC = ICC_LISTVIEW_CLASSES;
InitCommonControlsEx(&icex);
// 创建主窗口
HWND hwndMain = CreateWindowEx(0, WC_LISTVIEW, L"ListView_MapIndexToID Example",
WS_OVERLAPPEDWINDOW | LVS_REPORT, CW_USEDEFAULT, CW_USEDEFAULT, 400, 300,
NULL, NULL, GetModuleHandle(NULL), NULL);
// 添加一列以便能够看到列表视图的显示
LVCOLUMN lvColumn;
lvColumn.mask = LVCF_TEXT | LVCF_WIDTH;
lvColumn.pszText = L"Column 1";
lvColumn.cx = 200;
ListView_InsertColumn(hwndMain, 0, &lvColumn);
// 添加一些项到列表视图
LVITEM lvItem;
lvItem.mask = LVIF_TEXT | LVIF_PARAM;
lvItem.iItem = 0;
lvItem.iSubItem = 0;
lvItem.pszText = L"Item 1";
lvItem.lParam = 1001; // 关联的标识符(ID)
ListView_InsertItem(hwndMain, &lvItem);
lvItem.iItem = 1;
lvItem.pszText = L"Item 2";
lvItem.lParam = 1002; // 关联的标识符(ID)
ListView_InsertItem(hwndMain, &lvItem);
// 映射索引到关联的标识符(ID)
UINT id1 = ListView_MapIndexToID(hwndMain, 0);
UINT id2 = ListView_MapIndexToID(hwndMain, 1);
// 显示关联的标识符(ID)
MessageBox(NULL, (L"Item 1 ID: " + std::to_wstring(id1) + L"\nItem 2 ID: " + std::to_wstring(id2)).c_str(),
L"ListView_MapIndexToID Result", MB_OK);
// 显示窗口
ShowWindow(hwndMain, SW_SHOWNORMAL);
UpdateWindow(hwndMain);
// 进入消息循环
MSG msg;
while (GetMessage(&msg, NULL, 0, 0)) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
return 0;
}
在这个示例中,创建了一个带有一个列的列表视图控件,并向列表视图中插入两个项,每个项都关联一个标识符(ID)。然后,使用 ListView_MapIndexToID 函数将项的索引映射到关联的标识符(ID),并在消息框中显示结果。
转载请注明出处:http://www.zyzy.cn/article/detail/24742/Win32 API/Commctrl.h/ListView_MapIndexToID