PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Proposing to run a program
  • Specifying the executable to run and associating parameters with this executable
  • Don't propose to run the application executable at the end of setup
  • Modifying the identifier used to uninstall the application
  • Modifying the identifier used to uninstall the application
  • Modifying or creating the "AutoExec.BAT" file
  • Modifying or creating the "AutoExec.BAT" file
  • Modifying or creating the ".INI" files
  • Modifying or creating ".INI" files during the setup
  • Modifying or creating entries in the registry
  • Overview
  • Modifying or creating entries in the registry during the setup
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
When creating the setup program, WDINST allows you to configure the computer where the program will be installed. You can:
  • Propose to run a program at the end of setup (with or without command line).
  • Modify the registry:
    • modify the identifier used to uninstall the application,
    • modify or create entries.
  • Modify or create the "AutoExec.BAT" file.
  • Modify or create the ".INI" files.
By default, the setup program proposes to start the program at the end of the setup and no modification will be performed on the user computers.
The setup computer is configured in the setup editor WDINST ("Tools .. WDINST - Setup editor").The setup computer is configured in the setup editor WDINST. To start WDInst, on the "Tools" pane, in the "Utilities" group, click "WDInst".
The wizard for creating the setup program can also be used to configure the setup computer.
Note: To ask the user to confirm the modifications performed on the system when installing the application:
  1. Start WDInst if not already done ("Tools .. WdInst - Setup editor").Start WDInst if not already done: on the "Tools" pane, in the "Utilities" group, click "WDInst".
  2. Select "Parameters of setup.. System configuration".
  3. Check "Ask for confirmation before modifying".
Proposing to run a program
By default, the setup program proposes to run the executable of the application at the end of setup. The option "Start the program" is checked. The executable is automatically run when clicking the "Done" button.
The setup editor WDINST is used to:
  • Specify the executable to run and associate parameters with this executable. A single executable (".EXE" file) found in the list of files to install can be run.
  • Propose to run no application executable at the end of setup.
Note: If modifications are performed in the "AutoExec.Bat" file, no program should be run at the end of setup. Indeed, the modifications performed in this file will be taken into account when the computer is restarted.

Specifying the executable to run and associating parameters with this executable

To specify the executable to run and to associate parameters with this executable:
  1. Select "Parameters of setup .. End of setup".
  2. Enter the executable that must be run at the end of the application setup ("Command line" option).
    The executable to run corresponds to:
    • The name and full path of the executable file. The following keywords can be used:
      • - <SetupDir>: setup directory chosen by the user during the setup.
      • - <SetupDrive>: drive of the setup directory chosen by the user during the setup.
      • - <SetupFile>: setup directory of data files. The setup editor WDINST is used to configure this directory.
        See Configuring the directory of data files for more details.
      • - <WinDir>: Windows directory of user computers
    • The runtime parameters of the program installed (if necessary).
      For example: "<SetupDir>\MyApp.EXE /Param".

Don't propose to run the application executable at the end of setup

To avoid proposing to run the application executable at the end of setup:
  1. Select "Parameters of setup .. End of setup".
  2. Erase the content of the "Command line" option.
Modifying the identifier used to uninstall the application
If you have chosen to allow your application to be uninstalled, a specific identifier is automatically created in the registry. This identifier can be modified via the setup editor WDINST.
By default, this identifier is "<ApplicationNameWithoutSpace>". For example, "WDCustomer" for the "WD Customer" application. This identifier may (or may not) contain space characters.
This identifier will be created in the key:
  • "HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Uninstall" in Windows 2000 and NT
  • "HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall" in Windows 98 and Me.

Modifying the identifier used to uninstall the application

To modify the identifier used to uninstall the application:
  1. Select "Parameters of setup .. End of setup".
  2. Select the new identifier of the application.
Note: This identifier may (or may not) contain space characters.
Modifying or creating the "AutoExec.BAT" file
You have the ability to modify or create the "AutoExec.BAT" file on the setup computers. This file will be modified or created (if necessary) when the computer is restarted. In this case, a reboot is automatically proposed at the end of the application setup.
The "AutoExec.BAT" file is used to:
  • add the directory of the application executable into the PATH,
  • start the application when the setup computer is started,
  • etc.
