Summary

Synopsis

This article discusses how a list box can be populated dynamically at run time for a Basic MSI project.

Discussion

The following steps set up a dialog that allows a list box to be populated at run time in a Basic MSI project.

1. Select the Dialogs view in the project.

2. Add a list box control to the desired dialog (e.g., InstallWelcome dialog). The list box control is displayed on the toolbar by default. Hovering your mouse over each control displays the name of the control.

3. Select the Direct Editor view and find the ListBox table.

4. In the ListBox table, populate the columns with the appropriate values. The following table illustrates some example ListBox table entries. The properties listed in the Value column must be Public properties. A Public property is a property authored in all capital letters.

   Column Descriptions

   Property ? This is the name of the property that was associated with the control when it was added to the dialog.

   Order ? This specifies the order in which the entries are displayed on the dialog.

   Value ? In this case, the Value is a property that resolves at run time.

   Text ? The text to be displayed. In this case, the Text column does not need to be populated because a property is being used in the value column.

   Property	Order	Value	Text
   MYPROPERTY	1	[COMPANYNAME]
   MYPROPERTY	2	[MYPROP]

5. Once the table entries are authored the properties can be populated via a custom action or dialog.

   Example 1:

   The COMPANYNAME property by default can be edited by the user on the CustomerInformation dialog. A list box control can then be placed on a dialog that is called after the CustomerInformation dialog.

   Example 2:

   A piece of code can be written that uses the Windows Installer function MsiSetProperty and called via a custom action at some point prior to the dialog containing the list box control. For sample code that uses MSiSetProperty, see InstallShield Help Library topic Getting and Setting Properties.

Additional Information

For information on how to populate a list box in an InstallScript MSI, see InstallShield Help Library topic How Do I Populate a List Box at Run Time?

For more information on the ListBox table, see the Windows Installer Help Library topic ListBox Table.

For more information on the MsiSetProperty, see the Windows Installer Help Library topic MsiSetProperty.

For more information on the list box control, see the Windows Installer Help Library topic ListBox Control.