Win32 API:ListView_MapIndexToID 函数(Commctrl.h)
ListView_MapIndexToID 函数用于将列表视图控件中的项索引映射到与该项关联的标识符(ID)。该函数定义在 Commctrl.h 头文件中,用于操作 Windows 上的列表视图控件。以下是 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.dwSi...
Win32 API:ListView_InsertItem 函数(Commctrl.h)
ListView_InsertItem 函数是 Windows API 中用于在列表视图控件中插入新项的函数。该函数定义在 Commctrl.h 头文件中,用于操作 Windows 上的列表视图控件。以下是 ListView_InsertItem 函数的一般格式:int ListView_InsertItem( HWND hwnd, const LVITEM *pitem); 参数 hwnd 是列表视图控件的句柄。 参数 pitem 是一个指向 LVITEM 结构的指针,包含有关新项的信息。LVITEM 结构的定义如下:typedef struct tagLVITEM { UINT mask; int iItem; int iSubItem; UINT state; UINT stateMask; LPTSTR pszText; int cchTextMax; int iImage; LPARAM lParam; int iIndent;#if (_WIN32_IE >= 0x0300) int iGroupId; UINT cColumns...
Win32 API:ListView_InsertColumn 函数(Commctrl.h)
ListView_InsertColumn 函数是 Windows API 中用于在列表视图控件中插入新列的函数。该函数定义在 Commctrl.h 头文件中,用于操作 Windows 上的列表视图控件。以下是 ListView_InsertColumn 函数的一般格式:int ListView_InsertColumn( HWND hwnd, int iCol, const LVCOLUMN *pcol); 参数 hwnd 是列表视图控件的句柄。 参数 iCol 是要插入的新列的索引。 参数 pcol 是一个指向 LVCOLUMN 结构的指针,包含有关新列的信息。LVCOLUMN 结构的定义如下:typedef struct tagLVCOLUMN { UINT mask; int fmt; int cx; LPTSTR pszText; int cchTextMax; int iSubItem; int iImage; int iOrder; i...
Win32 API:ListView_HitTest 函数(Commctrl.h)
ListView_HitTest 函数是 Windows API 中用于执行鼠标点击测试(hit testing)的函数,特别是用于在列表视图控件中确定指定坐标下的子项和子项的部分。该函数定义在 Commctrl.h 头文件中,用于操作 Windows 上的列表视图控件。以下是 ListView_HitTest 函数的一般格式:int ListView_HitTest( HWND hwnd, LVHITTESTINFO *pinfo); 参数 hwnd 是列表视图控件的句柄。 参数 pinfo 是一个指向 LVHITTESTINFO 结构的指针,用于指定测试坐标并接收测试结果。LVHITTESTINFO 结构的定义如下:typedef struct tagLVHITTESTINFO { POINT pt; UINT flags; int iItem; int iSubItem; int iGroup;} LVHITTESTINFO, *LPLVHITTESTINFO; pt 是一个 POINT 结构,用于指定测试坐标。 flags 是一个表示测试结果...
Win32 API:ListView_GetWorkAreas 函数(Commctrl.h)
ListView_GetWorkAreas 函数是 Windows API 中用于检索列表视图控件的工作区域信息的函数。该函数定义在 Commctrl.h 头文件中,用于操作 Windows 上的列表视图控件。以下是 ListView_GetWorkAreas 函数的一般格式:BOOL ListView_GetWorkAreas( HWND hwnd, int nWorkAreas, LPRECT prc); 参数 hwnd 是列表视图控件的句柄。 参数 nWorkAreas 是指定工作区域的数量。 参数 prc 是一个指向 RECT 数组的指针,用于接收工作区域的信息。函数返回一个布尔值,表示是否成功获取工作区域的信息。工作区域是列表视图控件的一个可定制区域,可以用来定义列的布局。通过 ListView_SetWorkAreas 函数,可以设置工作区域的信息。ListView_GetWorkAreas 函数则用于检索当前设置的工作区域信息。以下是一个简单的示例代码:#include <windows.h>#include <comm...
Win32 API:ListView_GetViewRect 函数(Commctrl.h)
ListView_GetViewRect 函数是 Windows API 中用于检索列表视图控件的客户区域(client area)中,当前可见的部分的矩形的函数。该函数定义在 Commctrl.h 头文件中,用于操作 Windows 上的列表视图控件。以下是 ListView_GetViewRect 函数的一般格式:BOOL ListView_GetViewRect( HWND hwnd, RECT * prc); 参数 hwnd 是列表视图控件的句柄。 参数 prc 是一个指向 RECT 结构的指针,用于接收包含可见部分矩形坐标的信息。函数返回一个布尔值,表示是否成功获取可见部分的矩形。示例代码如下:#include <windows.h>#include <commctrl.h>LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam) { switch (uMsg) { case WM_CREATE: { ...
Win32 API:ListView_GetView 函数(Commctrl.h)
ListView_GetView 函数是 Windows API 中用于检索当前列表视图控件的视图样式的函数。该函数定义在 Commctrl.h 头文件中,用于操作 Windows 上的列表视图控件。以下是 ListView_GetView 函数的一般格式:DWORD ListView_GetView( HWND hwnd);参数 hwnd 是列表视图控件的句柄,函数返回一个 DWORD 类型的值,表示当前列表视图的视图样式。具体的视图样式取决于该函数返回的值。请注意,ListView_GetView 函数需要 Windows 版本为 Windows Vista 或更高版本。在调用该函数时,可以使用以下常量来解释返回的值: LVS_VIEW_ICON:图标视图 LVS_VIEW_DETAILS:详细信息视图 LVS_VIEW_SMALLICON:小图标视图 LVS_VIEW_LIST:列表视图示例代码如下:#include <windows.h>#include <commctrl.h>int main() { // 初始化 Common Control...
Win32 API:ListView_GetTopIndex 函数(Commctrl.h)
ListView_GetTopIndex 函数是 Win32 API 中用于获取在 ListView 控件中可见的第一个项的索引的函数。该函数位于 Commctrl.h 头文件中,通常与 ListView 控件一起使用。以下是该函数的一般形式:int ListView_GetTopIndex( HWND hwnd);参数: hwnd: ListView 控件的句柄(handle)。返回值: 如果函数调用成功,将返回可见项的索引。如果发生错误,返回值为-1。该函数的作用是获取 ListView 控件中当前可见区域的第一个项的索引。这对于处理大型数据集的 ListView 控件而言很有用,因为用户可能无法看到整个列表,而只能看到可见区域。以下是一个简单的示例代码,演示如何使用 ListView_GetTopIndex 函数:#include <Commctrl.h>// ...HWND hwndListView; // ListView 控件的句柄// 获取可见区域的第一个项的索引int topIndex = ListView_GetTopIndex(hwndListView...
Win32 API:ListView_GetToolTips 函数(Commctrl.h)
ListView_GetToolTips 函数用于获取列表视图控件(ListView)使用的工具提示控件的句柄。该函数在 Commctrl.h 头文件中声明。以下是该函数的声明:HWND ListView_GetToolTips( HWND hwnd);参数说明: hwnd:列表视图控件的句柄。函数返回值: 返回值为工具提示控件的句柄(HWND)。使用示例:#include <CommCtrl.h>// 假设 hListView 是你的列表视图控件的句柄HWND hToolTips = ListView_GetToolTips(hListView);// 使用 hToolTips 进行相应的操作这个函数可以帮助你获取列表视图控件使用的工具提示控件的句柄,以便于在程序中进行相应的处理。
Win32 API:ListView_GetTileInfo 函数(Commctrl.h)
ListView_GetTileInfo 函数用于获取列表视图控件(ListView)的磁贴信息。磁贴是一种在 Windows 8 及更高版本中引入的图块状元素,可用于自定义列表视图的外观。然而,在Windows 7以及之前的系统版本中,这个函数是不可用的。以下是 ListView_GetTileInfo 函数的声明:BOOL ListView_GetTileInfo( HWND hwnd, LVTILEINFO *pTileInfo);参数说明: hwnd:列表视图控件的句柄。 pTileInfo:指向 LVTILEINFO 结构的指针,用于接收磁贴信息。LVTILEINFO 结构的定义如下:typedef struct tagLVTILEINFO { UINT cbSize; int iItem; WCHAR *pszText; int cchTextMax; int iImage; LPARAM lParam; int iGroup; UINT cColumns; PUINT puColumns;} LVTIL...
Win32 API:ListView_GetTextColor 函数(Commctrl.h)
ListView_GetTextColor 函数是 Windows API 中用于获取列表视图控件(ListView)的文本颜色的函数。该函数在 Commctrl.h 头文件中声明。以下是该函数的声明:COLORREF ListView_GetTextColor( HWND hwnd);参数说明: hwnd:列表视图控件的句柄。函数返回值: 返回值为 COLORREF 类型,表示文本的颜色。使用示例:#include <CommCtrl.h>// 假设 hListView 是你的列表视图控件的句柄COLORREF textColor = ListView_GetTextColor(hListView);// 使用 textColor 进行相应的操作这个函数可以帮助你获取列表视图控件的文本颜色,以便于在程序中进行相应的处理。
Win32 API:ListView_GetTextBkColor 函数(Commctrl.h)
ListView_GetTextBkColor 函数是 Windows API 中用于获取列表视图控件(ListView)的文本背景颜色的函数。该函数在 Commctrl.h 头文件中声明。以下是该函数的声明:COLORREF ListView_GetTextBkColor( HWND hwnd);参数说明: hwnd:列表视图控件的句柄。函数返回值: 返回值为 COLORREF 类型,表示文本的背景颜色。使用示例:#include <CommCtrl.h>// 假设 hListView 是你的列表视图控件的句柄COLORREF textBkColor = ListView_GetTextBkColor(hListView);// 使用 textBkColor 进行相应的操作这个函数可以帮助你获取列表视图控件的文本背景颜色,以便于在程序中进行相应的处理。
Win32 API:ListView_GetSubItemRect 函数(Commctrl.h)
ListView_GetSubItemRect 函数是 Windows API 中用于获取列表视图控件(ListView)中指定项的指定子项(子列)的矩形区域信息的函数。该函数在 Commctrl.h 头文件中声明。以下是该函数的声明:BOOL ListView_GetSubItemRect( HWND hwnd, int i, int iSubItem, UINT code, LPRECT prc);参数说明: hwnd:列表视图控件的句柄。 i:要获取矩形区域信息的列表项的索引。 iSubItem:要获取矩形区域信息的子项的索引。 code:指定返回的矩形区域的类型,可以是以下常量之一: - LVIR_BOUNDS:返回包含整个项的矩形区域。 - LVIR_ICON:返回包含项的图标的矩形区域。 - LVIR_LABEL:返回包含项的标签文本的矩形区域。 - LVIR_SELECTBOUNDS:返回包含项的选择边界的矩形区域。 prc:指向 RECT 结构的指针,用于接收矩形区域的信息。函数返回值: 如果函数成功,返回值为TRUE;如果失败,返...
Win32 API:ListView_GetSelectionMark 函数(Commctrl.h)
ListView_GetSelectionMark 函数是 Windows API 中用于获取列表视图控件(ListView)中当前选择项的索引的函数。该函数在 Commctrl.h 头文件中声明。以下是该函数的声明:int ListView_GetSelectionMark( HWND hwnd);参数说明: hwnd:列表视图控件的句柄。函数返回值: 返回当前选择项的索引。如果没有选择项,则返回值为 -1。使用示例:#include <CommCtrl.h>// 假设 hListView 是你的列表视图控件的句柄int selectionMark = ListView_GetSelectionMark(hListView);if (selectionMark != -1) { // 存在选择项,可以使用 selectionMark 进行相应的操作} else { // 没有选择项}这个函数可以帮助你获取列表视图控件中当前选择项的索引,以便在程序中进行相应的处理。
Win32 API:ListView_GetSelectedCount 函数(Commctrl.h)
ListView_GetSelectedCount 函数是用于获取列表视图控件(ListView)中选中项的数量的函数。该函数在 Commctrl.h 头文件中声明。以下是该函数的声明:int ListView_GetSelectedCount( HWND hwnd);参数说明: hwnd:列表视图控件的句柄。函数返回值: 返回选中项的数量。使用示例:#include <CommCtrl.h>// 假设 hListView 是你的列表视图控件的句柄int selectedCount = ListView_GetSelectedCount(hListView);// 使用 selectedCount 进行相应的操作这个函数可以帮助你获取列表视图控件中选中项的数量,以便在程序中进行相应的处理。
Win32 API:ListView_GetNextItem 函数(Commctrl.h)
ListView_GetNextItem 函数是 Windows API 中用于在列表视图控件(ListView)中获取下一个或前一个项的索引的函数。该函数在 Commctrl.h 头文件中声明。以下是该函数的声明:int ListView_GetNextItem( HWND hwnd, int iStart, UINT flags);参数说明: hwnd:列表视图控件的句柄。 iStart:从哪个项开始搜索下一个项。如果要从第一个项开始,传递值 -1。 flags:标志,指定搜索方向。可以是以下常量之一: - LVNI_BELOW:向下搜索。 - LVNI_ABOVE:向上搜索。 - LVNI_TOLEFT:向左搜索。 - LVNI_TORIGHT:向右搜索。函数返回值: 返回下一个项的索引。如果没有下一个项,返回值为 -1。使用示例:#include <CommCtrl.h>// 假设 hListView 是你的列表视图控件的句柄int startIndex = -1; // 从第一个项开始搜索UINT searchDirection = LVNI_BE...
Win32 API:ListView_GetItemText 函数(Commctrl.h)
ListView_GetItemText 函数是 Windows API 中用于获取列表视图控件(ListView)中指定项的文本信息的函数。该函数在 Commctrl.h 头文件中声明。以下是该函数的声明:int ListView_GetItemText( HWND hwnd, int i, int iSubItem, LPWSTR pszText, int cchTextMax);参数说明: hwnd:列表视图控件的句柄。 i:要获取文本信息的列表项的索引。 iSubItem:要获取文本信息的子项的索引。如果是 0,则获取主项的文本。 pszText:指向缓冲区的指针,用于接收文本信息。 cchTextMax:缓冲区的最大长度,以字符为单位。函数返回值: 返回实际复制到缓冲区中的字符数,不包括终止 null 字符。如果出现错误,返回值为 -1。使用示例:#include <CommCtrl.h>// 假设 hListView 是你的列表视图控件的句柄int itemIndex = 2; // 要获取文本信息的列表项的索引int subItemIndex ...
Win32 API:ListView_GetItemState 函数(Commctrl.h)
ListView_GetItemState 函数是 Windows API 中用于获取列表视图控件(ListView)中指定项的状态信息的函数。该函数在 Commctrl.h 头文件中声明。以下是该函数的声明:UINT ListView_GetItemState( HWND hwnd, int i, UINT mask);参数说明: hwnd:列表视图控件的句柄。 i:要获取状态信息的列表项的索引。 mask:指定所需的状态项。可以是以下常量之一或它们的组合: - LVIS_SELECTED:项是否被选中。 - LVIS_FOCUSED:项是否拥有焦点。 - LVIS_STATEIMAGEMASK:项的状态图像的掩码。 - LVIS_OVERLAYMASK:项的叠加图像的掩码。函数返回值: 返回包含指定项状态信息的整数值。使用示例:#include <CommCtrl.h>// 假设 hListView 是你的列表视图控件的句柄int itemIndex = 2; // 要获取状态信息的列表项的索引UINT stateMask = LVIS_SELECTED...
Win32 API:ListView_GetItemRect 函数(Commctrl.h)
ListView_GetItemRect 函数是 Windows API 中用于获取列表视图控件(ListView)中指定项的矩形区域信息的函数。该函数同样在 Commctrl.h 头文件中声明。以下是该函数的声明:BOOL ListView_GetItemRect( HWND hwnd, int i, LPRECT prc, UINT code);参数说明: hwnd:列表视图控件的句柄。 i:要获取矩形区域信息的列表项的索引。 prc:指向 RECT 结构的指针,用于接收矩形区域的信息。 code:指定返回的矩形区域的类型,可以是以下常量之一: - LVIR_BOUNDS:返回包含整个项的矩形区域。 - LVIR_ICON:返回包含项的图标的矩形区域。 - LVIR_LABEL:返回包含项的标签文本的矩形区域。函数返回值: 如果函数成功,返回值为 TRUE;如果失败,返回值为 FALSE。使用示例:#include <CommCtrl.h>// 假设 hListView 是你的列表视图控件的句柄RECT rc;int itemIndex = ...
Win32 API:ListView_GetItemPosition 函数(Commctrl.h)
ListView_GetItemPosition 函数是Windows API中用于获取列表视图控件(ListView)中指定项的位置信息的函数。该函数在Commctrl.h头文件中声明。以下是该函数的声明:BOOL ListView_GetItemPosition( HWND hwnd, int i, POINT *ppt);参数说明: hwnd:列表视图控件的句柄。 i:要获取位置信息的列表项的索引。 ppt:指向POINT结构的指针,用于接收位置信息。函数返回值: 如果函数成功,返回值为TRUE;如果失败,返回值为FALSE。使用示例:#include <CommCtrl.h>// 假设 hListView 是你的列表视图控件的句柄POINT pt;int itemIndex = 2; // 要获取位置信息的列表项的索引BOOL result = ListView_GetItemPosition(hListView, itemIndex, &pt);if (result) { // 成功获取位置信息,pt ...