# win.appBar 库模块帮助文档

## win 成员列表 <a id="win" href="#win">&#x23;</a>

### win.appBar() <a id="win.appBar" href="#win.appBar">&#x23;</a>
[返回对象:winAppBarObject](#winAppBarObject)

### win.appBar(句柄) <a id="win.appBar" href="#win.appBar">&#x23;</a>
可选指定句柄,  
可选在第二个参数中使用表对象指定APPBARDATA属性

## win.appBar 成员列表 <a id="win.appBar" href="#win.appBar">&#x23;</a>

任务栏

### win.appBar.autoHide( 任务栏句柄,false) <a id="win.appBar.autoHide" href="#win.appBar.autoHide">&#x23;</a>
取消自动隐藏

### win.appBar.autoHide( 任务栏句柄,true) <a id="win.appBar.autoHide" href="#win.appBar.autoHide">&#x23;</a>
设置为自动隐藏

### win.appBar.command() <a id="win.appBar.command" href="#win.appBar.command">&#x23;</a>
发送命令,  
参数@1指定命令 ID，参数为 419 可显示桌面。

### win.appBar.find() <a id="win.appBar.find" href="#win.appBar.find">&#x23;</a>
返回系统任务栏句柄

### win.appBar.getAutoHideBar() <a id="win.appBar.getAutoHideBar" href="#win.appBar.getAutoHideBar">&#x23;</a>
返回左,上,右,下四个被设置为自动隐藏的任务栏句柄

### win.appBar.getTaskBar() <a id="win.appBar.getTaskBar" href="#win.appBar.getTaskBar">&#x23;</a>
返回系统任务栏信息,失败返回null  

[返回对象:STDAPPBARDATAObject](#STDAPPBARDATAObject)

### win.appBar.isAutoHide( 任务栏句柄 ) <a id="win.appBar.isAutoHide" href="#win.appBar.isAutoHide">&#x23;</a>
任务栏是否自动隐藏

### win.appBar.message(_ABM,{} ) <a id="win.appBar.message" href="#win.appBar.message">&#x23;</a>
发送任务栏命令,  
可选在第二个参数中使用一个表对象指定 APPBARDATA 的部分字段。  
函数会自动创建 APPBARDATA 结构体，并且合并参数 @2 指定的字段值。

### win.appBar.regist <a id="win.appBar.regist" href="#win.appBar.regist">&#x23;</a>
将窗口注册接收任务栏通知消息。  
相关范例: https://www.aardio.com/zh-cn/docs/examples/System/Desktop/appBarMsg.html

### win.appBar.regist(窗口句柄,自定义回调消息ID) <a id="win.appBar.regist" href="#win.appBar.regist">&#x23;</a>
将窗口注册接收任务栏通知消息。  
请在参数 @1 指定的窗口接收参数 @2 指定的消息 ID。  
wParam 为通知代码，例如应用全屏事件通知代码为 _ABN_FULLSCREENAPP  
lParam 为通知参数，对于 _ABN_FULLSCREENAPP 表示是否全屏

### win.appBar.regist(窗口对象,通知回调函数) <a id="win.appBar.regist" href="#win.appBar.regist">&#x23;</a>

```aardio
win.appBar.regist(winform,function(code,param){  
	if(code == 2/*_ABN_FULLSCREENAPP*/){  
		/*code 为通知代码，param 为通知参数。  
对于 _ABN_FULLSCREENAPP 通知消息 ，param 为是否有全屏窗口*/  
	}  
})
```

### win.appBar.setAutoHideBar( 任务栏句柄,_ABE_BOTTOM ) <a id="win.appBar.setAutoHideBar" href="#win.appBar.setAutoHideBar">&#x23;</a>
设置为自动停靠

### win.appBar.unRegist(窗口句柄) <a id="win.appBar.unRegist" href="#win.appBar.unRegist">&#x23;</a>
取消注册的任务栏回调消息

## STDAPPBARDATAObject 成员列表 <a id="STDAPPBARDATAObject" href="#STDAPPBARDATAObject">&#x23;</a>

### STDAPPBARDATAObject.hwnd <a id="STDAPPBARDATAObject.hwnd" href="#STDAPPBARDATAObject.hwnd">&#x23;</a>
窗口句柄

### STDAPPBARDATAObject.rc <a id="STDAPPBARDATAObject.rc" href="#STDAPPBARDATAObject.rc">&#x23;</a>
屏幕区块位置

### STDAPPBARDATAObject.rc.bottom <a id="STDAPPBARDATAObject.rc.bottom" href="#STDAPPBARDATAObject.rc.bottom">&#x23;</a>
下

### STDAPPBARDATAObject.rc.left <a id="STDAPPBARDATAObject.rc.left" href="#STDAPPBARDATAObject.rc.left">&#x23;</a>
左

### STDAPPBARDATAObject.rc.right <a id="STDAPPBARDATAObject.rc.right" href="#STDAPPBARDATAObject.rc.right">&#x23;</a>
右

### STDAPPBARDATAObject.rc.top <a id="STDAPPBARDATAObject.rc.top" href="#STDAPPBARDATAObject.rc.top">&#x23;</a>
上

### STDAPPBARDATAObject.state <a id="STDAPPBARDATAObject.state" href="#STDAPPBARDATAObject.state">&#x23;</a>
状态  
_ABS_前缀常量

### STDAPPBARDATAObject.uEdge <a id="STDAPPBARDATAObject.uEdge" href="#STDAPPBARDATAObject.uEdge">&#x23;</a>
状态栏靠在屏幕哪个边  
_ABE_ 前缀常量

### 自动完成常量
_ABE_BOTTOM=0x3  
_ABE_LEFT=0x0  
_ABE_RIGHT=0x2  
_ABE_TOP=0x1  
_ABM_ACTIVATE=0x6  
_ABM_GETAUTOHIDEBAR=0x7  
_ABM_GETSTATE=0x4  
_ABM_GETTASKBARPOS=0x5  
_ABM_NEW=0x0  
_ABM_QUERYPOS=0x2  
_ABM_REMOVE=0x1  
_ABM_SETAUTOHIDEBAR=0x8  
_ABM_SETPOS=0x3  
_ABM_SETSTATE=0xA  
_ABM_WINDOWPOSCHANGED=0x9  
_ABN_FULLSCREENAPP=2  
_ABN_POSCHANGED=1  
_ABN_STATECHANGE=0  
_ABN_WINDOWARRANGE=3  
_ABS_ALWAYSONTOP=0x2  
_ABS_AUTOHIDE=0x1