# win.ui.ctrl.bk 库模块帮助文档
## win.ui.ctrl 成员列表 #
### win.ui.ctrl.bk() #
无窗口控件,仅用于背景贴图,不建议用于频繁刷新绘图
[返回对象:winuictrlbkObject](#winuictrlbkObject)
## winuictrlbkObject 成员列表 #
### winuictrlbkObject.background #
参数指定图像路径，重设背景图像,
仅支持 gif,jpg 等，不支持png,
png 贴图请改用 bkplus 控件
### winuictrlbkObject.bgcolor #
背景色,RGB 格式数值
### winuictrlbkObject.bottom #
顶部位置，修改此属性不会主动刷新
### winuictrlbkObject.close() #
移除控件。
### winuictrlbkObject.forecolor #
前景色,RGB 格式数值
### winuictrlbkObject.getPos() #
返回 `x,y,cx,cy` 等 4 个值。
`x,y`为控件坐标，`cx,cy` 为控件宽、高。
### winuictrlbkObject.getRect() #
获取控件区块位置（::RECT 结构体）
### winuictrlbkObject.height #
高度，修改此属性不会主动刷新
### winuictrlbkObject.left #
左侧位置，修改此属性不会主动刷新
### winuictrlbkObject.linearGradient #
线程渐变方向,0为水平方向，其他数值为垂直方向渐变
### winuictrlbkObject.redraw() #
刷新,会导致背景窗口重建背景图缓存
不建议频繁调用
### winuictrlbkObject.right #
右侧位置，修改此属性不会主动刷新
### winuictrlbkObject.setBitmap() #
参数指定位图句柄,重设背景位图
控件负责销毁位图句柄
### winuictrlbkObject.setPos(x,y,cx,cw) #
修改控件的 x，y 坐标与宽（cx），高（cw）。
所有参数可选，不指定的参数则保持原值。
对于 bk,bkplus 控件此函数不负责重绘。
### winuictrlbkObject.setRect(rect,screen) #
设置控件区块位置。
参数 @rect 指定 ::RECT 结构体。
可选用 @screen 指定参数是否使用屏幕坐标，默认为 false
### winuictrlbkObject.show() #
显示窗口。
参数 @1 为 false 时隐藏窗口。
### winuictrlbkObject.top #
顶部位置，修改此属性不会主动刷新
### winuictrlbkObject.visible #
当前控件是否显示
### winuictrlbkObject.width #
宽度，修改此属性不会主动刷新
## winuictrlbkObject 事件列表 #
### winuictrlbkObject.onDrawBackground #
```aardio
winuictrlbkObject.onDrawBackground(hdc,rc){
/*背景绘图以后触发此回调,
hdc为当前绘图设备句柄,rc为控件位置*/
}
```