API version 1

- ‐

append

自身の子アイテムの最後にツリーアイテムを追加します。

文字列を指定するとその文字列をタイトルにしたツリーアイテムが追加されます。 XmlDocumentオブジェクトを指定するとXMLの内容に従って構築されたツリーが追加されます。

呼出形式一覧

呼出形式	説明
CRS::Common::UI::TreeItem append(CRS::Common::Core::String title)	指定されたタイトルのツリーアイテムを追加します。
CRS::Common::UI::TreeItem append(CRS::Common::Core::XmlDocument doc)	XMLの内容からツリーを生成し追加します。

戻り値一覧

戻り値	説明
CRS::Common::UI::TreeItem	追加されたツリーアイテムのアクセッサ。XMLを追加した場合は追加したXML内で最上位に位置するツリーアイテムのアクセッサ。

引数一覧

引数	説明
title	追加するツリーアイテムのタイトル。
doc	ツリー定義のXMLデータ。

例外

なし

関連項目

insertメソッド

XmlDocumentクラス

使用例 CRSダウンロード ダウンロード(TreeView_FolderClose.png) ダウンロード(TreeView_FolderOpen.png) ダウンロード(TreeView_Test.json) ダウンロード(TreeView_Test.xml)

Form TreeItem_methods {
   X = 0;
   Y = 0;
   width = 800;
   height = 600;

   TreeView treeView1 {
           x = 8;
           y = 8;
           width = 640;
           height = 480;

           checkBoxes = true;

           var closeImage = new Image();
           closeImage.loadImage("TreeView_FolderClose.png");
           setImage(0, closeImage);
           var openImage = new Image();
           openImage.loadImage("TreeView_FolderOpen.png");
           setImage(1, openImage);

           function onClicked(e) {
                   if (e.item == null) {
                           print("空白エリアがクリックされました");
                           return;
                   }
                   print("TreeItem(id=" + str(e.item.id) + ", title=" + e.item.title + ") がクリックされました。");
           };

           function getNumChildren(item) {
                   var numItems = 0;
                   for (var child = item.child; child != null; child = child.next) {
                           numItems ++;
                   }
                   return numItems;
           }
   }

   Button buttonAddChild {
           x = 656;
           y = 8;
           width = 128;
           Height = 24;
           Title = "Add child";
           function onTouch(e) {
                   var item = ^.treeView1.selectedItem;
                   var title = "Item";
                   if (item == null) {
                           item = ^.treeView1.rootItem;
                   } else {
                           item.Expanded = true;
                           title = item.Title;
                   }
                   var numItems = ^.treeView1.getNumChildren(item);
                   var titleToAdd = title + "-" + str(numItems);
                   var itemAdded = item.Append(titleToAdd);
                   itemAdded.selected = true;
                   itemAdded.openIcon = 1;
                   itemAdded.closeIcon = 0;

                   print("TreeItem(id=" + str(itemAdded.id) + ", title=" + itemAdded.title + ") を追加しました。");
           }
   }

   Button buttonInsert {
           x = 656;
           y = 40;
           width = 128;
           Height = 24;
           Title = "Insert";
           function onTouch(e) {
                   var item = ^.treeView1.selectedItem;
                   if (item == null) {
                           print("Item not selected");
                           return;
                   }
                   var itemParent = item.parent;
                   var title = itemParent.Title;
                   if (itemParent.id == ^.treeView1.RootItem.id) {
                           title = "Item";
                   }
                   var numItems = ^.treeView1.getNumChildren(itemParent);
                   var titleToInsert = title + "-" + numItems.toString();
                   var itemInserted = item.Insert(titleToInsert);
                   itemInserted.selected = true;
                   itemInserted.openIcon = 1;
                   itemInserted.closeIcon = 0;

                   print("TreeItem(id=" + str(itemInserted.id) + ", title=" + itemInserted.title + ") を挿入しました。");
           }
   }

   Button buttonDeleteSelected {
           x = 656;
           y = 72;
           width = 128;
           Height = 24;
           Title = "Delete selected";
           function onTouch(e) {
                   var item = ^.treeView1.selectedItem;
                   if (item != null) {
                           print("TreeItem(id=" + str(item.id) + ", title=" + item.title + ") を削除します。(子アイテムを含む)");

                           #選択されているTreeItemを子要素を含めて削除します
                           item.delete();
                   }
           }
   }

   Button buttonDeleteChild {
           x = 656;
           y = 104;
           width = 128;
           Height = 24;
           Title = "Delete child";
           function onTouch(e) {
                   var item = ^.treeView1.selectedItem;
                   if (item != null) {
                           print("TreeItem(id=" + str(item.id) + ", title=" + item.title + ") の子アイテムを削除します。");

                           #選択されているTreeItemの子要素を削除します
                           item.deleteChild();
                   }
           }
   }

   Button buttonOpenAppendXml {
           x = 656;
           y = 168;
           width = 128;
           Height = 24;
           Title = "Open XML(Append)...";

           function onTouch(e) {
                   var xmlDom = new XmlDocument;
                   xmlDom.get("TreeView_Test.xml");

                   var itemToAppend = ^.treeView1.selectedItem;
                   if (itemToAppend == null) {
                           itemToAppend = ^.treeView1.rootItem;
                   }

                   #  XmlDocument から復元されたツリーを itemToAppend の子アイテムとして追加します
                   itemToAppend.append(xmlDom);
                   itemToAppend.expandAll();
                   print("XmlDocument から復元されたツリーを選択されたアイテムの子アイテムとして追加しました");
           }
   }

   Button buttonOpenInsertXml {
           x = 656;
           y = 200;
           width = 128;
           Height = 24;
           Title = "Open XML(Insert)...";

           function onTouch(e) {
                   var item = ^.treeView1.selectedItem;
                   if (item == null) {
                           print("アイテムが選択されていないため挿入しません");
                           return;
                   }

                   var xmlDom =  new XmlDocument;
                   xmlDom.get("TreeView_Test.xml");

                   # XmlDocument から復元されたツリーを item の前に挿入します
                   item.insert(xmlDom);
                   item.parent.expandAll();
                   print("XmlDocument から復元されたツリーを選択されたアイテムの前に挿入しました");
           }
   }

   Button buttonOpenAppendJson {
           x = 656;
           y = 232;
           width = 128;
           Height = 24;
           Title = "Open JSON(Append)...";

           function onTouch(e) {
                   var jsonDom = new JsonDocument;
                   jsonDom.get("TreeView_Test.json");

                   var itemToAppend = ^.treeView1.selectedItem;
                   if (itemToAppend == null) {
                           itemToAppend = ^.treeView1.rootItem;
                   }

                   # JsonDocument から復元されたツリーを itemToAppend の子アイテムとして追加します
                   itemToAppend.append(jsonDom);
                   itemToAppend.expandAll();
                   print("JsonDocument から復元されたツリーを選択されたアイテムの子アイテムとして追加しました");
           }
   }

   Button buttonOpenInsertJson {
           x = 656;
           y = 264;
           width = 128;
           height = 24;
           Title = "Open JSON(Insert)...";

           function onTouch(e) {
                   var item = ^.treeView1.selectedItem;
                   if (item == null) {
                           print("アイテムが選択されていないため挿入しません");
                           return;
                   }

                   var jsonDom =  new JsonDocument;
                   jsonDom.get("TreeView_Test.json");

                   # JsonDocument から復元されたツリーを item の前に挿入します
                   item.insert(jsonDom);
                   item.parent.expandAll();
                   print("JsonDocument から復元されたツリーを選択されたアイテムの前に挿入しました");
           }
   }
}