Callback_stg_post_set()
Description: |
Callback procedure, informs that the setting member's value is being written to through one of the STG library's procedures; allows to respond to the value change. Procedure body has to be created elsewhere in the project (externally with respect to the library). |
Syntax: |
sub callback_stg_post_set(byref stg_name_or_num as string, index as byte,byref stg_value as string) |
Returns: |
--- |
See Also: |
Parameter |
Description |
stg_name_or_num |
Setting name or number. If the supplied string does not start with a digit (0-9), then the string should be interpreted as the name of the setting. If the string starts with a digit, then this should be interpreted as the setting number. Settings are numbered counting from 0, and in the order of their appearance in the setting configurator. |
index |
Setting member. |
stg_value |
New setting member's value that has just been set. |
Details
This procedure is invoked when the following procedures execute:
- Stg_start() — for all settings whose Storage Location is Non-volatile.
- Stg_restore_multiple() — for each setting being restored.
- Stg_restore_member() — for the setting being restored.
- Stg_set() — for the setting being written to.
- stg_sg(,,,EN_STG_SET) — for the setting being written to.
The following procedures can't be called from within callback_stg_post_set() or recursion error will be generated by the compiler: