SetupData.GetFileList

table SetupData.GetFileList ( 

number ListToGet = ARCHIVE_LIST )

Description

Returns a numerically indexed table containing information about each file in the setup.

Note: Some returned values are not calculated until the files have actually been installed.

Parameters

ListToGet

(number) The file list to retrieve. Choose from:

CONSTANT

VALUE

DESCRIPTION

ARCHIVE_LIST

0

Retrieve files in the setup archive.

EXTERNAL_LIST

1

Retrieve external files.

BOTH_LISTS

2

Retrieve both archive and external files.

Returns

(table) A numerically indexed table containing the file properties for every file within the setup. Every index in this table contains a table of file properties, indexed by the following keys:

KEY

TYPE

DESCRIPTION

AccessDate

string

The files last accessed date in the form: Tuesday, July 06, 2004, 12:46:06 PM

AccessDateISO

string

The file's last accessed date in the ISO format.

CompressFile

boolean

Whether the file is compressed within the archive.

CRC

number

The file's CRC value.

CreateBackup

boolean

Whether a backup of any existing file will be created before it is overwritten.

CreationDate

string

The files creation date in the form: Tuesday, July 06, 2004, 12:46:06 PM

CreationDateISO

string

The file's creation date in the ISO format.

CustomShortcutPath

string

The full path to the location where the custom shortcut will be created.

Destination

string

Where the file will be installed to.

FailSafeCopy

boolean

Whether a fail-safe copy will be performed.

FileDescription

string

The file's design-time description. This is the value entered in the Description field of a file's properties in the Setup Factory design environment.

FileName

string

The file's filename.

FileSource

string

The full path to the original location of the file.

FileVersion

string

The file's version.

FolderMatchMode

number

The folder match mode, if the current item is a folder reference:
INCLUDE_MATCHING_FILES = 0
EXCLUDE_MATCHING_FILES = 1.
If the current item is a file, then 0 is returned.

FolderRecurse

boolean

Whether the folder reference will be handled recursively. If the current item is a file, false will be returned.

FontName

string

The font name to use when registering the file as a font.

FullPath

string

The full path to the file, including file name.

IconIndex

number

The index of the icon to use for the shortcut.

IconPath

string

The external icon path to use for the shortcut.

IconShowMode

number

The Icon show mode:
SW_NORMAL = 1
SW_MAXIMIZE = 3
SW_MINIMIZE = 6.

InstallOrder

number

The install order of the file.

IsArchive

boolean

Whether the original file was an archive file.

IsFolderReference

boolean

Whether the current item is a folder reference.

IsHidden

boolean

Whether the original file was hidden.

IsInstalling

boolean

Whether the current item has been installed. This value is calculated at the time of the file's installation.

IsInstallingOnReboot

boolean

Whether the current item will be installed on system reboot. This value is calculated at the time of the file's installation.

IsReadOnly

boolean

Whether the original file was read only.

IsRuntimeSourceOk

boolean

Whether the runtime source of the file is valid.

IsSystem

boolean

Whether the original file was a system file.

ModifiedDate

string

The files last modified date in the form: Tuesday, July 06, 2004, 12:46:06 PM

ModifiedDateISO

string

The file's last modified date in the ISO format.

NeverRemove

boolean

Whether this file will be left behind by the uninstall.

NewAttributeArchive

boolean

Whether the Archive attribute will be applied to the file once it is installed.

NewAttributeHidden

boolean

Whether the Hidden attribute will be applied to the file once it is installed.

NewAttributeReadOnly

boolean

Whether the Read Only attribute will be applied to the file once it is installed.

NewAttributeSystem

boolean

Whether the System attribute will be applied to the file once it is installed.

Notes

string

The notes associated with the file.

Overwrite

number

What will happen if the file already exists on the user's system:
FILE_INSTALL_SAMEOLDER = 0

FILE_INSTALL_OLDER = 1

FILE_INSTALL_ALWAYS = 2

FILE_INSTALL_NEVER = 3

FILE_INSTALL_ASK = 4"

Packages

table

A numerically indexed table of all of the packages that the current item belongs to. If it does not belong to any package, nil is returned.

ProductVersion

string

The file's product version.

RegisterAsOCX

boolean

Whether the file will be registered as an OCX.

RegisterAsTLB

boolean

Whether the file will be registered as a Type Library.

RegisterAsTTF

boolean

Whether the file will be registered as a True Type Font.

SharedSystemFile

boolean

Whether the current item is a shared system file.

ShorcutInStartMenuAppFolder

boolean

Whether a shortcut be created in Start Menu > %AppFolder%

ShortcutArguments

string

The command line arguments that will be passed to the file when the user launches the shortcut.

ShortcutDescription

string

The description that will accompany the shortcut.

ShortcutInCustom

boolean

Whether a shortcut be created in the custom shortcut path

ShortcutInDesktop

boolean

Whether a shortcut be created on the desktop

ShortcutInQuickLaunch

boolean

Whether a shortcut be created in the quick launch folder

ShortcutInStartMenu

boolean

Whether a shortcut be created in the start menu

ShortcutInStartMenuPrograms

boolean

Whether a shortcut be created in Start Menu > Programs

ShortcutInStartup

boolean

Whether a shortcut be created in the Startup folder

SupressCRCCheck

boolean

Whether the CRC check is suppressed.

SupressInUseNotice

boolean

Whether the "In Use" message will be suppressed when the file is installed.

UseExternalIcon

boolean

Whether an external icon is used for the shortcut.

UseOriginalAttributes

boolean

Whether the original attributes will be used, or if the new attributes are going to be used.

If this action fails, nil will be returned. You can use Application.GetLastError to determine whether this action failed, and why.

ResultVariable

When adding an action with the action editor, you can use this field to specify a variable that the return value will be stored in.

See also:  Related Actions