InstallShield InstallScript: User Interface

This script creates SdShowMsg like modal dialog with custom ProgressBar control.

ShowProgressDialog.zip Written by Mark Eisenstein
File size: 1.048 bytes Last update: 2010-09-29

This dialog script works with any skin provided by the InstallShield Skin Customization Kit. It implements/demonstrates 3 radio buttons, hides the Default icon of a computer on the skin. It also implements push buttons like Next/Back/Cancel. The proper usage of the code requires a custom dialog (skinnable) to be created using the Dialog Editor. The code has been tested with Installshield 11.5 but should also work with previous versions (DevStudio 9 and above)

Customizing InstallShield 6 Dialogs

Dialog Bitmap Secrets

The method described below does not work with the new "Windows 2000 style" dialogs in IS6.

If you look at the dialog resource of a SdDialog in a resource editor, you will notice a cryptic string associated with the left hand bitmap. You can use this string in the second parameter of DialogSetInfo(DLG_INFO_ALTIMAGE, ...). The szInfoString has the following format:

<bitmap path>	Path to the bitmap you want to display.
<16 color bitmap id>	ID of the bitmap for 16 color mode. 10550 should always be used here. Otherwise, DialogSetInfo will not work properly when called.
<256 color bitmap id>	ID of the bitmap for 256 color mode. 10551 should always be used here. Otherwise, DialogSetInfo will not work properly when called.
<transparent flag>	Indicates that this bitmap should be displayed with transparent areas showing through the background, similar to the way an icon is displayed. Possible values are 0 = FALSE and 1 = TRUE. The default is 0 (FALSE).
<3D flag>	When 1 (TRUE), indicates that the dialog will have a small border around the edges of the static field, thus giving the bitmap a three-dimensional look. If this flag is set to 0 (FALSE), the bitmap displays normally. The default is FALSE.
<background color>	The color that is painted around the dialog if it is smaller than the standard dialog. The colors should be specified as RGB values, separated by commas (RRR,GGG,BBB). The default is 0,128,128 (teal).
<transparent color>	Color for that portion of the image (if <transparent flag> is TRUE ) that is transparent. The default is 255,0,255 (purple).

The @ and the semicolons must be in place exactly as shown. Here is an example format string:

This string indicates that the bitmap should be transparent and three-dimensional, and that there should be a teal border.

Dialog With TreeView Control

This package includes a custom dialog with a tree view control, and the script code to operate it. You can use it to display components (similar to SdComponentTree) or any other items. To make the scripts work, you need an _isuser.dll with a dialog id 30001, which contains a tree control 1068, and textcontrol ID_TEXT = 1106. A sample DLL is included.

Disable Close Box on Main Window

This code shows how to disable the Close [x] button in the title bar of the main setup window (if you are not running in FULLWINDOWMODE).

DisableCloseBox.zip Written by Robert Dickau
File size: 657 bytes Last update: 03/27/1999

Display a Text File

Display About Dialog

This dialog displays date and time of setup compilation and build, product version etc.

Dynamic Selection of Billboards

If you want to display billboards depending on user's selections, you can use this function to rename the billboards files right before data move.

Enhanced InstallShield Dialogs

The install package includes the required script files and DLLs (with source code for Visual C++ 1.52, 5.0 and 6.0, Borland C++ 5.02 and Borland C++ Builder 4) and a dialog sampler.

File Browse Dialog

With the browse dialog built into InstallShield (in AskPath etc.) you can select a directory, but not a file.

Two articles in the InstallShield knowledge base explain how to call the GetOpenFileName WinAPI directly with InstallShield 5 and 6 to get a dialog similar to the file select dialog of Windows. The user can browse the computer and select a file. You can specify a drop-down list of file types etc.

Improved File Browse Dialog

File Browse Dialog for InstallShield 3

If you are using InstallShield 3 you can use the below package (DLLs for 16 and 32 bit Windows, compiled and in C source code, usage instructions and a sample .rul file). It was developed by InstallShield Software Corporation for InstallShield3. InstallShield Software Corporation has removed this file from their web site and does no longer provide any support for it.

isbrowse.zip Written (but no longer supported) by InstallShield Software Corporation
File size: 1.007.107 bytes Last update: 02/14/1998

Get Description for Error Number Returned by IS6 Functions

Most errors returned by IS6 script functions are standard Win32 HRESULTS. There is an undocumented function FormatMessage that you can use to display description of the error:

Invisible Setup Types

Here is a way to display only a subset of the setup types you defined. It uses modified versions of SdSetupTypeEx() and ComponentSetupTypeEnum().

