Difference between revisions of "RegisterForSingleUpdate - Form"

From the CreationKit Wiki
Jump to navigation Jump to search
imported>Chesko
m
Line 26: Line 26:
*Aliases and quests will automatically unregister for this event when the quest stops. Active magic effects will automatically unregister when they are removed.
*Aliases and quests will automatically unregister for this event when the quest stops. Active magic effects will automatically unregister when they are removed.
*Subsequent calls to RegisterForSingleUpdate will override previous ones - i.e. calling it back to back will result in the second registered update occurring, but not the first. It will not interfere with updates started by RegisterForUpdate however.
*Subsequent calls to RegisterForSingleUpdate will override previous ones - i.e. calling it back to back will result in the second registered update occurring, but not the first. It will not interfere with updates started by RegisterForUpdate however.
*This function cannot be called when parent magic effect is not longer exist/active (see discussion).


== See Also ==
== See Also ==

Revision as of 10:51, 13 July 2023

Member of: ActiveMagicEffect Script, Alias Script, and Form Script

Registers this form/alias/magic effect for a single update event. Which also means you don't need to call UnregisterForUpdate() unless you want to cancel the update early. Only the specific form, alias, or magic effect that registered will get the event - it will not be relayed to attached aliases or magic effects.

Syntax

Function RegisterForSingleUpdate(float afInterval) native

Parameters

  • afInterval: In how much time (in seconds, ignoring menu-mode time) the OnUpdate() should be triggered

Return Value

None

Examples

; Register for a single update in 30.0 seconds - does not count menu-mode time.
RegisterForSingleUpdate(30.0)

Notes

  • Aliases and quests will automatically unregister for this event when the quest stops. Active magic effects will automatically unregister when they are removed.
  • Subsequent calls to RegisterForSingleUpdate will override previous ones - i.e. calling it back to back will result in the second registered update occurring, but not the first. It will not interfere with updates started by RegisterForUpdate however.
  • This function cannot be called when parent magic effect is not longer exist/active (see discussion).

See Also