# win.ui.shadow 库模块帮助文档

<details>  <summary>关于无边框窗口</summary>  <p>
无边框窗口：指的是在窗体设计器中将窗体的边框(border) 属性设为 "none"，
这种窗口不再有边框、标题栏。

注意隐藏标题栏、并将边框设为 "resizable"等不是无边框窗口，
这种效果在不同操作系统上显示效果都很差，要么是多出一圈，要么顶上多出一块。
不要这么做。

无边框窗口只要使用下面的代码就可以在窗口周围添加阴影，
并同时使用阴影实现完美的可拖动改变大小效果（即 resizable 边框 ）。

import win.ui.shadow;
win.ui.shadow(winform);

尤其是嵌入浏览器组件，直接使用 win.ui.resizeBorder 添加可拖动边框可能不起作用。
win.ui.shadow 可以通过阴影实现 win.ui.resizeBorder 的功能。

如果只想添加阴影，不想支持可拖动边框，可以下面这样写：

import win.ui.shadow;
win.ui.shadow(winform).setResizeBorder(false)

在无边框窗口上，可以自行实现标题栏按钮，调用以下函数模拟标题栏按钮消息

winform.hitMax() //模拟点击最大化按钮
winform.hitMin() //模拟点击最小化按钮
winform.hitClose() //模拟点击关闭按钮

winform.onMouseDown  = function(wParam,lParam){
	winform.hitCaption()	
}

标准库提供了以下的类可以直接在无边框窗口上创建虚拟的标题栏以及可拖动边框:

win.ui.simpleWindow 实现最普通的标题栏。
win.ui.simpleWindow2 实现的标题栏没有最大化按钮。
win.ui.simpleWindow3 标题栏使用分层窗口实现，并使用 orphanWindow 悬浮在父窗口上面。
</p></details>

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

### win.ui.shadow <a id="win.ui.shadow" href="#win.ui.shadow">&#x23;</a>
阴影边框

创建阴影边框  
创建阴影后,窗体对象的_shadowWindow属性被设置为此对象

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

### win.ui.shadow(窗体对象,不透明度,阴影大小,外圆角,内圆角,阻影颜色,暗部插值位置,聚焦系数) <a id="win.ui.shadow" href="#win.ui.shadow">&#x23;</a>
除参数 @1 以外,其他所有参数可选  
不透明度默认为 65,255 为完全不透明。  
阴影大小默认为 10 像素，  
默认根据阴影大小自动计算外圆角大小。  
内圆角默认为空  
阴影颜色默认为0xFF000000,FF为透明度  
暗部插值位置默认为0.15,这个值是阴影内侧暗部插值点距外边界的百分比  
聚焦系数默认为15,以该系数乘以阴影大小换算为距离外边界的百分比,  
加大聚焦系数会淡化阴影

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

### winUiShadowObject._form <a id="winUiShadowObject._form" href="#winUiShadowObject._form">&#x23;</a>
[返回对象:winform](https://www.aardio.com/zh-cn/docs/library-reference/win/ui/_.html#winform)

### winUiShadowObject.opacity <a id="winUiShadowObject.opacity" href="#winUiShadowObject.opacity">&#x23;</a>
设置在阴影初始透明度上叠加的不透明度。  
可指定的值范围自 0 到 255，设为 1 禁用叠加不透明度。  
修改普通窗口透明度时会自动修改阴影窗口（如果存在）的叠加透明度。

### winUiShadowObject.setRadius(外圆角,内圆角) <a id="winUiShadowObject.setRadius" href="#winUiShadowObject.setRadius">&#x23;</a>
设置圆角大小。  
如果窗口使用了 win.region.round 创建圆角窗口则会自动调用此函数。

### winUiShadowObject.setResizeBorder(true) <a id="winUiShadowObject.setResizeBorder" href="#winUiShadowObject.setResizeBorder">&#x23;</a>
允许通过拖动阴影边框改变父窗口大小  
如果窗口当前已经应用win.ui.resizeBorder添加了拖动边框,  
则默认启用此属性,不再需要调用此函数

### winUiShadowObject.show(true) <a id="winUiShadowObject.show" href="#winUiShadowObject.show">&#x23;</a>
暂时显示或隐藏阴影  
阴影会跟随所有者窗体自动显示隐藏,此函数仅用于特殊情况

## winUiShadowObject 事件列表 <a id="winUiShadowObjectEvent" href="#winUiShadowObjectEvent">&#x23;</a>

### winUiShadowObject.onDrawShadow(hdc,hMemDc,hMemBitmap,width,height) <a id="winUiShadowObject.onDrawShadow" href="#winUiShadowObject.onDrawShadow">&#x23;</a>

```aardio
winUiShadowObject.onDrawShadow = function(hdc,hMemDc,hMemBitmap,width,height){  
	var graphics = ..gdip.graphics(hMemDc);  
	graphics.smoothingMode = 4/*_GdipSmoothingModeAntiAlias*/;  

	graphics.delete();  
}
```