API version 1

- ‐

insert

オブジェクトに要素を追加します。

このメソッドは実行する対象が非配列オブジェクト、配列定義オブジェクト、または配列要素オブジェクトにより動作が変わります。

非配列オブジェクトに対して実行すると、指定したオブジェクトをオブジェクトツリー上の直前の位置に挿入します。

配列定義オブジェクト(ary[5]の時のary)に対して実行すると、配列の末尾に新しい要素が挿入されます。

配列要素オブジェクト(ary[5]の時のary[1]など)に対して実行すると、直前の位置に新しい要素が挿入されます。

呼出形式一覧

呼出形式	説明
void insert(reference child[, string name])	childをオブジェクトツリー上の自身の直前の位置にname名で挿入します。
void insert([integer count])	自身が配列定義オブジェクトの場合に配列要素の末尾にcount個新しい要素が挿入されます。
void insert([integer elements])	自身が配列要素オブジェクトの場合に直前の位置にelements個新しい要素が挿入されます。

戻り値一覧

戻り値	説明
void	なし

引数一覧

引数	説明
child	挿入するオブジェクトの参照。
name	オブジェクト名 省略すると無名で挿入されます。
count	挿入する要素の数 省略すると1件挿入されます。
elements	挿入する要素の数 省略すると1件挿入されます。

例外

コード	説明
SYS-24:1	配列添字が不正です

使用例

/* 配列オブジェクトでの利用例 */
Record arrayRec[] {
    Number numItem;
    String strItem;
}
arrayRec.insert(10);

/* 配列要素での利用例 */
Record arrayRec[5] {
    Number numItem;
    String strItem;
}
arrayRec[1].insert(2);

関連項目

truncate メソッド

使用例 CRSダウンロード ダウンロード(Dialog12.crs)

Form Objcntl {
   x = 0;
   y = 0;
   width = 800;
   height = 600;
   TextBox textbox1 {
           x = 100;
           y = 120;
           width = 168;
           height = 48;
   }
   Button button1 {
           x = 100;
           y = 200;
           width = 160;
           height = 48;
           Title = "ユーザー定義イベントを\r\n発生させる" ;

           function onTouch(e) {
                   var eventname = "UserEvent";
                   var userEvent1 =
                           new Event(eventname)  {
                                   String data ;
                           }
                   userEvent1.data.Value = ^.TextBox1.Value;
                   PostEvent(userEvent1) ;
           }
   }

   function OnUserEvent(e) {
           //.MessageBox(e.data.Value) ;
           print("from = ",e.from) ;

           var child = new Number[5];
           child[0] = 5;
           child[1] = 4;
           child[2] = 3;
           child[3] = 2;
           child[4] = 1;
           append(child, "TheArray");
           print("clasName=",child.className) ;
           print("array=",child.isArray," inx= ",child.index," Len= ",child.length);
           print("name=",child.name);
           print("type=",child.subType);
           print("change=",child.useChange);

           var fun = findObject("TheArray", FIND_EVENTPATH);
           if (fun == null) { print("null return") ; } ;
           print("find=",fun);
           for (var i in child) {
                   print(" indx=",i, " value=",child[i].value, "\n");
           }
           child.insert( 0 ) ;
           var ca = getChildObjects();
           for (var j in ca) {
                   if (ca[j] != null) {
                           print("inx= ", j, " value= ",ca[j].value ) ;
                   }
           }
           //.get("dialog12.crs");
           /* child.truncate() ; #このサンプルでは使えません */
   }
}