folder.moveTo( )

4D v19

folder.moveTo( )

説明

folder.moveTo( ) メソッドはFolder オブジェクト(ソースフォルダ)をdestinationFolder 引数で指定した移行先へと移動するか、名称を変更します。

destinationFolder 引数の移行先はディスク上に存在する必要があります。そうでない場合、エラーが生成されます。

デフォルトでは、フォルダは移動した時に元の名前を維持します。移動したフォルダの名称を変更したい場合、新しい名前をnewName 引数に渡します。新しい名前は命名規則(例: ":", "/", などの文字を含んでいて履けない、など)に則っている必要があります。そうでない場合、エラーが返されます。

返されたオブジェクト

メソッドは移動されたFolder オブジェクトを返します。

例題

フォルダを移動して名称変更したい場合を考えます:

 C_OBJECT($tomove;$moved)

 $docs:=Folder(fk documents folder)

 $tomove:=$docs.folder("Pictures")

 $tomove2:=$tomove.moveTo($docs.folder("Archives");"Pic_Archives")

参照

file.moveTo( )
folder.copyTo( )