Gambas Documentation
Application Repository
Code Snippets
Compilation & Installation
Components
gb
*[]
.Array.Bounds
.Stat.Perm
.Stream.Lines
.Stream.Term
.Symbol
_BoxedString
Application
Args
Daemon
Dir
Env
Handle
Id
Name
ParentHandle
Path
Priority
Startup
Task
TempDir
Title
Version
Args
Array
Boolean[]
Byte[]
Class
Classes
Collection
Component
Components
Date[]
Enum
Env
Error
File
Float[]
gb
Integer[]
Jit
Long[]
Object
Object[]
Observer
Param
Pointer[]
Process
Short[]
Single[]
Stat
Stream
String
String[]
System
Task
Timer
User
Variant[]
gb.args
gb.cairo
gb.chart
gb.clipper
gb.complex
gb.compress
gb.crypt
gb.data
gb.db
gb.db.form
gb.db.mysql
gb.db.odbc
gb.db.postgresql
gb.db.sqlite2
gb.db.sqlite3
gb.dbus
gb.dbus.trayicon
gb.debug
gb.desktop
gb.desktop.gnome.keyring
gb.desktop.x11
gb.eval
gb.eval.highlight
gb.form
gb.form.dialog
gb.form.editor
gb.form.htmlview
gb.form.mdi
gb.form.print
gb.form.stock
gb.form.terminal
gb.gmp
gb.gsl
gb.gtk
gb.gtk.opengl
gb.gtk3
gb.gtk3.opengl
gb.gtk3.webview
gb.gui
gb.gui.opengl
gb.gui.qt
gb.gui.qt.ext
gb.gui.qt.opengl
gb.gui.qt.webkit
gb.gui.trayicon
gb.gui.webview
gb.hash
gb.highlight
gb.image
gb.image.effect
gb.image.imlib
gb.image.io
gb.inotify
gb.jit
gb.libxml
gb.logging
gb.map
gb.markdown
gb.media
gb.media.form
gb.memcached
gb.mime
gb.mongodb
gb.mysql
gb.ncurses
gb.net
gb.net.curl
gb.net.pop3
gb.net.smtp
gb.openal
gb.opengl
gb.opengl.glsl
gb.opengl.glu
gb.opengl.sge
gb.openssl
gb.option
gb.pcre
gb.pdf
gb.poppler
gb.qt4
gb.qt4.ext
gb.qt4.opengl
gb.qt4.webkit
gb.qt4.webview
gb.qt5
gb.qt5.ext
gb.qt5.opengl
gb.qt5.webkit
gb.qt5.webview
gb.qt6
gb.qt6.ext
gb.qt6.opengl
gb.qt6.webview
gb.report
gb.report2
gb.scanner
gb.sdl
gb.sdl.sound
gb.sdl2
gb.sdl2.audio
gb.settings
gb.signal
gb.term
gb.test
gb.util
gb.util.web
gb.v4l
gb.vb
gb.web
gb.web.feed
gb.web.form
gb.web.gui
gb.xml
gb.xml.html
gb.xml.rpc
gb.xml.xslt
Controls pictures
Deprecated components
Developer Documentation
Development Environment Documentation
Documents
Error Messages
Gambas Playground
How To's
Language Index
Language Overviews
Last Changes
Lexicon
README
Search the wiki
To Do
Topics
Tutorials
Wiki License
Wiki Manual

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