|
Callback_stg_post_set() |
Top Previous Next |
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: |
Part |
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 listing in the descriptor file. |
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 type is "R" (volatile). See Setting Descriptor File for details. |
| • | 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: