INFORMATIONS PROCESS

4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 11.3 (Modifiée)


INFORMATIONS PROCESS (process; procNom; procStatut; procTemps{; procVisible{; uniqueID{; origine}}})

ParamètreTypeDescription
processNumériqueNuméro du process
procNomAlphaNom du process
procStatutNumériqueStatut du process
procTempsNumériqueTemps d'exécution cumulé du process en ticks
procVisibleBooléenVisible (Vrai) ou Caché (Faux)
uniqueIDEntierNuméro unique du process
origineEntier longOrigine du process

Description

La commande INFORMATIONS PROCESS retourne les informations sur le process dont vous passez le numéro dans process.

Après l'appel :

procNom retourne le nom du process. Quelques points sont à noter à propos du nom du process :

- Si le process a été démarré depuis la boîte de dialogue Exécuter une méthode (avec l'option Nouveau process sélectionnée), son nom est "P_" suivi d'un numéro.

- Si le process a été démarré à partir d'une commande de menu personnalisé dont la propriété Démarrer un process est sélectionnée, le nom du process est "M_" ou "ML_" suivi d'un numéro.

- Si un process a été stoppé (et son "espace" non encore réutilisé), son nom est encore retourné. Pour détecter si un process est stoppé, testez procStatut=-1 (voir ci-dessous).

procStatut retourne le statut du process au moment de l'appel. Ce paramètre peut retourner l'une des valeurs fournies par les constantes prédéfinies suivantes (thème "Statut du process") :

ConstanteType Valeur
DétruitEntier long-1
EndormiEntier long1
InexistantEntier long-100
En exécutionEntier long0
Dialogue cachéEntier long6
SuspenduEntier long5
En attente d'entrée sortieEntier long3
En attente d'un drapeau interneEntier long4
En attente d'événementEntier long2

procTemps retourne le cumul du temps que le process a utilisé depuis qu'il a été démarré, en ticks (1/60e de seconde.)

procVisible, s'il est spécifié, retourne VRAI si le process est visible, FAUX s'il est caché.

uniqueID, s'il est spécifié, retourne le numéro unique du process. En effet, chaque process se voit attribuer un numéro de process ainsi qu'un numéro unique de process par session. Ce dernier permet de différencier strictement deux process ou sessions de process. Il correspond au nombre de process ayant été lancés au cours de la session de l'application 4D.

origine, s'il est spécifié, retourne une valeur décrivant l'origine du process. Ce paramètre peut retourner l'une des valeurs fournies par les constantes prédéfinies suivantes (thème Type du process) :

ConstanteTypeValeur
Process gestionnaire de clientsEntier long-31
Process d'activitéEntier long-26
Process minuteur interneEntier long-25
Process exécution méthode SQLEntier long-24
Process CSMEntier long-22
Process de restitutionEntier long-21
Process du fichier d'historiqueEntier long-20
Process de sauvegardeEntier long-19
Process 4D Server interneEntier long-18
Process macro éditeur de méthodEntier long-17
Process sur fermetureEntier long-16
Process interface serveurEntier long-15
Process exécuté sur clientEntier long-14
Process du serveur WebEntier long-13
Process web 4D ClientEntier long-12
Process web avec contexteEntier long-11
Autre process 4DEntier long-10
Tâche externeEntier long-9
Gestionnaire d'événementEntier long-8
Gestionnaire Apple EventEntier long-7
Gestionnaire du port sérieEntier long-6
Gestionnaire d'indexEntier long-5
Gestionnaire du cacheEntier long-4
Process web sans contexteEntier long-3
Process développementEntier long-2
Process principalEntier long-1
AucunEntier long0
Process exécuté sur serveurEntier long1
Créé par commande de menuEntier long2
Créé par dialogue d'exécutionEntier long3
Autre process utilisateurEntier long4

Note : Les process internes à 4D retournent une valeur négative et les process générés par l'utilisateur retournent une valeur positive.

Si le process n'existe pas, ce qui veut dire que vous n'avez pas passé un nombre inclus dans l'intervalle [1>Nombre de process], INFORMATIONS PROCESS laisse les valeurs des variables passées en paramètres inchangées.

Exemples

(1) L'exemple suivant retourne le nom, le statut, et le temps écoulé dans les variables vNom, vStatut, et vTempsPassé pour le process courant :

   C_ALPHA(80; vNom) ` Initialiser les variables
   C_ENTIER(vStatut)
   C_ENTIER(vTempsPassé)
   INFORMATIONS PROCESS (Numero du process courant; vNom; vStatut; vTempsPassé)

(2) Voir l'exemple de la section Méthode base Sur fermeture.

Référence

Nombre de process, Statut du process.


4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant