「マクロリファレンス:3:Shell オブジェクト」を編集中

= メソッド =
== CreateFolder メソッド ==
フォルダーを作成します。

;構文
<syntaxhighlight lang="javascript">
shell.CreateFolder(strFolder);
</syntaxhighlight>

;引数
strFolder
:作成するフォルダーのパスを指定します。相対パスを使用する場合は、Mery.exe からの相対パスとなります。

== DeleteFile メソッド ==
指定したファイルを削除します。

;構文
<syntaxhighlight lang="javascript">
shell.DeleteFile(strFile);
</syntaxhighlight>

;引数
strFile
:削除するファイルのパスを指定します。相対パスを使用する場合は、Mery.exe からの相対パスとなります。

== DeleteFolder メソッド ==
指定したフォルダー、サブフォルダー、およびファイルを削除します。

;構文
<syntaxhighlight lang="javascript">
shell.DeleteFolder(strFolder, bRecursive);
</syntaxhighlight>

;引数
strFolder
:削除するフォルダーのパスを指定します。相対パスを使用する場合は、Mery.exe からの相対パスとなります。

bRecursive
:true を指定すると指定したフォルダー、サブフォルダー、およびファイルを削除します。それ以外の場合は false を指定します。省略すると false が使用されます。

== FileExists メソッド ==
指定したファイルが存在する場合は true を、存在しない場合は false を返します。

;構文
<syntaxhighlight lang="javascript">
var b = shell.FileExists(strFile);
</syntaxhighlight>

;引数
strFile
:存在するかどうかを調べるファイルのパスを指定します。相対パスを使用する場合は、Mery.exe からの相対パスとなります。

== FolderExists メソッド ==
指定したフォルダーが存在する場合は true を、存在しない場合は false を返します。

;構文
<syntaxhighlight lang="javascript">
var b = shell.FolderExists(strFolder);
</syntaxhighlight>

;引数
strFolder
:存在するかどうかを調べるフォルダーのパスを指定します。相対パスを使用する場合は、Mery.exe からの相対パスとなります。

== GetFileAttributes メソッド ==
指定したファイルまたはフォルダーの属性を取得します。

;構文
<syntaxhighlight lang="javascript">
var n = shell.GetFileAttributes(strFile);
</syntaxhighlight>

;引数
strFile
:属性を取得するファイルまたはフォルダーのパスを指定します。相対パスを使用する場合は、Mery.exe からの相対パスとなります。

== GetKeyState メソッド ==
指定した仮想キーの状態を取得します。

;構文
<syntaxhighlight lang="javascript">
var i = shell.GetKeyState(nVirtKey);
</syntaxhighlight>

;引数
nVirtKey
:仮想キーを指定します。仮想キーが文字または数字 (A から Z、a から z、または 0 から 9) の場合、nVirtKey はその文字の ASCII 値を指定します。 その他のキーの場合は、[https://learn.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes 仮想キー コード]の値を指定します。

;戻り値
:負の値の場合、キーは押されています。CAPS LOCK キーなどのキーは、下位ビットが 1 の場合、オンになっています。

;バージョン
Mery Ver 3.7.2 以降で使用できます。

== Run メソッド ==
新しいプロセスでプログラムを実行します。

;構文
<syntaxhighlight lang="javascript">
var n = shell.Run(strCommand, nWindowStyle, bWaitOnReturn, strParameter, strFolder);
</syntaxhighlight>

;引数
strCommand
:実行するコマンドを指定します。相対パスを使用する場合は、Mery.exe からの相対パスとなります。

nWindowStyle
:プログラム ウィンドウの外観を示す整数値を指定します。このパラメーターは省略できます。
:{|class="wikitable"
|1||ウィンドウをアクティブにして表示します。ウィンドウが最小化または最大化されている場合、元のサイズと位置に復元します。
|-
|2||ウィンドウをアクティブにして最小化ウィンドウで表示します。
|-
|3||ウィンドウをアクティブにして最大化ウィンドウで表示します。
|-
|4||ウィンドウを最新のサイズと位置で表示します。アクティブなウィンドウは切り替わりません。
|}

bWaitOnReturn
:プログラムの実行が終了するまでスクリプトを待機させるかどうかを示すブール値を指定します。このパラメーターは省略できます。

strParameter
:実行ファイルに渡すパラメーターを指定します。このパラメーターは省略できます。

strFolder
:作業フォルダーを指定します。相対パスを使用する場合は、Mery.exe からの相対パスとなります。このパラメーターは省略できます。

== SetFileAttributes メソッド ==
指定したファイルまたはフォルダーの属性を設定します。

;構文
<syntaxhighlight lang="javascript">
shell.SetFileAttributes(strFile, nAttr);
</syntaxhighlight>

;引数
strFile
:属性を設定するファイルまたはフォルダーのパスを指定します。相対パスを使用する場合は、Mery.exe からの相対パスとなります。

nAttr
:次の値の組み合わせを指定します。
:{|class="wikitable"
|0||標準ファイル
|-
|1||読み取り専用ファイル
|-
|2||隠しファイル
|-
|4||システム ファイル
|-
|32||アーカイブ ファイル
|}