Shellid 関数 (LotusScript 言語)

別のプログラムを起動し、そのタスク ID を返します。

構文

Shellid ( program [ , windowStyle ] )

要素

program

実行するプログラムの名前と引数を表す文字列式です。program は、拡張子 .BAT、.COM、.PIF、.EXE を持つ実行ファイルの名前にすることができます。拡張子は省略できます。必要に応じて完全パスを指定できます。

DOS の内部コマンドを使用するとエラーとなります。

windowStyle

オプション。次の表に示す有効なウィンドウの種類を示す数値です。

スタイル

説明

定数

1、5、9

フォーカスを持った通常ウィンドウ

SHELL_NORMAL_FOCUS

2

フォーカスを持ったアイコン (既定)

SHELL_MIN_FOCUS

3

フォーカスを持った最大表示ウィンドウ

SHELL_MAX_FOCUS

4、8

フォーカスなしの通常ウィンドウ

SHELL_NORMAL_NO_FOCUS

6、7

フォーカスなしのアイコン

SHELL_MIN_NO_FOCUS

これらの定数は、ファイル lsconst.lss 内に定義されます。このファイルをスクリプト内に取り込めば、定数名に割り当てられた数値ではなく定数名を使用できるようになります。

戻り値

オペレーティングシステムが Windows または Macintosh の場合は、LotusScript® が program の起動に成功すると、Shellid からプログラムのタスク ID が返されます。これは、プログラムを一意に識別する番号です。その他のオペレーティングシステムで LotusScript が program の起動に成功した場合は、Shellid から数値 33 が返されます。

program を起動できなかった場合は、Shellid からエラーが返されます。

使用法

Shellid は、その戻り値が使用されるように、式や代入ステートメントの中で呼び出さなければなりません。

Shellid がプログラムを起動すると、その完了を待たずにスクリプトの実行が継続されます。スクリプトの残りの部分が実行される前に、Shellid で起動されたプログラムが実行を終えているかどうかは確認できません。

ShellID は制限された操作であるため、実行時セキュリティレベル 2 以上の「制限された操作を許可する」を設定していることを確認してください。

この機能により、発生しているプロセスを中止できるプロセスが生成されます。

後でプログラムを終了できるように、関数から「ID」が返されます。この動作が実行されないようにするには、Shell を使用してください。