全局API

模块
	D2D支持
	炫彩扩展模块开发接口

函数
BOOL WINAPI	XInitXCGUI (BOOL bD2D)
	炫彩_初始化 初始化界面库. 更多...
void WINAPI	XRunXCGUI ()
	炫彩_运行 运行消息循环,当炫彩窗口数量为0时退出. 更多...
void WINAPI	XExitXCGUI ()
	炫彩_退出 退出界面库释放资源. 不可在dllmain()中卸载, 否则会死锁 更多...
void WINAPI	XC_PostQuitMessage (int nExitCode)
	炫彩_PostQuitMessage 发送WM_QUIT消息退出消息循环,详情参见系统API PostQuitMessage(). 更多...
void WINAPI	XC_SetWindowIcon (HIMAGE hImage)
	@炫彩_置窗口图标 全局窗口图标, 所有未设置图标的窗口,都将使用此默认图标 更多...
int WINAPI	XC_UnicodeToAnsi (const wchar_t *pIn, int inLen, __out char *pOut, int outLen)
	炫彩_U2A Unicode转换Ansi编码, 更多...
int WINAPI	XC_AnsiToUnicode (const char *pIn, int inLen, __out wchar_t *pOut, int outLen)
	炫彩_A2U Ansi转换Unicode编码, 更多...
LRESULT WINAPI	XC_SendMessage (HWINDOW hWindow, UINT msg, WPARAM wParam, LPARAM lParam)
	@anchor 炫彩_发送窗口消息 更多...
BOOL WINAPI	XC_PostMessage (HWINDOW hWindow, UINT msg, WPARAM wParam, LPARAM lParam)
	@anchor 炫彩_投递窗口消息 更多...
vint WINAPI	XC_CallUiThread (funCallUiThread pCall, vint data)
	@炫彩_调用界面线程 调用UI线程, 设置回调函数,在回调函数里操作UI,通过SendMessage()实现,阻塞模式 更多...
const char *WINAPI	XC_itoa (int nValue)
	炫彩_整数到文本A 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240. 更多...
const wchar_t *WINAPI	XC_itow (int nValue)
	炫彩_整数到文本W 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放. 更多...
const char *WINAPI	XC_ftoa (float fValue)
	炫彩_浮点数到文本A 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放. 更多...
const wchar_t *WINAPI	XC_ftow (float fValue)
	炫彩_浮点数到文本W 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放. 更多...
const wchar_t *WINAPI	XC_atow (const char *pValue)
	炫彩_A2W 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放. 更多...
const char *WINAPI	XC_wtoa (const wchar_t *pValue)
	炫彩_W2A 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放. 更多...
const wchar_t *WINAPI	XC_utf8tow (const char *pUtf8)
	炫彩_UTF8到文本W 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放. 更多...
const wchar_t *WINAPI	XC_utf8towEx (const char *pUtf8, int length)
	炫彩_UTF8到文本W扩展 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放. 更多...
const char *WINAPI	XC_utf8toa (const char *pUtf8)
	炫彩_UTF8到文本A 转换函数, 返回结果最大长度10240, 使用共享缓存,不需要释放. 更多...
const char *WINAPI	XC_atoutf8 (const char *pValue)
	炫彩_文本A到UTF8 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放. 更多...
const char *WINAPI	XC_wtoutf8 (const wchar_t *pValue)
	炫彩_文本W到UTF8 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240,, 使用共享缓存,不需要释放. 更多...
const char *WINAPI	XC_wtoutf8Ex (const wchar_t *pValue, int length)
	炫彩_文本W到UTF8扩展 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放. 更多...
void WINAPI	XC_DebugToFileInfo (const char *pInfo)
	炫彩_输出调试信息到文件 打印调试信息到文件xcgui_debug.txt. 更多...
BOOL WINAPI	XC_IsHELE (HXCGUI hEle)
	炫彩_是否元素 判断是否为元素句柄. 更多...
BOOL WINAPI	XC_IsHWINDOW (HXCGUI hWindow)
	炫彩_是否窗口 判断是否为窗口句柄. 更多...
BOOL WINAPI	XC_IsShape (HXCGUI hShape)
	炫彩_是否形状对象 判断是否为形状对象. 更多...
BOOL WINAPI	XC_IsHXCGUI (HXCGUI hXCGUI, XC_OBJECT_TYPE nType)
	炫彩_是否句柄包含类型 判断句柄是否拥有该类型. 更多...
HWINDOW WINAPI	XC_hWindowFromHWnd (HWND hWnd)
	炫彩_转换HWND到HWINDOW 通过窗口HWND句柄获取HWINDOW句柄. 更多...
BOOL WINAPI	XC_SetActivateTopWindow ()
	炫彩_激活窗口 激活当前进程最上层窗口 更多...
