OverviewGlobal VariablesSession VariablesDesign-time Constants
Session variables are special types of variables that are expanded at runtime when they are used. When they are used on screens, their values are automatically expanded for you, however if a session variable is used in an action script, it must be manually expanded using the SessionVar.Expand action. This type of variable was designed to be used on screens, while global variables were designed to be used in action script.
While there are predefined session variables available to use, you can also create custom session variables at design time and run time. At design time, they can be defined on the Session Variables tab of the Project Settings dialog. At run time, you can create and manipulate session variables using the available SessionVar actions.
Note: If a session variable used on a screen needs to be set to a different value, it must be set prior to the screen's displaying, and all of its events. Another option is to set the text of the screen control using the appropriate Dlg***.SetProperties action. Any changes made to a session variable on a screen after the screen has been created (just before the On Preload event) will have no effect.
The following pre-defined session variables are available in TrueUpdate:
The path to the Application Data folder on the user's system. This folder serves as a common repository for application-specific data. Typically, this path is something like "C:\Documents and Settings\YourName\Application Data." On Windows Vista or later, it would return something like "C:\Users\YourName\AppData\Roaming."
The path to the all-user Application Data folder on the user's system. This folder servers as a common repository for application-specific data. Typically this is something like "C:\Documents and Settings\All Users\Application Data." On Windows Vista or later, this returns "C:\ProgramData."
The user's Common Files folder. Typically, this is something like: C:\Program Files\Common Files.
Your company’s name. The value of this variable is set on the Session Variables tab of the Project Settings dialog.
The copyright message for your product. The value of this variable is set on the Session Variables tab of the Project Settings dialog.
The path to the user's DAO (Data Access Objects) directory.
The path to the user's Desktop folder. On Windows NT/2000/XP/Vista or later, this is the path from the per-user profile.
The path to the user's Desktop folder. On Windows NT/2000/XP/Vista or later, this is the path from the All Users profile. On a non-Windows NT system, this will simply be the path to the user's Desktop folder (the same as _DesktopFolder).
The path to the user’s font directory (e.g. "C:\Windows\Fonts").
The user's personal (My Documents) folder on their system. Usually this is something like "C:\Documents and Settings\YourName\My Documents" on Windows 2000/XP and "C:\My Documents" on Windows 98/ME, and "C:\Users\YourName\Documents" on Windows Vista or later.
Note: Windows 95 did not have the My Documents folder and this variable will return "C:" if run on such a system.
The name of the product that you are updating. The value of this variable is set on the Session Variables tab of the Project Settings dialog.
The user's Program Files folder (typically, this is something like "C:\Program Files").
The name of the registered user of the system.
The organization of the registered user of the system.
The drive that the update executable was run from (e.g. "C:" or "D:").
The full path to the folder that the update executable was run from (e.g. "C:\Downloads" or "D:\").
The full path, including the filename, for the current update executable.
For example, if the user was running "update.exe" from "C:\Downloads", %SourceFilename% would be expanded to "C:\Downloads\update.exe".
The path to the user's Start menu folder. On Windows NT/2000/XP/Vista or later, this is the path from the per-user profile.
The path to the user's Start menu folder. On Windows NT/2000/XP/Vista or later, this is the path from the All Users profile. On a non-Windows NT system, this will simply be the path to the user's Start menu folder (the same as %StartFolder%).
The path to the Programs folder in the user's Start menu. On Windows NT/2000/XP/Vista or later, this is the path from the per-user profile.
The path to the Programs folder in the user's Start menu. On Windows NT/2000/XP/Vista or later, this is the path from the All Users profile. On a non-Windows NT system, this will simply be the path to the Programs folder in the user's Start menu (the same as %StartProgramsFolder%).
The path to the user's Startup folder. On Windows NT/2000/XP/Vista or later, this is the path from the per-user profile.
The path to the user's Startup folder. On Windows NT/2000/XP/Vista or later, this is the path from the All Users profile. On a non-Windows NT system, this will be the path to the user's Startup folder (the same as %StartupFolder%).
The path to the user’s Windows System folder (e.g. "C:\Windows\System").
The drive that the user's Windows System directory is located on (usually "C:").
The path to the user's Temp folder.
The path to the user’s Windows folder (e.g. "C:\Windows").