Accessing the Options settings via scripting

   

 

FinalBuilder allows you to modify FinalBuilder options at runtime using scripting. This makes it possible to specify the path to a third party tool at runtime so that a FinalBuilder project can for example use a different version of a third party tool. Note that these modified settings are not saved and will be lost when you close FinalBuilder, unless you choose Tools -> Options and click OK before closing.

 

The options objects are accessible using the GetOptionsObject script function. This function takes the name of the options object as a parameter. The name is the same as appears in the Options dialog.  For example to access the Delphi options you would use this code (VBScript example) :

 

dim delphiOptions

set delphiOptions = GetOptionsObject("Embarcadero Delphi")

delphiOptions.D6LibraryPath =delphiOptions.D6LibraryPath & ";$(DELPHI)\Components\Lib"

 

Listed below are the available properties on the IDE options objects.

 

FinalBuilder General Options

 

Name : General Options

 

   property PromptOnClose : boolean

   property PromptOnNew : boolean

   property DisplayPropDialog : boolean

   property SaveBeforeRun : Boolean

   property ShowTree : Boolean

   property AutoLoadLastProject : Boolean

   property PromptOnDeleteAction: boolean

   property AutoSizeListColumns : boolean

   property DisplayScriptErrors : Boolean

 

FinalBuilder Script Editor

 

Name : Script Editor

 

   property LineNumbers: boolean

   property DefaultScriptLanguage : String

   property AutoSaveScripts : boolean

 

FinalBuilder Logging Options

 

Name : Logging

 

   property LogHistoryCount : integer

   property IncludeActionOutput : boolean

   property OnlyIncludeErrorAction : boolean

   property ConfirmDeleteRunLog : boolean

   property ConfirmDeleteLogFile : boolean

 

 

Properties of Option objects for other option objects are available through the script editor automatic code completion (like Intellisense).