copyHere メソッド
System.Shell.Item をフォルダにコピーします。
Syntax
System.Shell.Folder.copyHere(oItem [, intOptions])
パラメータ
| oItem |
必須要素です。
コピーする System.Shell.Item です。
|
| intOptions |
任意です。コピー操作オプションの組み合わせを指定する整数です。
注 これらの値は、C++ の SHFILEOPSTRUCT 構造体の fFlags メンバーで使用するために定義されたフラグに基づきます。これらのフラグは、Microsoft Visual Basic、Visual Basic Scripting Edition (VBScript)、または Microsoft JScript には定義されないため、値を定義するか、その数値に相当するものを使用する必要があります。
| 0 | 既定。指定されたオプションはありません。
| | 4 |
進行状況ダイアログ ボックスは表示しません。
| | 8 |
指定した場所に同じ名前のファイルが存在する場合は、コピー元のファイルの名前を変更します。
| | 16 |
表示されたダイアログ ボックスで [すべてはい] をクリックします。
| | 64 |
可能な場合にはアンドゥ情報を維持します。
| | 128 |
ワイルドカード ファイル名 (*.*) が指定された場合にのみ操作を実行します。
| | 256 |
進行状況ダイアログ ボックスを表示しますが、ファイル名は示しません。
| | 512 |
新規ディレクトリの作成を必要とする操作の場合、新規ディレクトリを作成するかどうかの確認をしません。
| | 1024 |
エラーが発生した場合、ユーザー インターフェイスを表示しません。
| | 4096 |
再帰を無効にします。
| | 8192 |
グループとして接続されているファイルをコピーしません。指定したファイルのみコピーします。
|
|
戻り値
戻り値はありません。
解説
この呼び出しを実行するために、SHFolder プロパティを使用して System.Shell.Item から Shell フォルダ オブジェクトを取得する必要があります。
例
以下の例は、システム フォルダにオブジェクトをコピーする方法を示しています。
// メンバー変数。
var oShellFolderItem;
var oShellFolder;
// --------------------------------------------------------------------
// フォルダ ピッカー ダイアログを表示し、Shell.Item オブジェクトを
// 取得します。Shell フォルダ オブジェクトも取得します。
// --------------------------------------------------------------------
function ChooseAFolder()
{
oShellFolderItem = System.Shell.chooseFolder("SDK Choose Folder Example", 0);
if (oShellFolderItem)
{
// System.Shell.Item からフォルダ オブジェクトを取得します。
oShellFolder = oShellFolderItem.SHFolder;
}
}
// --------------------------------------------------------------------
// ガジェットにドロップされたオブジェクトの名前を表示します。
// 必要に応じ、オブジェクトを削除、コピー、または移動します。
// --------------------------------------------------------------------
function GetItemFromDrop()
{
var intIndex = 0;
var oItem;
while(oItem = System.Shell.itemFromFileDrop(event.dataTransfer, intIndex))
{
// 必要に応じオブジェクトを削除します。
if (deleteDrop.checked == true)
{
System.Shell.RecycleBin.deleteItem(oItem.path);
}
// 必要に応じオブジェクトをコピーします。
if ((copyDrop.checked == true) && (oShellFolder!= null))
{
try
{
oShellFolder.copyHere(oItem, 8);
}
catch(e)
{
// エラー ハンドリング。
}
}
// 必要に応じオブジェクトを移動します。
if ((moveDrop.checked == true) && (oShellFolder != null))
{
try
{
oShellFolder.moveHere(oItem, 8);
}
catch(e)
{
// エラー ハンドリング。
}
}
intIndex++;
}
}
適用対象