# HB_IDLEADD()

Adds the background task.

Syntax

  HB_IDLEADD( <cbAction> ) --> nHandle

Arguments

  <cbAction> is a codeblock that will be executed during idle states. There are no arguments passed to this codeblock during evaluation.

Returns

  <nHandle> The handle (an integer value) that identifies the task. This handle can be used for deleting the task.

Description

  HB_IDLEADD() adds a passed codeblock to the list of background tasks that will be evaluated during the idle states. There is no limit for the number of tasks.

Examples

          nTask := HB_IDLEADD( {|| SayTime()} )

Status

  Ready

Compliance

  Harbour extension similar to FT_ONIDLE() function available in NanForum library.

Platforms

  All

Files

  source/rtl/idle.c

See Also

- HB_IDLEDEL()
- HB_IDLESTATE()