# win.dlg.argbColor 库模块帮助文档
[范例源码](https://www.aardio.com/zh-cn/docs/examples/Windows/dialog/colorPicker.html)
## WinDlgArgbColorObject 成员列表 #
### WinDlgArgbColorObject.choose(initColor,gdiFormat) #
弹出选择颜色对话框。
可选使用参数 @initColor 指定最初选定的颜色。
如果将可选参数 @gdiFormat 指定为 true 则参数与返回值为 GDI 颜色格式（0xBBGGRR 格式数值）。
否则默认使用 GDI+ 颜色格式（用 0xAARRGGBB 格式数值）。
### WinDlgArgbColorObject.getHsb() #
返回当前 H,S,V 颜色分量
### WinDlgArgbColorObject.getLab() #
返回当前 H,S,B 颜色分量
### WinDlgArgbColorObject.getRgba() #
返回当前 R,G,B,A 颜色分量
### WinDlgArgbColorObject.lastSelectedColor #
最后获取的颜色，如果未修改初始颜色则此属性为 null 。
### WinDlgArgbColorObject.openColorTable() #
打开 color.table 支持的色表,
色表是由多个色卡信息组成的数组,
每个色卡由颜色中文名、英文名、RGB格式颜色数值三个元素组成
### WinDlgArgbColorObject.ready #
```aardio
WinDlgArgbColorObject.ready = function(){
WinDlgArgbColorObject.center()/*窗体准备就绪并即将显示或处理消息前调用此函数。
详细说明请参考 win.form 对象 ready 属性/方法说明。*/
}
```
### WinDlgArgbColorObject.setColor(argbColor) #
修改当前颜色。
参数 @argbColor 指定 0xAARRGGBB 格式颜色（GDI+ 格式）。
### WinDlgArgbColorObject.setColor(rgbColor,true) #
修改当前颜色。
参数 @argbColor 指定 0xBBGGRR 颜色格式（GDI 格式）。
## WinDlgArgbColorObject 事件列表 #
### WinDlgArgbColorObject.onColorChange #
```aardio
WinDlgArgbColorObject.onColorChange = function(argb){
/*调色器当前颜色改变时触发此事件，
回调参数 argb 为 ARGB 格式（0xAARRGGBB）颜色数值*/
}
```
## win.dlg 成员列表 #
### win.dlg.argbColor #
增强版取色与选色对话框。
支持 GDI+ 颜色格式（用 0xAARRGGBB 格式数值表示颜色）。
win.dlg.argbColor 继承自 win.ui.ctrl.pick 控件。
取色放大镜使用技巧:
取色时取的是放大镜十字准星右下角的那个像素。
取色时按住 `Ctrl` 键放大镜不动且图像不变,
按住 `Shift` 键放大镜不动但图像随鼠标指向改变,
同时按住 `Ctrl+Shift` 键等价于按 `Ctrl` 键。
### win.dlg.argbColor() #
[返回对象:WinDlgArgbColorObject](#WinDlgArgbColorObject)
### win.dlg.argbColor(parentForm) #
增强版取色与选色对话框。。
参数 @parentForm 指定父窗口对象或者父窗口句柄。
返回对象提供 choose 方法可用于打开选色对话框。