Function Reference

首页  后退  前进

GUICtrlCreateList

 

创建列表(List)控件.

 

GUICtrlCreateList ( "text", left, top [, width [, height [, style = -1 [, exStyle = -1]]]] )

参数

text

控件显示的文本.

left

控件左侧的位置. 若此值为 -1, 则根据 GUICoordMode() 的设置计算左侧位置.

top

控件上方的位置. 若此值为 -1, 则根据 GUICoordMode() 的设置计算顶部位置.

width

[可选] 控件的宽度(默认使用先前的宽度).

height

[可选] 控件的高度(默认使用先前的高度).

style

[可选] 控件的样式. 查看附录 GUI 控件样式表.

默认样式 ( -1) : $LBS_SORT, $WS_BORDER, $WS_VSCROLL

强制样式 : $WS_TABSTOP, $LBS_NOTIFY

exStyle

[可选] 控件的扩展样式. 查看附录 扩展样式表.

默认值 ( -1) : $WS_EX_CLIENTEDGE

返回值

成功:

返回控件标识符(控件ID).

失败:

返回 0.

备注

要获得控件的值, 查看 GUICtrlRead().

设置或者修改控件信息, 参考 GUICtrlUpdate...() 控件更新控件更新类函数.

 

列表项目可由 GUICtrlSetData() 设置

 

要限制使用水平滚动条请使用 GUICtrlSetLimit()

 

要在默认样式上添加新样式, 可使用 BitOR($GUI_SS_DEFAULT_LIST, 新样式,...) 语句.

使用上面列出的值必须将 #include <ListBoxConstants.au3> 语句写入脚本中.

 

默认大小 $GUI_DOCKAUTO 出现的大小和位置.

相关

GUICoordMode (Option), GUICtrlSetData, GUICtrlSetLimit, GUICtrlUpdate..., GUIGetMsg

函数示例

#include <GUIConstantsEx.au3>
#include <MsgBoxConstants.au3>
Example()
Func Example()
    Local $sMESSAGE = "The following buttons have been clicked"
    GUICreate("My GUI list") ; will create a dialog box that when displayed is centered
    Local $idAdd = GUICtrlCreateButton("Add", 64, 32, 75, 25)
    Local $idClear = GUICtrlCreateButton("Clear", 64, 72, 75, 25)
    Local $idMylist = GUICtrlCreateList("buttons that have been clicked", 176, 32, 121, 97)
    GUICtrlSetLimit(-1, 200) ; to limit horizontal scrolling
    GUICtrlSetData(-1, $sMESSAGE)
    Local $idClose = GUICtrlCreateButton("my closing button", 64, 160, 175, 25)
    GUISetState(@SW_SHOW)
    ; Loop until the user exits.
    While 1
        Switch GUIGetMsg()
            Case $GUI_EVENT_CLOSE
                ExitLoop
            Case $idAdd
                GUICtrlSetData($idMylist, "You clicked button No1|")
            Case $idClear
                GUICtrlSetData($idMylist, "")
            Case $idClose
                MsgBox($MB_SYSTEMMODAL, "", "the closing button has been clicked", 2)
                Exit
        EndSwitch
    WEnd
EndFunc   ;==>Example

----------------------------------------