Displaying a Background Window in InstallScript and InstallScript MSI Installations

InstallShield 2024

Project: This information applies to the following project types:

InstallScript
InstallScript MSI

By default, installations do not display a background window. If you want to use the PlayMMedia function to display an Adobe Flash application file (.swf) or AVI files, your installation must display a background window. You may also want to display a background window for one type of billboard.

Tip:You can display a Flash file billboard and image billboards without a background window. For more information, see Billboard Styles and File Types for InstallScript and InstallScript MSI Projects.

The method for displaying a background window depends on which project type you are using.

InstallScript Projects

To display a background window in an InstallScript project, modify the script’s OnShowUI event handler by removing the double slashes from the beginnings of the following lines of code:

//if ( LoadStringFromStringTable( "TITLE_MAIN", szTitle ) < ISERR_SUCCESS ) then // Load the title string.

//    szTitle = IFX_SETUP_TITLE;

//endif;

//SetTitle( szTitle, 24, WHITE );

//Enable( FULLWINDOWMODE );

//Enable( BACKGROUND );

//SetColor( BACKGROUND, RGB( 0, 128, 128 ) );

InstallScript MSI Projects

To display a background window in an InstallScript MSI project, modify the appropriate script’s UI event handler (such as OnFirstUIBefore or OnMaintUIBefore) by removing the double slashes from the beginnings of the following lines of code:

// SetTitle( @PRODUCT_NAME, 24, WHITE );

// SetTitle( @PRODUCT_NAME, 0, BACKGROUNDCAPTION );

// Enable( FULLWINDOWMODE );

// Enable( BACKGROUND );

// SetColor(BACKGROUND,RGB (0, 128, 128));

See Also