SdShowDlgEdit1

InstallShield 2014 » InstallScript Language Reference

Project: This information applies to the following project types:

InstallScript
InstallScript MSI

The SdShowDlgEdit1 function creates a general dialog that displays a message and one single-line edit field. You can specify a title for the dialog.

Syntax

SdShowDlgEdit1 ( szTitle, szMsg, szField1, svEdit1 );

Parameters

SdShowDlgEdit1 Parameters

Parameter

Description

szTitle

Specifies the title of the dialog. To display the default title (“Edit Data”), pass a null string (“”) in this parameter.

szMsg

Specifies the message to display in the dialog. To include in this message the product name set by a previous call to SdProductName, insert the place holder %P anywhere in the message string. When the message is displayed, %P is replaced by the product name.

szField1

Specifies a field name to be displayed to the left of the edit field. The default field name is “Field 1:”. To display the default name, pass a null string (“”) in this parameter. The maximum number of characters that can be displayed is approximately 10. The actual maximum depends on the combined width of each character in the field name. If the field name exceeds the available space, it will be truncated on the right when the dialog is displayed.

svEdit1

Specifies an initial value for the edit field; returns the value of the edit field when the dialog is closed.

Return Values

SdShowDlgEdit1 Return Values

Return Value

Description

NEXT (1)

Indicates that the Next button was clicked.

BACK (12)

Indicates that the Back button was clicked.

Additional Information

To view an example of this or other dialogs for your installation, use the Dialog Sampler. In InstallShield, on the Tools menu, point to InstallScript, then click Standard Dialog Sampler or Skinned Dialog Sampler.

See Also