4D Doc Center : PROCESS PROPERTIES

4D v14.3

PROCESS PROPERTIES


PROCESS PROPERTIES ( process ; procName ; procState ; procTime {; procVisible {; uniqueID {; origin}}} )

引数	型	説明
process	倍長整数	プロセス番号
procName	文字	プロセス名
procState	倍長整数	プロセスの状態
procTime	倍長整数	プロセスの稼働時間 (Tick)
procVisible	ブール	TRUE: 表示, FALSE: 非表示
uniqueID	整数	ユニークなプロセス番号
origin	倍長整数	プロセスの発生源

PROCESS PROPERTIESコマンドはprocessに渡したプロセス番号を持つプロセスに関する情報を返します。

このコマンド呼出し後に:

procNameはプロセスの名前を返します。プロセス名で注意すべき点は、次のとおりです:
- プロセスがメソッド実行ダイアログボックスから (新規プロセスオプションを選択した状態で) 起動された場合、プロセスの名前は“P_”で始まりその後に数字が続きます。
- プロセス開始プロパティが選択されたカスタムメニューから起動されたプロセスの場合には、プロセスの名前は“M_”または“ML_”で始まり、その後に数字が続きます。
- Webサーバーによりプロセスが開始されれた場合、名前は"Web Process#"+UUIDです。
- プロセスがアボートしていた場合（そして、そのスロットがまだ再使用されていない場合)、プロセスの名前はそのまま返されます。プロセスがアボートしたかどうかを検出するには、procState=-1を判定します（下記の表を参照）。

procStateは、呼び出しを行った時点のプロセスの状態を返します。この引数は次の定義済定数で提供される値のいずれか1つを返します:

procTimeは、プロセスが起動されてからの稼働時間をtick数 (1/60秒) で返します。
procVisibleが指定された場合には、プロセスが表示されている場合はTRUE、隠されている場合はFALSEを返します。
uniqueIDが指定された場合には、独自のプロセス番号を返します。各プロセスはプロセス番号と、セッション内でユニークなプロセス番号を持っています。ユニークプロセス番号は、2つのプロセス間または2つのプロセスセッションの間で区別することができるようにするものです。これは4Dセッションの間に開始されたプロセス番号に対応するものです。

originが指定された場合には、プロセスの発生元を表わす値を返します。4Dは下記の定数を定義しています (Process Typeテーマ内):

定数	型	値
_o_Web process with context	倍長整数	-11
Apple event manager	倍長整数	-7
Backup process	倍長整数	-19
Cache manager	倍長整数	-4
Client manager process	倍長整数	-31
Created from execution dialog	倍長整数	3
Created from menu command	倍長整数	2
Design process	倍長整数	-2
Event manager	倍長整数	-8
Execute on client process	倍長整数	-14
Execute on server process	倍長整数	1
External task	倍長整数	-9
Indexing process	倍長整数	-5
Internal 4D server process	倍長整数	-18
Internal timer process	倍長整数	-25
Log file process	倍長整数	-20
Main process	倍長整数	-1
Method editor macro process	倍長整数	-17
Monitor process	倍長整数	-26
MSC process	倍長整数	-22
None	倍長整数	0
On exit process	倍長整数	-16
Other 4D process	倍長整数	-10
Other user process	倍長整数	4
Restore Process	倍長整数	-21
Serial Port Manager	倍長整数	-6
Server interface process	倍長整数	-15
SQL Method execution process	倍長整数	-24
Web process on 4D remote	倍長整数	-12
Web process with no context	倍長整数	-3
Web server process	倍長整数	-13

注: 4Dの内部プロセスは負の値を返し、ユーザが作成したプロセスは正の値を返します。

プロセスが存在しない場合、つまり1からCount tasksまでの番号を渡さなかった場合、PROCESS PROPERTIESコマンドは変数パラメータの変更を行いません。

次の例は、変数vName, vState, vTimeSpentに現在のプロセスのプロセス名、プロセスステータス、プロセス時間を返します:

 C_TEXT(vName) ` Initialize the variables

 C_LONGINT(vState)

 C_LONGINT(vTime)

 PROCESS PROPERTIES(Current process;vName;vState;vTimeSpent)