# win.ui.ctrl.progress 库模块帮助文档

## win.ui.ctrl 成员列表 <a id="win.ui.ctrl" href="#win.ui.ctrl">&#x23;</a>

### win.ui.ctrl.progress <a id="win.ui.ctrl.progress" href="#win.ui.ctrl.progress">&#x23;</a>
进度条控件

### win.ui.ctrl.progress() <a id="win.ui.ctrl.progress" href="#win.ui.ctrl.progress">&#x23;</a>
进度条控件  

[返回对象:progressObject](#progressObject)

## progressObject 成员列表 <a id="progressObject" href="#progressObject">&#x23;</a>

### progressObject._parentForm <a id="progressObject._parentForm" href="#progressObject._parentForm">&#x23;</a>
返回创建控件的容器窗口（win.form对象），所有窗口控件都拥有此只读属性。  
对于使用窗体设计器创建的窗口，也就是返回设计时窗体容器。  

即使子窗口移除子窗口样式、更改父子关系，或以 orphanWindow显示，  
控件的 _parentForm 始终都不会改变  

[返回对象:winform](https://www.aardio.com/zh-cn/docs/library-reference/win/ui/_.html#winform)

### progressObject.bottom <a id="progressObject.bottom" href="#progressObject.bottom">&#x23;</a>
底部坐标

### progressObject.capture <a id="progressObject.capture" href="#progressObject.capture">&#x23;</a>
是否捕获全局鼠标消息

### progressObject.close() <a id="progressObject.close" href="#progressObject.close">&#x23;</a>
关闭控件窗

### progressObject.delta(偏移值) <a id="progressObject.delta" href="#progressObject.delta">&#x23;</a>
修改当前进度,参数指定相对于当前进度的偏移值

### progressObject.disabled <a id="progressObject.disabled" href="#progressObject.disabled">&#x23;</a>
是否禁用

### progressObject.getClientRect() <a id="progressObject.getClientRect" href="#progressObject.getClientRect">&#x23;</a>
控件客户区块位置(::RECT结构体)  

[返回对象:rectObject](https://www.aardio.com/zh-cn/docs/library-reference/global/_.html#rectObject)

### progressObject.getParent() <a id="progressObject.getParent" href="#progressObject.getParent">&#x23;</a>
返回父窗口  

[返回对象:staticObject](https://www.aardio.com/zh-cn/docs/library-reference/win/ui/ctrl/static.html#staticObject)

### progressObject.getPos() <a id="progressObject.getPos" href="#progressObject.getPos">&#x23;</a>
返回相对坐标,宽,高  
x,y,cx,cy=win.getPos(hwnd)

### progressObject.getRect() <a id="progressObject.getRect" href="#progressObject.getRect">&#x23;</a>
控件区块位置(::RECT结构体)

### progressObject.getRect(true) <a id="progressObject.getRect" href="#progressObject.getRect">&#x23;</a>
控件屏幕区块位置(::RECT结构体)

### progressObject.height <a id="progressObject.height" href="#progressObject.height">&#x23;</a>
高度

### progressObject.hwnd <a id="progressObject.hwnd" href="#progressObject.hwnd">&#x23;</a>
控件句柄

### progressObject.id <a id="progressObject.id" href="#progressObject.id">&#x23;</a>
控件ID

### progressObject.invalidate(/*可选使用::RECT()对象指定客户区*/) <a id="progressObject.invalidate(/*可选使用::RECT" href="#progressObject.invalidate(/*可选使用::RECT">&#x23;</a>
使窗口绘图区无效

### progressObject.invalidate(/*可选使用::RECT()对象指定客户区*/,0) <a id="progressObject.invalidate(/*可选使用::RECT" href="#progressObject.invalidate(/*可选使用::RECT">&#x23;</a>
使窗口绘图区无效  
不刷新背景

### progressObject.left <a id="progressObject.left" href="#progressObject.left">&#x23;</a>
左侧坐标

### progressObject.max <a id="progressObject.max" href="#progressObject.max">&#x23;</a>
最大值,注意不能大于0xFFFF,不要使用负数

### progressObject.min <a id="progressObject.min" href="#progressObject.min">&#x23;</a>
最小值,注意不能大于0xFFFF,不要使用负数

### progressObject.modifyStyle(remove,add,swpFlags) <a id="progressObject.modifyStyle" href="#progressObject.modifyStyle">&#x23;</a>
修改窗口样式,所有参数都是可选参数,  
@remove 用数值指定要移除的样式,可使用 _WS_ 前缀的常量  
@add 用数值指定要添加的样式,可使用 _WS_ 前缀的常量  
@swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量  
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos  
细节请参考 win.modifyStyle 函数源码

### progressObject.modifyStyleEx(remove,add,swpFlags) <a id="progressObject.modifyStyleEx" href="#progressObject.modifyStyleEx">&#x23;</a>
修改窗口扩展样式,所有参数都是可选参数,  
@remove 用数值指定要移除的样式,可使用 _WS_EX_ 前缀的常量  
@add 用数值指定要添加的样式,可使用 _WS_EX_ 前缀的常量  
@swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量  
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos  
细节请参考 win.modifyStyle 函数源码

### progressObject.orphanWindow() <a id="progressObject.orphanWindow" href="#progressObject.orphanWindow">&#x23;</a>
使控件脱离原来的窗口,可以显示在父窗口外面,  
但仍然显示在原来的位置,继续如影随形的跟随父窗口移动或改变大小,  
控件原来的固定边距等参数仍然有效

### progressObject.pos <a id="progressObject.pos" href="#progressObject.pos">&#x23;</a>
进度条当前值,不能大于 0xFFFF,不要使用负数

### progressObject.redraw() <a id="progressObject.redraw" href="#progressObject.redraw">&#x23;</a>
刷新

### progressObject.right <a id="progressObject.right" href="#progressObject.right">&#x23;</a>
右侧坐标

### progressObject.setFocus() <a id="progressObject.setFocus" href="#progressObject.setFocus">&#x23;</a>
设置焦点

### progressObject.setParent(控件对象) <a id="progressObject.setParent" href="#progressObject.setParent">&#x23;</a>
改变父窗口

### progressObject.setPos(x坐标,y坐标,宽,高,插入位置,参数) <a id="progressObject.setPos" href="#progressObject.setPos">&#x23;</a>
调整窗口位置或排序,所有参数可选  
同时指定x,y坐标则移动位置  
同时指定宽高则改变大小  
指定插入位置(句柄或_HWND前缀常量)则调整Z序

### progressObject.setRange(最小值,最大值) <a id="progressObject.setRange" href="#progressObject.setRange">&#x23;</a>
设置进度条最大值,最小值  
注意值不能大于0xFFFF,不要使用负数

### progressObject.setRect(rc) <a id="progressObject.setRect" href="#progressObject.setRect">&#x23;</a>
设置控件区块位置(::RECT结构体)

### progressObject.setRect(rc,true) <a id="progressObject.setRect" href="#progressObject.setRect">&#x23;</a>
设置控件屏幕区块位置(::RECT结构体)

### progressObject.show(true) <a id="progressObject.show" href="#progressObject.show">&#x23;</a>
显示控件

### progressObject.startProgress() <a id="progressObject.startProgress" href="#progressObject.startProgress">&#x23;</a>
显示进条,并显示循环滚动进度的动画,  
可选在参数中指定动画间隔时,以毫秒为单位

### progressObject.step <a id="progressObject.step" href="#progressObject.step">&#x23;</a>
设置stepIt()函数的步进增量  
默认为10

### progressObject.stepIt() <a id="progressObject.stepIt" href="#progressObject.stepIt">&#x23;</a>
进度条前进一个增量，最出最大值时设为最小值。  
返回步进前位置

### progressObject.stopProgress() <a id="progressObject.stopProgress" href="#progressObject.stopProgress">&#x23;</a>
停止显示循环滚动进度动画,隐藏进度条

### progressObject.theme <a id="progressObject.theme" href="#progressObject.theme">&#x23;</a>
外观主题,例如  
winform.button.theme = "Explorer"  
winform.button.theme = false

### progressObject.threadCallable() <a id="progressObject.threadCallable" href="#progressObject.threadCallable">&#x23;</a>
开启此控件的跨线程调用功能

### progressObject.top <a id="progressObject.top" href="#progressObject.top">&#x23;</a>
顶部坐标

### progressObject.update() <a id="progressObject.update" href="#progressObject.update">&#x23;</a>
重绘invalidate函数指定的区块

### progressObject.value <a id="progressObject.value" href="#progressObject.value">&#x23;</a>
进度条当前值,不能大于 0xFFFF,不要使用负数

### progressObject.visible <a id="progressObject.visible" href="#progressObject.visible">&#x23;</a>
当前控件窗口是否显示。  
仅检查当前窗口的可见性样式（窗口 是否具有 _WS_VISIBLE 样式）。  
不考虑父窗口是否可见，不考虑是否被其他窗口遮挡。  
如果需要同时判断父窗口的可见性，应改用 win.isVisible 函数。

### progressObject.width <a id="progressObject.width" href="#progressObject.width">&#x23;</a>
宽度
