4D v18

folder.copyTo( )

ホーム

 
4D v18
folder.copyTo( )

folder.copyTo( )  


 

説明  

folder.copyTo( ) メソッドはFolder オブジェクト(ソースフォルダ)を、destinationFolder 引数で指定したフォルダへとコピーします。

destinationFolder 引数で指定するフォルダはディスク上に存在している必要があり、そうでない場合にはエラーが生成されます。

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

同じ名前のフォルダがすでにdestinationFolder 引数で指定されたフォルダ内にあり、それが空でない場合、デフォルトで4D はコピーをする前にそのフォルダの中身をチェックし、同じ名前のファイルが存在する場合にはエラーを返します。overwrite 引数にfk overwrite 定数を渡すことで、既存のフォルダの存在を無視して上書きすることができます:

定数 コメント
fk overwrite 4

既存の要素があれば、それを上書きします。

返されるオブジェクト

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

例題  

ユーザーのドキュメントフォルダからデータベースフォルダへとPicturees フォルダをコピーしたい場合を考えます:

 C_OBJECT($userImages;$copiedImages)
 $userImages:=Folder(fk documents folder+"/Pictures/")
 $copiedImages:=$userImages.copyTo(Folder(fk database folder);fk overwrite)



参照 

COPY DOCUMENT
folder.moveTo( )

 
プロパティ 

プロダクト: 4D
テーマ: ファイルとフォルダ

This command can be run in preemptive processes

 
ページの目次 
 
履歴 

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v18)