TreeView

TV := GuiObj.Add("TreeView", Options)

TV := GuiObj.AddTreeView(Options)

MyGui := Gui()
TV := MyGui.Add("TreeView")
P1 := TV.Add("First parent")
P1C1 := TV.Add("Parent 1's first child", P1)  ; Specify P1 to be this item's parent.
P2 := TV.Add("Second parent")
P2C1 := TV.Add("Parent 2's first child", P2)
P2C2 := TV.Add("Parent 2's second child", P2)
P2C2C1 := TV.Add("Child 2's first child", P2C2)

MyGui.Show  ; Show the window and its TreeView.

MyGui := Gui()
ImageListID := IL_Create(10)  ; Create an ImageList with initial capacity for 10 icons.
Loop 10  ; Load the ImageList with some standard system icons.
    IL_Add(ImageListID, "shell32.dll", A_Index)
TV := MyGui.Add("TreeView", "ImageList" . ImageListID)
TV.Add("Name of Item", 0, "Icon4")  ; Add an item to the TreeView and give it a folder icon.
MyGui.Show

TV := MyGui.Add("TreeView", "-ReadOnly")
TV.OnEvent("ItemEdit", TV_Edit)  ; Call TV_Edit whenever a user has finished editing an item.
; ...
TV_Edit(TV, Item)
{
    TV.Modify(TV.GetParent(Item), "Sort")  ; This works even if the item has no parent.
}

Add

TreeViewに新しいアイテムを追加します。

ItemID := TV.Add(Name, ParentItemID, Options)

パラメータ

名前

型：文字列

テキストまたは数値（数値式の結果を含む）。

ParentItemID

型：整数

If omitted, it defaults to 0, meaning the item will be added at the top level. Otherwise, specify the ID number of the new item's parent.

Options

型：文字列

If blank or omitted, it defaults to no options. Otherwise, specify one or more options from the list below (not case-sensitive). 各オプションと次のオプションはスペースまたはタブで区切る。オプションを削除する場合は、オプションの前にマイナス記号を付けます。オプションを追加する場合は、プラス記号を使用することができますが、必須ではありません。

太字：項目名を太字で表示します。後でアイテムのボールドを解除するには、TV.Modify(ItemID, "-Bold")を使用します。Boldの直後に、開始状態を示す0または1を続けることもできる。

チェックTreeViewにチェックボックスがある場合）アイテムの左にチェックマークを表示します。後でチェックを外すには、TV.Modify(ItemID, "-Check")を使用します。Checkの直後に、開始状態を示す0または1を続けることもできる。つまり、"Check"も"Check".VarContainingOneは同じである（ここで使われているピリオドは連結演算子である）。

展開する：アイテムを展開し、その子アイテムを表示します。後でアイテムを折りたたむには、TV.Modify(ItemID, "-Expand")を使用します。子供がいない場合、Modify メソッドはアイテムの ID ではなく 0 を返します。対照的に、Addメソッドは、後でそのアイテムに子供が追加された場合に備えて、そのアイテムを拡張されたものとしてマークする。下の「選択」オプションとは異なり、項目を展開してもその親項目は自動的に展開されません。最後に、Expandの直後に、開始状態を示す0または1を続けることもできる。言い換えれば、"Expand"も"Expand".VarContainingOneは同じである。

First | Sort | N:これらのオプションはAddメソッドにのみ適用されます。新しいアイテムの位置は、その兄弟アイテム（兄弟アイテムとは、同じレベルにある他のアイテムのことです）との相対的な位置関係で指定されます。これらのオプションがない場合、新しい項目は最後/最下部の兄弟として追加されます。そうでない場合は、Firstという単語を指定して、その項目を最初の兄弟／一番上の兄弟として追加するか、Sortという単語を指定して、その項目をアルファベット順に兄弟の中に挿入する。プレーンな整数Nが指定された場合、それは新しい項目を挿入する兄弟のID番号とみなされる（Nが唯一のオプションの場合、引用符で囲む必要はない）。

Icon（アイコン）： Icon（アイコン）という単語と、アイテム名の左に表示されるこのアイテムのアイコンの番号を指定します。このオプションがない場合、ImageListの最初のアイコンが使われます。空白のアイコンを表示するには、ImageList のアイコンの数より大きい数を指定します。コントロールにイメージリストがない場合、アイコンは表示されず、アイコンのためのスペースも確保されません。

選択：項目を選択します。一度に1つの項目しか選択できないため、以前に選択されていた項目は自動的に選択解除される。さらに、このオプションは、必要に応じて、その親を展開することによって、新しく選択された項目を明らかにする。現在の選択範囲を知るには、GetSelectionメソッドを呼び出します。

並べ替え： Modify メソッドの場合、このオプションは、指定された項目の子をアルファベット順に並べ替えます。代わりにすべてのトップレベル項目をソートするには、TV.Modify(0, "Sort")を使用します。子供がいない場合は、変更された項目のIDの代わりに0が返される。

