Application (gb)

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

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

• Global Special Event Handlers