# win.ui.ctrl.ipaddress 库模块帮助文档

## win.ui.ctrl 成员列表 <a id="win.ui.ctrl" href="#win.ui.ctrl">&#x23;</a>

### win.ui.ctrl.ipaddress() <a id="win.ui.ctrl.ipaddress" href="#win.ui.ctrl.ipaddress">&#x23;</a>
IP地址控件  

[返回对象:SysIPAddressObject](#SysIPAddressObject)

## SysIPAddressObject 成员列表 <a id="SysIPAddressObject" href="#SysIPAddressObject">&#x23;</a>

### SysIPAddressObject._parentForm <a id="SysIPAddressObject._parentForm" href="#SysIPAddressObject._parentForm">&#x23;</a>
返回创建控件的容器窗口（win.form对象），所有窗口控件都拥有此只读属性。  
对于使用窗体设计器创建的窗口，也就是返回设计时窗体容器。  

即使子窗口移除子窗口样式、更改父子关系，或以 orphanWindow显示，  
控件的 _parentForm 始终都不会改变  

[返回对象:winform](https://www.aardio.com/zh-cn/docs/library-reference/win/ui/_.html#winform)

### SysIPAddressObject.addCtrl <a id="SysIPAddressObject.addCtrl" href="#SysIPAddressObject.addCtrl">&#x23;</a>

```aardio
SysIPAddressObject.addCtrl(  

	edit ={ cls="edit";left=0;top=0;right=50;bottom=50;autoResize=false ;hide=1;edge=1;  }  
)
```

### SysIPAddressObject.address <a id="SysIPAddressObject.address" href="#SysIPAddressObject.address">&#x23;</a>
IP地址数值格式

### SysIPAddressObject.bottom <a id="SysIPAddressObject.bottom" href="#SysIPAddressObject.bottom">&#x23;</a>
底部坐标

### SysIPAddressObject.capture <a id="SysIPAddressObject.capture" href="#SysIPAddressObject.capture">&#x23;</a>
是否捕获全局鼠标消息

### SysIPAddressObject.className <a id="SysIPAddressObject.className" href="#SysIPAddressObject.className">&#x23;</a>
运行时类名

### SysIPAddressObject.clear() <a id="SysIPAddressObject.clear" href="#SysIPAddressObject.clear">&#x23;</a>
清除列表框所有内容

### SysIPAddressObject.clientRect <a id="SysIPAddressObject.clientRect" href="#SysIPAddressObject.clientRect">&#x23;</a>
获取控件客户区块位置(::RECT结构体)

### SysIPAddressObject.close() <a id="SysIPAddressObject.close" href="#SysIPAddressObject.close">&#x23;</a>
关闭控件窗

### SysIPAddressObject.cls <a id="SysIPAddressObject.cls" href="#SysIPAddressObject.cls">&#x23;</a>
设计时类名

### SysIPAddressObject.disabled <a id="SysIPAddressObject.disabled" href="#SysIPAddressObject.disabled">&#x23;</a>
是否禁用

### SysIPAddressObject.getClientRect() <a id="SysIPAddressObject.getClientRect" href="#SysIPAddressObject.getClientRect">&#x23;</a>
控件客户区块位置(::RECT结构体)  

[返回对象:rectObject](https://www.aardio.com/zh-cn/docs/library-reference/global/_.html#rectObject)

### SysIPAddressObject.getFont() <a id="SysIPAddressObject.getFont" href="#SysIPAddressObject.getFont">&#x23;</a>
控件字体(::LOGFONT结构体)  

[返回对象:logfontObject](#logfontObject)

### SysIPAddressObject.getParent() <a id="SysIPAddressObject.getParent" href="#SysIPAddressObject.getParent">&#x23;</a>
返回父窗口  

[返回对象:staticObject](https://www.aardio.com/zh-cn/docs/library-reference/win/ui/ctrl/static.html#staticObject)

### SysIPAddressObject.getPos() <a id="SysIPAddressObject.getPos" href="#SysIPAddressObject.getPos">&#x23;</a>
返回相对坐标,宽,高  
x,y,cx,cy=win.getPos(hwnd)

### SysIPAddressObject.getRect() <a id="SysIPAddressObject.getRect" href="#SysIPAddressObject.getRect">&#x23;</a>
控件区块位置(::RECT结构体)

### SysIPAddressObject.getRect(true) <a id="SysIPAddressObject.getRect" href="#SysIPAddressObject.getRect">&#x23;</a>
控件屏幕区块位置(::RECT结构体)

### SysIPAddressObject.height <a id="SysIPAddressObject.height" href="#SysIPAddressObject.height">&#x23;</a>
高度

### SysIPAddressObject.hwnd <a id="SysIPAddressObject.hwnd" href="#SysIPAddressObject.hwnd">&#x23;</a>
控件句柄

### SysIPAddressObject.id <a id="SysIPAddressObject.id" href="#SysIPAddressObject.id">&#x23;</a>
控件ID

### SysIPAddressObject.invalidate(/*可选使用::RECT()对象指定客户区*/) <a id="SysIPAddressObject.invalidate(/*可选使用::RECT" href="#SysIPAddressObject.invalidate(/*可选使用::RECT">&#x23;</a>
使窗口绘图区无效

### SysIPAddressObject.invalidate(/*可选使用::RECT()对象指定客户区*/,0) <a id="SysIPAddressObject.invalidate(/*可选使用::RECT" href="#SysIPAddressObject.invalidate(/*可选使用::RECT">&#x23;</a>
使窗口绘图区无效  
不刷新背景

### SysIPAddressObject.left <a id="SysIPAddressObject.left" href="#SysIPAddressObject.left">&#x23;</a>
左侧坐标

### SysIPAddressObject.modifyStyle(remove,add,swpFlags) <a id="SysIPAddressObject.modifyStyle" href="#SysIPAddressObject.modifyStyle">&#x23;</a>
修改窗口样式,所有参数都是可选参数,  
@remove 用数值指定要移除的样式,可使用 _WS_ 前缀的常量  
@add 用数值指定要添加的样式,可使用 _WS_ 前缀的常量  
@swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量  
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos  
细节请参考 win.modifyStyle 函数源码

### SysIPAddressObject.modifyStyleEx(remove,add,swpFlags) <a id="SysIPAddressObject.modifyStyleEx" href="#SysIPAddressObject.modifyStyleEx">&#x23;</a>
修改窗口扩展样式,所有参数都是可选参数,  
@remove 用数值指定要移除的样式,可使用 _WS_EX_ 前缀的常量  
@add 用数值指定要添加的样式,可使用 _WS_EX_ 前缀的常量  
@swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量  
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos  
细节请参考 win.modifyStyle 函数源码

### SysIPAddressObject.orphanWindow() <a id="SysIPAddressObject.orphanWindow" href="#SysIPAddressObject.orphanWindow">&#x23;</a>
使控件脱离原来的窗口,可以显示在父窗口外面,  
但仍然显示在原来的位置,继续如影随形的跟随父窗口移动或改变大小,  
控件原来的固定边距等参数仍然有效

### SysIPAddressObject.postMessage(msg,wParam,lParam) <a id="SysIPAddressObject.postMessage" href="#SysIPAddressObject.postMessage">&#x23;</a>
投递窗口消息到消息队列中  
此函数用法请参考 ::User32.PostMessage

### SysIPAddressObject.right <a id="SysIPAddressObject.right" href="#SysIPAddressObject.right">&#x23;</a>
右侧坐标

### SysIPAddressObject.sendMessage(msg,wParam,lParam) <a id="SysIPAddressObject.sendMessage" href="#SysIPAddressObject.sendMessage">&#x23;</a>
发送窗口消息  
此函数用法请参考 ::User32.SendMessage

### SysIPAddressObject.setFocus() <a id="SysIPAddressObject.setFocus" href="#SysIPAddressObject.setFocus">&#x23;</a>
设置焦点

### SysIPAddressObject.setFont(指定字体) <a id="SysIPAddressObject.setFont" href="#SysIPAddressObject.setFont">&#x23;</a>
指定LOGFONT字体对象,或逻辑字体句柄

### SysIPAddressObject.setFont(混入字体属性) <a id="SysIPAddressObject.setFont" href="#SysIPAddressObject.setFont">&#x23;</a>

```aardio
SysIPAddressObject.setFont(point=10;name="宋体");
```

### SysIPAddressObject.setParent(控件对象) <a id="SysIPAddressObject.setParent" href="#SysIPAddressObject.setParent">&#x23;</a>
改变父窗口

### SysIPAddressObject.setPos(x坐标,y坐标,宽,高,插入位置,参数) <a id="SysIPAddressObject.setPos" href="#SysIPAddressObject.setPos">&#x23;</a>
调整窗口位置或排序,所有参数可选  
同时指定x,y坐标则移动位置  
同时指定宽高则改变大小  
指定插入位置(句柄或_HWND前缀常量)则调整Z序

### SysIPAddressObject.setRange(起始IP,结束IP) <a id="SysIPAddressObject.setRange" href="#SysIPAddressObject.setRange">&#x23;</a>
设置IP范围  
参数可以是文本,也可以分别是指定四组数值的数组

### SysIPAddressObject.setRect(rc) <a id="SysIPAddressObject.setRect" href="#SysIPAddressObject.setRect">&#x23;</a>
设置控件区块位置(::RECT结构体)

### SysIPAddressObject.setRect(rc,true) <a id="SysIPAddressObject.setRect" href="#SysIPAddressObject.setRect">&#x23;</a>
设置控件屏幕区块位置(::RECT结构体)

### SysIPAddressObject.show(true) <a id="SysIPAddressObject.show" href="#SysIPAddressObject.show">&#x23;</a>
显示控件

### SysIPAddressObject.text <a id="SysIPAddressObject.text" href="#SysIPAddressObject.text">&#x23;</a>
IP 地址文本格式

### SysIPAddressObject.theme <a id="SysIPAddressObject.theme" href="#SysIPAddressObject.theme">&#x23;</a>
外观主题,例如  
winform.button.theme = "Explorer"  
winform.button.theme = false

### SysIPAddressObject.threadCallable() <a id="SysIPAddressObject.threadCallable" href="#SysIPAddressObject.threadCallable">&#x23;</a>
开启此控件的跨线程调用功能

### SysIPAddressObject.top <a id="SysIPAddressObject.top" href="#SysIPAddressObject.top">&#x23;</a>
顶部坐标

### SysIPAddressObject.update() <a id="SysIPAddressObject.update" href="#SysIPAddressObject.update">&#x23;</a>
重绘invalidate函数指定的区块

### SysIPAddressObject.width <a id="SysIPAddressObject.width" href="#SysIPAddressObject.width">&#x23;</a>
宽度

## SysIPAddressObject 事件列表 <a id="SysIPAddressObjectEvent" href="#SysIPAddressObjectEvent">&#x23;</a>

### SysIPAddressObject.onChange() <a id="SysIPAddressObject.onChange" href="#SysIPAddressObject.onChange">&#x23;</a>

```aardio
SysIPAddressObject.onChange = function(){  
	/*响应事件，文本内容已变更*/
}
```

### SysIPAddressObject.onFieldChanged <a id="SysIPAddressObject.onFieldChanged" href="#SysIPAddressObject.onFieldChanged">&#x23;</a>

```aardio
SysIPAddressObject.onFieldChanged = function(field,value){
	/*IP 变更事件,  
field 是变更字段的位置，可能值为1，2，3，4之一，  
value 是实际变更字段的数值，字段为空时值为 -1*/
}
```

### SysIPAddressObject.onFocusGot() <a id="SysIPAddressObject.onFocusGot" href="#SysIPAddressObject.onFocusGot">&#x23;</a>

```aardio
SysIPAddressObject.onFocusGot = function(){ 
	/*响应事件，已获得输入焦点*/
}
```

### SysIPAddressObject.onFocusLost() <a id="SysIPAddressObject.onFocusLost" href="#SysIPAddressObject.onFocusLost">&#x23;</a>

```aardio
SysIPAddressObject.onFocusLost = function(){
	/*响应事件，已失去输入焦点*/
}
```

