全局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字符串指针.
inLenpIn字符数量.
pOut指向接收转换后的Unicode字符串缓冲区指针.
outLenpOut缓冲区大小,字符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.
nIDID值.
返回
成功返回句柄,否则返回NULL.

◆ XC_GetObjectByIDName()

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

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

参数
hWindow所属窗口句柄,如果不属于任何窗口填NULL.
pNameID名称.
返回
成功返回句柄,否则返回NULL.

◆ XC_GetObjectByName()

HXCGUI WINAPI XC_GetObjectByName ( const wchar_t *  pName)

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

参数
pNamename名称.
返回
成功返回句柄,否则返回NULL.

◆ XC_GetObjectByUID()

HXCGUI WINAPI XC_GetObjectByUID ( int  nUID)

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

参数
nUIDUID值.
返回
成功返回句柄,否则返回NULL.

◆ XC_GetObjectByUIDName()

HXCGUI WINAPI XC_GetObjectByUIDName ( const wchar_t *  pName)

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

参数
pNameUID名称.
返回
成功返回句柄,否则返回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结构体.

参数
pFontLOGFONTW结构体指针.
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()

参数
pDllFileNameDLL文件名
返回
返回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父窗口句柄
XCStyleGUI库窗口样式,样式请参见宏定义 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字符串指针.
inLenpIn字符数量.
pOut指向接收转换后的Ansi字符串缓冲区指针.
outLenpOut缓冲区大小,字节单位.
返回
如果成功,返回写入接收缓冲区字节数量.

◆ XC_utf8toa()

const char *WINAPI XC_utf8toa ( const char *  pUtf8)

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

参数
pUtf8utf8字符串指针.
返回
返回结果.

◆ 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, 使用共享缓存,不需要释放.

参数
pUtf8utf8字符串指针.
lengthutf8字符串长度.
返回
返回结果.

◆ 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父窗口句柄
XCStyleGUI库窗口样式,样式请参见宏定义 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父窗口句柄
XCStyleGUI库窗口样式,样式请参见宏定义 window_style_
返回
返回窗口句柄, 然后调用 XModalWnd_DoModal() 显示, 根据 XModalWnd_DoModal() 返回值可判断用户点了哪个按钮退出

◆ XRunXCGUI()

void WINAPI XRunXCGUI ( )

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

返回
无返回