List-列表

函数
HELE WINAPI	XList_Create (int x, int y, int cx, int cy, HXCGUI hParent)
	列表_创建 创建列表元素. 更多...
HELE WINAPI	XList_CreateEx (int x, int y, int cx, int cy, HXCGUI hParent, int col_extend_count)
	列表_创建扩展 创建列表元素, 使用内置项模板, 自动创建数据适配器 更多...
int WINAPI	XList_AddColumn (HELE hEle, int width)
	列表_增加列 增加列. 更多...
int WINAPI	XList_InsertColumn (HELE hEle, int width, int iCol)
	列表_插入列 插入列. 更多...
void WINAPI	XList_EnableMultiSel (HELE hEle, BOOL bEnable)
	列表_启用多选 启用或关闭多选功能. 更多...
void WINAPI	XList_EnableDragChangeColumnWidth (HELE hEle, BOOL bEnable)
	列表_启用拖动更改列宽 启用拖动改变列宽度. 更多...
void WINAPI	XList_EnableVScrollBarTop (HELE hEle, BOOL bTop)
	列表_启用垂直滚动条顶部对齐 启用垂直滚动条顶部对齐. 更多...
void WINAPI	XList_EnableRowBkFull (HELE hEle, BOOL bFull)
	列表_启用行背景铺满 启用行背景铺满模式. 更多...
void WINAPI	XList_EnableFixedRowHeight (HELE hEle, BOOL bEnable)
	@列表_启用固定行高 更多...
void WINAPI	XList_EnableTemplateReuse (HELE hEle, BOOL bEnable)
	@列表_启用模板复用 更多...
void WINAPI	XList_EnableVirtualTable (HELE hEle, BOOL bEnable)
	@列表_启用虚表 更多...
void WINAPI	XList_SetVirtualRowCount (HELE hEle, int nRowCount)
	@列表_置虚表行数 更多...
void WINAPI	XList_SetSort (HELE hEle, int iColumn, int iColumnAdapter, BOOL bEnable)
	列表_置排序 设置排序属性. 更多...
void WINAPI	XList_SetDrawRowBkFlags (HELE hEle, int nFlags)
	列表_置行背景绘制标志 设置是否绘制指定状态下行的背景. 更多...
void WINAPI	XList_SetSplitLineColor (HELE hEle, COLORREF color)
	@列表_置分割线颜色 更多...
void WINAPI	XList_SetColumnWidth (HELE hEle, int iRow, int width)
	列表_置列宽 设置列宽度. 更多...
void WINAPI	XList_SetColumnMinWidth (HELE hEle, int iRow, int width)
	列表_置列最小宽度 设置列最小宽度. 更多...
void WINAPI	XList_SetColumnWidthFixed (HELE hEle, int iColumn, BOOL bFixed)
	列表_置列宽度固定 设置指定列宽度固定. 更多...
int WINAPI	XList_GetColumnWidth (HELE hEle, int iColumn)
	列表_取列宽度 获取指定列宽度. 更多...
int WINAPI	XList_GetColumnCount (HELE hEle)
	列表_取列数量 获取列数量. 更多...
BOOL WINAPI	XList_SetItemData (HELE hEle, int iRow, int iColumn, vint data)
	列表_置项数据 设置项用户数据. 更多...
vint WINAPI	XList_GetItemData (HELE hEle, int iRow, int iColumn)
	列表_取项数据 获取项用户数据. 更多...
BOOL WINAPI	XList_SetSelectRow (HELE hEle, int iRow)
	列表_置选择行 设置选择行. 更多...
int WINAPI	XList_GetSelectRow (HELE hEle)
	列表_取选择行 获取选择行. 更多...
int WINAPI	XList_GetSelectRowCount (HELE hEle)
	列表_取选择行数量 获取选择行数量. 更多...
BOOL WINAPI	XList_AddSelectRow (HELE hEle, int iRow)
	@列表_添加选择行 更多...
void WINAPI	XList_SetSelectAll (HELE hEle)
	列表_置选择全部 选择全部行. 更多...
int WINAPI	XList_GetSelectAll (HELE hEle, out_buffer_ int *pArray, int nArraySize)
	列表_取全部选择 获取全部选择的行. 更多...
void WINAPI	XList_VisibleRow (HELE hEle, int iRow)
	列表_显示指定行 滚动视图让指定行可见 更多...
BOOL WINAPI	XList_CancelSelectRow (HELE hEle, int iRow)
	列表_取消选择行 取消选择指定行(这里的项可以理解为行). 更多...
void WINAPI	XList_CancelSelectAll (HELE hEle)
	列表_取消全部选择行 取消选择所有项(这里的项可以理解为行). 更多...
HELE WINAPI	XList_GetHeaderHELE (HELE hEle)
	列表_取列表头 获取列表头元素. 更多...
void WINAPI	XList_BindAdapter (HELE hEle, HXCGUI hAdapter)
	列表_绑定数据适配器 绑定数据适配器. 更多...
void WINAPI	XList_BindAdapterHeader (HELE hEle, HXCGUI hAdapter)
	列表_列表头绑定数据适配器 列表头绑定数据适配器. 更多...
HXCGUI WINAPI	XList_CreateAdapter (HELE hEle, int colExtend_count)
	列表_创建数据适配器 创建数据适配器，根据绑定的项模板初始化数据适配器的列(字段名); 数据适配器存储数据, UI对象根据绑定的字段名显示数据适配器中对应的数据; 更多...
HXCGUI WINAPI	XList_CreateAdapterHeader (HELE hEle)
	列表_列表头创建数据适配器 创建数据适配器，根据绑定的项模板初始化数据适配器的列(字段名); 数据适配器存储数据, UI对象根据绑定的字段名显示数据适配器中对应的数据; 更多...
BOOL WINAPI	XList_CreateAdapters (HELE hEle, int col_extend_count)
	列表_创建数据适配器2 创建数据适配器，根据绑定的项模板初始化数据适配器的列(字段名); 数据适配器存储数据, UI对象根据绑定的字段名显示数据适配器中对应的数据; 此接口是简化接口, 合并了 XList_CreateAdapter() 和 XList_CreateAdapterHeader() 接口; 更多...
HXCGUI WINAPI	XList_GetAdapter (HELE hEle)
	列表_取数据适配器 获取数据适配器. 更多...
