How to: Manage Application Settings
In Visual Studio LightSwitch, you can manage settings that apply to the application instead of an individual screen or entity. You manage these settings in the Application Designer, which contains tabs on which you can set general, extensions, screen navigation, access control, and application type properties.
This topic covers settings on the General Properties tab. For information about settings on other tabs, see Managing Settings in LightSwitch.
Note
For projects that have been upgraded to Visual Studio 2012 Update 2, some application settings appear on the Client Properties tab, which you access by choosing the Edit Client properties link on the General Properties tab.
You can manage the following settings on the General Properties tab:
Setting |
Description |
|---|---|
Application name |
Specifies the name that will appear in the application’s title bar and on the Start menu. By default, the value of this setting is the project name. |
Logo image |
Specifies an optional image that appears on the ribbon in the default application shell. Companies typically use their corporate logos for this setting. You can specify either a .png or .jpg image. Note Applies only to Silverlight clients. |
Shell |
Specifies the application shell, which defines the layout of the application. The default value of this setting is LightSwitch Standard Shell. You can add shells as extensions. See Extensions: Adding New Capabilities to LightSwitch. |
Theme |
Specifies the application theme, which defines the visual appearance of all application elements. The default value of this setting is LightSwitch Blue Theme. Note Applies only to Silverlight clients. You can add themes as extensions. See Extensions: Adding New Capabilities to LightSwitch. |
Application icon |
Specifies the icon that will appear in the Start menu and on the taskbar. If you don't specify a value, a default icon appears. Note Applies only to Silverlight clients. The Application icon property takes a 32X32 pixel Portable Networks Graphics (.png) file that you can create by using Paint or another graphics program. The icon is visible only for the deployed application. |
Application version |
Specifies a major and minor version number for the application. The default value of this setting is 1.0. The maximum version number is 65334.9999. |
Culture or Default Language |
Specifies a default localization culture for the LightSwitch application. The default value of this setting is the culture of the development computer. |
To change the application display name
In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.
In the Application Designer, choose the General Properties tab.
For applications that have been upgraded to Visual Studio 2012 Update 2, choose the Edit Client properties link, and then choose the Client Properties tab.
In the Application name field, enter the displayed new name for the application.
To change the shell
In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.
In the Application Designer, choose the General Properties tab.
For applications that have been upgraded to Visual Studio 2012 Update 2, choose the Edit Client properties link, and then choose the Client Properties tab.
In the Shell list, choose the shell that you want to apply.
To change the theme
In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.
In the Application Designer, choose the General Properties tab.
For applications that have been upgraded to Visual Studio 2012 Update 2, choose the Edit Client properties link, and then choose the Client Properties tab.
In the Theme list, choose the theme that you want to apply.
To add an application icon
In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.
In the Application Designer, choose the General Properties tab.
For applications that have been upgraded to Visual Studio 2012 Update 2, choose the Edit Client properties link, and then choose the Client Properties tab.
Choose the Select button next to the Application icon field.
In the Select Image dialog box, choose the Import button.
In the Open dialog box, locate the directory that contains your .png icon file, choose the icon, and then choose the Open button.
Choose the OK button to close the Select Image dialog box.
The name of the icon file appears in the Application icon field.
To change the application version
In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.
In the Application Designer, choose the General Properties tab.
In the Application version field, enter a major version number in the first text box, and then enter a minor version number in the second text box.
You must specify an integer between 0 and 65534.
To change the culture
In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.
In the Application Designer, choose the General Properties tab.
In the Culture or Default Language list, choose the culture that you want to use as the default culture.
To add a logo image
In Solution Explorer, open the shortcut menu for the Properties node, and then choose Open.
In the Application Designer, choose the General Properties tab.
For applications that have been upgraded to Visual Studio 2012 Update 2, choose the Edit Client properties link, and then choose the Client Properties tab.
Choose the Select button next to the Logo image field.
In the Select Image dialog box, choose the Import button.
In the Open dialog box, locate the directory that contains your .png or .jpg logo, choose the file, and then choose the Open button.
Choose the OK to close the Select Image dialog box.
The name of the image file appears in the Logo image field.
See Also
Tasks
How to: Manage Application Settings
How to: Create Menu Items and Navigation Groups
LightSwitch Authentication and Authorization
How to: Change the Application Type
Walkthrough: Localizing a LightSwitch Application