QuickAdd Subroutine

Launches the Quick Add dialog box for adding a data block.

Syntax

QuickAdd (DataSource, [intErrorMode])

Properties

The QuickAdd subroutine syntax has these parts:

Part

Description

DataSource

String. The name of the database block you want to add.

intErrorMode

Integer. (Optional). The error mode.
0 (default) – Allows the subroutines to provide the error messages. Errors are displayed in the form of a message box. If no entry is made for the intErrorMode parameter, the default is used.

1 – Allows the user to handle the error messages. Errors in the subroutines are passed back to the calling routine for handling.

2 – Writes errors to all destinations. No error messages display. Instead, the errors are written to all iFIX destinations, including the Alarm History window destinations using SendOperatorMessage.

Return Value

Integer. The status of the database block.

0 = OK (data block already exists)

1 = Invalid Syntax

2 = Undefined (Quick Add dialog is launched)

3 = Data Type Mismatch

4 = User chose Use Anyway

5 = User chose not to add the block

 

Example