HDeactivateTrigger (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HDeactivateTrigger (Function)

In french: HDésactiveTrigger

Not available with this kind of connection

Disables a trigger. Then, this trigger can be re-enabled by HActivateTrigger.

Reminder: A trigger is a WLanguage procedure automatically called by the HFSQL engine whenever a HFSQL function is run. A trigger is defined by HDescribeTrigger. See Managing the triggers for more details.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Example

// In the initialization code of the project
LOCAL
TriggerResult is boolean
// Create a trigger for the all the analysis data files
TriggerResult = HDescribeTrigger("*", "HADD,HMODIFY," + ...
"HDELETE, HCROSS,HWRITE", "CheckUserRights", hTriggerBefore)
// "CheckUserRights" is a global procedure of the project
IF TriggerResult = False THEN
Error("Error on a trigger: " + HErrorInfo)
RETURN
END
...
// Disables the trigger for all the data files
// On HDelete and HCross
HDeactivateTrigger("*", "HDELETE,HCROSS")

Syntax

<Result> = HDeactivateTrigger([<List of data files> [, <List of functions>]] [, <Type>])

<Result>: Boolean

True if the operation was performed,
False if a problem occurred. HError is used to identify the error.

<List of data files>: Optional character string (with quotes)

Logical name of one or more data files.
To specify several names of data files, the names of the data files must be separated by a comma (",").
To use all the data files found in the analysis, this parameter must be equal to "*".

By default, all the data files are taken into account.

<List of functions>: Optional character string (with quotes)

Name of one or more HFSQL or TableXXX functions on which the trigger must be implemented. To specify several names of functions, the names of functions must be separated by a comma (","). You have the ability to define triggers on the following HFSQL functions:
HModify
HAdd
HDelete
HWrite
HCross
If <List of functions> is set to "*", all the HFSQL functions that can activate a trigger are taken into account.

By default, all the HFSQL functions that can activate a trigger are taken into account.

<Type>: Optional Integer constant

Indicates the type of trigger. All triggers are affected if this parameter is not specified.
hTriggerBefore The procedure is run before the HFSQL function.
hTriggerAfter The procedure is run after the HFSQL function.

Business / GUI classification : Business Logic

Component : wd250hf.dll