====== TimerMsgAfterDelay ======

Sends a message after a delay.

==== Synopsis ====

''%%TimerHandle TimerMsgAfterDelay (Item msgport, uint32 seconds, uint32 microseconds, uint32 userdata1, uint32 userdata2)%%''

==== Description ====

Creates a timer that notifies you by message after the specified delay. The timer is a one-shot; after sending a notification message the timer enters a suspended state. Use ''%%TimerReset()%%'' to reactivate the timer using new time values, ''%%TimerRestart()%%'' to start another delay period of the same length as last time, or ''%%TimerCancel()%%'' to delete the timer.

The TimerServices thread must be active before calling this function.

==== Arguments ====

  * **msgport** Port to which the notification message is sent.

  * **seconds** Seconds portion of the delay.

  * **microseconds** Microseconds portion of the delay. This value can be larger than 1 million.

  * **userdata1** Value passed back to you in the msg_DataPtr field of the notification message.

  * **userdata2** Value passed back to you in the msg_DataSize field of the notification message.

==== Return Value ====

A TimerHandle (a positive value) on success or a negative error code.

==== Implementation ====

Library call implemented in lib3do.lib.

==== Associated Files ====

lib3do.lib, timerutils.h

==== See Also ====

''%%TimerMsgAtTime%%'', [[:documentation:development:opera:pf25:ppgfldr:smmfldr:ldofldr:01ldo185#xref12235|TimerMsgHeartbeat]]