4D v16.3
Process state
- 4D Language Reference
-
- Processes
-
- Processes
- Preemptive 4D processes
- Count tasks
- Count user processes
- Count users
- Current process
- Current process name
- DELAY PROCESS
- EXECUTE ON CLIENT
- Execute on server
- GET REGISTERED CLIENTS
- New process
- PAUSE PROCESS
- Process aborted
- Process number
- PROCESS PROPERTIES
- Process state
- REGISTER CLIENT
- RESUME PROCESS
- UNREGISTER CLIENT
Process state
| Process state ( process ) -> Function result | ||||||||
| Parameter | Type | Description | ||||||
| process | Longint |
|
Process number | |||||
| Function result | Longint |
|
State of the process | |||||
The Process state command returns the state of the process whose number you pass in process.
The function result can be one of the values provided by the following predefined constants:
| Constant | Type | Value |
| Aborted | Longint | -1 |
| Delayed | Longint | 1 |
| Does not exist | Longint | -100 |
| Executing | Longint | 0 |
| Hidden modal dialog | Longint | 6 |
| Paused | Longint | 5 |
| Waiting for input output | Longint | 3 |
| Waiting for internal flag | Longint | 4 |
| Waiting for user event | Longint | 2 |
If the process does not exist (which means you did not pass a number in the range 1 to Count tasks), Process state returns Does not exist (-100).
The following example puts the name and process reference number for each process into the asProcName and aiProcNum arrays. The method checks to see if the process has been aborted. In this case, the process name and number are not added to the arrays:
$vlNbTasks:=Count tasks
ARRAY TEXT(asProcName;$vlNbTasks)
ARRAY INTEGER(aiProcNum;$vlNbTasks)
$vlActualCount:=0
For($vlProcess;1;$vlNbTasks)
If(Process state($vlProcess)>=Executing)
$vlActualCount:=$vlActualCount+1
PROCESS PROPERTIES($vlProcess;asProcName{$vlActualCount};$vlState;$vlTime)
aiProcNum{$vlActualCount}:=$vlProcess
End if
End for
` Eliminate unused extra elements
ARRAY TEXT(asProcName;$vlNbTasks)
ARRAY INTEGER(aiProcNum;$vlActualCount)
Product: 4D
Theme: Processes
Number:
330
Created: < 4D v6
4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)