HXCGUI WINAPI	XList_GetAdapterHeader (HELE hEle)
	列表_列表头获取数据适配器 获取列表头数据适配器. 更多...
BOOL WINAPI	XList_SetItemTemplateXML (HELE hEle, const wchar_t *pXmlFile)
	列表_置项模板文件 设置项布局模板文件. 更多...
BOOL WINAPI	XList_SetItemTemplateXMLFromMem (HELE hEle, void *data, int length)
	@列表_置项模板从内存 更多...
BOOL WINAPI	XList_SetItemTemplateXMLFromZipRes (HELE hEle, int id, const wchar_t *pFileName, const wchar_t *pPassword, HMODULE hModule)
	@列表_置项模板从资源ZIP 从RC资源ZIP加载 更多...
BOOL WINAPI	XList_SetItemTemplateXMLFromString (HELE hEle, const char *pStringXML)
	列表_置项模板从字符串 设置项布局模板文件. 更多...
BOOL WINAPI	XList_SetItemTemplate (HELE hEle, HTEMP hTemp)
	列表_置项模板 设置列表项模板. 更多...
HTEMP WINAPI	XList_GetItemTemplate (HELE hEle)
	@列表_取项模板 更多...
HTEMP WINAPI	XList_GetItemTemplateHeader (HELE hEle)
	@列表_取项模板列表头 更多...
HXCGUI WINAPI	XList_GetTemplateObject (HELE hEle, int iRow, int iColumn, int nTempItemID)
	列表_取模板对象 通过模板项ID,获取实例化模板项ID对应的对象句柄. 更多...
int WINAPI	XList_GetRowIndexFromHXCGUI (HELE hEle, HXCGUI hXCGUI)
	列表_取对象所在行 获取当前对象所在模板实例,属于列表中哪一行. 更多...
HXCGUI WINAPI	XList_GetHeaderTemplateObject (HELE hEle, int iColumn, int nTempItemID)
	列表_取列表头模板对象 列表头,通过模板项ID,获取实例化模板项ID对应的对象句柄. 更多...
int WINAPI	XList_GetHeaderColumnIndexFromHXCGUI (HELE hEle, HXCGUI hXCGUI)
	列表_取列表头对象所在列 列表头,获取当前对象所在模板实例,属于列表头中哪一个列. 更多...
void WINAPI	XList_SetHeaderHeight (HELE hEle, int height)
	列表_置列表头高度 设置列表头高度. 更多...
int WINAPI	XList_GetHeaderHeight (HELE hEle)
	列表_取列表头高度 获取列表头高度. 更多...
void WINAPI	XList_GetVisibleRowRange (HELE hEle, __out int *piStart, __out int *piEnd)
	列表_取可视行范围 获取当前可见行范围. 更多...
void WINAPI	XList_SetRowHeightDefault (HELE hEle, int nHeight, int nSelHeight)
	列表_置行默认高度 设置行默认高度. 更多...
void WINAPI	XList_GetRowHeightDefault (HELE hEle, __out int *pHeight, __out int *pSelHeight)
	列表_取行默认高度 获取行默认高度. 更多...
void WINAPI	XList_SetRowHeight (HELE hEle, int iRow, int nHeight, int nSelHeight)
	列表_置行高度 设置行高度. 更多...
void WINAPI	XList_GetRowHeight (HELE hEle, int iRow, __out int *pHeight, __out int *pSelHeight)
	列表_取行高度 获取行高度. 更多...
void WINAPI	XList_SetRowSpace (HELE hEle, int nSpace)
	列表_置行间距 设置行间距. 更多...
int WINAPI	XList_GetRowSpace (HELE hEle)
	列表_取行间距 获取行间距大小. 更多...
void WINAPI	XList_SetLockColumnLeft (HELE hEle, int iColumn)
	列表_置锁定列左侧 锁定列,设置左侧锁定列分界列索引. 更多...
void WINAPI	XList_SetLockColumnRight (HELE hEle, int iColumn)
	列表_置锁定列右侧 锁定列,设置右侧锁定列分界列索引 更多...
void WINAPI	XList_SetLockRowBottom (HELE hEle, BOOL bLock)
	列表_置锁定行底部 设置是否锁定末尾行. 更多...
void WINAPI	XList_SetLockRowBottomOverlap (HELE hEle, BOOL bOverlap)
	@列表_置锁定行底部重叠 更多...
void WINAPI	XList_SetDragRectColor (HELE hEle, COLORREF color, int width)
	@列表_置拖动矩形颜色 更多...
BOOL WINAPI	XList_HitTest (HELE hEle, POINT *pPt, __out int *piRow, __out int *piColumn)
	列表_测试点击项 检测坐标点所在项. 更多...
BOOL WINAPI	XList_HitTestOffset (HELE hEle, POINT *pPt, __out int *piRow, __out int *piColumn)
	列表_测试点击项扩展 检查坐标点所在项,自动添加滚动视图偏移量. 更多...
void WINAPI	XList_RefreshData (HELE hEle)
	列表_刷新数据 修改数据后,刷新所有项模板,以便更新数据到模板(如果项可见). 更多...
void WINAPI	XList_RefreshRow (HELE hEle, int iRow)
	列表_刷新指定行 修改数据后,刷新指定行模板,以便更新数据到模板(如果当前项可见). 更多...
void WINAPI	XList_RefreshDataHeader (HELE hEle)
	@列表_刷新数据列表头 更多...
BOOL WINAPI	XList_DeleteColumn (HELE hEle, int iColumn)
	列表_删除列 删除列.列表头-删除指定列, 列表项保持不变, 数据适配器保持不变, 仅针对列表头项 更多...
void WINAPI	XList_DeleteColumnAll (HELE hEle)
	@anchor 列表_删除列全部 列表头-删除所有的列, 列表项保持不变, 数据适配器保持不变, 仅针对列表头项 更多...
int WINAPI	XList_AddColumnText2 (HELE hEle, int nWidth, const wchar_t *pText)
	列表_添加列文本2 简化接口 更多...
int WINAPI	XList_AddColumnImage2 (HELE hEle, int nWidth, HIMAGE hImage)
	列表_添加列图片2 简化接口 更多...
int WINAPI	XList_AddColumnText (HELE hEle, int nWidth, const wchar_t *pName, const wchar_t *pText)
	@anchor 列表_添加列文本 更多...
int WINAPI	XList_AddColumnImage (HELE hEle, int nWidth, const wchar_t *pName, HIMAGE hImage)
	@anchor 列表_添加列图片 更多...
int WINAPI	XList_AddRowText (HELE hEle, const wchar_t *pText)
	@anchor 列表_添加行文本 更多...
int WINAPI	XList_AddRowTextEx (HELE hEle, const wchar_t *pName, const wchar_t *pText)
	@anchor 列表_添加行文本扩展 更多...
int WINAPI	XList_AddRowImage (HELE hEle, HIMAGE hImage)
	@anchor 列表_添加行图片 更多...
int WINAPI	XList_AddRowImageEx (HELE hEle, const wchar_t *pName, HIMAGE hImage)
	@anchor 列表_添加行图片扩展 更多...
int WINAPI	XList_InsertRowText (HELE hEle, int iRow, const wchar_t *pValue)
	@anchor 列表_插入行文本 更多...
int WINAPI	XList_InsertRowTextEx (HELE hEle, int iRow, const wchar_t *pName, const wchar_t *pValue)
	@anchor 列表_插入行文本扩展 更多...
int WINAPI	XList_InsertRowImage (HELE hEle, int iRow, HIMAGE hImage)
	@anchor 列表_插入行图片 更多...
int WINAPI	XList_InsertRowImageEx (HELE hEle, int iRow, const wchar_t *pName, HIMAGE hImage)
	@anchor 列表_插入行图片扩展 更多...
BOOL WINAPI	XList_SetItemText (HELE hEle, int iRow, int iColumn, const wchar_t *pText)
	@anchor 列表_置项文本 更多...
BOOL WINAPI	XList_SetItemTextEx (HELE hEle, int iRow, const wchar_t *pName, const wchar_t *pText)
	@anchor 列表_置项文本扩展 更多...
BOOL WINAPI	XList_SetItemImage (HELE hEle, int iRow, int iColumn, HIMAGE hImage)
	@anchor 列表_置项图片 更多...
BOOL WINAPI	XList_SetItemImageEx (HELE hEle, int iRow, const wchar_t *pName, HIMAGE hImage)
	@anchor 列表_置项图片扩展 更多...
BOOL WINAPI	XList_SetItemInt (HELE hEle, int iRow, int iColumn, int nValue)
	@anchor 列表_置项指数值 更多...
BOOL WINAPI	XList_SetItemIntEx (HELE hEle, int iRow, const wchar_t *pName, int nValue)
	@anchor 列表_置项整数值扩展 更多...
BOOL WINAPI	XList_SetItemFloat (HELE hEle, int iRow, int iColumn, float fFloat)
	@anchor 列表_置项浮点值 更多...
BOOL WINAPI	XList_SetItemFloatEx (HELE hEle, int iRow, const wchar_t *pName, float fFloat)
	@anchor 列表_置项浮点值扩展 更多...
const wchar_t *WINAPI	XList_GetItemText (HELE hEle, int iRow, int iColumn)
	@anchor 列表_取项文本 更多...
const wchar_t *WINAPI	XList_GetItemTextEx (HELE hEle, int iRow, const wchar_t *pName)
	@anchor 列表_取项文本扩展 更多...
HIMAGE WINAPI	XList_GetItemImage (HELE hEle, int iRow, int iColumn)
	@anchor 列表_取项图片 更多...
HIMAGE WINAPI	XList_GetItemImageEx (HELE hEle, int iRow, const wchar_t *pName)
	@anchor 列表_取项图片扩展 更多...
BOOL WINAPI	XList_GetItemInt (HELE hEle, int iRow, int iColumn, __out int *pOutValue)
	@anchor 列表_取项整数值 更多...
BOOL WINAPI	XList_GetItemIntEx (HELE hEle, int iRow, const wchar_t *pName, __out int *pOutValue)
	@anchor 列表_取项整数值扩展 更多...
BOOL WINAPI	XList_GetItemFloat (HELE hEle, int iRow, int iColumn, __out float *pOutValue)
	@anchor 列表_取项浮点值 更多...
BOOL WINAPI	XList_GetItemFloatEx (HELE hEle, int iRow, const wchar_t *pName, __out float *pOutValue)
	@anchor 列表_取项浮点值扩展 更多...
BOOL WINAPI	XList_DeleteRow (HELE hEle, int iRow)
	@anchor 列表_删除行 数据适配器-删除指定项 和 列表删除指定项, 列表头保持不变, 仅针对列表项 更多...
BOOL WINAPI	XList_DeleteRowEx (HELE hEle, int iRow, int nCount)
	@anchor 列表_删除行扩展 数据适配器-删除指定数量的行 和 列表删除指定数量项, 列表头保持不变, 仅针对列表项 更多...
void WINAPI	XList_DeleteRowAll (HELE hEle)
	@anchor 列表_删除行全部 数据适配器-删除全部项 和 列表删除全部项, 列表头保持不变, 仅针对列表项 更多...
void WINAPI	XList_DeleteColumnAll_AD (HELE hEle)
	@anchor 列表_删除列全部AD 数据适配器-清空数据适配器 和 列表删除全部项, 列表头保持不变, 仅针对列表项 更多...
int WINAPI	XList_GetCount_AD (HELE hEle)
	@anchor 列表_取行数量AD 数据适配器-获取行数量 更多...
int WINAPI	XList_GetCountColumn_AD (HELE hEle)
	@anchor 列表_取列数量AD 数据适配器-获取列数量 更多...

详细描述

函数说明

XList_AddColumn()

int WINAPI XList_AddColumn	(	HELE	hEle,
		int	width
	)

列表_增加列 增加列.

参数

hEle	元素句柄.
width	列宽度.

返回

返回位置索引.

XList_AddColumnImage()

int WINAPI XList_AddColumnImage	(	HELE	hEle,
		int	nWidth,
		const wchar_t *	pName,
		HIMAGE	hImage
	)

@anchor 列表_添加列图片

参数

hEle	元素句柄
nWidth
pName
hImage

返回

列索引

XList_AddColumnImage2()

int WINAPI XList_AddColumnImage2	(	HELE	hEle,
		int	nWidth,
		HIMAGE	hImage
	)

列表_添加列图片2 简化接口

参数

hEle	元素句柄
nWidth	列宽度
hImage	图片句柄

返回

返回列索引

XList_AddColumnText()

int WINAPI XList_AddColumnText	(	HELE	hEle,
		int	nWidth,
		const wchar_t *	pName,
		const wchar_t *	pText
	)

