Method # App --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ## Description Returns the instance of the appropriate application object used by the App. This varies by project type. ## Usage ``` xojo App.Property = value ``` Or ``` xojo App.Method ``` | Part | Description | |----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Property | Any valid property of the appropriate `DesktopApplication`, `WebApplication`, `ConsoleApplication`, `ServiceApplication`, `MobileApplication` class (based on your project type). | | value | Any valid method or property of the appropriate `DesktopApplication`, `WebApplication`, `ConsoleApplication`, `ServiceApplication`, `MobileApplication` class (based on your project type). | | Method | Any valid method of the appropriate `DesktopApplication`, `WebApplication`, `ConsoleApplication`, `ServiceApplication`, `MobileApplication` class (based on your project type). | ## Notes This method returns a specific instance of an application class, depending on the App type: --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### Global information The application class can be a useful place to store information that needs to be global for the project. For example, an App might store its preferences in a Dictionary as a public property of the App object to make it accessible throughout the project. When you do this, you refer to the property by using the App prefix: ``` xojo App.PreferencesDict.Value("DefaultUser") = "Tina" ``` --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### App can return Nil It is possible for the App method to return `Nil` under certain circumstances. The App method returns the global application object only after it has been registered with the runtime. That means that any operations which happen before this registration process cannot rely on App returning non-nil. This is concern only very early in the program initialization stages; by the time the Application.Opening event fires you can be certain that App will return non-nil. The most common cases for App returning `Nil` are: - Within a constructor for the Application object itself. - Within menu item constructors when the menu bar is attached to the App class. It is possible that there are other cases, so do not rely on these being the only two. ## Sample code In a desktop or web App, turns on AutoQuit so that the App quits when all its Windows are closed or all its Sessions are disconnected: ``` xojo App.AutoQuit = True ``` ## Compatibility | | | |-----------------------|-----| | **Project Types** | All | | **Operating Systems** | All |

`DesktopApplication`, `ConsoleApplication`, `Session`, `ServiceApplication`, `WebApplication`, `WebSession`, `MobileApplication` classes