CitectVBA Programming Reference

CitectVBA is a Visual Basic for Applications (VBA) and VBScript-compatible Basic scripting language. Citect SCADA has embedded support for CitectVBA.

Note: CitectVBA is not supported on a 64-bit process, such as an alarm server operating in Extended Memory mode. If a call to CitectVBA code occurs from a 64-bit process, an error code will be returned, a hardware alarm will be raised and the Cicode thread will stop.
For information regarding methods you can use to extend Citect SCADA that do not require CitectVBA, see the topic Extending Citect SCADA with External Libraries in the main Citect SCADA help.

CitectVBA has the following features:

• CitectVBA code is multithreaded and fully scheduled within the Citect SCADA Kernel.
• CitectVBA uses the same well proven engine that Cicode uses and can be used wherever Cicode is used.
• CitectVBA has a small footprint of under 400K.
• CitectVBA code is directly callable from Citect SCADA Command and Expression fields.
• CitectVBA code is callable from Cicode and vice versa.
• CitectVBA code provides native support for ActiveX objects, Citect SCADA Variable Tags and Alarm Tags.
• CitectVBA makes ActiveX object manipulating easier. It allows direct interaction with the object models from 3rd party applications such as Word, Excel, etc.

Note: You may notice slight differences between CitectVBA and VBA in other applications; this is normal as each application has a different object model.

The Cicode Editor has been upgraded to fully support CitectVBA. New features of the editor include:

• Integrated Cicode and CitectVBA compiler
• Integrated Cicode and CitectVBA source code editor
• Integrated Cicode and CitectVBA debugger

This section contains information on the CitectVBA programming language and describes the following:

Published June 2018