# inet.downBox 库模块帮助文档

## inet 成员列表 <a id="inet" href="#inet">&#x23;</a>

### inet.downBox <a id="inet.downBox" href="#inet.downBox">&#x23;</a>
下载对话框

### inet.downBox() <a id="inet.downBox" href="#inet.downBox">&#x23;</a>
创建一个下载对话框  

[返回对象:inetDownBoxObject](#inetDownBoxObject)

### inet.downBox(父窗口,"标题",下载成功关闭超时) <a id="inet.downBox" href="#inet.downBox">&#x23;</a>
所有参数可选  
参数@3可选指定下载成功自动关闭对话框的超时值,单位毫秒

## inetDownBoxObject 成员列表 <a id="inetDownBoxObject" href="#inetDownBoxObject">&#x23;</a>

### inetDownBoxObject.bufferSize <a id="inetDownBoxObject.bufferSize" href="#inetDownBoxObject.bufferSize">&#x23;</a>
缓冲区大小  
不指定则默认为 256KB

### inetDownBoxObject.changeInterval(请输入ID,1000) <a id="inetDownBoxObject.changeInterval" href="#inetDownBoxObject.changeInterval">&#x23;</a>
重新设定定时器的延时时间

### inetDownBoxObject.clearInterval(请输入ID) <a id="inetDownBoxObject.clearInterval" href="#inetDownBoxObject.clearInterval">&#x23;</a>
删除定时器

### inetDownBoxObject.complete <a id="inetDownBoxObject.complete" href="#inetDownBoxObject.complete">&#x23;</a>
是否下载完成

### inetDownBoxObject.contentLength <a id="inetDownBoxObject.contentLength" href="#inetDownBoxObject.contentLength">&#x23;</a>
文件长度  
如果文件长度为零,并且modified属性为false,表示不需要重新下载

### inetDownBoxObject.cookies <a id="inetDownBoxObject.cookies" href="#inetDownBoxObject.cookies">&#x23;</a>
自定义HTTP请求头中的请求cookie

### inetDownBoxObject.download <a id="inetDownBoxObject.download" href="#inetDownBoxObject.download">&#x23;</a>
弹出下载对话框并开始下载文件

### inetDownBoxObject.download(URL,存储路径,配置文件,userAgent,proxy,... ) <a id="inetDownBoxObject.download" href="#inetDownBoxObject.download">&#x23;</a>
下载文件  
参数@1指定下载网址,允许传入一个动态返回 url 的线程函数  
参数@2可以指定目录或文件路径,目录必须以反斜杠结尾,  
其他参数可省略  
下载成功返回存储文路径  
userAgent,proxy等可选参数用于创建http对象,参考inet.http构造函数说明

### inetDownBoxObject.endProc <a id="inetDownBoxObject.endProc" href="#inetDownBoxObject.endProc">&#x23;</a>

```aardio
inetDownBoxObject.endProc = function(savePath,fileSize,unmodified){
	/*下载成功触发此函数。  
savePath 为下载文件路径。  
fileSize 为文件大小，  
文件未变更则 unmodified 为 true*/
	if(!unmodified)
		owner.endModal();
}
```

### inetDownBoxObject.getPos() <a id="inetDownBoxObject.getPos" href="#inetDownBoxObject.getPos">&#x23;</a>
返回相对坐标,宽,高

### inetDownBoxObject.headers <a id="inetDownBoxObject.headers" href="#inetDownBoxObject.headers">&#x23;</a>
指定下载时的请求HTTP头

### inetDownBoxObject.labInfo <a id="inetDownBoxObject.labInfo" href="#inetDownBoxObject.labInfo">&#x23;</a>
显示信息  

[返回对象:staticObject](https://www.aardio.com/zh-cn/doc/library-reference/win/ui/ctrl/static.html#staticObject)

### inetDownBoxObject.labProgress <a id="inetDownBoxObject.labProgress" href="#inetDownBoxObject.labProgress">&#x23;</a>
显示进度信息  

[返回对象:staticObject](https://www.aardio.com/zh-cn/doc/library-reference/win/ui/ctrl/static.html#staticObject)

### inetDownBoxObject.modified <a id="inetDownBoxObject.modified" href="#inetDownBoxObject.modified">&#x23;</a>
文件在上次下载以后是否修改过

### inetDownBoxObject.modifyStyle(remove,add,swpFlags) <a id="inetDownBoxObject.modifyStyle" href="#inetDownBoxObject.modifyStyle">&#x23;</a>
修改窗口样式,所有参数都是可选参数,  
@remove 用数值指定要移除的样式,可使用 _WS_ 前缀的常量  
@add 用数值指定要添加的样式,可使用 _WS_ 前缀的常量  
@swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量  
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos  
细节请参考 win.modifyStyle 函数源码

### inetDownBoxObject.modifyStyleEx(remove,add,swpFlags) <a id="inetDownBoxObject.modifyStyleEx" href="#inetDownBoxObject.modifyStyleEx">&#x23;</a>
修改窗口扩展样式,所有参数都是可选参数,  
@remove 用数值指定要移除的样式,可使用 _WS_EX_ 前缀的常量  
@add 用数值指定要添加的样式,可使用 _WS_EX_ 前缀的常量  
@swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量  
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos  
细节请参考 win.modifyStyle 函数源码

### inetDownBoxObject.progress <a id="inetDownBoxObject.progress" href="#inetDownBoxObject.progress">&#x23;</a>
进度条  

[返回对象:plusObject](#plusObject)

### inetDownBoxObject.referer <a id="inetDownBoxObject.referer" href="#inetDownBoxObject.referer">&#x23;</a>
指定下载时的引用页

### inetDownBoxObject.removeResumeFile() <a id="inetDownBoxObject.removeResumeFile" href="#inetDownBoxObject.removeResumeFile">&#x23;</a>
移除断点续传配置文件

### inetDownBoxObject.savePath <a id="inetDownBoxObject.savePath" href="#inetDownBoxObject.savePath">&#x23;</a>
下载成功后的文件存储路径

### inetDownBoxObject.setInterval(回调函数,延时毫秒数,...) <a id="inetDownBoxObject.setInterval" href="#inetDownBoxObject.setInterval">&#x23;</a>

```aardio
inetDownBoxObject.setInterval(回调函数,延时毫秒数,...setInterval(   
	function(){  
		/*参数@1指定执行函数,参数@2指定执行间隔，  
可选指定一个或多个回调参数，不指定回调参数则默认为:  
 hwnd,message,timerId,tick,  

如果在定时器中执行了win.delay等继续消息循环的代码，  
在定时器退出前不会再触发同一定时器（重入）。  

定时器回调函数返回数值可修改时间间隔,  
返回false取消该定时器*/  
	},1000   
)
```

### inetDownBoxObject.setPos(x,y,宽,高,插入位置,参数) <a id="inetDownBoxObject.setPos" href="#inetDownBoxObject.setPos">&#x23;</a>
调整窗口位置或排序  
所有参数可选

### inetDownBoxObject.setTimeout(函数名,延时,其他参数) <a id="inetDownBoxObject.setTimeout" href="#inetDownBoxObject.setTimeout">&#x23;</a>
延时执行函数

### inetDownBoxObject.statusCode <a id="inetDownBoxObject.statusCode" href="#inetDownBoxObject.statusCode">&#x23;</a>
HTTP状态码

### inetDownBoxObject.test(URL,存储路径,配置文件,userAgent,proxy,... ) <a id="inetDownBoxObject.test" href="#inetDownBoxObject.test">&#x23;</a>
检测是否已下载最新文件  
参数@1指定下载网址  
参数@2可以指定目录或文件路径,目录必须以反斜杠结尾,  
已下载文件未变更返回true  
需要下载或续传返回false,下载错误返回null  
userAgent,proxy等可选参数用于创建http对象,参考inet.http构造函数说明

### inetDownBoxObject.text <a id="inetDownBoxObject.text" href="#inetDownBoxObject.text">&#x23;</a>
对话框标题

### inetDownBoxObject.userAgent <a id="inetDownBoxObject.userAgent" href="#inetDownBoxObject.userAgent">&#x23;</a>
指定下载时的请求User Agent