BOOL WINAPI	XC_SetProperty (HXCGUI hXCGUI, const wchar_t *pName, const wchar_t *pValue)
	炫彩_置属性 设置对象属性. 更多...
const wchar_t *WINAPI	XC_GetProperty (HXCGUI hXCGUI, const wchar_t *pName)
	炫彩_取属性 获取对象属性. 更多...
BOOL WINAPI	XC_RegisterWindowClassName (const wchar_t *pClassName)
	@炫彩_注册窗口类名 注册窗口类名 当炫彩退出时, 会自动注销类名; 假如类名没有注销, DLL卸载后, 类名所指向的窗口过程地址失效, 再次使用此类名, 造成程序崩溃 更多...
BOOL WINAPI	XC_IsSViewExtend (HELE hEle)
	炫彩_是否滚动视图扩展元素 判断元素是否从滚动视图元素扩展的新元素,包含滚动视图元素. 更多...
XC_OBJECT_TYPE WINAPI	XC_GetObjectType (HXCGUI hXCGUI)
	炫彩_取对象类型 获取句柄类型. 更多...
HXCGUI WINAPI	XC_GetObjectByID (HWINDOW hWindow, int nID)
	炫彩_取对象从ID 通过ID获取对象句柄,不包括窗口对象. 更多...
HXCGUI WINAPI	XC_GetObjectByIDName (HWINDOW hWindow, const wchar_t *pName)
	炫彩_取对象从ID名称 通过ID名称获取对象句柄. 更多...
HXCGUI WINAPI	XC_GetObjectByUID (int nUID)
	炫彩_取对象从UID 通过UID获取对象句柄,不包括窗口对象. 更多...
HXCGUI WINAPI	XC_GetObjectByUIDName (const wchar_t *pName)
	炫彩_取对象从UID名称 通过UID名称获取对象句柄. 更多...
HXCGUI WINAPI	XC_GetObjectByName (const wchar_t *pName)
	炫彩_取对象从名称 通过name获取对象句柄. 更多...
int WINAPI	XC_GetHandleCount ()
	@炫彩_取句柄总数 获取当前所使用的句柄总数量 更多...
void WINAPI	XC_SetPaintFrequency (UINT nMilliseconds)
	炫彩_置绘制频率 设置UI的最小重绘频率. 更多...
void WINAPI	XC_SetTextRenderingHint (int nType)
	炫彩_置文本炫彩质量 设置文本渲染质量GDI+. 更多...
void WINAPI	XC_SetD2dTextRenderingMode (XC_DWRITE_RENDERING_MODE mode)
	@炫彩_置D2D文本渲染模式 更多...
void WINAPI	XC_EnableGdiDrawText (BOOL bEnable)
	@炫彩_启用GDI绘制文本 将影响到以下函数: XDraw_TextOut XDraw_TextOutEx XDraw_TextOutA 更多...
void WINAPI	XC_EnableAutoRedrawUI (BOOL bEnable)
	@炫彩_启用自动重绘UI 当修改UI后将自动调用重绘函数更新UI, 例如按钮: XBtn_SetText(), 将自动调用 XEle_Redraw() 更新UI 更多...
BOOL WINAPI	XC_RectInRect (RECT *pRect1, RECT *pRect2)
	炫彩_是否矩形相交 判断两个矩形是否相交及重叠. 更多...
void WINAPI	XC_CombineRect (RECT *pDest, RECT *pSrc1, RECT *pSrc2)
	炫彩_组合矩形 组合两个矩形区域. 更多...
void WINAPI	XC_ShowLayoutFrame (BOOL bShow)
	炫彩_显示布局边界 显示布局对象边界. 更多...
void WINAPI	XC_ShowSvgFrame (BOOL bShow)
	@炫彩_显示边界 辅助功能 更多...
void WINAPI	XC_EnableDebugFile (BOOL bEnable)
	炫彩_启用debug文件 启用debug文件. 更多...
void WINAPI	XC_EnableResMonitor (BOOL bEnable)
	炫彩_启用资源监视器 启用资源监视器. 更多...
void WINAPI	XC_SetLayoutFrameColor (COLORREF color)
	炫彩_置布局边界颜色 设置布局边框颜色. 更多...
void WINAPI	XC_EnableErrorMessageBox (BOOL bEnable)
	炫彩_启用错误弹窗 启用错误弹出,通过该接口可以设置遇到严重错误时不弹出消息提示框. 更多...
BOOL WINAPI	XC_EnableDPI (BOOL bEnable)
	@炫彩_启用DPI 启用DPI几种方式: 1.在项目属性中启用DPI, 2.使用清单文件, 3.调用此函数, 4.自己调用DPI函数, 参考MSDN: https://learn.microsoft.com/zh-cn/windows/win32/hidpi/setting-the-default-dpi-awareness-for-a-process 更多...
