|
|
|
|
|
|
|
|
- Déclaration
- Propriétés spécifiques à la description des variables de type Thread
- Fonctions WLangage manipulant les variables de type Thread
Thread (Type de variable) En anglais : Thread
Le type Thread permet de définir toutes les caractéristiques d'un thread. Les caractéristiques de ce thread peuvent être définies et modifiées à l'aide de différentes propriétés WLangage. Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable. // Déclare une variable pour manipuler un thread
t est un Thread
// Construit un thread et déclenche son exécution sur une procédure
t = ThreadExécute(Proc, ("Premier paramètre", 2)) // Construit un thread
t est un Thread(Proc, ("Premier paramètre", 2))
// Déclenche l'exécution du thread
ThreadExécute(t) Dans ce cas, le thread n'est pas décrit. La variable devra être affectée avec un thread existant ou avec le résultat d'une des fonctions d'exécution des threads.
Décrire un thread via le type Thread Masquer les détails
MaVariable est un Thread (<Procédure> [, <Paramètres> [, <Options>]])
<Procédure> : Chaîne de caractères ou variable de type Procédure Procédure à exécuter. Ce paramètre peut correspondre : - au nom de la procédure à exécuter.
- au nom de la variable de type Procédure correspondant à la procédure à exécuter.
<Paramètres> : Liste de valeurs entre parenthèses et séparées par des virgules Paramètres de la procédure à exécuter. Cette liste de paramètres est de la forme :
(<Paramètre 1>, ..., <Paramètre N>) - <Paramètre 1> : Premier paramètre de la procédure.
- ...
- <Paramètre N> : Nième paramètre de la procédure.
<Options> : Constante optionnelle de type Entier Mode de lancement du thread. | | | threadAttendDémarrage | Attend le démarrage effectif du thread avant de continuer l'exécution. | | threadContexteGlobal | Force l'utilisation du contexte global du projet si le thread est exécuté depuis une fenêtre. Le thread continuera donc de s'exécuter jusqu'à la fermeture de l'application.
Par défaut, le contexte de la fenêtre est utilisé, le thread est donc arrêté lors de la fermeture de la fenêtre. | threadCopieComplèteContexteHFSQL
(Valeur par défaut) | Provoque la copie immédiate du contexte HFSQL courant.
Conseillé par exemple si le thread doit tenir compte des positions en cours dans les fichiers et requêtes du contexte de l'appelant. | | threadCopieLégèreContexteHFSQL | Provoque la copie immédiate d'une partie du contexte HFSQL courant.
Sont mémorisés : - les répertoires où se trouvent les fichiers de données en HFSQL Classic.
- les connexions en HFSQL Client/Serveur.
| | threadNormal | Lance le thread en mode normal. Le contexte HFSQL est copié lors de la première utilisation d'une fonctionnalité HFSQL. | | threadSécurisé | Lance un thread en mode sécurisé. Dans ce mode : - une erreur de compilation sera affichée si des accès aux champs sont effectués dans le thread (ou si la procédure utilise l'attribut "UI").
- une exception sera générée :
- si le thread accède aux champs en exécution,
- si la fonction ThreadArrête est utilisée.
- la fermeture de la fenêtre qui a lancé le thread provoque une demande d'arrêt (mais le thread peut continuer à s'exécuter après la fermeture de la fenêtre).
|
Dans ce cas, le thread est décrit et sa description ne peut plus être modifiée. Le thread n'est pas exécuté automatiquement, une déclaration seule ne provoquera donc pas l'exécution du thread. Il faut appeler une des fonctions d'exécution des threads pour déclencher l'exécution du thread. Remarques Propriétés spécifiques à la description des variables de type Thread Les propriétés suivantes peuvent être utilisées pour manipuler une variable de type Thread : | | | | Nom de la propriété | Type manipulé | Effet |
|---|
| ArrêtDemandé | Booléen | - Vrai si l'arrêt du thread a été demandé,
- Faux dans le cas contraire.
Cette propriété est disponible en lecture seulement. | | Etat | Constante de type Entier | Etat du thread : - threadArrêtDemandé : L'arrêt du thread a été demandé.
- threadEncours : Le thread est en cours d'exécution.
- threadNonExécuté : Le thread n'a pas été exécuté.
- threadSuspendu : Le thread est suspendu.
- threadTerminé : Le thread existe mais il est terminé.
Cette propriété est disponible en lecture seulement. | | Nom | Chaîne de caractères | Nom du thread. Cette propriété est disponible en lecture seulement. | | Priorité | Constante de type Entier | Niveau de priorité actuel du thread :- PrioritéElevée : Priorité élevée.
- PrioritéNormale : Priorité normale.
- PrioritéBasse : Priorité basse.
| | ValeurRenvoyée | Valeur renvoyée par le thread. | Attention : - Si le thread est toujours en cours, la propriété ValeurRenvoyée est bloquante en attendant la fin du thread.
- Si le thread est terminé sans erreur fatale, la propriété renvoie la ou les valeurs de retour de la procédure principale du thread.
Cette propriété est disponible en lecture seulement. Rappel : - La propriété Etat permet de connaître l'état du thread.
- Il est possible d'attendre la fin d'un thread avec la fonction ThreadAttend.
|
Fonctions WLangage manipulant les variables de type Thread
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|