IP Address Dialog Box

This dialog uses a formatted input control to prompt the user for an IP address. It supports InstallShield 5 and 6.

Important: Internet Explorer 4 or higher must be installed on the target machine. (You can create an IP dialog without this requirement using InstallDialogue.)

DlgIpAddr.zip Written by Robert Dickau
File size: 31.414 bytes Last update: 11/23/1999

License Dialog with Focus on "No" Button

This is a modified version of the SdLicense dialog script. It exchanges the text and functionality of the "Yes" and "No" buttons, thus making "No" the default. (If you want to use it in other languages than English, you will have to adjust the button text).

Maximize Setup Window with Taskbar Visible

Sometimes it would be nice to have setup behave like a maximized window: covering the whole screen, but leaving the task bar visible. This makes sense as the Welcome dialog tells users to exit all other programs. However, if the background window hides the task bar, they can no longer see which other tasks are currently running. To get this behaviour, replace the Enable(FULLWINDOWMODE) line in the SetupScreen function with the following:

The required prototypes and constants are already defined in InstallShield (at least in 5.53) so there's nothing more to do.

Note: The trick to Disable(FULLWINDOWMODE) does no longer work in the latest version of InstallShield 5.

Network Browse Dialog with UNC Support

Sometimes you need to browse for a directory on the network, but there isn't a drive mapped to the network resource. With native InstallShield5 functions this is not possible because the browse dialog doesn't support UNC paths. Isdll.dll provides a function which allows you to browse local AND in the network to choose a directory in UNC. Included is the DLL (compiled and C++ source code) and usage instructions. The DLL only supports 32 bit.

This dialog uses a variation of InstallShield Pro's edit1 (in technical, copyright terms, it's called a derivative work). The archive includes dialog resources for 16 and 32 bit, the dialog's .rul and .h file and a usage example. Note: You need to preserve InstallShield's and KPMG's copyright messages in the source code.

Note: The dialog template is included only as .rc file, not as compiled DLL. In order to use this function open the _isuser project (located in your in your InstallShield directory) in Visual C++, merge in the .rc file and compile. Rename the resulting _isuser.dll to _ISKPMG.DLL and insert it into the setup files pane in InstallShield.

Place Dialogs on the Lower Right Corner of the Screen

Installshield only allows you place some dialogs off center screen. This code will allow you to place all the dialogs on the lower right corner of the screen. Co-ordinates can be changed to move the dialogs anywhere and works with custom and InstallShield Dialogs.

MyRegisterUserEx displays a dialog box similar to SdRegisterUserEx, but the Next button will only be enabled if a valid serial number is entered. A sample validation function is included, but you should write your own, either as InstallShield script function, or in a custom DLL.
A function to Generate a Per-User Serial Number can be found in the string functions section.

Replacement for SdAskOptionsList

In InstallShield 5.52/5.53 the behaviour of the SdAskOptionsList has changed. Now it displays size information in the component list. In cases where these options are not file media related, this is undesirable. This dialog is an enhancemanet to the original SdAskOptionsList. It takes the same parameters plus one boolean value that to switch size information on or off.

Display Post-Reboot Self Registration Errors

If BATCH_INSTALL is TRUE, in IS6 all sef registration operations will be postponed until after the reboot. However if a problem occurs, the OnSelfRegistrationError event handler is not called (as it would be if no reboot is required). You can work around this limitation by simply calling OnSelfRegistrationError() in your OnRebooted event handler. The error handler will do nothing if no error occurred, so it doesn't hurt to call it unconditionally.

Welcome Dialog with Custom Icon and Text

This sample will not work on InstallShield 6. A custom welcome dialog sample is available in the IS6 program directory under <PROGRAMFILES>\InstallShield\InstallShield Professional 6.1\Examples\Example Custom Welcome Dialog.

This dialog uses the standard dialog resource of SdWelcome() and combines it with a modified script. You can place your program's icon beside the welcome message. You can also replace any of the messages in the dialog (e.g. change the copyright warning if you're distributing a shareware program).

Notice: There have been reports that changing the icon does not work on Windows NT. However, I could not reproduce this behaviour. If you are experiencing this problem, please contact me.

mysdwelcome.zip (2.159 Bytes) Provided by Stefan Krueger

	News	Discussions	Windows Installer	Related Tools	More Help	InstallScript	About InstallSite	Shop	Site Search
	Neuigkeiten	Diskussionsgruppen	Windows Installer	MSI FAQ	Artikel			Shop	Suche