void WINAPI	XC_EnableAutoDPI (BOOL bEnable)
	@炫彩_启用自动DPI 默认禁用; 当启用后, 创建窗口时自动检测DPI调整UI缩放, 处理DPI改变消息; 禁用后,当DPI改变,需要手动设置窗口DPI 更多...
void WINAPI	XC_EnableAutoExitApp (BOOL bEnable)
	炫彩_启用自动退出程序 启动或禁用自动退出程序,当检测到所有用户创建的窗口都关闭时,自动退出程序; 可调用 XC_PostQuitMessage() 手动退出程序 更多...
BOOL WINAPI	XC_IsEnableD2D ()
	@炫彩_是否启用D2D 判断是否启用了D2D 更多...
void WINAPI	XC_GetTextSize (const wchar_t *pString, int length, HFONTX hFontX, __out SIZE *pOutSize)
	炫彩_取文本绘制大小 获取文本绘制大小. 更多...
void WINAPI	XC_GetTextShowSize (const wchar_t *pString, int length, HFONTX hFontX, __out SIZE *pOutSize)
	炫彩_取文本显示大小 获取文本显示大小. 更多...
void WINAPI	XC_GetTextShowSizeEx (const wchar_t *pString, int length, HFONTX hFontX, int nTextAlign, __out SIZE *pOutSize)
	@anchor 炫彩_取文本显示大小扩展 更多...
void WINAPI	XC_GetTextShowRect (const wchar_t *pString, int length, HFONTX hFontX, int nTextAlign, int width, __out SIZE *pOutSize)
	@炫彩_取文本显示矩形 更多...
HFONTX WINAPI	XC_GetDefaultFont ()
	炫彩_取默认字体 获取默认字体. 更多...
void WINAPI	XC_SetDefaultFont (HFONTX hFontX)
	炫彩_置默认字体 设置默认字体. 更多...
void WINAPI	XC_AddFileSearchPath (const wchar_t *pPath)
	炫彩_添加搜索路径 添加文件搜索路径, 默认路为exe目录和程序当前运行目录. 更多...
void WINAPI	XC_InitFont (LOGFONTW *pFont, wchar_t *pName, int size, BOOL bBold, BOOL bItalic, BOOL bUnderline, BOOL bStrikeOut)
	炫彩_初始化字体 初始化LOGFONTW结构体. 更多...
void *WINAPI	XC_Malloc (int size)
	炫彩_分配内存 在UI库中申请内存. 更多...
void WINAPI	XC_Free (void *p)
	炫彩_释放内存 在UI库中释放内存. 更多...
void WINAPI	XC_Alert (const wchar_t *pTitle, const wchar_t *pText)
	炫彩_弹框 弹出提示框. 更多...
HINSTANCE WINAPI	XC_Sys_ShellExecute (HWND hwnd, const wchar_t *lpOperation, const wchar_t *lpFile, const wchar_t *lpParameters, const wchar_t *lpDirectory, int nShowCmd)
	炫彩_系统_ShellExecute 参见系统API ShellExecute() 更多...
HMODULE WINAPI	XC_LoadLibrary (const wchar_t *lpFileName)
	炫彩_载入动态库 系统API LoadLibrary 更多...
FARPROC WINAPI	XC_GetProcAddress (HMODULE hModule, const char *lpProcName)
	炫彩_取动态库中函数地址 系统API GetProcAddress 更多...
BOOL WINAPI	XC_FreeLibrary (HMODULE hModule)
	炫彩_释放动态库 系统API FreeLibrary 更多...
HMODULE WINAPI	XC_LoadDll (const wchar_t *pDllFileName)
	炫彩_加载DLL 加载指定DLL,并且调用DLL中函数LoadDll(), DLL中导出函数格式: int WINAPI LoadDll() 更多...
int WINAPI	XC_MessageBox (const wchar_t *pTitle, const wchar_t *pText, int nFlags, HWND hWndParent, int XCStyle)
	@炫彩_消息框 此窗口是一个模态窗口 更多...
HWINDOW WINAPI	XMsg_Create (const wchar_t *pTitle, const wchar_t *pText, int nFlags, HWND hWndParent, int XCStyle)
	@炫彩消息框_创建 弹出窗口调用 XModalWnd_DoModal() , 此窗口是一个模态窗口, 更多...
HWINDOW WINAPI	XMsg_CreateEx (DWORD dwExStyle, DWORD dwStyle, const wchar_t *lpClassName, const wchar_t *pTitle, const wchar_t *pText, int nFlags, HWND hWndParent, int XCStyle)
	@炫彩消息框_创建扩展 此窗口是一个模态窗口 更多...

详细描述

函数说明

XC_AddFileSearchPath()

void WINAPI XC_AddFileSearchPath

