Billboards are used in installation packages as a way to advertise your application's features (in text and images) during setup. Billboards are most typically associated with progress actions during a lengthy operation.
The Billboard host control displays one or more billboards, but is itself invisible. It behaves like any other dialog control and acts as a placeholder for the displayed billboards. The billboards, which act as "views" for the billboard host control, are associated with an install action (standard or custom) and are conditioned by the install state of a feature. Each billboard can have one or more controls associated with it.
Billboards can be created only in projects which support the dialog
editor, for example Enterprise.
The following tutorial will guide you step by step in creating your first package with billboards.
- 1. Add a Billboard Host to your dialog
- 2. Add controls to billboard
- 3. Add more billboards
- 4. Run your MSI with billboards
1. Add a Billboard Host to your dialog
As billboards most common use is to display images or text during a long operation and the billboard host control is automatically subscribed to the SetProgress event, we have chosen the ProgressDlg dialog as target for the billboards.
Switch to the Dialogs page and select the
“ProgressDlg” dialog in the tree.
Use the toolbar button to select the “Billboard
Host” control and place it on the dialog.
There must exist at least one billboard for your billboard host,
so a billboard is automatically created for you and associated with
the “InstallFiles” standard action.
2. Add controls to billboard
Now it is time to add some controls to your billboard. These can be: texts, scrollable texts, bitmaps, icons, group boxes, lines.
Add controls to your billboard the same way you add them to a dialog. Place them directly on the surface of the host.
Arrange them as follows:
Build and run the
project.
If your installation takes little time, the billboards will only be
visible briefly.
3. Add more billboards
If you would like more than one billboard to advertise your installation select the “Edit Billboards...” option from the context menu of the Billboard Host control. The Billboards Dialog will be displayed allowing you to create and edit more billboards.
Add a second billboard and configure it as showed below:
Initially all new billboards are without controls.
You can change the active billboard (the billboard that you want to edit) by selecting it in the Properties Pane, in the “Billboards” field.
Both in the Billboards Dialog
and in the “Billboards” field combo the billboards
are displayed in the same order they will be showed at
run-time.
Add more controls to your new billboard in the same way as before.
4. Run your MSI with billboards
Build the project and notice the
results. During installation the billboards will look like
this:
The End
This concludes our tutorial. To learn more, please read the ComboBox and ListBox controls tutorial.