@anchor 列表_添加列文本

参数

hEle	元素句柄
nWidth
pName
pText

返回

列索引

XList_AddColumnText2()

int WINAPI XList_AddColumnText2	(	HELE	hEle,
		int	nWidth,
		const wchar_t *	pText
	)

列表_添加列文本2 简化接口

参数

hEle	元素句柄
nWidth	列宽度
pText	标题文本

返回

返回列索引

XList_AddRowImage()

int WINAPI XList_AddRowImage	(	HELE	hEle,
		HIMAGE	hImage
	)

@anchor 列表_添加行图片

参数

hEle	元素句柄
hImage

返回

行索引

XList_AddRowImageEx()

int WINAPI XList_AddRowImageEx	(	HELE	hEle,
		const wchar_t *	pName,
		HIMAGE	hImage
	)

@anchor 列表_添加行图片扩展

参数

hEle	元素句柄
pName
hImage

返回

行索引

XList_AddRowText()

int WINAPI XList_AddRowText	(	HELE	hEle,
		const wchar_t *	pText
	)

@anchor 列表_添加行文本

参数

hEle	元素句柄
pText

返回

行索引

XList_AddRowTextEx()

int WINAPI XList_AddRowTextEx	(	HELE	hEle,
		const wchar_t *	pName,
		const wchar_t *	pText
	)

@anchor 列表_添加行文本扩展

参数

hEle	元素句柄
pName
pText

返回

行索引

XList_AddSelectRow()

BOOL WINAPI XList_AddSelectRow	(	HELE	hEle,
		int	iRow
	)

@列表_添加选择行

参数

hEle	元素句柄
iRow	行索引

返回

成功返回TRUE,否则返回FALSE

XList_BindAdapter()

void WINAPI XList_BindAdapter	(	HELE	hEle,
		HXCGUI	hAdapter
	)

列表_绑定数据适配器 绑定数据适配器.

参数

hEle	元素句柄.
hAdapter	数据适配器句柄 XAdTable.

XList_BindAdapterHeader()

void WINAPI XList_BindAdapterHeader	(	HELE	hEle,
		HXCGUI	hAdapter
	)

列表_列表头绑定数据适配器 列表头绑定数据适配器.

参数

hEle	元素句柄.
hAdapter	数据适配器句柄 XAdMap.

XList_CancelSelectAll()

void WINAPI XList_CancelSelectAll

(

HELE

hEle

)

列表_取消全部选择行 取消选择所有项(这里的项可以理解为行).

参数

hEle

元素句柄.

XList_CancelSelectRow()

BOOL WINAPI XList_CancelSelectRow	(	HELE	hEle,
		int	iRow
	)

列表_取消选择行 取消选择指定行(这里的项可以理解为行).

参数

hEle	元素句柄.
iRow	行索引.

返回

成功返回TRUE否则返回FALSE.

XList_Create()

HELE WINAPI XList_Create	(	int	x,
		int	y,
		int	cx,
		int	cy,
		HXCGUI	hParent
	)

列表_创建 创建列表元素.

参数

x	元素x坐标.
y	元素y坐标.
cx	宽度.
cy	高度.
hParent	父是窗口资源句柄或UI元素资源句柄.如果是窗口资源句柄将被添加到窗口, 如果是元素资源句柄将被添加到元素.

返回

元素句柄.

XList_CreateAdapter()

HXCGUI WINAPI XList_CreateAdapter	(	HELE	hEle,
		int	colExtend_count
	)

列表_创建数据适配器
创建数据适配器，根据绑定的项模板初始化数据适配器的列(字段名); 数据适配器存储数据, UI对象根据绑定的字段名显示数据适配器中对应的数据;

参数

hEle	元素句柄.
colExtend_count	列延伸-预计列表总列数, 默认值0; 限制最大延伸范围, 避免超出范围, 增加不必要的字段. 例如默认模板是1列, 但是数据有5列,那么列延伸填5

返回

返回适配器句柄.

XList_CreateAdapterHeader()

HXCGUI WINAPI XList_CreateAdapterHeader

(

HELE

hEle

)

列表_列表头创建数据适配器 创建数据适配器，根据绑定的项模板初始化数据适配器的列(字段名); 数据适配器存储数据, UI对象根据绑定的字段名显示数据适配器中对应的数据;

参数

hEle

元素句柄.

返回

返回适配器句柄.

XList_CreateAdapters()

BOOL WINAPI XList_CreateAdapters	(	HELE	hEle,
		int	col_extend_count
	)

列表_创建数据适配器2 创建数据适配器，根据绑定的项模板初始化数据适配器的列(字段名); 数据适配器存储数据, UI对象根据绑定的字段名显示数据适配器中对应的数据; 此接口是简化接口, 合并了 XList_CreateAdapter() 和 XList_CreateAdapterHeader() 接口;

参数

hEle	元素句柄.
col_extend_count	列延伸-预计列表总列数, 默认值0; 限制最大延伸范围, 避免超出范围, 增加不必要的字段. 例如默认模板是1列, 但是数据有5列,那么列延伸填5

返回

如果成功返回TRUE, 否则返回FALSE.

XList_CreateEx()

HELE WINAPI XList_CreateEx	(	int	x,
		int	y,
		int	cx,
		int	cy,
		HXCGUI	hParent,
		int	col_extend_count
	)

列表_创建扩展 创建列表元素, 使用内置项模板, 自动创建数据适配器

参数

x	元素x坐标.
y	元素y坐标.
cx	宽度.
cy	高度.
hParent	父是窗口资源句柄或UI元素资源句柄.如果是窗口资源句柄将被添加到窗口, 如果是元素资源句柄将被添加到元素.
col_extend_count	列数量; 例如:内置模板是1列, 如果数据有5列, 那么此参数填5

返回

元素句柄.

XList_DeleteColumn()

BOOL WINAPI XList_DeleteColumn	(	HELE	hEle,
		int	iColumn
	)

列表_删除列 删除列.列表头-删除指定列, 列表项保持不变, 数据适配器保持不变, 仅针对列表头项

参数

hEle	元素句柄.
iColumn	列索引.

返回

成功返回TRUE否则返回FALSE.

XList_DeleteColumnAll()

void WINAPI XList_DeleteColumnAll

(

HELE

hEle

)

@anchor 列表_删除列全部 列表头-删除所有的列, 列表项保持不变, 数据适配器保持不变, 仅针对列表头项

参数

hEle

元素句柄.

XList_DeleteColumnAll_AD()

void WINAPI XList_DeleteColumnAll_AD

(

HELE

hEle

)

@anchor 列表_删除列全部AD 数据适配器-清空数据适配器 和 列表删除全部项, 列表头保持不变, 仅针对列表项

参数

hEle

元素句柄

XList_DeleteRow()

BOOL WINAPI XList_DeleteRow	(	HELE	hEle,
		int	iRow
	)

@anchor 列表_删除行 数据适配器-删除指定项 和 列表删除指定项, 列表头保持不变, 仅针对列表项

参数

hEle	元素句柄
iRow

返回

成功返回TRUE,否则返回FALSE

XList_DeleteRowAll()

void WINAPI XList_DeleteRowAll

(

HELE

hEle

)

@anchor 列表_删除行全部 数据适配器-删除全部项 和 列表删除全部项, 列表头保持不变, 仅针对列表项

参数

hEle

元素句柄

XList_DeleteRowEx()

BOOL WINAPI XList_DeleteRowEx	(	HELE	hEle,
		int	iRow,
		int	nCount
	)

@anchor 列表_删除行扩展 数据适配器-删除指定数量的行 和 列表删除指定数量项, 列表头保持不变, 仅针对列表项

参数

hEle	元素句柄
iRow
nCount

返回

成功返回TRUE,否则返回FALSE

XList_EnableDragChangeColumnWidth()

void WINAPI XList_EnableDragChangeColumnWidth	(	HELE	hEle,
		BOOL	bEnable
	)

列表_启用拖动更改列宽 启用拖动改变列宽度.

参数

hEle	元素句柄.
bEnable	是否启用.

XList_EnableFixedRowHeight()

void WINAPI XList_EnableFixedRowHeight	(	HELE	hEle,
		BOOL	bEnable
	)

@列表_启用固定行高

参数

hEle	元素句柄
bEnable	是否启用

XList_EnableMultiSel()

void WINAPI XList_EnableMultiSel	(	HELE	hEle,
		BOOL	bEnable
	)

列表_启用多选 启用或关闭多选功能.

参数

hEle	元素句柄.
bEnable	是否启用.

XList_EnableRowBkFull()

void WINAPI XList_EnableRowBkFull	(	HELE	hEle,
		BOOL	bFull
	)

列表_启用行背景铺满 启用行背景铺满模式.

参数

hEle	元素句柄.
bFull	是否启用铺满.

XList_EnableTemplateReuse()

void WINAPI XList_EnableTemplateReuse	(	HELE	hEle,
		BOOL	bEnable
	)

@列表_启用模板复用

参数

hEle	元素句柄
bEnable	是否启用

XList_EnableVirtualTable()

void WINAPI XList_EnableVirtualTable	(	HELE	hEle,
		BOOL	bEnable
	)

@列表_启用虚表

参数

hEle	元素句柄
bEnable	是否启用

XList_EnableVScrollBarTop()

void WINAPI XList_EnableVScrollBarTop	(	HELE	hEle,
		BOOL	bTop
	)

列表_启用垂直滚动条顶部对齐 启用垂直滚动条顶部对齐.

参数

hEle	元素句柄.
bTop	是否启用.

XList_GetAdapter()

HXCGUI WINAPI XList_GetAdapter

(

HELE

hEle

)

列表_取数据适配器 获取数据适配器.

参数

hEle

元素句柄.

返回

数据适配器句柄.

XList_GetAdapterHeader()

HXCGUI WINAPI XList_GetAdapterHeader

(

HELE

hEle

)

列表_列表头获取数据适配器 获取列表头数据适配器.

参数

hEle

元素句柄.

返回

返回数据适配器句柄.

XList_GetColumnCount()

int WINAPI XList_GetColumnCount

(

HELE

hEle

)

列表_取列数量 获取列数量.

参数

hEle

元素句柄.

返回

返回列数量.

XList_GetColumnWidth()

int WINAPI XList_GetColumnWidth	(	HELE	hEle,
		int	iColumn
	)

列表_取列宽度 获取指定列宽度.

参数

hEle	元素句柄.
iColumn	列索引.

返回

返回指定列宽度.

XList_GetCount_AD()

int WINAPI XList_GetCount_AD

(

HELE

hEle

)

@anchor 列表_取行数量AD 数据适配器-获取行数量

参数

hEle

元素句柄

返回

返回行数量

XList_GetCountColumn_AD()

int WINAPI XList_GetCountColumn_AD

(

HELE

hEle

)

@anchor 列表_取列数量AD 数据适配器-获取列数量

参数

hEle

元素句柄

返回

返回列数量

XList_GetHeaderColumnIndexFromHXCGUI()

int WINAPI XList_GetHeaderColumnIndexFromHXCGUI	(	HELE	hEle,
		HXCGUI	hXCGUI
	)

列表_取列表头对象所在列 列表头,获取当前对象所在模板实例,属于列表头中哪一个列.

参数

hEle	元素句柄.
hXCGUI	对象句柄.

返回

成功返回列索引, 否则返回XC_ID_ERROR.

XList_GetHeaderHeight()

int WINAPI XList_GetHeaderHeight

(

HELE

hEle

)

列表_取列表头高度 获取列表头高度.

参数

hEle

元素句柄.

返回

返回列表头高度.

XList_GetHeaderHELE()

HELE WINAPI XList_GetHeaderHELE

(

HELE

hEle

)

列表_取列表头 获取列表头元素.

参数

hEle

元素句柄.

返回

返回列表头元素句柄.

XList_GetHeaderTemplateObject()

HXCGUI WINAPI XList_GetHeaderTemplateObject	(	HELE	hEle,
		int	iColumn,
		int	nTempItemID
	)

列表_取列表头模板对象 列表头,通过模板项ID,获取实例化模板项ID对应的对象句柄.

参数

hEle	元素句柄.
iColumn	列表头 列索引.
nTempItemID	模板项ID.

返回

成功返回对象句柄,否则返回NULL.

XList_GetItemData()

vint WINAPI XList_GetItemData	(	HELE	hEle,
		int	iRow,
		int	iColumn
	)

列表_取项数据 获取项用户数据.

参数

hEle	元素句柄.
iRow	行索引.
iColumn	列索引.

返回

返回用户数据.