(

const wchar_t *

pPath

)

炫彩_添加搜索路径 添加文件搜索路径, 默认路为exe目录和程序当前运行目录.

参数

pPath

文件夹, 目录, 路径.

XC_Alert()

void WINAPI XC_Alert	(	const wchar_t *	pTitle,
		const wchar_t *	pText
	)

炫彩_弹框 弹出提示框.

参数

pTitle	提示框标题
pText	提示内容

XC_AnsiToUnicode()

int WINAPI XC_AnsiToUnicode	(	const char *	pIn,
		int	inLen,
		__out wchar_t *	pOut,
		int	outLen
	)

炫彩_A2U Ansi转换Unicode编码,

参数

pIn	指向待转换的Ansi字符串指针.
inLen	pIn字符数量.
pOut	指向接收转换后的Unicode字符串缓冲区指针.
outLen	pOut缓冲区大小,字符wchar_t单位.

返回

如果成功,返回写入接收缓冲区字符wchar_t数量.

XC_atoutf8()

const char *WINAPI XC_atoutf8

(

const char *

pValue

)

炫彩_文本A到UTF8 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放.

参数

pValue

参数.

返回

返回结果.

XC_atow()

const wchar_t *WINAPI XC_atow

(

const char *

pValue

)

炫彩_A2W 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放.

参数

pValue

参数.

返回

返回结果.

XC_CallUiThread()

vint WINAPI XC_CallUiThread	(	funCallUiThread	pCall,
		vint	data
	)

@炫彩_调用界面线程 调用UI线程, 设置回调函数,在回调函数里操作UI,通过SendMessage()实现,阻塞模式

参数

pCall	回调函数 funCallUiThread ; vint (CALLBACK *funCallUiThread)(vint data)
data	用户自定义数据

返回

回调函数返回值

XC_CombineRect()

void WINAPI XC_CombineRect	(	RECT *	pDest,
		RECT *	pSrc1,
		RECT *	pSrc2
	)

炫彩_组合矩形 组合两个矩形区域.

参数

pDest	新的矩形区域.
pSrc1	源矩形1.
pSrc2	源矩形2.

XC_DebugToFileInfo()

void WINAPI XC_DebugToFileInfo

(

const char *

pInfo

)

炫彩_输出调试信息到文件 打印调试信息到文件xcgui_debug.txt.

参数

pInfo

XC_EnableAutoDPI()

void WINAPI XC_EnableAutoDPI

(

BOOL

bEnable

)

@炫彩_启用自动DPI 默认禁用; 当启用后, 创建窗口时自动检测DPI调整UI缩放, 处理DPI改变消息; 禁用后,当DPI改变,需要手动设置窗口DPI

参数

bEnable

是否启用

XC_EnableAutoExitApp()

void WINAPI XC_EnableAutoExitApp

(

BOOL

bEnable

)

炫彩_启用自动退出程序 启动或禁用自动退出程序,当检测到所有用户创建的窗口都关闭时,自动退出程序; 可调用 XC_PostQuitMessage() 手动退出程序

参数

bEnable

是否启用.

XC_EnableAutoRedrawUI()

void WINAPI XC_EnableAutoRedrawUI

(

BOOL

bEnable

)

@炫彩_启用自动重绘UI 当修改UI后将自动调用重绘函数更新UI, 例如按钮: XBtn_SetText(), 将自动调用 XEle_Redraw() 更新UI

参数

bEnable

是否启用

XC_EnableDebugFile()

void WINAPI XC_EnableDebugFile

(

BOOL

bEnable

)

炫彩_启用debug文件 启用debug文件.

参数

bEnable

是否启用.

XC_EnableDPI()

BOOL WINAPI XC_EnableDPI

(

BOOL

bEnable

)

@炫彩_启用DPI 启用DPI几种方式: 1.在项目属性中启用DPI, 2.使用清单文件, 3.调用此函数, 4.自己调用DPI函数, 参考MSDN: https://learn.microsoft.com/zh-cn/windows/win32/hidpi/setting-the-default-dpi-awareness-for-a-process

参数

bEnable

是否启用.

返回

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

XC_EnableErrorMessageBox()

void WINAPI XC_EnableErrorMessageBox

(

BOOL

bEnable

)

炫彩_启用错误弹窗 启用错误弹出,通过该接口可以设置遇到严重错误时不弹出消息提示框.

参数

bEnable

是否启用.

XC_EnableGdiDrawText()

void WINAPI XC_EnableGdiDrawText

(

BOOL

bEnable

)

@炫彩_启用GDI绘制文本 将影响到以下函数: XDraw_TextOut XDraw_TextOutEx XDraw_TextOutA

参数

bEnable

是否启用

XC_EnableResMonitor()

void WINAPI XC_EnableResMonitor

