SetStatusExStaticText

InstallShield 2026 » InstallScript Language Reference

The SetStatusExStaticText function sets the static text displayed in the STATUSEX dialog above the status text. The events OnFirstUIBefore, OnMaintUIBefore, and OnUpdateUIBefore automatically call this function to set the status text appropriately.

Syntax

SetStatusExStaticText ( szString);

Parameters

SetStatusExStaticText Parameters

Parameter

Description

szString

The text to be set as the static text. The following standard strings are available using the SdLoadString function:

IDS_IFX_STATUSEX_STATICTEXT_FIRSTUI—The InstallShield Wizard is installing %P.
IDS_IFX_STATUSEX_STATICTEXT_MAINTUI_MODIFY—The InstallShield Wizard is modifying %P.
IDS_IFX_STATUSEX_STATICTEXT_MAINTUI_REPAIR—The InstallShield Wizard is repairing %P.
IDS_IFX_STATUSEX_STATICTEXT_MAINTUI_REMOVEALL—The InstallShield Wizard is removing %P.
IDS_IFX_STATUSEX_STATICTEXT_UPDATEUI—The InstallShield Wizard is updated %VI of %P to version %VS.

Note:The status dialog supports the text substitution, %P, but does not support any other text substitutions such as %VI or %VS. If you are setting the static text to a string with any other text substitution than %P, you must call the SdSubstituteProductInfo function to update these text substitutions to the correct value before calling SetStatusExStaticText.

Return Values

SetStatusExStaticText Return Values

Return Value

Description

ISERR_SUCCESS

Indicates that the function was successful.

< ISERR_SUCCESS

Indicates that the function was not successful.