PreviousNext
Macrovision

Disable

InstallShield 2008 ยป InstallScript Language Reference

The Disable function deactivates the user interface object or setup feature specified by the parameter nConstant.

If your script calls the Disable function to disable the Next or Back button, that button is disabled in all dialogs displayed after that function call. To re-enable the Next or Back button, you must call Enable with the corresponding constant.

Note

Note

Calling this function will have no effect on the following dialogs since they enable/disable the Next button internally.

Syntax

Disable ( nConstant );

Parameters

Disable Parameters 

Parameter

Description

nConstant

Specifies the user interface object or operational feature to disable.

Pass one of the following predefined constants in this parameter:

  • BACKBUTTON—Disables (grays out) the Back button that is displayed in some built-in dialogs. The Back button is enabled by default.
  • BACKGROUND—Disables and hides the setup's main background window. Note that this parameter has no effect when the setup is in full-screen mode.
  • BILLBOARD—Suppresses the display of billboards during a setup.
  • CANCELBUTTON—Disables (grays out) the Cancel button that is displayed in some built-in dialogs.
  • DIALOGCACHE—Disables the dialog cache mechanism. For more information about dialog caching, see Enable.
Note

DIALOGCACHE has no effect on dialogs that do not have a Next or Back button.

  • HOURGLASS—Causes the mouse cursor to change from the “Busy” cursor (an hourglass by default), to a normal cursor (a pointer by default).
  • LOGGING—Disables the logging of uninstallation information so that no information will be recorded in the uninstallation log file. Note that logging is enabled automatically by the function DeinstallStart. Disabling the logging of uninstallation information before calling DeinstallStart will have no effect since logging will be re-enabled automatically when DeinstallStart is called. You must disable logging manually immediately before performing operations that should not be logged for uninstallation.

    • Note that the effects of InstallScript custom actions—as opposed to the effects of an InstallScript project event-driven script—are not logged for uninstallation.

    To prevent changes made by a component in the IDE from being removed during uninstallation, set the component's Permanent property to Yes.

  • NEXTBUTTON—Disables (grays out) the Next button that is displayed in some built-in InstallScript dialogs. On most dialogs, the Next button is enabled by default.
  • PCRESTORE—Disables System Restore compatibility, which is enabled by default.

nConstant (cont.)

  • REGISTRYFUNCTIONS_USETEXTSUBS—Disables text substitutions in strings that are passed to registry functions; this is enabled by default. Use this option when working with registry function strings that contain opening angle brackets (<) and closing angle brackets (>) but that should not be interpreted as text substitutions.
  • SELFREGISTERBATCH—Disables the “batch method” for registering files copied with XCopyFile and the SELFREGISTER constant. The batch method is enabled by default.

    • When the batch method is disabled, files are registered immediately when copied with XCopyFile and the SELFREGISTER constant. If the batch method is enabled, registration is postponed until data transfer takes place.

  • SERVICE_DIFX_32—Disables DIFx support for 32-bit platforms.
  • SERVICE_DIFX_AMD64—Disables DIFx support for AMD 64-bit platforms.
  • SERVICE_DIFX_IA64—Disables DIFx support for Itanium 64-bit platforms.
  • SERVICE_ISFONTREG—Disables global font registration. For details, see Installing Fonts Through InstallScript and InstallScript Object Projects. Global font registration is enabled by default; once it is disabled, it cannot be re-enabled from the script.
  • STATUS—Disables and hides the progress indicator (status bar).
  • STATUSDLG—Disables and hides the dialog style progress indicator (status bar).
  • STATUSEX—Disables the display of the default Setup Status dialog.
  • STATUSOLD—Disables and hides the old style progress indicator (status bar).
  • UPDATE_SERVICE_INSTALL—Disables FLEXnet Connect in an installation at run time. This must be done before any file transfer events occur.

    • Note that you must add FLEXnet Connect support to a project by selecting Yes for the Enable FLEXnet Connect setting in the Update Notifications view in order for it to be enabled and disabled through the InstallScript Enable and Disable functions; otherwise, calling Enable(UPDATE_SERVICE_INSTALL) or Disable(UPDATE_SERVICE_INSTALL) has no effect. Also note that FLEXnet Connect support is enabled by default if the Enable FLEXnet Connect setting in the Update Notifications view is set to Yes.

Project-Specific Note

The UPDATE_SERVICE_INSTALL constant applies to InstallScript projects. It does not have any effect in InstallScript MSI installations, which install FLEXnet Connect through a merge module.

nConstant (cont.)

  • USE_LOADED_SKIN—Intended for use with custom dialogs that will not work with dialog skins (for example, dialogs that are not the standard size); not recommended for use with built-in dialogs. Disables the use of the skin that you specified in the in the Release property grid's Specify Skin property. (If you specified <Do not use any skin>, this option has no effect.) Disabling of the skin applies only to dialogs that are displayed after you call Disable(USE_LOADED_SKIN). To disable skin use for a custom dialog, you must call Disable(USE_LOADED_SKIN) before calling WaitOnDialog. To re-enable skin use, call Enable(USE_LOADED_SKIN).
  • WOW64FSREDIRECTION—Disables 64-bit Windows file system redirection. You must do this when installing files to the WINSYSDIR64 destination. If you do not disable file system redirection when installing files to the 64-bit Windows system folder, the files are incorrectly redirected to the 32-bit Windows system folder. Calling this function with this parameter on 32-bit Windows has no effect.

Return Values

Disable Return Values 

Return Value

Description

0

Indicates that the function successfully disabled the user interface object or setup feature specified by the parameter nConstant.

< 0

Indicates that the function was unable to disable the user interface object or setup feature specified by the parameter nConstant.

See Also

Disable Example

Enable



Copyright Information | Contact Macrovision