Dokumentaro de Gambaso
Compilation & Installation
Components
gb
Array
Error
gb.crypt
gb.qt4
Documents
Indekso de Lingvo
Language Overviews
LeguMin
Lexicon
Registro

Application (gb)

This class gives information about the currently running application, and grants access to the process environment and process command line.

This class is static.

Static properties
Args   Returns an array containing the arguments passed to the program by the shell.
Daemon   Set this property to TRUE to make the current application a daemon.
Dir   Returns the application directory.
Env   Returns a virtual collection of strings containing the process environment variables.
Handle   Returns the system pid (process identifier) of your program. This returns the same value as the property named Id.
Id   Returns the system pid (process identifier) of your program. This returns the same value as the property named Handle.
Name   Return the application name.
ParentHandle   Return the identifier of the parent of the current process.
Path   Returns the application path, i.e. the directory where it resides.
Priority   Return or set the current process priority.
Startup   Return the startup class object.
Task   Return if we are executing a background task.
TempDir   Return the directory where the temporary files of the current process are stored.
Title   Returns the title of the application being executed.
Version   Returns the program version, as defined in the IDE project properties dialog.

Example

Imagine you start a new project in Gambas, you call this project "MyApplication", the comments are "This is the title of MyApplication", you save it at /home/user/gambas/MyApplication, and you are writing the first version, that is, 0.0.1.

If you type... You get... Notes
PRINT "Directory: ";
Application.Dir
Directory: /usr/bin The current process directory, as returned by the getcwd() system function.
PRINT "Environment: ";
Application.Env.Count;
" variables"
Environment: 77 variables
PRINT "Application handle: ";
Application.Handle
Application handle: 8792 The process handle (or process id) is different at each execution.
PRINT "Application Id: ";
Application.Id
Application Id: 8792 This property is a synonym of the previous one.
PRINT "Name: ";
Application.Name
Name: MyApplication This is the name of the application, i.e. the name of its source directory.
PRINT "Path: ";
Application.Path
Path: /home/username/gambas/MyApplication The directory where the application runs.
PRINT "Title: ";
Application.Title
Title: This is the title of MyApplication The title of your application, as defined in the project property dialog.
PRINT "Current app. version: ";
Application.Version
Current app. version: 0.0.1 The application version, as defined in the project property dialog.

See also