|
Navigation: Program Reference > Scripting and Variables > System Variables |
|
System variables are variables that points to information about current state of operational system and setup program. You can use these variables in the expressions of your setup project.
Project's Variables
The project's variables points to information about your setup project.
Variable |
Meaning |
%SoftwareName% |
This variable contains the Software Name project property's value. |
%CompanyName% |
This variable contains the Company Name project property's value. |
%SoftwareVersion% |
This variable contains the Version project property's value. |
Directories' Variables
The directories' variables points to the system directories of operational system.
Variable |
Meaning |
%InstallDir% |
This is the directory where your application files will be installed. The end-user must to be able to choose this location during the setup wizard. Typically, its value is C:\Program Files\%SofwareName%. |
%AppDataDir% |
Application Data directory. Typically, its value is \Application Data. This directory's variable is available only in Windows Mobile devices. |
%IPSMDir% |
IPSM directory. Typically, its value is \IPSM. This directory's variable is available only in Windows Mobile devices. |
%WinDrive% |
The drive where Windows is installed. Typically, its value is C:. |
%MyDocumentsDir% |
My Documents directory. Typically, its value is C:\My Documents. |
%ProgramFilesDir% |
Program Files directory. Typically, its value is C:\Program Files. |
%AccessoriesDir% |
Accessories directory. Typically, its value is \Program Files\Accessories. This directory's variable is available only in Windows Mobile devices. |
%ActiveSyncDir% |
The directory where Microsoft ActiveSync is installed. Typically, its value is C:\Program Files\Microsoft ActiveSync. |
%CommonFilesDir% |
Common Files directory. Typically, its value is C:\Program Files\Common Files. |
%CommunicationDir% |
Communication directory. Typically, its value is \Program Files\Communication. This directory's variable is available only in Windows Mobile devices. |
%HotSyncDir% |
The directory where HotSync is installed. Typically, its value is C:\Program Files\HotSync. |
%OfficeDir% |
The directory where the Pocket Office is installed. Typically, its value is \Program Files\Office. This directory's variable is available only in Windows Mobile devices. |
%OutlookDir% |
The directory where the Pocket Outlook is installed. Typically, its value is \Program Files\Pocket Outlook. This directory's variable is available only in Windows Mobile devices. |
%PalmInstallDir% |
The directory where the Palm OS files will be installed. Typically, its value is C:\Program Files\HotSync\%HotSyncUsers%\Install. |
%WinDir% |
The directory where Windows is installed. Typically, its value is C:\Windows. |
%DesktopDir% |
Desktop directory. Typically, its value is C:\Windows\Desktop. |
%FontsDir% |
The directory where the fonts are installed. Typically, its value is C:\Windows\Fonts. |
%HelpDir% |
The directory where the system help files are installed. Typically, its value is C:\Windows\Help. |
%StartMenuDir% |
Start Menu directory. Typically, its value is C:\Windows\Start Menu. |
%ProgramsDir% |
Start Menu > Programs directory. Typically, its value is C:\Windows\Start Menu\Programs. |
%ProgramGroupDir% |
The directory where the application's shortcuts are normally created. Typically, its value is C:\Windows\Start Menu\Programs\%ProgramGroup%. |
%GamesDir% |
The directory where the games' shortcuts are normally created. Typically, its value is \Windows\Start Menu\Programs\Games. This directory's variable is available only in Windows Mobile devices. |
%StartUpDir% |
Start Up directory. Typically, its value is C:\Windows\Start Up. |
%SysDir% |
The directory where the system files are installed, like runtimes and third-party controls. Typically, its value is C:\Windows\System. |
%StorageCard% |
The storage card's directory. Typically, its value is \Storage Card. This directory's variable is available only in Windows Mobile devices. |
Scripting Variables
The scripting variables are used to access useful information in your click-script events.
Variable |
Meaning |
%ActiveDialogHandle% |
The window's handle of the active setup dialog. |
%ActiveSyncVersion% |
The version of Microsoft ActiveSync installed. |
%CmdLine% |
The command line used to call the setup program. |
%CmdLineParam% |
The array of parameters used to call the setup program. For example, to access the first parameter enter %CmdLineParam[0]%. |
%CmdLineParamCount% |
The number of parameters used to call the setup program. |
%CurrentDay% |
The day part of current date. For example, if current date is "1/2/2006", this variable's value is 2. |
%CurrentHour% |
The hour part of current time. For example, if current time is "1:2:3", this variable's value is 1. |
%CurrentMinute% |
The minute part of current time. For example, if current time is "1:2:3", this variable's value is 2. |
%CurrentMonth% |
The month part of current date. For example, if current date is "1/2/2006", this variable's value is 1. |
%CurrentSecond% |
The second part of current time. For example, if current time is "1:2:3", this variable's value is 3. |
%CurrentYear% |
The year part of current date. For example, if current date is "1/2/2006", this variable's value is 2006. |
%Date% |
The current date's string, formatted using the operational system localization settings. |
%DotNetDir% |
The directory where .NET Framework is installed. |
%DotNetVersion% |
The version of .NET Framework installed. |
%SelectedHotSyncUsers% |
The array of selected HotSync's users. VisualSetup will use this array to install the Palm OS files for each selected HotSync's user. |
%IsActiveSyncInstalled% |
This variable's value is True only if Microsoft ActiveSync is installed. |
%IsAdmin% |
This variable's value is True only is you are logged with Administrator rights. |
%IsDotNetInstalled% |
This variable's value is True only if .NET Framework is installed. |
%IsHotSyncInstalled% |
This variable's value is True only if HotSync is installed. |
%IsNT% |
This variable's value is True only if you are running a Windows NT platform. |
%Language% |
The active language's name. |
%ProgramGroup% |
The name of the program group where the application's shortcuts will be created. |
%Reboot% |
Defines if you want computer to be rebooted when setup program is closed. |
%ReplacedInUseFiles% |
The array of in use files that were replaced by installer. |
%Result% |
The variable that contains the value that will be returned by current action. |
%SetupHandle% |
The module's handle of the current setup program. |
%Time% |
The current time's string, formatted using the operational system localization settings. |