函数说明

GUICtrlCreateList

在GUI上创建一个列表(List)控件。

GUICtrlCreateList ( "文本", 左侧, 上方 [, 宽度 [, 高度 [, 风格 [, 扩展风格]]]] )

 

参数

文本 控件的文本。
左侧 控件左侧的位置。若此值为 -1 则根据 GUICoordMode 的设置来计算左侧位置。
上方 控件上方的位置。若此值为 -1 则根据 GUICoordMode 的设置来计算上方位置。
宽度 [可选参数] 控件的宽度(默认值为上一个控件的宽度)。
高度 [可选参数] 控件的高度(默认值为上一个控件的高度)。
风格 [可选参数] 指定控件的风格。请查看附录中关于 GUI 控件风格 的说明。

默认值(-1):$LBS_SORT, $WS_BORDER, $WS_VSCROLL, $LBS_NOTIFY
强制性风格:$WS_TABSTOP
扩展风格 [可选参数] 指定控件的扩展风格。请查看附录的 扩展风格表

 

返回值

成功: 返回控件标识符(控件ID)。
失败: 返回值为0。

 

注意

若要获得控件的各种值请查看 GUICtrlRead.
若要设置或修改控件的各种信息请查看 GUICtrlSet....

列表项目可由 GUICtrlSetData 设置。

若要限制水平滚动条的显示请使用 GUICtrlSetLimit

要在默认风格的基础上添加一个新的风格可使用 BitOr($GUI_SS_DEFAULT_LIST, 新风格,...)。

 

相关

GUICoordMode(选项), GUICtrlSetData, GUICtrlSetLimit, GUICtrlSet..., GUIGetMsg

 

示例


#include <GUIConstants.au3>

GLOBAL $MESSAGE = "列表项目1"
GUICreate("我的 GUI 之列表") ; 创建一个居中显示的窗口

$add=GUICtrlCreateButton ("添加", 64,32,75,25)
$clear=GUICtrlCreateButton ("清除", 64,72,75,25)
$mylist=GUICtrlCreateList ("列表项目2", 176,32,121,97)
GUICtrlSetLimit(-1,200) ; 限制水平滚动条
GUICtrlSetData(-1,$MESSAGE)
$close=GUICtrlCreateButton ("我的关闭按钮", 64,160,175,25)

GUISetState ()

$msg = 0
While $msg <> $GUI_EVENT_CLOSE
    $msg = GUIGetMsg()

    Select
         case $msg = $add
        GUICtrlSetData($mylist,"您点击了第一个按钮!")
         case $msg = $clear
        GUICtrlSetData($mylist,"")
         Case $msg = $close
            MsgBox(0,"", "关闭按钮被点击",2)
            Exit
    EndSelect
Wend