NIM_Duilib_Framework/docs/List/Combo.md

Combo

Combo 继承了 Box 容器属性和方法，更多可用属性和方法请参考：Box 容器

可用属性

属性名称	默认值	参数类型	用途
dropbox		STRING	设置弹出框的样式,如(padding="1,1,1,1")
dropboxsize	0,150	SIZE	弹出框大小设置
vscrollbar	false	BOOL	是否使用竖向滚动条,如(true)

可用接口

接口名称	用途
GetText	获取当前选择项文本
GetListBox	获取当前所属的 List 对象
GetDropBoxAttributeList	获取下拉框属性信息
SetDropBoxAttributeList	设置下拉框的属性信息
GetDropBoxSize	获取下拉框容器大小
SetDropBoxSize	设置下拉框容器大小
SetPopupTop	设置 Combobox 是否向上弹出
IsPopupTop	判断 Combobox 弹出模式是否是向上弹出
SelectItem	选择一个子项
GetItemAt	获取指定索引下的子项控件
GetCurSel	获取当前选择项索引
GetCount	获取所有子项数量
AttachSelect	监听子项被选择事件
OnSelectItem	默认的子项被选择处理函数

GetText

获取当前选择项文本

std::wstring GetText()

• 参 数：无
• 返回值：返回当前选择项文本

GetListBox

获取当前所属的 List 对象

ListBox* GetListBox()

• 参 数：无
• 返回值：返回所属的 List 对象指针

GetDropBoxAttributeList

获取下拉框属性信息

std::wstring GetDropBoxAttributeList()

• 参 数：无
• 返回值：返回字符串形式的属性信息

SetDropBoxAttributeList

设置下拉框的属性信息

void SetDropBoxAttributeList(const std::wstring& pstrList)

• 参 数：
  • pstrList 转义后的 XML 格式属性列表
• 返回值：无

GetDropBoxSize

获取下拉框容器大小

CSize GetDropBoxSize()

• 参 数：无
• 返回值：返回容器大小

SetDropBoxSize

设置下拉框容器大小

void SetDropBoxSize(CSize szDropBox)

• 参 数：
  • szDropBox 要设置的大小信息
• 返回值：无

SetPopupTop

设置 Combobox 是否向上弹出

void SetPopupTop(bool top)

• 参 数：
  • top 为 true 则向上弹出，false 为默认向下弹出
• 返回值：无

IsPopupTop

判断 Combobox 弹出模式是否是向上弹出

bool IsPopupTop() const

• 参 数：无
• 返回值：返回 true 表示向上弹出，否则为 false

SelectItem

选择一个子项

bool SelectItem(int iIndex)

• 参 数：
  • iIndex 要选择的子项索引
• 返回值：返回 true 表示成功，否则为 false

GetItemAt

获取指定索引下的子项控件

Control* GetItemAt(int iIndex)

• 参 数：
  • iIndex 要获取的子项索引
• 返回值：返回控件指针

GetCurSel

获取当前选择项索引

int GetCurSel()

• 参 数：无
• 返回值：返回当前选择项索引

GetCount

获取所有子项数量

virtual int GetCount()

• 参 数：无
• 返回值：返回所有子项数量

AttachSelect

监听子项被选择事件

void AttachSelect(const EventCallback& callback)

• 参 数：
  • callback 子项被选择后触发的回调函数
• 返回值：无

OnSelectItem

默认的子项被选择处理函数

bool OnSelectItem(EventArgs* args)

• 参 数：
  • args 参数列表
• 返回值：始终返回 true