Function Reference

GUICtrlCreateListViewItem

リストビューアイテムを作成します。

GUICtrlCreateListViewItem ( "text", listviewID )

 

パラメータ

text Opt("GUIDataSeparatorChar")で区切られた サブアイテムテキスト。
listviewID アイテムを保持するリストビューコントロールのコントロールID。

 

返し値

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

 

注意

この関数は選択可能な個々のリストビューアイテムを作成します。アイテムの機能は通常のコントロールと同じでGUICtrlSetDataで設定することができます。
アイテムは他のコントロールと同様にGUICtrlDeleteで削除することが可能です。
リストビューアイテムは$GUI_DROPACCEPTEDを設定したエディットコントロール、インプットコントロールにドラッグアンドドロップすることが可能です。
列のサイズ変更についてはGUICtrlCreateListViewを参照してください。

特殊フラグの$GUI_BKCOLOR_TRANSPARENTをリストビューコントロールに使用することで、リストビューアイテムのラインの背景色を交互にかわるように設定できます。
奇数番目のラインはGUICtrlSetBkColorでリストビューコントロールに設定された色になります。
偶数番目のラインはGUICtrlSetBkColorでリストビューアイテムコントロールに設定された色になります。

 

関連

GUICtrlCreateListView, GUICtrlSetData, GUICtrlSetState, GUICtrlDelete, GUIGetMsg, GUICtrlRead, GUIDataSeparatorChar (Option)

 


#include <GUIConstantsEx.au3>
#include <WindowsConstants.au3>

Opt('MustDeclareVars', 1)

Example()

Func Example()
    Local $listview, $button, $item1, $item2, $item3, $input1, $msg
   
    GUICreate("listview items", 220, 250, 100, 200, -1, $WS_EX_ACCEPTFILES)
    GUISetBkColor(0x00E0FFFF)  ; 背景色を変更

    $listview = GUICtrlCreateListView("col1  |col2|col3  ", 10, 10, 200, 150);,$LVS_SORTDESCENDING)
    $button = GUICtrlCreateButton("Value?", 75, 170, 70, 20)
    $item1 = GUICtrlCreateListViewItem("item2|col22|col23", $listview)
    $item2 = GUICtrlCreateListViewItem("............item1|col12|col13", $listview)
    $item3 = GUICtrlCreateListViewItem("item3|col32|col33", $listview)
    $input1 = GUICtrlCreateInput("", 20, 200, 150)
    GUICtrlSetState(-1, $GUI_DROPACCEPTED)   ; ドラッグアンドドロップ許可
    GUISetState()
    GUICtrlSetData($item2, "|ITEM1")
    GUICtrlSetData($item3, "||COL33")
    GUICtrlDelete($item1)

    Do
        $msg = GUIGetMsg()
       
        Select
            Case $msg = $button
                MsgBox(0, "listview item", GUICtrlRead(GUICtrlRead($listview)), 2)
            Case $msg = $listview
                MsgBox(0, "listview", "clicked=" & GUICtrlGetState($listview), 2)
        EndSelect
    Until $msg = $GUI_EVENT_CLOSE
EndFunc   ;==>Example