(

BOOL

bEnable

)

炫彩_启用资源监视器 启用资源监视器.

参数

bEnable

是否启用.

XC_Free()

void WINAPI XC_Free

(

void *

p

)

炫彩_释放内存 在UI库中释放内存.

参数

p

内存首地址.

XC_FreeLibrary()

BOOL WINAPI XC_FreeLibrary

(

HMODULE

hModule

)

炫彩_释放动态库 系统API FreeLibrary

参数

hModule

动态库模块句柄

返回

成功返回TRUE,否则返回FALSE

XC_ftoa()

const char *WINAPI XC_ftoa

(

float

fValue

)

炫彩_浮点数到文本A 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放.

参数

fValue

参数.

返回

返回结果.

XC_ftow()

const wchar_t *WINAPI XC_ftow

(

float

fValue

)

炫彩_浮点数到文本W 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放.

参数

fValue

参数.

返回

返回结果.

XC_GetDefaultFont()

HFONTX WINAPI XC_GetDefaultFont

(

)

炫彩_取默认字体 获取默认字体.

返回

返回默认字体句柄.

XC_GetHandleCount()

int WINAPI XC_GetHandleCount

(

)

@炫彩_取句柄总数 获取当前所使用的句柄总数量

返回

返回当前所使用的句柄总数量

XC_GetObjectByID()

HXCGUI WINAPI XC_GetObjectByID	(	HWINDOW	hWindow,
		int	nID
	)

炫彩_取对象从ID 通过ID获取对象句柄,不包括窗口对象.

参数

hWindow	所属窗口句柄,如果不属于任何窗口填NULL.
nID	ID值.

返回

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

XC_GetObjectByIDName()

HXCGUI WINAPI XC_GetObjectByIDName	(	HWINDOW	hWindow,
		const wchar_t *	pName
	)

炫彩_取对象从ID名称 通过ID名称获取对象句柄.

参数

hWindow	所属窗口句柄,如果不属于任何窗口填NULL.
pName	ID名称.

返回

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

XC_GetObjectByName()

HXCGUI WINAPI XC_GetObjectByName

(

const wchar_t *

pName

)

炫彩_取对象从名称 通过name获取对象句柄.

参数

pName

name名称.

返回

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

XC_GetObjectByUID()

HXCGUI WINAPI XC_GetObjectByUID

(

int

nUID

)

炫彩_取对象从UID 通过UID获取对象句柄,不包括窗口对象.

参数

nUID

UID值.

返回

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

XC_GetObjectByUIDName()

HXCGUI WINAPI XC_GetObjectByUIDName

(

const wchar_t *

pName

)

炫彩_取对象从UID名称 通过UID名称获取对象句柄.

参数

pName

UID名称.

返回

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

XC_GetObjectType()

XC_OBJECT_TYPE WINAPI XC_GetObjectType

(

HXCGUI

hXCGUI

)

炫彩_取对象类型 获取句柄类型.

参数

hXCGUI

炫彩对象句柄.

返回

返回句柄类型.

XC_GetProcAddress()

FARPROC WINAPI XC_GetProcAddress	(	HMODULE	hModule,
		const char *	lpProcName
	)

炫彩_取动态库中函数地址 系统API GetProcAddress

参数

hModule	动态库模块句柄
lpProcName	函数名

返回

返回函数地址

XC_GetProperty()

const wchar_t *WINAPI XC_GetProperty	(	HXCGUI	hXCGUI,
		const wchar_t *	pName
	)

炫彩_取属性 获取对象属性.

参数

hXCGUI	对象句柄.
pName	属性名.

返回

返回属性值, 如果没有返回空.

XC_GetTextShowRect()

void WINAPI XC_GetTextShowRect	(	const wchar_t *	pString,
		int	length,
		HFONTX	hFontX,
		int	nTextAlign,
		int	width,
		__out SIZE *	pOutSize
	)

@炫彩_取文本显示矩形

参数

pString	字符串.
length	字符串长度
hFontX	字体.
nTextAlign	文本对齐 textFormatFlag_
width	最大宽度
pOutSize	接收返回大小.

XC_GetTextShowSize()

void WINAPI XC_GetTextShowSize	(	const wchar_t *	pString,
		int	length,
		HFONTX	hFontX,
		__out SIZE *	pOutSize
	)

炫彩_取文本显示大小 获取文本显示大小.

参数

pString	字符串.
length	字符串长度
hFontX	字体.
pOutSize	接收返回大小.

XC_GetTextShowSizeEx()

void WINAPI XC_GetTextShowSizeEx	(	const wchar_t *	pString,
		int	length,
		HFONTX	hFontX,
		int	nTextAlign,
		__out SIZE *	pOutSize
	)

@anchor 炫彩_取文本显示大小扩展

参数

