Share via


How to: Manage Application Settings

Application settings in Visual Studio LightSwitch 2011 are properties that apply to the application instead of an individual screen or entity. Application settings are managed in the Application Designer, a tabbed interface with tabs for setting general, extensions, screen navigation, access control, and application type properties.

This topic covers settings in the General Properties tab. Settings for the Extensions tab are covered in the topic How to: Add or Remove Extensions. Settings for the Screen Navigation tab are covered in the topic How to: Create Menu Items and Navigation Groups. Settings for the Access Control tab are covered in the topic How to: Create a Role-based Application. Settings for the Application Type tab are covered in the topic How to: Change the Deployment Topology and Application Type.

Settings available in the General Properties tab are as follows:

Setting

Description

Application name

Specifies the name that will be displayed in the application’s title bar and in the Start menu for Windows. The default is the project name.

Logo image

Specifies an optional image that is displayed in some application shells. The Logo image is typically used to display a company logo.

The Logo image can be either a .png or .jpg image.

Shell

Specifies the application shell, which defines the layout of the application. The default is LightSwitch Standard Shell.

Additional shells can be added as extensions. For more information, see Extensions: Adding New Capabilities to LightSwitch

Theme

Specifies the application theme, which defines the visual appearance of all application elements. The default is LightSwitch Blue Theme.

Additional themes can be added as extensions. For more information, see Extensions: Adding New Capabilities to LightSwitch

Application icon

Specifies the icon that will be displayed in the Start menu for Windows and on the task bar. If not specified, a default icon will be shown.

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 is 1.0. The maximum version number is 65334.9999.

Culture

Specifies a localization culture for the LightSwitch runtime file that is deployed with the application. The default is the culture of the development computer.

To change the application display name

  1. In Solution Explorer, double-click Properties to open the Application designer.

  2. In the Application Designer, click the General Properties tab.

  3. In the Application name field, type the name that you want to be displayed for the application.

To change the shell

  1. In Solution Explorer, double-click Properties to open the Application designer.

    In the Application Designer, click the General tab.

  2. Expand the Shell drop-down list.

    A list of available shells, if any, will appear in the list.

  3. Click the shell that you want to apply.

To change the theme

  1. In Solution Explorer, double-click Properties to open the Application designer.

    In the Application Designer, click the General Properties tab.

  2. Expand the Theme drop-down list.

    A list of available themes, if any, will appear in the list.

  3. Click the theme that you want to apply.

To add an application icon

  1. In Solution Explorer, double-click Properties to open the Application designer.

  2. In the Application Designer, click the General Properties tab.

  3. Click the Select button to the right of the Application icon field.

    The Select Image dialog box appears.

  4. In the Select Image dialog box, click Import.

  5. In the Open dialog box, locate the directory that contains your .png icon file, and then select the icon and click Open.

  6. Click OK to close the Select Image dialog box.

    The name of the icon file will appear in the Application icon field.

To change the application version

  1. In Solution Explorer, double-click Properties to open the Application designer.

  2. In the Application Designer, click the General Properties tab.

  3. In the Application version field, type a major version number in the first text box, and then type a minor version number in the second text box.

    The values must be a number between 0 and 65534.

To change the culture

  1. In Solution Explorer, double-click Properties to open the Application designer.

    In the Application Designer, click the General Properties tab.

  2. Expand the Culture drop-down list.

    A list of available cultures will appear in the list.

  3. Click the culture that you want to use.

To add a logo image

  1. Note

    Although a logo image can be added to any project, it will only be displayed in projects that use a custom application shell extension that supports the logo image. The default LightSwitch application shell does not support displaying a logo image.

    In Solution Explorer, double-click Properties to open the Application designer.

  2. In the Application Designer, click the General Properties tab.

  3. Click the Select button to the right of the Logo image field.

  4. In the Select Image dialog box, click Import.

  5. In the Open dialog box, locate the directory that contains your .png or .jpg logo, and then select the file and click Open.

  6. Click OK to close the Select Image dialog box.

    The name of the image file will appear in the Logo image field.

See Also

Tasks

How to: Manage Application Settings

How to: Create Menu Items and Navigation Groups

How to: Create a Role-based Application

How to: Change the Deployment Topology and Application Type

Concepts

How to: Add or Remove Extensions