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

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

### win.ui.listPopup <a id="win.ui.listPopup" href="#win.ui.listPopup">&#x23;</a>
弹出列表框

### win.ui.listPopup() <a id="win.ui.listPopup" href="#win.ui.listPopup">&#x23;</a>
创建弹出列表框  
参数中指定edit,或richedit控件对象

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

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

### winuilistpopupObject.height <a id="winuilistpopupObject.height" href="#winuilistpopupObject.height">&#x23;</a>
显示高度

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

### winuilistpopupObject.onComplete <a id="winuilistpopupObject.onComplete" href="#winuilistpopupObject.onComplete">&#x23;</a>

```aardio
winuilistpopupObject.onComplete = function(text){
	/*用户已完成输入  
在候选列表中选中某项并已完成输入  
或者在输入后直接回车可触发此事件*/;
}
```

### winuilistpopupObject.onGetItems <a id="winuilistpopupObject.onGetItems" href="#winuilistpopupObject.onGetItems">&#x23;</a>

```aardio
winuilistpopupObject.onGetItems = function(text){
	return {/*text参数是用户已输入的文本,返回要显示的字符串数组,  
可选在第2个返回值返回要选中的索引*/};
}
```

### winuilistpopupObject.onSetText <a id="winuilistpopupObject.onSetText" href="#winuilistpopupObject.onSetText">&#x23;</a>

```aardio
winuilistpopupObject.onSetText = function(text){
	/*用户已选择列表项  
text参数为列表项选中的文本  
返回值为确认输入的文本*/;
	return text;
}
```