alertDisconnect()

Unregisters the function work() from call when changes are made to the values.

Synopsis

int alertDisconnect([class object], string|function_ptr work, string alert1, [string alert2 ...]|dyn_string alert_list);

Parameters

Parameter Meaning
object An object of a Control++ class.
work

Name of the work function that is called when alerts occur

Or

a function pointer to the work function (callback function).

alert1, alert2, ...

|

alert_list

Alert handling attributes or a list of alert handling attributes (dyn_string).

Return Value

If successful 0, in the event of an error -1.

Errors

Errors can be retrieved with getLastError() . The return value is then the appropriate error code. An alert is issued in the event of non-existent data points, incorrect parameter transfers or spelling errors.

Description

The function alertDisconnect() unregisters the function work() from the call when changes are made to the values of the alert handling attributes alert1, alert2, ... The work function is no longer executed spontaneously.

Example

main()
{
  alertDisconnect("work",":_alert_hdl.._text",":_alert_hdl.._visible");
}

You can find an example of how to use a Control++ class instance in an alertDisconnect function in the chapter alertConnect().

Assignment

Alert handling, waiting control function

Availability

CTRL