Function Reference

GUICtrlCreateList

GUI用のリストコントロールを作成します。

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

 

パラメータ

text コントロールのテキスト。
left コントロールの左端。-1を使用するとGUICoordModeに基づいて左端位置が計算されます。
top コントロールの上端。-1を使用するとGUICoordModeに基づいて上端位置が計算されます。
width [オプション] コントロールの幅(デフォルトは最後に使用された幅)。
height [オプション] コントロールの高さ(デフォルトは最後に使用された高さ)。
style [オプション] コントロールのスタイルを定義。GUIコントロールスタイル付録を参照。

デフォルト ( -1) : $LBS_SORT、$WS_BORDER、$WS_VSCROLL
強制適用されるスタイル : $WS_TABSTOP、$LBS_NOTIFY
exStyle [オプション] コントロールの拡張スタイルを定義。拡張スタイル表を参照。

 

返し値

成功 新しく作成したコントロールの識別子(コントロールID)を返します。
失敗 0を返します。

 

注意

コントロールの値を取得する方法についてはGUICtrlReadを参照。
コントロールの情報を設定/変更する方法についてはGUICtrlUpdate...を参照。

リストの選択可能なエントリーはGUICtrlSetDataを使用して設定できます。

水平方向のスクロールを制限するにはGUICtrlSetLimitを使用します。

デフォルトスタイルに他のスタイルを組み合わせる場合はBitOr($GUI_SS_DEFAULT_LIST, newstyle,...)を使用してください。

上で指定されている値を使用するためにはスクリプトに#include <ListBoxConstants.au3>と書く必要があります。

デフォルトのサイズ変更方法は$GUI_DOCKAUTOで左上位置が基準になります。

 

関連

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

 


#include <GUIConstantsEx.au3>

Opt('MustDeclareVars', 1)

Example()

Func Example()
    Local $MESSAGE = "The following buttons have been clicked"
    Local $add, $clear, $mylist, $close, $msg
   
    GUICreate("My GUI list") ; 表示時に中央に表示されるダイアログボックスを作成

    $add = GUICtrlCreateButton("Add", 64, 32, 75, 25)
    $clear = GUICtrlCreateButton("Clear", 64, 72, 75, 25)
    $mylist = GUICtrlCreateList("buttons that have been clicked", 176, 32, 121, 97)
    GUICtrlSetLimit(-1, 200)    ; 水平方向のスクロールを制限
    GUICtrlSetData(-1, $MESSAGE)
    $close = GUICtrlCreateButton("my closing button", 64, 160, 175, 25)

    GUISetState()

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

        Select
            Case $msg = $add
                GUICtrlSetData($mylist, "You clicked button No1|")
            Case $msg = $clear
                GUICtrlSetData($mylist, "")
            Case $msg = $close
                MsgBox(0, "", "the closing button has been clicked", 2)
                Exit
        EndSelect
    WEnd
EndFunc   ;==>Example