Volume Cost List Control

InstallShield 2016

Project • This information applies to the following project types:

•

Basic MSI

•

Merge Module

A volume cost list control displays the disk space requirements that are associated with each volume or drive.

The list has five possible columns. The headings for each column are configurable in the UIText table, which you can access in the Direct Editor view. The UIText table identifies the values of string entries so that localized strings are displayed at run time when appropriate. Following is a list of the keys in the UIText table for each column, along with their default English values:

•

VolumeCostVolume—Volume

•

VolumeCostSize—Disk Size

•

VolumeCostAvailable—Available

•

VolumeCostRequired—Required

•

VolumeCostDifference—Differences

When you select a volume list cost control in a dialog of the Dialogs view, InstallShield displays the following settings in the right pane.

Settings for a Volume Cost List Control
Setting	Description
Name	Enter a name for this volume cost list. The name must be unique among all of the controls in your project.
Available Col Width	Specify the default width in installer units (1/12 of the height of the system font) for the Available column. This column is hidden if the value is the number 0 or it is left blank.
Base Text Style	This font style is used for the contents of the volume cost list if you specify nothing for the Text Style setting.
Cancel	If this is the only control on the dialog that will dismiss the dialog, select True. Clicking the cancel control has the same effect as pressing the ESC key or clicking the Close button on the title bar. The Cancel or Finish button is usually the cancel control. This value is ignored if True is selected for the ErrorDialog setting of the dialog that contains this control.
Context Help	This setting is reserved for future use. Windows Installer does not currently support launching context-sensitive help topics from the installation.
Default	If this is the only control on the dialog that you want to be the default control, which means that it is activated when the end user presses the ENTER key, select True. The Next or OK button is usually the default control.
Differences Col Width	Specify the default width in installer units (1/12 of the height of the system font) for the Differences column. This column is hidden if the value is the number 0 or it is left blank.
Disk Size Col Width	Specify the default width in installer units (1/12 of the height of the system font) for the Disk Size column. This column is hidden if the value is the number 0 or it is left blank.
Enabled	Indicate whether the control is enabled. True means that this control is available (the end user can interact with it). False means that it is not available (grayed out).
Height	Specify the height of the control in Windows Installer user interface units (1/12 of the height of the system font).
Left	Specify the distance from the left edge of the dialog to the start of the control in installer units (1/12 of the height of the system font).
Left Scrollbar	If you want the arrow and vertical scrollbar to be displayed on the left side of the control, select True. This option should be selected only when True is selected for the Right-to-Left setting.
Required Col Width	Specify the default width in installer units (1/12 of the height of the system font) for the Required column. This column is hidden if the value is the number 0 or it is left blank.
Right-Aligned	The default value of False aligns the text to the left of the control. Set it to True to align the text to the right.
Right-to-Left	For English and other languages that are written from left to right, select False. For Hebrew and those languages that are read from right to left, select True.
Show CD-ROM	To include CD-ROM volumes in the control, select True.
Show Fixed	To include hard drives in the control, select True.
Show Floppy	To include floppy drives in the control, select True.
Show RAMDisk	To include RAM volumes in the control, select True.
Show Remote	To include mapped network drives in the control, select True.
Show Removable	To include removable drives in the control, select True.
Sunken	To give the control’s edges a recessed, three-dimensional appearance, select True. To use the default visual style for the control, select False.
Tab Index	Assign an integer that—along with the other controls on this dialog but excluding controls such as static text—specifies the order in which each control on the dialog receives focus when the end user presses the TAB key. The lowest tab index that you can use is the number 0.
Tab Stop	Indicate whether this control receives focus within the tab order. True indicates that the control receives focus; False indicates that the control does not receive focus.
Text	This setting contains the text that is used for the control’s label. Although you cannot see the label, it is available for screen readers. When you type a value for this setting, you are creating a string entry and setting its initial value for all of the languages that are currently in the project. As an alternative to typing a new value, you can click the ellipsis button (...) in this setting to select an existing string. For more information, see Using String Entries in InstallShield.
Text Style	Select the font style, size, and color (if available) in which you want the control’s label to be displayed. Leaving the value as <Default> displays the font that is contained in the DefaultUIFont property. This setting is enabled if Text is selected for the Control Style setting.
Tooltip	Enter the text that you want to be displayed when the end user places the mouse pointer over the control. When you type a value for this setting, you are creating a string entry and setting its initial value for all of the languages that are currently in the project. As an alternative to typing a new value, you can click the ellipsis button (...) in this setting to select an existing string. For more information, see Using String Entries in InstallShield.
Top	Specify the distance from the top of the dialog to the top of the control in installer units (1/12 of the height of the system font).
Visible	True means that the control is visible, and False means that it is hidden. You can also make the control visible by editing its condition in the Behavior area for the dialog.
Volume Col Width	Specify the default width in installer units (1/12 of the height of the system font) for the Volume column. This column is hidden if the value is the number 0 or it is left blank.
Width	Specify the width of the control in Windows Installer user interface units (1/12 of the height of the system font).

Volume Cost List Control

InstallShield 2016 Help Library

August 2016