Tile Configuration Settings

InstallShield 2019 » Shortcuts View

Project • Tile Configuration Settings are available within the Shortcuts view for the following project types:

• Basic MSI
• DIM
• InstallScript
• InstallScript MSI
• Merge Module

The settings for tile configurations are organized into the following main categories:

• General
• Appearance

General

Use the tile configuration’s General setting to view the path of the .exe file that is associated to the tile.

General Settings

Setting

Project Type

Description

Target

Basic MSI, DIM, InstallScript, InstallScript MSI, Merge Module, MSI Database, MSM Database, Transform

Displays the path of the .exe file (for example, [INSTALLDIR]File.exe) that is associated to the tile.

Appearance

Use a tile configuration’s Appearance settings to specify tile customizations such as the background color of the tile.

Appearance Settings

Setting

Project Type

Description

Text Color

Basic MSI, DIM, InstallScript, InstallScript MSI, Merge Module, MSI Database, MSM Database, Transform

Choose a foreground text color that is used to display the app name on a medium-sized tile. Available drop-down options are:

• Light—Sets the text color that is displayed on a medium-sized tile to be light (white text).
• Dark—Sets the text color that is displayed on the medium-sized tile to be dark (black text).

Note • Only a medium-sized tile (150x150) has room to display a name on the tile. Also, in order for the Text Color setting to have an effect, the Show Name on Medium Tile setting must be Yes.

Background Color

Basic MSI, DIM, InstallScript MSI, Merge Module, MSI Database, MSM Database, Transform

Specify a color to be used as the background color of the tile. This color must be in RGB hex string format #rrggbb, or must be a known color. A drop-down selection provides a list of known colors, or an ellipsis button (…) lets you choose a custom color interactively.

Small Tile Image

Basic MSI, DIM, InstallScript MSI, Merge Module, MSI Database, MSM Database, Transform

Specify a relative path to a small-sized (70x70) tile background image, or click the ellipsis button (...) to browse to a .png or .jpg file.

Important • If you choose to use custom images, refer to the following considerations:

• Custom images must be added to the project manually and you must specify an image for both the Small Tile Image (70x70) and the Medium Tile Image (150x150). If you specify only one, the default Windows styling for the app icon and background is applied to the tile.
• If you provide scaled, high-contrast, or localized images, you need to manually create a resources.pri file and place it in the same directory as the app's .exe file and its .visualelementsmanifest.xml file. For more information about using images or creating a resources.pri file, refer to the following MSDN article: How to customize Start screen tiles for desktop apps (Windows Runtime apps).
• When browsing for a tile image, if you have created or will create a resources.pri file, the specific image selected may include qualifiers that the resources.pri file maps to (such as ISLogo.scale-80.png). In this case, the qualifiers should be removed from the value for Small Tile Image or Medium Tile Image. However if a resources.pri is not being used or doesn't have a mapping for this particular file, then the qualifiers are part of the file name and should be retained. If qualifiers are detected, a dialog appears to let you choose which path and file name to use.

Medium Tile Image

Basic MSI, DIM, InstallScript MSI, Merge Module, MSI Database, MSM Database, Transform

Specify a relative path to a medium-sized (150x150) tile background image.

Important • If you choose to use custom images, refer to the following considerations:

• Custom images must be added to the project manually and you must specify an image for both the Small Tile Image (70x70) and the Medium Tile Image (150x150). If you specify only one, the default Windows styling for the app icon and background is applied to the tile.
• If you provide scaled, high-contrast, or localized images, you need to manually create a resources.pri file and place it in the same directory as the app's .exe file and its .visualelementsmanifest.xml file. For more information about using images or creating a resources.pri file, refer to the following MSDN article: How to customize Start screen tiles for desktop apps (Windows Runtime apps).
• When browsing for a tile image, if you have created or will create a resources.pri file, the specific image selected may include qualifiers that the resources.pri file maps to (such as ISLogo.scale-80.png). In this case, the qualifiers should be removed from the value for Small Tile Image or Medium Tile Image. However if a resources.pri is not being used or doesn't have a mapping for this particular file, then the qualifiers are part of the file name and should be retained. If qualifiers are detected, a dialog appears to let you choose which path and file name to use.

Show Name on Medium Tile

Basic MSI, DIM, InstallScript, InstallScript MSI, Merge Module, MSI Database, MSM Database, Transform

Specify whether the app name should be shown on a medium-sized tile (150x150). Available options are:

• Yes—Display the app name on the tile when a medium-sized tile is used.
• No—Do not display the app name on the tile.

This setting has no effect when a small-sized tile is used.

InstallShield 2019 Help Library

April 2019

 Copyright Information | Flexera

Open topic with navigation