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)