XList_GetItemFloat()

BOOL WINAPI XList_GetItemFloat	(	HELE	hEle,
		int	iRow,
		int	iColumn,
		__out float *	pOutValue
	)

@anchor 列表_取项浮点值

参数

hEle	元素句柄
iRow
iColumn
pOutValue

返回

成功返回TRUE,否则返回FALSE

XList_GetItemFloatEx()

BOOL WINAPI XList_GetItemFloatEx	(	HELE	hEle,
		int	iRow,
		const wchar_t *	pName,
		__out float *	pOutValue
	)

@anchor 列表_取项浮点值扩展

参数

hEle	元素句柄
iRow
pName
pOutValue

返回

成功返回TRUE,否则返回FALSE

XList_GetItemImage()

HIMAGE WINAPI XList_GetItemImage	(	HELE	hEle,
		int	iRow,
		int	iColumn
	)

@anchor 列表_取项图片

参数

hEle	元素句柄
iRow
iColumn

返回

XList_GetItemImageEx()

HIMAGE WINAPI XList_GetItemImageEx	(	HELE	hEle,
		int	iRow,
		const wchar_t *	pName
	)

@anchor 列表_取项图片扩展

参数

hEle	元素句柄
iRow
pName

返回

XList_GetItemInt()

BOOL WINAPI XList_GetItemInt	(	HELE	hEle,
		int	iRow,
		int	iColumn,
		__out int *	pOutValue
	)

@anchor 列表_取项整数值

参数

hEle	元素句柄
iRow
iColumn
pOutValue

返回

成功返回TRUE,否则返回FALSE

XList_GetItemIntEx()

BOOL WINAPI XList_GetItemIntEx	(	HELE	hEle,
		int	iRow,
		const wchar_t *	pName,
		__out int *	pOutValue
	)

@anchor 列表_取项整数值扩展

参数

hEle	元素句柄
iRow
pName
pOutValue

返回

成功返回TRUE,否则返回FALSE

XList_GetItemTemplate()

HTEMP WINAPI XList_GetItemTemplate

(

HELE

hEle

)

@列表_取项模板

参数

hEle

元素句柄

返回

返回列表项模板句柄

XList_GetItemTemplateHeader()

HTEMP WINAPI XList_GetItemTemplateHeader

(

HELE

hEle

)

@列表_取项模板列表头

参数

hEle

元素句柄

返回

返回列表头项模板句柄

XList_GetItemText()

const wchar_t *WINAPI XList_GetItemText	(	HELE	hEle,
		int	iRow,
		int	iColumn
	)

@anchor 列表_取项文本

参数

hEle	元素句柄
iRow
iColumn

返回

返回文本内容

XList_GetItemTextEx()

const wchar_t *WINAPI XList_GetItemTextEx	(	HELE	hEle,
		int	iRow,
		const wchar_t *	pName
	)

@anchor 列表_取项文本扩展

参数

hEle	元素句柄
iRow
pName

返回

返回文本内容

XList_GetRowHeight()

void WINAPI XList_GetRowHeight	(	HELE	hEle,
		int	iRow,
		__out int *	pHeight,
		__out int *	pSelHeight
	)

列表_取行高度 获取行高度.

参数

hEle	元素句柄.
iRow	行索引
pHeight	高度.
pSelHeight	选中时高度.

XList_GetRowHeightDefault()

void WINAPI XList_GetRowHeightDefault	(	HELE	hEle,
		__out int *	pHeight,
		__out int *	pSelHeight
	)

列表_取行默认高度 获取行默认高度.

参数

hEle	元素句柄.
pHeight	高度.
pSelHeight	选中时高度.

XList_GetRowIndexFromHXCGUI()

int WINAPI XList_GetRowIndexFromHXCGUI	(	HELE	hEle,
		HXCGUI	hXCGUI
	)

列表_取对象所在行 获取当前对象所在模板实例,属于列表中哪一行.

参数

hEle	元素句柄.
hXCGUI	对象句柄, UI元素句柄或形状对象句柄.

返回

成功返回行索引, 否则返回XC_ID_ERROR.

XList_GetRowSpace()

int WINAPI XList_GetRowSpace

(

HELE

hEle

)

列表_取行间距 获取行间距大小.

参数

hEle

元素句柄.

返回

返回行间距大小.

XList_GetSelectAll()

int WINAPI XList_GetSelectAll	(	HELE	hEle,
		out_buffer_ int *	pArray,
		int	nArraySize
	)

列表_取全部选择 获取全部选择的行.

参数

hEle	元素句柄.
pArray	接收行索引数组.
nArraySize	数组大小.

返回

返回行数量.

XList_GetSelectRow()

int WINAPI XList_GetSelectRow

(

HELE

hEle

)

列表_取选择行 获取选择行.

参数

hEle

元素句柄.

返回

行索引.

XList_GetSelectRowCount()

int WINAPI XList_GetSelectRowCount

(

HELE

hEle

)

列表_取选择行数量 获取选择行数量.

参数

hEle

元素句柄.

返回

返回选择行数量.

XList_GetTemplateObject()

HXCGUI WINAPI XList_GetTemplateObject	(	HELE	hEle,
		int	iRow,
		int	iColumn,
		int	nTempItemID
	)

列表_取模板对象 通过模板项ID,获取实例化模板项ID对应的对象句柄.

参数

hEle	元素句柄.
iRow	行索引.
iColumn	列索引.
nTempItemID	模板项itemID.

返回

成功返回对象句柄,否则返回NULL.

XList_GetVisibleRowRange()

void WINAPI XList_GetVisibleRowRange	(	HELE	hEle,
		__out int *	piStart,
		__out int *	piEnd
	)

列表_取可视行范围 获取当前可见行范围.

参数

hEle	元素句柄.
piStart	开始行索引.
piEnd	结束行索引.

XList_HitTest()

BOOL WINAPI XList_HitTest	(	HELE	hEle,
		POINT *	pPt,
		__out int *	piRow,
		__out int *	piColumn
	)

列表_测试点击项 检测坐标点所在项.

参数

hEle	元素句柄.
pPt	坐标点.
piRow	行索引.
piColumn	列索引.

返回

成功返回TRUE否则返回FALSE.

XList_HitTestOffset()

BOOL WINAPI XList_HitTestOffset	(	HELE	hEle,
		POINT *	pPt,
		__out int *	piRow,
		__out int *	piColumn
	)

列表_测试点击项扩展 检查坐标点所在项,自动添加滚动视图偏移量.

参数

hEle	元素句柄.
pPt	坐标点.
piRow	行索引.
piColumn	列索引.

返回

成功返回TRUE否则返回FALSE.

XList_InsertColumn()

int WINAPI XList_InsertColumn	(	HELE	hEle,
		int	width,
		int	iCol
	)

列表_插入列 插入列.

参数

hEle	元素句柄.
width	列宽度.
iCol	插入位置索引.

返回

返回插入位置索引.

XList_InsertRowImage()

int WINAPI XList_InsertRowImage	(	HELE	hEle,
		int	iRow,
		HIMAGE	hImage
	)

@anchor 列表_插入行图片

参数

hEle	元素句柄
iRow
hImage

返回

行索引

XList_InsertRowImageEx()

int WINAPI XList_InsertRowImageEx	(	HELE	hEle,
		int	iRow,
		const wchar_t *	pName,
		HIMAGE	hImage
	)

@anchor 列表_插入行图片扩展

参数

hEle	元素句柄
iRow
pName
hImage

返回

行索引

XList_InsertRowText()

int WINAPI XList_InsertRowText	(	HELE	hEle,
		int	iRow,
		const wchar_t *	pValue
	)

@anchor 列表_插入行文本

参数

hEle	元素句柄
iRow
pValue

返回

行索引

XList_InsertRowTextEx()

int WINAPI XList_InsertRowTextEx	(	HELE	hEle,
		int	iRow,
		const wchar_t *	pName,
		const wchar_t *	pValue
	)

@anchor 列表_插入行文本扩展

参数

hEle	元素句柄
iRow
pName
pValue

返回

行索引

XList_RefreshData()

void WINAPI XList_RefreshData

(

HELE

hEle

)

列表_刷新数据 修改数据后,刷新所有项模板,以便更新数据到模板(如果项可见).

参数

hEle

元素句柄.

XList_RefreshDataHeader()

void WINAPI XList_RefreshDataHeader

(

HELE

hEle

)

@列表_刷新数据列表头

返回

hEle 元素句柄

XList_RefreshRow()

void WINAPI XList_RefreshRow	(	HELE	hEle,
		int	iRow
	)

列表_刷新指定行 修改数据后,刷新指定行模板,以便更新数据到模板(如果当前项可见).

参数

hEle	元素句柄.
iRow	行索引.

XList_SetColumnMinWidth()

void WINAPI XList_SetColumnMinWidth	(	HELE	hEle,
		int	iRow,
		int	width
	)

列表_置列最小宽度 设置列最小宽度.

参数

hEle	元素句柄.
iRow	列索引.
width	宽度.

XList_SetColumnWidth()

void WINAPI XList_SetColumnWidth	(	HELE	hEle,
		int	iRow,
		int	width
	)

列表_置列宽 设置列宽度.

参数

hEle	元素句柄.
iRow	列索引.
width	宽度.

XList_SetColumnWidthFixed()

void WINAPI XList_SetColumnWidthFixed	(	HELE	hEle,
		int	iColumn,
		BOOL	bFixed
	)

列表_置列宽度固定 设置指定列宽度固定.

参数

hEle	元素句柄.
iColumn	列索引.
bFixed	是否固定宽度.

XList_SetDragRectColor()

void WINAPI XList_SetDragRectColor	(	HELE	hEle,
		COLORREF	color,
		int	width
	)

@列表_置拖动矩形颜色

参数

hEle	元素句柄
color	颜色值 请使用宏: RGBA()
width	线宽度

XList_SetDrawRowBkFlags()

void WINAPI XList_SetDrawRowBkFlags	(	HELE	hEle,
		int	nFlags
	)

列表_置行背景绘制标志 设置是否绘制指定状态下行的背景.

参数

hEle	元素句柄.
nFlags	标志位 list_drawItemBk_flag_.

XList_SetHeaderHeight()

void WINAPI XList_SetHeaderHeight	(	HELE	hEle,
		int	height
	)

列表_置列表头高度 设置列表头高度.

参数

hEle	元素句柄.
height	高度.

XList_SetItemData()

BOOL WINAPI XList_SetItemData	(	HELE	hEle,
		int	iRow,
		int	iColumn,
		vint	data
	)

列表_置项数据 设置项用户数据.

参数

hEle	元素句柄.
iRow	行索引.
iColumn	列索引.
data	用户数据.

返回

成功返回TRUE否则返回FALSE.

XList_SetItemFloat()

BOOL WINAPI XList_SetItemFloat	(	HELE	hEle,
		int	iRow,
		int	iColumn,
		float	fFloat
	)

@anchor 列表_置项浮点值

参数

hEle	元素句柄
iRow
iColumn
fFloat

返回

成功返回TRUE,否则返回FALSE

XList_SetItemFloatEx()

BOOL WINAPI XList_SetItemFloatEx	(	HELE	hEle,
		int	iRow,
		const wchar_t *	pName,
		float	fFloat
	)

@anchor 列表_置项浮点值扩展

参数

hEle	元素句柄
iRow
pName
fFloat

返回

成功返回TRUE,否则返回FALSE

XList_SetItemImage()

BOOL WINAPI XList_SetItemImage	(	HELE	hEle,
		int	iRow,
		int	iColumn,
		HIMAGE	hImage
	)

@anchor 列表_置项图片

参数

hEle	元素句柄
iRow
iColumn
hImage

返回

成功返回TRUE,否则返回FALSE

XList_SetItemImageEx()

BOOL WINAPI XList_SetItemImageEx	(	HELE	hEle,
		int	iRow,
		const wchar_t *	pName,
		HIMAGE	hImage
	)

@anchor 列表_置项图片扩展

参数

hEle	元素句柄
iRow
pName
hImage

返回

成功返回TRUE,否则返回FALSE

XList_SetItemInt()

BOOL WINAPI XList_SetItemInt	(	HELE	hEle,
		int	iRow,
		int	iColumn,
		int	nValue
	)

@anchor 列表_置项指数值

参数

hEle	元素句柄
iRow
iColumn
nValue

返回

成功返回TRUE,否则返回FALSE

XList_SetItemIntEx()

BOOL WINAPI XList_SetItemIntEx	(	HELE	hEle,
		int	iRow,
		const wchar_t *	pName,
		int	nValue
	)

