ISWiProject Object

ISWiProject contains the interface for opening, closing, and saving an InstallShield project (.ism) file. When InstallShield is installed on your system, you can instantiate a copy of ISWiProject with the following VB and VBScript syntax:

Build Status Events

These events are raised during the build process and provide status updates. You can set pbCancel to stop the build.

Many feature properties and attributes are available in the automation interface through this object’s methods, properties, and collections. The following table lists the ISWiProject Object members. Remember that some methods, properties, and collections are only available for a particular project type.

Members

ISWiProject Object Members
Name	Project	Type	Description
ActiveLanguage	All	Read-Write Property	Gets or sets the default language of the project. Specify a single language as a string language ID. The automation interface uses the active language whenever you get or set a localizable property, such as ISWiShortcut's DisplayName. In the IDE, localizable properties must use a string table entry. If the property has a string ID, the string you enter for the property becomes the value in the string table for the active language.
AddAdvancedFile	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object	Method	Creates an advanced file with the specified name and (optionally) in the specified disk image in the current project.
AddAutomaticUpgradeEntry	Basic MSI, InstallScript MSI	Method	Creates a new ISWiAutomaticUpgradeEntry item and returns a handle to that object.
AddComponent	All	Method	Creates an ISWiComponent object in the current project.
AddCustomAction	Basic MSI, InstallScript MSI	Method	Creates an ISWiCustomAction object in the current project.
AddDimReference	Basic MSI	Method	Creates an ISWiDimReference object in the current project.
AddFeature	All	Method	Creates an ISWiFeature object in the current project.
AddLanguage	All	Method	Adds a language to the current project.
AddPathVariable	All	Method	Adds a path variable to the current project.
AddProductConfig	Basic MSI, InstallScript MSI	Method	Creates an ISWiProductConfig object in the current project.
AddProperty	Basic MSI, InstallScript MSI	Method	Creates a new ISWiProperty item and returns a handle to that object.
AddSetupFile	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object	Method	Creates a support file with the specified name in the current project.
AddSetupType	InstallScript, InstallScript Object	Method	Creates a setup type with the specified name in the current project.
AddSqlServerConnection	All	Method	Adds a new server connection to the current project.
AddUpgradeTableEntry	Basic MSI, InstallScript MSI	Method	Creates a new ISWiStaticUpgradeEntry item and returns a handle to that object.
AdminExecuteSequence	Basic MSI, InstallScript MSI	Read-only Property	Returns an ISWiSequence collection representing the Administration Execute sequence in the current project.
AdminUISequence	Basic MSI, InstallScript MSI	Read-only Property	Returns an ISWiSequence collection representing the Administration User Interface sequence in the current project.
AdvtExecuteSequence	Basic MSI, InstallScript MSI	Read-only Property	Returns an ISWiSequence collection representing the Advertisement Execute sequence in the current project.
AdvtUISequence	Basic MSI, InstallScript MSI	Read-only Property	Returns an ISWiSequence collection representing the Advertisement User Interface sequence in the current project. (Note that validation rule ICE78 requires the Advertisement User Interface sequence to be empty. For more information, see ICEs.)
BuildPatchConfiguration	Basic MSI, InstallScript MSI	Method	Calling this method builds the patch configuration identified by the strPatchConfiguration variable. This action has the same effect as right-clicking on a patch configuration in the Patch Design view and then selecting 'Build Patch'.
BuildPCPFile	Basic MSI, InstallScript MSI	Method	Builds a patch package based on a .pcp file.
CloseProject	All	Method	Closes an InstallShield installation project.
CompanyName	Basic MSI, InstallScript, InstallScript MSI	Read-Write Property	Specifies the company name. In Basic MSI and InstallScript MSI projects, this property corresponds with the Publisher setting in the Add or Remove Programs area of the General Information view. In InstallScript projects, this property corresponds with the Company Name setting in the Product Properties area of the General Information view.
CompanyPhone	Basic MSI, InstallScript, InstallScript MSI	Read-Write Property	Specifies the phone number that you would like end users to call for technical support. This phone number is displayed on the Support Information dialog of Add or Remove Programs. This property corresponds with the Support Phone Number setting in the Add or Remove Programs area of the General Information view.
CompanyURL	Basic MSI, InstallScript, InstallScript MSI	Read-Write Property	Specifies the URL that you would like end users to visit for technical support. This URL is used as a hyperlink on the Support Information dialog of Add or Remove Programs. This property corresponds with the Publisher/Product URL setting in the Add or Remove Programs area of the General Information view.
CreatePatch	Basic MSI, InstallScript MSI	Method	The CreatePatch method is deprecated for new development. It has been replaced with the BuildPCPFile and BuildPatchConfiguration methods.
CreateProject	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module	Method	Creates a new project file (.ism).
DeleteAdvancedFile	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object	Method	Deletes the specified advanced file from the current project.
DeleteComponent	All	Method	Deletes the specified component from the project.
DeleteCustomAction	Basic MSI, InstallScript MSI	Method	Deletes an ISWiCustomAction object in the current project.
DeleteDimReference	Basic MSI	Method	Deletes a specific DIM reference from the current project.
DeleteMergeModule	Basic MSI, InstallScript MSI	Method	Deletes a merge module from the current project.
DeletePathVariable	All	Method	Deletes a path variable from the current project.
DeleteProductConfig	Basic MSI, InstallScript MSI	Method	Deletes an ISWiProductConfig object from the current project.
DeleteProperty	Basic MSI, InstallScript MSI	Method	Deletes a property from the Property table.
DeleteSetupFile	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object	Method	Deletes the specified support file from the current project.
DeleteSetupType	InstallScript, InstallScript Object	Method	Deletes the specified setup type from the current project.
DeleteSQLConnection	All	Method	Remove a SQL Server connection from the current project.
DeselectLanguage	All	Method	Deselects a language from the current project.
ExportProject	All	Method	Causes the .ism file to use the XML representation, which is better suited for source code integration.
ExportStrings	All	Method	Exports string table entries to a text file.
GenerateGUID	All	Method	Generates a new, unique GUID as a string.
ImportProject	All	Method	Converts an .isv file (a text file kept in a source code integration program) to an InstallShield .ism project file. The .isv file format has been deprecated to version 2.x of InstallShield for Windows Installer and versions of InstallShield Developer prior to 8.x.
ImportStrings	All	Method	Imports string table entries from a text file.
INSTALLDIR	Basic MSI, InstallScript MSI	Read-Write Property	Sets the INSTALLDIR property for the project. A typical value is “[ProgramFilesFolder]CompanyName\ProductName”.
InstallExecuteSequence	Basic MSI, InstallScript MSI	Read-only Property	Returns an ISWiSequence collection representing the Installation Execute sequence in the current project.
InstallUISequence	Basic MSI, InstallScript MSI	Read-only Property	Returns an ISWiSequence collection representing the Installation User Interface sequence in the current project.
ISWiAdvancedFiles	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object	Collection	Contains every advanced file (as an ISWiAdvancedFile object) in your project.
ISWiAutomaticUpgradeEntries	Basic MSI, InstallScript MSI	Collection	Returns a collection of ISWiAutomaticUpgradeEntry items. This collection presents a list of Automatic Upgrade Items as they are defined in the IDE.
ISWiComponents	All	Collection	Contains all of the components in this project.
ISWiCustomActions	Basic MSI, InstallScript MSI	Collection	Contains all of the custom actions in this project.
ISWiDimDependencies	Basic MSI	Collection	Contains all of the DIM dependencies associated with a DIM reference.
ISWiDimReferences	Basic MSI	Collection	Contains every DIM reference in the current project.
ISWiFeatures	All	Collection	Contains all features’ names and their components.
ISWiLanguages	All	Collection	Contains all of the languages included in the current project.
ISWiPathVariables	All	Collection	Contains all of the path variables that are associated with the current project.
ISWiProductConfigs	All	Collection	Contains all of the product configurations in this project.
ISWiProperties	Basic MSI, InstallScript MSI	Collection	Contains all of the Windows Installer properties in this project.
ISWiSetupFiles	Basic MSI, InstallScript, InstallScript MSI, InstallScript Object	Collection	Contains every support file (as an ISWiSetupFile object) in your project.
ISWiSetupTypes	InstallScript, InstallScript Object	Collection	Contains every setup type (as an ISWiSetupType object) in your project.
ISWiSISProperties	Basic MSI, InstallScript MSI	Collection	Contains all of the Summary Information Stream properties in this project.
ISWiSQLConnections	All	Collection	Contains all of the SQL Server connections in the current project.
ISWiUpgradeTableEntries	Basic MSI, InstallScript MSI	Collection	Returns a collection of ISWiStaticUpgradeEntry items. This collection presents a list of static major upgrade items, as defined in the IDE.
ModuleID and ModuleIDGUID	Merge Module	Read-Write String Properties	These properties are used only with merge module projects. Every merge module has a record in the ModuleSignature table. The ModuleID field of the ModuleSignature table is composed of two sections: ModuleID.ModuleIDGUID. For example, IDID.019880FB_04F2_4D4B_99C9_9A0A12185229The ModuleID property gets or sets IDID. The ModuleIDGUID property gets or sets 019880FB_04F2_4D4B_99C9_9A0A12185229.
OpenProject	All	Method	Opens an InstallShield installation project (.ism file). This method fails if the project is open in the InstallShield user interface.
PackageCode	Basic MSI, InstallScript MSI	Read-Write Property	Gets or sets the package code as a string GUID. The GUID must be surrounded by braces—{12345678-1234-1234-1234-1234567890AB}, for example.
ProductCode	All	Read-Write Property	Gets or sets the product code as a string GUID. The GUID must be surrounded by braces—{12345678-1234-1234-1234-1234567890AB}, for example. This property is not available for merge module projects.
ProductName	All	Read-Write Property	Gets or sets the product name.
ProductVersion	All	Read-Write Property	Contains the version number of the project as a string.
RemoveFeature	All	Method	Deletes a feature from the project.
SaveProject	All	Method	Saves an InstallShield installation project.
ProjectSchemaVersion	All	Read-Write Property	Enables you to save your project file (.ism) as the current schema version of InstallShield or as an earlier schema version every time that it is saved through the automation interface. Saving a project to an earlier schema enables users who have not upgraded to the same version of InstallShield to open and maintain your project. Specify one of the following schema version values in this property: epvCurrent (current version of InstallShield—applies to Basic MSI, InstallScript, and InstallScript MSI projects) epv120 (InstallShield 12—applies to Basic MSI, InstallScript, and InstallScript MSI projects) epv1150 (InstallShield 11.5—applies to Basic MSI, InstallScript, and InstallScript MSI projects) epv110 (InstallShield 11—applies to Basic MSI, InstallScript, and InstallScript MSI projects) epv1050 (InstallShield 10.5—applies to Basic MSI, InstallScript, and InstallScript MSI projects) epv100 (InstallShield X—applies to Basic MSI, InstallScript, and InstallScript MSI projects) epv90 (InstallShield DevStudio 9.0—applies to Basic MSI, InstallScript, and InstallScript MSI projects) epv801 (InstallShield Developer 8.01—applies to Basic MSI and InstallScript MSI projects) epv80 (InstallShield Developer 8.0—applies to Basic MSI and InstallScript MSI projects) epv704 (InstallShield Developer 7.04—applies to Basic MSI and InstallScript MSI projects) epv701 (InstallShield Developer 7.01—applies to Basic MSI and InstallScript MSI projects)
ProjectSchemaVersion (cont.)			Note that when you save your project to an earlier version of an InstallShield product, the schema of your project is modified to conform to the earlier version; any tables or columns that are available in the later version of the InstallShield product but not in the earlier version are lost during the downgrade process. If you save an InstallScript project as an earlier schema version, the script file (.rul) is not downgraded to the earlier version; only the .ism file is downgraded. If a script file created or modified in the later version of the InstallShield product contains functions that are not available in the earlier version, your script will not compile in the earlier version.
UpgradeCode	Basic MSI, InstallScript MSI	Read-Write Property	Gets or sets the Upgrade Code property as a string GUID. The GUID must be surrounded by braces—{12345678-1234-1234-1234-1234567890AB}, for example. This property is not available for merge module projects.
UseXMLProjectFormat	All	Boolean Read-Write Property	Specifies whether the project file should use the XML file format.