pString	字符串.
length	字符串长度
hFontX	字体.
nTextAlign	文本对齐方式 textFormatFlag_
pOutSize	接收返回大小.

XC_GetTextSize()

void WINAPI XC_GetTextSize	(	const wchar_t *	pString,
		int	length,
		HFONTX	hFontX,
		__out SIZE *	pOutSize
	)

炫彩_取文本绘制大小 获取文本绘制大小.

参数

pString	字符串.
length	字符串长度
hFontX	字体.
pOutSize	接收返回大小.

XC_hWindowFromHWnd()

HWINDOW WINAPI XC_hWindowFromHWnd

(

HWND

hWnd

)

炫彩_转换HWND到HWINDOW 通过窗口HWND句柄获取HWINDOW句柄.

参数

hWnd

窗口HWND句柄.

返回

返回HWINDOW句柄.

XC_InitFont()

void WINAPI XC_InitFont	(	LOGFONTW *	pFont,
		wchar_t *	pName,
		int	size,
		BOOL	bBold,
		BOOL	bItalic,
		BOOL	bUnderline,
		BOOL	bStrikeOut
	)

炫彩_初始化字体 初始化LOGFONTW结构体.

参数

pFont	LOGFONTW结构体指针.
pName	字体名称.
size	字体大小.
bBold	是否为粗体.
bItalic	是否为斜体.
bUnderline	是否有下划线.
bStrikeOut	是否有删除线.

XC_IsEnableD2D()

BOOL WINAPI XC_IsEnableD2D

(

)

@炫彩_是否启用D2D 判断是否启用了D2D

返回

如果启用D2D返回TRUE,否则相反

XC_IsHELE()

BOOL WINAPI XC_IsHELE

(

HXCGUI

hEle

)

炫彩_是否元素 判断是否为元素句柄.

参数

hEle

元素句柄.

返回

成功返回TRUE,否则相反.

XC_IsHWINDOW()

BOOL WINAPI XC_IsHWINDOW

(

HXCGUI

hWindow

)

炫彩_是否窗口 判断是否为窗口句柄.

参数

hWindow

窗口句柄.

返回

成功返回TRUE,否则相反.

XC_IsHXCGUI()

BOOL WINAPI XC_IsHXCGUI	(	HXCGUI	hXCGUI,
		XC_OBJECT_TYPE	nType
	)

炫彩_是否句柄包含类型 判断句柄是否拥有该类型.

参数

hXCGUI	炫彩句柄.
nType	句柄类型.

返回

成功返回TRUE否则返回FALSE.

XC_IsShape()

BOOL WINAPI XC_IsShape

(

HXCGUI

hShape

)

炫彩_是否形状对象 判断是否为形状对象.

参数

hShape

形状对象句柄.

返回

成功返回TRUE否则返回FALSE.

XC_IsSViewExtend()

BOOL WINAPI XC_IsSViewExtend

(

HELE

hEle

)

炫彩_是否滚动视图扩展元素 判断元素是否从滚动视图元素扩展的新元素,包含滚动视图元素.

参数

hEle

元素句柄.

返回

如果成功返回TRUE,否则相反.

XC_itoa()

const char *WINAPI XC_itoa

(

int

nValue

)

炫彩_整数到文本A 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240.

参数

nValue

参数.

返回

返回结果.

XC_itow()

const wchar_t *WINAPI XC_itow

(

int

nValue

)

炫彩_整数到文本W 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放.

参数

nValue

参数.

返回

返回结果.

XC_LoadDll()

HMODULE WINAPI XC_LoadDll

(

const wchar_t *

pDllFileName

)

炫彩_加载DLL 加载指定DLL,并且调用DLL中函数LoadDll(), DLL中导出函数格式: int WINAPI LoadDll()

参数

pDllFileName

DLL文件名

返回

返回DLL模块句柄

XC_LoadLibrary()

HMODULE WINAPI XC_LoadLibrary

(

const wchar_t *

lpFileName

)

炫彩_载入动态库 系统API LoadLibrary

参数

lpFileName

文件名

返回

返回动态库模块句柄

XC_Malloc()

void *WINAPI XC_Malloc

(

int

size

)

炫彩_分配内存 在UI库中申请内存.

参数

size

大小,字节为单位.

返回

内存首地址.

XC_MessageBox()

int WINAPI XC_MessageBox	(	const wchar_t *	pTitle,
		const wchar_t *	pText,
		int	nFlags,
		HWND	hWndParent,
		int	XCStyle
	)

@炫彩_消息框 此窗口是一个模态窗口

参数

pTitle	标题, 修改颜色通过 设置标题颜色
pText	内容文本, 修改颜色通过 设置窗口颜色
nFlags	标识 messageBox_flag_
hWndParent	父窗口句柄
XCStyle	GUI库窗口样式,样式请参见宏定义 window_style_

