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:

Using Pre-gets and Post-sets

 


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 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:

Stg_start()

Stg_check_all()

Stg_restore_multiple()

Stg_restore_member()

Stg_get()

Stg_set()

Stg_sg()