This folder contains:


CustomCodeAction: ZGDialogAction

Classname: com.zerog.ia.customcode.dialogs.ZGDialogAction

Description:

Implements ZGStandardDialog as a custom code action.  Allows functionality similar to the DisplayMessageDialog custom code action.  ZGDialogPanel is useful (as opposed to ZGDialogPanel) when you want to show a dialog during the “Files” task of your installer.

Input InstallAnywhere Variables:

 ZGDialogAction_DefaultButtonText”: optional variable that sets the text displayed on the default button.  Default text is “OK”.

ZGDialogAction_CancelButtonText”:  optional variable that sets the text displayed on the cancel button.  Default text is “Cancel”.

ZGDialogAction_DetailsButtonText”:  optional variable that sets the text displayed on the details button.  Default text is “Details”.

ZGDialogAction_DetailsButtonOn”:  optional variable that determines whether the details button is shown.  Default behavior is that the details button is not shown.

ZGDialogAction_CancelButtonOn”:  optional variable that determines whether the cancel button is shown.  Default behavior is that the cancel button is not shown.

ZGDialogAction_Title”:  optional variable to set the dialog window title.  Default Title is “ZGStandard Dialog (ZGDialogAction_Title)”.

ZGDialogAction_Label”:  optional variable to set the dialog’s label text.  Default text is “Label goes here (ZGDialogAction_Label)”.

ZGDialogAction_Narrative”:  optional variable to set the dialog’s narrative text.  Default is “Narrative Text Goes Here (ZGDialogAction__Narrative)”;

Output InstallAnywhere Variables:

ZGDialogAction_Results”:  returns the button that was pressed.  Can be one of the following: “Default”, “Cancel”, “Details”, or “ERROR” (no quotes). 

General Instructions: 

This README explains how to set and take advantage of the ZGDialogAction custom code action.

First you must add a “Execute Custom Code” action somewhere in your installer.

Once you have added the “Execute Custom Code” action to your project, you will need to select the JAR or ZIP file that contains the desired action.  To select the JAR or ZIP file, click on the “Choose JAR or ZIP …” button and select the file in the “Choose Code Archive” dialog that appears.

Next you have to designate the “Class:” that is to be called for the custom action.  In this case, you should enter “com.zerog.ia.customcode.dialogs.ZGDialogAction” (no quotes).

ZGDialogAction will pop up a dialog box and display up to three buttons.   The Default button is always shown, however you control the visibility of the Cancel button and the Details button.  All variables in ZGDialogAction are optional, however it is a good idea to specify the title, label, and narrative text variables, as the default text is merely a reminder to do so.  There are a lot of variables available for use with this custom code, but in practice you should only use a few for each instance of ZGDialogAction.

The button that was selected by the user will be returned in the variable “ZGDialogAction_Results” as “Default”, “Cancel”, “Details”, or “ERROR” regardless of whether or not you renamed your buttons.

The default behavior of ZGDialogAction pops up a panel with a title, narrative, and only the default button with its text set to “OK”.      


8 August 2000