|
|
|
|
|
|
|
|
|
|
|
version 11.3 (Modifiée)
INFORMATIONS PROCESS (process; procNom; procStatut; procTemps{; procVisible{; uniqueID{; origine}}})
| Paramètre | Type | Description | |
| process | Numérique |  | Numéro du process |
| procNom | Alpha |  | Nom du process |
| procStatut | Numérique | | Statut du process |
| procTemps | Numérique | | Temps d'exécution cumulé du process en ticks |
| procVisible | Booléen | | Visible (Vrai) ou Caché (Faux) |
| uniqueID | Entier | | Numéro unique du process |
| origine | Entier long | | Origine 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") :
| Constante | Type | Valeur |
| Détruit | Entier long | -1 |
| Endormi | Entier long | 1 |
| Inexistant | Entier long | -100 |
| En exécution | Entier long | 0 |
| Dialogue caché | Entier long | 6 |
| Suspendu | Entier long | 5 |
| En attente d'entrée sortie | Entier long | 3 |
| En attente d'un drapeau interne | Entier long | 4 |
| En attente d'événement | Entier long | 2 |
• 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) :
| Constante | Type | Valeur |
| Process gestionnaire de clients | Entier long | -31 |
| Process d'activité | Entier long | -26 |
| Process minuteur interne | Entier long | -25 |
| Process exécution méthode SQL | Entier long | -24 |
| Process CSM | Entier long | -22 |
| Process de restitution | Entier long | -21 |
| Process du fichier d'historique | Entier long | -20 |
| Process de sauvegarde | Entier long | -19 |
| Process 4D Server interne | Entier long | -18 |
| Process macro éditeur de méthod | Entier long | -17 |
| Process sur fermeture | Entier long | -16 |
| Process interface serveur | Entier long | -15 |
| Process exécuté sur client | Entier long | -14 |
| Process du serveur Web | Entier long | -13 |
| Process web 4D Client | Entier long | -12 |
| Process web avec contexte | Entier long | -11 |
| Autre process 4D | Entier long | -10 |
| Tâche externe | Entier long | -9 |
| Gestionnaire d'événement | Entier long | -8 |
| Gestionnaire Apple Event | Entier long | -7 |
| Gestionnaire du port série | Entier long | -6 |
| Gestionnaire d'index | Entier long | -5 |
| Gestionnaire du cache | Entier long | -4 |
| Process web sans contexte | Entier long | -3 |
| Process développement | Entier long | -2 |
| Process principal | Entier long | -1 |
| Aucun | Entier long | 0 |
| Process exécuté sur serveur | Entier long | 1 |
| Créé par commande de menu | Entier long | 2 |
| Créé par dialogue d'exécution | Entier long | 3 |
| Autre process utilisateur | Entier long | 4 |
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.
|
|
|
|
|
|
|
|
|
|
|