Vis：必要に応じて、TreeViewをスクロールしたり、親を展開したりして、アイテムが完全に表示されるようにします。

VisFirst:上記と同じですが、TreeViewもスクロールされ、可能であればアイテムが一番上に表示されます。このオプションは通常、AddメソッドよりもModifyメソッドで使用した方が効果的です。

戻り値

型：整数

On success, this method returns the unique ID number of the newly added item. On failure, it returns 0.

備考

多数のアイテムを追加する場合、アイテムを追加する前にTV.Opt("-Redraw")を使用し、その後にTV.Opt("+Redraw")を使用することでパフォーマンスを向上させることができる。詳細は「再描画」を参照。

Modify

アイテムの属性や名前を変更する。

ItemID := TV.Modify(ItemID , Options, NewName)

パラメータ

ItemID

型：整数

The ID number of the item to modify.

Options

型：文字列

If this and the NewName parameter is omitted, the item will be selected. Otherwise, specify one or more options from the list above.

NewName

型：文字列

省略された場合、現在の名前は変更されない。Otherwise, specify the new name of the item.

戻り値

型：整数

This method returns the item's own ID.

Delete

指定された項目またはすべての項目を削除します。

TV.Delete(ItemID)

パラメータ

ItemID

型：整数

省略された場合、TreeViewのすべてのアイテムが削除されます。Otherwise, specify the ID number of the item to delete.

GetSelection

選択された項目の ID 番号を返します。

ItemID := TV.GetSelection()

戻り値

型：整数

This method returns the selected item's ID number.

GetCount

コントロール内の項目の総数を返します。

Count := TV.GetCount()

戻り値

型：整数

This method returns the total number of items in the control. The value is always returned immediately because the control keeps track of the count.

GetParent

Returns the ID number of the specified item's parent.

ParentItemID := TV.GetParent(ItemID)

パラメータ

ItemID

型：整数

The ID number of the item to check.

戻り値

型：整数

This method returns the ID number of the specified item's parent. If the item has no parent, it returns 0, which applies to all top-level items.

GetChild

指定された項目の先頭/末尾の子の ID 番号を返します。

ChildItemID := TV.GetChild(ItemID)

パラメータ

ItemID

型：整数

The ID number of the item to check. If 0, the ID number of the first/top item in the TreeView is returned.

戻り値

型：整数

This method returns the ID number of the specified item's first/top child. If there is no child, it returns 0.

GetPrev

指定された項目の上にある兄弟の ID 番号を返します。

PrevItemID := TV.GetPrev(ItemID)

ItemID

型：整数

The ID number of the item to check.

戻り値

型：整数

This method returns the ID number of the sibling above the specified item. If there is no sibling, it returns 0.

GetNext

指定された項目の次の項目の ID 番号を返します。

NextItemID := TV.GetNext(ItemID, ItemType)

パラメータ

ItemID

型：整数

If omitted, it defaults to 0, meaning the ID number of the first/top item in the TreeView is returned. Otherwise, specify the ID number of the item to check.

ItemType

型：文字列

省略した場合は、指定した項目より下の兄弟のID番号を取得する。Otherwise, specify one of the following strings:

Full or F: Retrieves the next item regardless of its relationship to the specified item. This allows the script to easily traverse the entire tree, item by item. See the example below.

Check, Checked or C: Gets only the next item with a checkmark.

戻り値

型：整数

This method returns the ID number of the next item below the specified item. If there is no next item, it returns 0.

備考

The following example traverses the entire tree, item by item:

ItemID := 0  ; Causes the loop's first iteration to start the search at the top of the tree.
Loop
{
    ItemID := TV.GetNext(ItemID, "Full")  ; Replace "Full" with "Checked" to find all checkmarked items.
    if not ItemID  ; No more items in tree.
        break
    ItemText := TV.GetText(ItemID)
    MsgBox('The next Item is ' ItemID ', whose text is "' ItemText '".')
}

GetText

指定された項目のテキスト/名前を取得します。

Text := TV.GetText(ItemID)

パラメータ

ItemID

型：整数

The ID number of the item whose text to be retrieved.

戻り値

型：文字列

This method returns the retrieved text. Only up to 8191 characters are retrieved.

Get

Returns the ID number of the specified item if it has the specified attribute.

ItemID := TV.Get(ItemID, Attribute)

パラメータ

ItemID

型：整数

The ID number of the item to check.

Attribute

型：文字列

Specify one of the following strings:

E, Expand or Expanded: The item is currently expanded (i.e. its children are being displayed).

C, Check or Checked: The item has a checkmark.

B or Bold: The item is currently bold in font.

戻り値

型：整数

If the specified item has the specified attribute, its own ID is returned. Otherwise, 0 is returned.

備考

Since an IF-statement sees any non-zero value as "true", the following two lines are functionally identical: if TV.Get(ItemID, "Checked") = ItemID and if TV.Get(ItemID, "Checked").

