win.ui.ctrl.pick 库模块帮助文档

win.ui.ctrl 成员列表 #

win.ui.ctrl.pick #

服于创建取色器的窗口类,
可用于创建独立窗口,也可以作为控件类使用。

取色放大镜使用技巧:
取色时取的是放大镜十字准星右下角的那个像素。
取色时按住Ctrl键放大镜不动且图像不变,
按住Shift键放大镜不动但图像随鼠标指向改变,
同时按住Ctrl+Shift键等价于按Ctrl键

win.ui.ctrl.pick() #

创建取色器,
可选使用参数@1指定父窗口,可选用参数@2自定义创建窗口的参数,
可使用setColor函数修改颜色值,参数指定颜色值,
取色器颜色改变时会触发onColorChange函数,
该回调函数唯一的参数即为当前变更后的颜色

返回对象:winUiCtrlPickObject

winUiCtrlPickObject 成员列表 #

winUiCtrlPickObject.bgcolor #

背景颜色

winUiCtrlPickObject.bottom #

底部坐标

winUiCtrlPickObject.center(目标窗口句柄) #

居中窗口,并调整以保证显示在可见范围内
目标窗口句柄如果为空则取父窗口或所有者窗口,为0表示桌面

winUiCtrlPickObject.close() #

关闭窗口

winUiCtrlPickObject.doModal(/请指定所有者窗口\n可省略此参数/) #

弹出模态对话框

winUiCtrlPickObject.getClientRect() #

窗口客户区块位置(::RECT结构体)

返回对象:rectObject

winUiCtrlPickObject.getHsb() #

返回当前H,S,V颜色分量

winUiCtrlPickObject.getLab() #

返回当前H,S,B颜色分量

winUiCtrlPickObject.getPos() #

返回相对父窗口客户区的坐标,宽,高,
参数为true返回屏幕坐标,宽,高,
x,y,cx,cy=win.getPos(hwnd)

winUiCtrlPickObject.getRect() #

窗口区块位置(::RECT结构体)

返回对象:rectObject

winUiCtrlPickObject.getRect(true) #

窗口屏幕区块位置(::RECT结构体)

winUiCtrlPickObject.getRgba() #

返回当前R,G,B,A颜色分量

winUiCtrlPickObject.height #

高度

winUiCtrlPickObject.hwnd #

窗口句柄

winUiCtrlPickObject.onColorChange #

winUiCtrlPickObject.onColorChange = function(argb){
    /*调色器当前颜色改变时触发此事件,  
回调参数为ARGB格式颜色数值*/
}

winUiCtrlPickObject.onDropFiles #

winUiCtrlPickObject.onDropFiles = function(files){  
    /*接受系统拖放,files是拖放的所有文件路径名数组*/  
}

winUiCtrlPickObject.onInitDialog #

winUiCtrlPickObject.onInitDialog = function(hwnd,message,wParam,lParam){  
    winUiCtrlPickObject.center()/*模态对话框初始化完成触发该函数*/  
}

winUiCtrlPickObject.openColorTable() #

打开color.table支持的色表,
色表是由多个色卡信息组成的数组,
每个色卡由颜色中文名、英文名、RGB格式颜色数值三个元素组成

winUiCtrlPickObject.orphanWindow(transparent,hwndBuddy) #

创建悬浮窗口,
悬浮窗口仍然显示在原来的位置,
可选参数 @transparent 如果为 true 则转换为分层透明窗口,
可选利用 @buddy 参数将只有句柄的窗口托管在悬浮窗口之上实现相同的效果,
伙伴窗口总是会保持在悬浮窗口前面，并保持相同的大小、位置

winUiCtrlPickObject.redraw() #

刷新

winUiCtrlPickObject.right #

右侧坐标

winUiCtrlPickObject.setColor(ARGB颜色数值) #

修改当前颜色

winUiCtrlPickObject.setColor(RGB颜色数值,true) #

修改当前颜色

winUiCtrlPickObject.setPos(x坐标,y坐标,宽,高,插入位置,参数) #

调整窗口位置或排序,所有参数可选
同时指定x,y坐标则移动位置
同时指定宽高则改变大小
指定插入位置(句柄或_HWND前缀常量)则调整Z序

winUiCtrlPickObject.setRect(rc) #

设置窗口区块位置(::RECT结构体)

winUiCtrlPickObject.setRect(rc,true) #

设置窗口屏幕区块位置(::RECT结构体)

winUiCtrlPickObject.setRedraw(false) #

禁止重绘

winUiCtrlPickObject.setRedraw(true) #

恢复重绘

winUiCtrlPickObject.show #

显示窗口，并指定显示参数

winUiCtrlPickObject.show() #

显示窗口

winUiCtrlPickObject.show(false) #

隐藏窗口

winUiCtrlPickObject.show(true) #