Documentation de Gambas - /comp/gb/application

/comp/gb/application
Le page anglaise est plus récente.

# Application (gb)

Cette classe fournit des informations sur l'application actuellement exécutée, et donne accès à sa ligne de commande et aux variables d'environnement de son processus.

Cette classe est statique.

Propriétés statiques

Retourne un tableau (Array) contenant les arguments passés au programme par le noyau.
Args
Définit cette propriété à TRUE pour rendre l'application actuelle en un démon.
Daemon
Retourne le répertoire de l'application.
Dir
Retourne une collection virtuel de chaînes de caractères contenant les variables d'environnement du processus.
Env
Retourne le pid système (process identifiant (identificateur du processus)) de votre programme. Retourne la même valeur que la propriété dénommée Id.
Handle
Retourne le pid (process identifier (identificateur du processus)) de votre programme. Renvoie la même valeur que la propriété nommée Handle.
Id
Retourne le nom de l'application comme définit dans le dialog propriété de l'IDE pour le projet .
Name
Retourne le chemin de l'application, c.a.d. le répertoire où elle réside.
Path
Priority
Retourne l'objet de la classe startup (démarrage).
Startup
Retourne le titre de l'application en cours d'exécution.
Title
Retourne la version du programme, comme définie dans la fenêtre de propriété du projet dans l'EDI.
Version

### Exemple

Imaginez que vous démarreriez un nouveau projet en Gambas, vous appelleriez ce projet "Mon Application", les commentaires sont "Voici le titre de Mon Application", vous le sauvez dans `/home/user/gambas/Mon Application`, et vous écrivez sa première version, c'est à dire, la 0.0.1.

Si vous tapez... | Vous aurez... | Notes
--- | --- | ---
`PRINT "Répertoire : "; Application.Dir` | `Répertoire : /usr/bin` | Le répertoire actuel du processus, tel que retourné par la fonction système `getcwd()`.
`PRINT "Environnement : "; Application.Env` ].Count; " variables"= | `Environnement: 77 variables` |
`PRINT "Gestionnaire de l'application: "; Application.Handle` | `Gestionnaire d'application : 8792` | L’ identifiant processus (ou process id) est différent à chaque éxécution.
`PRINT "Application Id : "; Application.Id` | `Application Id: 8792` | Cette propriété est un synonyme de la précédente.
`PRINT "Nom : "; Application.Name` | `Nom : Mon Application` | Ceci est le nom donné à l'application, c.a.d. le nom de son répertoire source.
`PRINT "Chemin: "; Application.Path` | `Chemin: /home/username/gambas/Mon Application` | Chemin où vous avez créé l'application.
`PRINT "Valeur retournée : "; Application.Return` | `0` | Ceci est la valeur retournée par votre application au système d'exploitation quand elle se termine.
`PRINT "Titre : "; Application.Title` | `Titre : Voici le titre de MonApplication` | Le titre de votre application, tel que défini dans la propriété projet du dialogue formulaire
`PRINT "Version actuelle de l'application: "; Application.Version` | `Version actuelle de l'application: 0.0.1` | Le numéro de version de l'application, comme défini dans la propriété projet du dialogue formulaire

## Gestionnaires spéciaux d'événements globaux

Pour être prises en compte par l'interpréteur, ces gestionnaires d'Evènement doivent être définis comme méthodes statiques dans la classe de démarrage.

`Application_Read` | Intercepte les données envoyées sur l'entrée standard. Si cette Méthode statique est définie dans la classe de démarrage du projet, l’entrée standard est surveillée par l’interpréteur, et la Méthode est appelée chaque fois qu’il y a quelque chose à lire sur l’entrée standard.