返回

messageBox_flag_ok:点击确定按钮退出, messageBox_flag_cancel:点击取消按钮退出, messageBox_flag_other:其他方式退出

XC_PostMessage()

BOOL WINAPI XC_PostMessage	(	HWINDOW	hWindow,
		UINT	msg,
		WPARAM	wParam,
		LPARAM	lParam
	)

@anchor 炫彩_投递窗口消息

参数

hWindow	窗口句柄
msg
wParam
lParam

返回

XC_PostQuitMessage()

void WINAPI XC_PostQuitMessage

(

int

nExitCode

)

炫彩_PostQuitMessage 发送WM_QUIT消息退出消息循环,详情参见系统API PostQuitMessage().

参数

nExitCode

退出码.

XC_RectInRect()

BOOL WINAPI XC_RectInRect	(	RECT *	pRect1,
		RECT *	pRect2
	)

炫彩_是否矩形相交 判断两个矩形是否相交及重叠.

参数

pRect1	矩形1.
pRect2	矩形2.

返回

如果两个矩形相交返回TRUE,否则相反.

XC_RegisterWindowClassName()

BOOL WINAPI XC_RegisterWindowClassName

(

const wchar_t *

pClassName

)

@炫彩_注册窗口类名 注册窗口类名 当炫彩退出时, 会自动注销类名; 假如类名没有注销, DLL卸载后, 类名所指向的窗口过程地址失效, 再次使用此类名, 造成程序崩溃

参数

pClassName

类名.

返回

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

XC_SendMessage()

LRESULT WINAPI XC_SendMessage	(	HWINDOW	hWindow,
		UINT	msg,
		WPARAM	wParam,
		LPARAM	lParam
	)

@anchor 炫彩_发送窗口消息

参数

hWindow	窗口句柄
msg
wParam
lParam

返回

成功返回TRUE,否则返回FALSE

XC_SetActivateTopWindow()

BOOL WINAPI XC_SetActivateTopWindow

(

)

炫彩_激活窗口 激活当前进程最上层窗口

返回

成功返回TRUE,否则返回FALSE

XC_SetD2dTextRenderingMode()

void WINAPI XC_SetD2dTextRenderingMode

(

XC_DWRITE_RENDERING_MODE

mode

)

@炫彩_置D2D文本渲染模式

参数

mode	渲染模式 XC_DWRITE_RENDERING_MODE

XC_SetDefaultFont()

void WINAPI XC_SetDefaultFont

(

HFONTX

hFontX

)

炫彩_置默认字体 设置默认字体.

参数

hFontX

炫彩字体句柄.

返回

成功返回TRUE否则返回FALSE.

XC_SetLayoutFrameColor()

void WINAPI XC_SetLayoutFrameColor

(

COLORREF

color

)

炫彩_置布局边界颜色 设置布局边框颜色.

参数

color

颜色值, 请使用宏: RGBA()

XC_SetPaintFrequency()

void WINAPI XC_SetPaintFrequency

(

UINT

nMilliseconds

)

炫彩_置绘制频率 设置UI的最小重绘频率.

参数

nMilliseconds

重绘最小时间间隔,单位毫秒.

XC_SetProperty()

BOOL WINAPI XC_SetProperty	(	HXCGUI	hXCGUI,
		const wchar_t *	pName,
		const wchar_t *	pValue
	)

炫彩_置属性 设置对象属性.

参数

hXCGUI	对象句柄.
pName	属性名.
pValue	属性值.

返回

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

XC_SetTextRenderingHint()

void WINAPI XC_SetTextRenderingHint

(

int

nType

)

炫彩_置文本炫彩质量 设置文本渲染质量GDI+.

参数

nType

参见GDI+ TextRenderingHint 定义.

XC_SetWindowIcon()

void WINAPI XC_SetWindowIcon

(

HIMAGE

hImage

)

@炫彩_置窗口图标 全局窗口图标, 所有未设置图标的窗口,都将使用此默认图标

参数

hImage

图标句柄

XC_ShowLayoutFrame()

void WINAPI XC_ShowLayoutFrame

(

BOOL

bShow

)

炫彩_显示布局边界 显示布局对象边界.

参数

bShow

是否显示.

XC_ShowSvgFrame()

void WINAPI XC_ShowSvgFrame

(

BOOL

bShow

)

@炫彩_显示边界 辅助功能

参数

bShow

是否显示

XC_Sys_ShellExecute()

HINSTANCE WINAPI XC_Sys_ShellExecute	(	HWND	hwnd,
		const wchar_t *	lpOperation,
		const wchar_t *	lpFile,
		const wchar_t *	lpParameters,
		const wchar_t *	lpDirectory,
		int	nShowCmd
	)

