OnFirstUIBefore

InstallShield DevStudio » InstallScript Language Reference

The OnFirstUIBefore event handler responds to the First UI Before event. It performs tasks that must take place before the installation of features for a first-time installation of an application.

Typically, this handler calls InstallScript functions for the following tasks:

To set up the screen.
To display dialogs that welcome the end user, display the software license, and show other information about the software to be installed.
To get information from the end user—including user registration, the destination path (INSTALLDIR), and the setup type.

The following script example shows the InstallScript source for the OnFirstUIBefore handler in a typical setup.

function OnFirstUIBefore( )

    NUMBER nResult, nSetupType;
    STRING szTitle, szMsg, svName, svCompany, svSerial;
    STRING szDir;

begin

    nSetupType = TYPICAL;	
    szDir = INSTALLDIR;
    szName    = "";
    szCompany = "";

Dlg_Start:
    // Beginning of dialogs label
    Dlg_SdWelcome:
    szTitle = "";
    szMsg   = "";
    nResult = SdWelcome( szTitle, szMsg );

    if (nResult = BACK) goto Dlg_Start;

// get user information
Dlg_SdRegisterUserEx:
    szTitle   = "";
    szMsg     = "";
    nResult   = SdRegisterUserEx( szTitle, szMsg, svName, svCompany, svSerial );

    if (nResult = BACK) goto Dlg_SdWelcome;

Dlg_SdAskDestPath:
    szTitle = "";
    szMsg = "";
    nResult = SdAskDestPath( szTitle, szMsg, szDir, 0 );

    INSTALLDIR = szDir;

    if (nResult = BACK) goto Dlg_SdRegisterUserEx;

//
// show other dialog boxes
//

    // show the progress dialog
    Enable(STATUSEX);

    return 0;
end;