Reminders:
  • The "AutoExec.BAT" file is automatically run when the computer is started.
  • The PATH lists the directories in which the executables (".EXE" files) and the libraries ("DLL" files) are sought in priority.

Modifying or creating the "AutoExec.BAT" file

To modify or create the "AutoExec.BAT" file:
  1. Select "Parameters of setup.. System configuration".
  2. Enter the command line to add to or to modify in the "AutoExec.BAT" file.
  3. Specify the location of the corresponding "command line" in the "AutoExec.BAT" file ("Location" combo box):
    • At the beginning. Corresponds to the first "command line" of the "AutoExec.BAT" file.
    • At the end. Corresponds to the last "command line" of the "AutoExec.BAT" file.
    • After PATH. By positioning a "command line" after the PATH, the executable and/or the libraries used in this command line will be sought in the directories of the PATH.
  4. If the same command line already exists in the "AutoExec.BAT" file, you can:
    • Replace the existing command line. Select the "Replace" parameter ("Type" combo box).
    • Add the command line. Select the "Add" parameter ("Type" combo box).
Note: To directly add the setup directory of the application into the PATH, use the buttons:
  • "At the beginning". The setup directory of the application will be the first directory of the PATH.
  • "At the end". The setup directory of the application will be the last directory of PATH.
Modifying or creating the ".INI" files
When installing a WINDEV application, you have the ability to modify or create the ".INI" files on the setup computers. These files will be associated with the application installed.
The ".INI" files are used to:
  • Customize the application according to the connected user
  • Define the default parameters of the application
Then, the ".INI" files can be read and modify from the application directly (INIRead and INIWrite).
For example, to save the runtime language of the setup program in the "MyApp.INI" file (found in the setup directory of the application):
  • ".INI" file: <SetupDir>\MyApp.INI
  • Section: LANGUAGE
  • Configures: LANGUAGE_INSTALL
  • Value: <Language>
The <Language> keyword will be automatically replaced during the setup by the number of the runtime language of the setup program (this number can be used by Nation).
In this example, if the number of the runtime language is 3, the following parameter will be added into the "MyApp.INI" file:
[LANGUAGE]
LANGUAGE_INSTALL=3

Modifying or creating ".INI" files during the setup

To modify or create ".INI" files during the setup:
  1. Select "Parameters of setup.. System configuration".
  2. Specify the relevant ".INI" file. This file will be created if necessary. You can specify:
    • The name and full path of the file.
      The following keywords can be used:
      • <SetupDir>: setup directory chosen by the user during the setup.
      • <SetupDrive>: drive of the setup directory chosen by the user during the setup.
      • <SetupFile>: setup directory of data files. The setup editor WDINST is used to configure this directory. See Configuring the directory of data files for more details.
      • <WinDir>: directory of Windows on the user computers.
        For example: "<SetupDir>\MyDirectory\MyFile.INI".
    • The name of the file. The file will be sought or created in the directory of Windows. For example: "MyFile.INI".
    • No file. The "WIN.INI" file will be modified.
  3. Specify the section to modify or to create.
  4. Specify the parameter to modify or to create.
  5. Specify the value of the parameter.
    To retrieve the number of the runtime language for the setup program, use the <Language> keyword.
Modifying or creating entries in the registry

Overview

When installing a WINDEV application, you have the ability to modify or create entries in the registry.
The registry alloows you to:
  • Customize the application according to the connected user
  • Define the default parameters of the application
Then the registry can be read and modified from the application directly (RegistrySetValue, RegistryQueryValue , ...).
For example, to save the runtime language of setup program in the registry, type:
  • Key: HKEY_LOCAL_MACHINE\Software\MyCompany\MyApp\1.0\
  • Name: Language
  • Value: <Language>
The <Language> keyword will be automatically replaced during the setup by the number of the runtime language of the setup program (this number can be used by Nation).

Modifying or creating entries in the registry during the setup

To modify or create entries in the registry during the setup:
  1. Select "Parameters of setup.. System configuration".
  2. Specify the relevant key (full path). This key will be created if necessary.
  3. Specify the name of the value to modify. This value will be created if necessary.
  4. Specify the new value.
    To retrieve the number of the runtime language for the setup program, use the <Language> keyword.
Minimum required version
  • Version 9
Comments
Click [Add] to post a comment