炫彩_系统_ShellExecute 参见系统API ShellExecute()

参数

hwnd
lpOperation
lpFile
lpParameters
lpDirectory
nShowCmd

返回

执行成功会返回应用程序句柄

XC_UnicodeToAnsi()

int WINAPI XC_UnicodeToAnsi	(	const wchar_t *	pIn,
		int	inLen,
		__out char *	pOut,
		int	outLen
	)

炫彩_U2A Unicode转换Ansi编码,

参数

pIn	指向待转换的Unicode字符串指针.
inLen	pIn字符数量.
pOut	指向接收转换后的Ansi字符串缓冲区指针.
outLen	pOut缓冲区大小,字节单位.

返回

如果成功,返回写入接收缓冲区字节数量.

XC_utf8toa()

const char *WINAPI XC_utf8toa

(

const char *

pUtf8

)

炫彩_UTF8到文本A 转换函数, 返回结果最大长度10240, 使用共享缓存,不需要释放.

参数

pUtf8

utf8字符串指针.

返回

返回结果.

XC_utf8tow()

const wchar_t *WINAPI XC_utf8tow

(

const char *

pUtf8

)

炫彩_UTF8到文本W 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放.

参数

pUtf8

参数.

返回

返回结果.

XC_utf8towEx()

const wchar_t *WINAPI XC_utf8towEx	(	const char *	pUtf8,
		int	length
	)

炫彩_UTF8到文本W扩展 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放.

参数

pUtf8	utf8字符串指针.
length	utf8字符串长度.

返回

返回结果.

XC_wtoa()

const char *WINAPI XC_wtoa

(

const wchar_t *

pValue

)

炫彩_W2A 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放.

参数

pValue

参数.

返回

返回结果.

XC_wtoutf8()

const char *WINAPI XC_wtoutf8

(

const wchar_t *

pValue

)

炫彩_文本W到UTF8 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240,, 使用共享缓存,不需要释放.

参数

pValue

字符串指针

返回

返回结果

XC_wtoutf8Ex()

const char *WINAPI XC_wtoutf8Ex	(	const wchar_t *	pValue,
		int	length
	)

炫彩_文本W到UTF8扩展 转换函数, 返回结果最大长度 TEXT_BUFFER_SIZE = 10240, 使用共享缓存,不需要释放.

参数

pValue	字符串指针
length	字符串长度

返回

返回结果

XExitXCGUI()

void WINAPI XExitXCGUI

(

)

炫彩_退出 退出界面库释放资源. 不可在dllmain()中卸载, 否则会死锁

返回

无返回

XInitXCGUI()

BOOL WINAPI XInitXCGUI

(

BOOL

bD2D

)

炫彩_初始化 初始化界面库.

参数

bD2D	是否启用D2D, 如果启用将使用D2D绘制图形,否则使用GDI+绘制图形

返回

成功返回TRUE否则返回FALSE.

XMsg_Create()

HWINDOW WINAPI XMsg_Create	(	const wchar_t *	pTitle,
		const wchar_t *	pText,
		int	nFlags,
		HWND	hWndParent,
		int	XCStyle
	)

@炫彩消息框_创建 弹出窗口调用 XModalWnd_DoModal() , 此窗口是一个模态窗口,

参数

pTitle	标题, 修改颜色通过 设置标题颜色
pText	内容文本, 修改颜色通过 设置窗口颜色
nFlags	标识 messageBox_flag_
hWndParent	父窗口句柄
XCStyle	GUI库窗口样式,样式请参见宏定义 window_style_

返回

返回窗口句柄, 根据 XModalWnd_DoModal() 返回值可判断用户点了哪个按钮退出

XMsg_CreateEx()

HWINDOW WINAPI XMsg_CreateEx	(	DWORD	dwExStyle,
		DWORD	dwStyle,
		const wchar_t *	lpClassName,
		const wchar_t *	pTitle,
		const wchar_t *	pText,
		int	nFlags,
		HWND	hWndParent,
		int	XCStyle
	)

@炫彩消息框_创建扩展 此窗口是一个模态窗口

参数

dwExStyle	窗口扩展样式
dwStyle	窗口样式
lpClassName	窗口类名
pTitle	标题, 修改颜色通过 设置标题颜色
pText	内容文本, 修改颜色通过 设置窗口颜色
nFlags	标识 messageBox_flag_
hWndParent	父窗口句柄
XCStyle	GUI库窗口样式,样式请参见宏定义 window_style_

返回

返回窗口句柄, 然后调用 XModalWnd_DoModal() 显示, 根据 XModalWnd_DoModal() 返回值可判断用户点了哪个按钮退出

XRunXCGUI()

void WINAPI XRunXCGUI

(

)

炫彩_运行 运行消息循环,当炫彩窗口数量为0时退出.

返回

无返回