@anchor 列表_置项整数值扩展

参数

hEle	元素句柄
iRow
pName
nValue

返回

成功返回TRUE,否则返回FALSE

XList_SetItemTemplate()

BOOL WINAPI XList_SetItemTemplate	(	HELE	hEle,
		HTEMP	hTemp
	)

列表_置项模板 设置列表项模板.

参数

hEle	元素句柄.
hTemp	模板句柄.

返回

如果成功返回TRUE,否则返回FALSE.

XList_SetItemTemplateXML()

BOOL WINAPI XList_SetItemTemplateXML	(	HELE	hEle,
		const wchar_t *	pXmlFile
	)

列表_置项模板文件 设置项布局模板文件.

参数

hEle	元素句柄.
pXmlFile	文件名.

返回

成功返回TRUE否则返回FALSE.

XList_SetItemTemplateXMLFromMem()

BOOL WINAPI XList_SetItemTemplateXMLFromMem	(	HELE	hEle,
		void *	data,
		int	length
	)

@列表_置项模板从内存

参数

hEle	元素句柄
data	内地地址
length	内存大小, 字节为单位

返回

如果成功返回TRUE,否则返回FALSE

XList_SetItemTemplateXMLFromString()

BOOL WINAPI XList_SetItemTemplateXMLFromString	(	HELE	hEle,
		const char *	pStringXML
	)

列表_置项模板从字符串 设置项布局模板文件.

参数

hEle	元素句柄.
pStringXML	字符串指针.

返回

成功返回TRUE否则返回FALSE.

XList_SetItemTemplateXMLFromZipRes()

BOOL WINAPI XList_SetItemTemplateXMLFromZipRes	(	HELE	hEle,
		int	id,
		const wchar_t *	pFileName,
		const wchar_t *	pPassword,
		HMODULE	hModule
	)

@列表_置项模板从资源ZIP 从RC资源ZIP加载

参数

hEle	元素句柄
id	RC资源ID
pFileName	项模板文件名
pPassword	zip密码
hModule	模块句柄

返回

如果成功返回TRUE,否则返回FALSE

XList_SetItemText()

BOOL WINAPI XList_SetItemText	(	HELE	hEle,
		int	iRow,
		int	iColumn,
		const wchar_t *	pText
	)

@anchor 列表_置项文本

参数

hEle	元素句柄
iRow	行索引
iColumn	在数据适配器中的列索引
pText

返回

成功返回TRUE,否则返回FALSE

XList_SetItemTextEx()

BOOL WINAPI XList_SetItemTextEx	(	HELE	hEle,
		int	iRow,
		const wchar_t *	pName,
		const wchar_t *	pText
	)

@anchor 列表_置项文本扩展

参数

hEle	元素句柄
iRow
pName
pText

返回

成功返回TRUE,否则返回FALSE

XList_SetLockColumnLeft()

void WINAPI XList_SetLockColumnLeft	(	HELE	hEle,
		int	iColumn
	)

列表_置锁定列左侧 锁定列,设置左侧锁定列分界列索引.

参数

hEle	元素句柄.
iColumn	列索引,-1代表不锁定.

XList_SetLockColumnRight()

void WINAPI XList_SetLockColumnRight	(	HELE	hEle,
		int	iColumn
	)

列表_置锁定列右侧 锁定列,设置右侧锁定列分界列索引

参数

hEle	元素句柄.
iColumn	列索引, -1代表不锁定. 暂时只支持锁定末尾列

XList_SetLockRowBottom()

void WINAPI XList_SetLockRowBottom	(	HELE	hEle,
		BOOL	bLock
	)

列表_置锁定行底部 设置是否锁定末尾行.

参数

hEle	元素句柄.
bLock	是否锁定.

XList_SetLockRowBottomOverlap()

void WINAPI XList_SetLockRowBottomOverlap	(	HELE	hEle,
		BOOL	bOverlap
	)

@列表_置锁定行底部重叠

参数

hEle	元素句柄
bOverlap	是否重叠

XList_SetRowHeight()

void WINAPI XList_SetRowHeight	(	HELE	hEle,
		int	iRow,
		int	nHeight,
		int	nSelHeight
	)

列表_置行高度 设置行高度.

参数

hEle	元素句柄.
iRow	行索引
nHeight	高度.
nSelHeight	选中时高度.

XList_SetRowHeightDefault()

void WINAPI XList_SetRowHeightDefault	(	HELE	hEle,
		int	nHeight,
		int	nSelHeight
	)

列表_置行默认高度 设置行默认高度.

参数

hEle	元素句柄.
nHeight	高度.
nSelHeight	选中时高度.

XList_SetRowSpace()

void WINAPI XList_SetRowSpace	(	HELE	hEle,
		int	nSpace
	)

列表_置行间距 设置行间距.

参数

hEle	元素句柄.
nSpace	行间距大小.

XList_SetSelectAll()

void WINAPI XList_SetSelectAll

(

HELE

hEle

)

列表_置选择全部 选择全部行.

参数

hEle

元素句柄.

XList_SetSelectRow()

BOOL WINAPI XList_SetSelectRow	(	HELE	hEle,
		int	iRow
	)

列表_置选择行 设置选择行.

参数

hEle	元素句柄.
iRow	行索引.

返回

成功返回TRUE否则返回FALSE.

XList_SetSort()

void WINAPI XList_SetSort	(	HELE	hEle,
		int	iColumn,
		int	iColumnAdapter,
		BOOL	bEnable
	)

列表_置排序 设置排序属性.

参数

hEle	元素句柄.
iColumn	列索引.
iColumnAdapter	需要排序的数据在数据适配器中的列索引.
bEnable	是否启用排序功能.

XList_SetSplitLineColor()

void WINAPI XList_SetSplitLineColor	(	HELE	hEle,
		COLORREF	color
	)

@列表_置分割线颜色

参数

hEle	元素句柄
color	颜色值, 请使用宏: RGBA()

XList_SetVirtualRowCount()

void WINAPI XList_SetVirtualRowCount	(	HELE	hEle,
		int	nRowCount
	)

@列表_置虚表行数

参数

hEle	元素句柄
nRowCount	行数

XList_VisibleRow()

void WINAPI XList_VisibleRow	(	HELE	hEle,
		int	iRow
	)

列表_显示指定行 滚动视图让指定行可见

参数

hEle	元素句柄.
iRow	行索引.