SetImageList

Sets or replaces an ImageList for displaying icons.

PrevImageListID := TV.SetImageList(ImageListID , IconType)

パラメータ

ImageListID

型：整数

The ID number returned from a previous call to IL_Create.

IconType

型：整数

省略された場合、デフォルトは 0 です。Otherwise, specify 2 for state icons (which are not yet directly supported, but could be used via SendMessage).

戻り値

型：整数

On success, this method returns the ImageList ID that was previously associated with the TreeView. On failure, it returns 0. このような切り離されたImageListは、通常IL_Destroyで破棄する必要があります。

MyGui.Add("Button", "Hidden Default", "OK").OnEvent("Click", ButtonOK)
...
ButtonOK(*) {
    global
    if MyGui.FocusedCtrl != TV
        return
    MsgBox("Enter was pressed. The selected item ID is " TV.GetSelection())
}

; The following folder will be the root folder for the TreeView. Note that loading might take a long
; time if an entire drive such as C:\ is specified:
TreeRoot := A_MyDocuments
TreeViewWidth := 280
ListViewWidth := A_ScreenWidth/2 - TreeViewWidth - 30

; Create the MyGui window and display the source directory (TreeRoot) in the title bar:
MyGui := Gui("+Resize", TreeRoot)  ; Allow the user to maximize or drag-resize the window.

; Create an ImageList and put some standard system icons into it:
ImageListID := IL_Create(5)
Loop 5
    IL_Add(ImageListID, "shell32.dll", A_Index)
; Create a TreeView and a ListView side-by-side to behave like Windows Explorer:
TV := MyGui.Add("TreeView", "r20 w" TreeViewWidth " ImageList" ImageListID)
LV := MyGui.Add("ListView", "r20 w" ListViewWidth " x+10", ["Name","Modified"])

; Create a Status Bar to give info about the number of files and their total size:
SB := MyGui.Add("StatusBar")
SB.SetParts(60, 85)  ; Create three parts in the bar (the third part fills all the remaining width).

; Add folders and their subfolders to the tree. Display the status in case loading takes a long time:
M := Gui("ToolWindow -SysMenu Disabled AlwaysOnTop", "Loading the tree..."), M.Show("w200 h0")
DirList := AddSubFoldersToTree(TreeRoot, Map())
M.Hide()

; Call TV_ItemSelect whenever a new item is selected:
TV.OnEvent("ItemSelect", TV_ItemSelect)

; Call Gui_Size whenever the window is resized:
MyGui.OnEvent("Size", Gui_Size)

; Set the ListView's column widths (this is optional):
Col2Width := 70  ; Narrow to reveal only the YYYYMMDD part.
LV.ModifyCol(1, ListViewWidth - Col2Width - 30)  ; Allows room for vertical scrollbar.
LV.ModifyCol(2, Col2Width)

; Display the window. The OS will notify the script whenever the user performs an eligible action:
MyGui.Show

AddSubFoldersToTree(Folder, DirList, ParentItemID := 0)
{
    ; This function adds to the TreeView all subfolders in the specified folder
    ; and saves their paths associated with an ID into an object for later use.
; It also calls itself recursively to gather nested folders to any depth.
    Loop Files, Folder "\*.*", "D"  ; Retrieve all of Folder's sub-folders.
    {
        ItemID := TV.Add(A_LoopFileName, ParentItemID, "Icon4")
        DirList[ItemID] := A_LoopFilePath
        DirList := AddSubFoldersToTree(A_LoopFilePath, DirList, ItemID)
    }
    return DirList
}

TV_ItemSelect(thisCtrl, Item)  ; This function is called when a new item is selected.
{
    ; Put the files into the ListView:
    LV.Delete  ; Clear all rows.
    LV.Opt("-Redraw")  ; Improve performance by disabling redrawing during load.
    TotalSize := 0  ; Init prior to loop below.
    Loop Files, DirList[Item] "\*.*"  ; For simplicity, omit folders so that only files are shown in the ListView.
    {
        LV.Add(, A_LoopFileName, A_LoopFileTimeModified)
        TotalSize += A_LoopFileSize
    }
    LV.Opt("+Redraw")

; Update the three parts of the status bar to show info about the currently selected folder:
    SB.SetText(LV.GetCount() " files", 1)
    SB.SetText(Round(TotalSize / 1024, 1) " KB", 2)
    SB.SetText(DirList[Item], 3)
}

Gui_Size(thisGui, MinMax, Width, Height)  ; Expand/Shrink ListView and TreeView in response to the user's resizing.
{
    if MinMax = -1  ; The window has been minimized.  No action needed.
        return
    ; Otherwise, the window has been resized or maximized. Resize the controls to match.
    TV.GetPos(,, &TV_W)
    TV.Move(,,, Height - 30)  ; -30 for StatusBar and margins.
    LV.Move(,, Width - TV_W - 30, Height - 30)
}