Actiona Wiki

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== ProcessHandle [En cours de Traduction Wismerheal][WSL] ======
Cet objet représente un processus en cours d’exécution.


===== Fonctions =====
==== ProcessHandle ====
Fonction de Construction.

=== Syntaxe ===
<code javascript>
var myObject = new ProcessHandle();
</code>
<code javascript>
var myObject = new ProcessHandle(otherProcessHandle);
</code>
<code javascript>
var myObject = new ProcessHandle(processId);
</code>

=== Arguments ===
  - otherProcessHandle - (ProcessHandle) autre "ProcessHandle" à copier
  - processId - (integer) identifiant de processus pour gérer/contrôler celui-ci

=== Exceptions ===
  * (ParameterTypeError) type de paramètre incorrect
  * (ParameterCountError) nombre de paramètre incorrect

=== Example ===
Créer un "ProcessHandle" représentant un processus invalide.
<code javascript>
var myObject = new ProcessHandle();
</code>
Créer un "ProcessHandle" représentant une copie d' **otherProcessHandle**.
<code javascript>
var myObject = new ProcessHandle(otherProcessHandle);
</code>
Créer un "ProcessHandleé lié au processus disposant de l'identifiant (id) 1337.
<code javascript>
var myObject = new ProcessHandle(1337);
</code>
===== Méthodes =====
==== clone ====
Renvoie une copie de ce "ProcessHandle".

=== Syntax ===
<code javascript>
myObject.clone();
</code>

=== Renvoie ===
  * (ProcessHandle) une copie de ce "ProcessHandle"

=== Example ===
<code javascript>
var copyOfMyObject = myObject.clone();
</code>
==== equals ====
Renvoie vrai si ce "ProcessHandle" et un autre se réfèrent au même processus.

=== Syntaxe ===
<code javascript>
myObject.equals(other);
</code>

=== Arguments ===
  - other - (ProcessHandle) autre "ProcessHandle"

=== Renvoi ===
  * (bool) vrai si **other** se réfère au même processus

=== Example ===
<code javascript>
if(myFirstObject.equals(mySecondObject))
	//Do something
</code>
==== toString ====
Renvoie une chaîne représentant ce "ProcessHandle".

=== Syntaxe ===
<code javascript>
myObject.toString();
</code>

=== Renvoie ===
  * (string) une chaîne représentant ce "ProcessHandle"

=== Example ===
<code javascript>
Console.print(myObject.toString());
</code>

=== Notes ===
Cette méthode est appelée automatiquement quand vous tentez de convertir un "ProcessHandle" en chaîne.

==== id ====
Renvoie l'identifiant du processus (id).

=== Syntaxe ===
<code javascript>
myObject.id();
</code>

=== Renvoie ===
  * (integer) l'identifiant du processus (id)

==== kill ====
Tenter d'arrêter un processus.

=== Syntaxe ===
<code javascript>
myObject.kill(killMode, timeout);
</code>

=== Arguments ===
  - killMode - ([[#killmode|KillMode]]) le mode d'arrêt à utiliser
  - timeout - (integer) le délai d'attente en millisecondes quand on utilise "GracefulThenForceful"

=== Renvoie ===
  * (boolean) vrai si le processus a été arrêté.
==== isRunning ====
Renvoie vrai si le processus est actuellement en exécution.

=== Syntaxe ===
<code javascript>
myObject.isRunning();
</code>

=== Renvoie ===
  * (boolean) vrai si le processus est actuellement en exécution
==== command ====
Renvoie la commande qui fut utilisée pour lancer le processus.

=== Syntaxe ===
<code javascript>
myObject.command();
</code>

=== Renvoie ===
  * (c) la commande qui fut utilisée pour lancer le processus

=== Exceptions ===
  * (OpenProcessError) ne parvient pas à ouvrir le processus (Windows)
  * (GetModuleFilenameError) ne parvient pas à obtenir le nom de fichier du module unable to get the module (Windows)
  * (GetProcessError) ne parvient pas à obtenir la commande du processus (Linux)
==== priority ====
Renvoie la priorité de ce processus.

=== Syntaxe ===
<code javascript>
myObject.priority();
</code>

=== Renvoie ===
  * ([[#priority|Priority]]) la priorité du processus

=== Exceptions ===
  * (OpenProcessError) ne parvient pas à ouvrir le processus (Windows)
  * (GetPriorityClassError) ne parvient pas à obtenir la classe de la priorité (Windows)
  * (OperatingSystemError) Ceci n'est pas disponible pour ce système d'exploitation (Linux)

=== Notes ===
Cette Méthode fonctionne seulement sur Windows du fait que Linux ne dispose pas du principe de priorité de processus.
===== Enumerations =====
==== KillMode ====
Politique à respecter pour utiliser la tentative d'arrêt d'un processus.

=== Valeurs ===
  - Graceful (Élégante): Linux: envoi un signal Windows SIGTERM: ferme toutes le fenêtres appartenant au processus
  - Forceful (Brutale): Linux: envoi un signal Windows SIGKILL: utilise "TerminateProcess" (arrêter processus) pour arrêter le processus
  - GracefulThenForceful [Élégante puis brutale): Tente d'arrêter le processus en utilisant la méthode élégante puis, après le délai d'attente, utilisera la méthode brutale.
==== Priority ====
La priorité d'un processus.

=== Valeurs ===
  - AboveNormal: en dessous de la normale
  - BelowNormal: au dessus de la normale
  - High: haute
  - Idle: en attente / au repos
  - Normal: normale
  - Realtime: en temps réel