TCallBack Class Reference

#include <e32std.h>

class TCallBack
Public Attributes
TInt(*iFunction
TAny *iPtr
Public Member Functions
TCallBack()
TCallBack(TInt(*)(TAny *aPtr))
TCallBack(TInt(*)(TAny *aPtr), TAny *)
TInt CallBack()

Detailed Description

Encapsulates a general call-back function.

The class encapsulates:

1. a pointer to a function which takes an argument of type TAny* and returns a TInt.

2. a pointer which is passed to the function every time it is called. The pointer can point to any object. It can also be NULL.

The callback function can be a static function of a class, e.g. TInt X::Foo(TAny *) or it can be a function which is not a member of any class, e.g. TInt Foo(TAny *).

When used with the CIdle and the CPeriodic classes, the callback function is intended to be called repeatedly; the encapsulated pointer is passed on each call. Typically, the pointer refers to an object which records the state of the task across each call. When used with CIdle, the callback function should also return a true (non-zero) value if it is intended to be called again, otherwise it should return a false (zero) value.

See also: CIdle CPeriodic

Member Attribute Documentation

iFunction

TInt(*iFunction

A pointer to the callback function.

iPtr

TAny *iPtr

A pointer that is passed to the callback function when the function is called.

Constructor & Destructor Documentation

TCallBack ( )

TCallBack()[inline]

Default constructor.

Sets the function pointer to Null.

TCallBack ( TInt(*)(TAny *aPtr) )

TCallBack(TInt(*)(TAny *aPtr)aFunction)[inline]

Constructs the callback object with the specified callback function.

Parameters
aFunctionA pointer to the callback function. It takes an argument of type TAny* and returns a TInt. It must be either a static member of a class or a function which is not a member of any class.

TCallBack ( TInt(*)(TAny *aPtr), TAny * )

TCallBack(TInt(*)(TAny *aPtr)aFunction,
TAny *aPtr
)[inline]

Constructs the callback object with the specified callback function and a pointer to any object.

Parameters
aFunctionA pointer to the callback function. It takes an argument of type TAny* and returns a TInt. It must be either a static member of a class or a function which is not a member of any class.
aPtrA pointer which is always passed to the callback function.

Member Function Documentation

CallBack ( )

TInt CallBack()const [inline]

Calls the callback function.

See also: CIdle CPeriodic

Return Value
The value returned by the callback function. The meaning of this value depends entirely on the context in which the callback function is called. For example, when used with the CIdle class, a false (zero) value indicates that the callback function should not be called again. As another example, when used with the CPeriodic class, the return value is ignored and is irrelevant in that context.