Collapse all Symbian^3 Product Developer Library

MNcdLoadNodeOperationObserver Class Reference

class MNcdLoadNodeOperationObserver

Observer interface for node load operations

Node load operation users should implement this interface to be able to receive callbacks.

The observer can show progress via either the progress variable or by loaded nodes count / total count of nodes to load or both.

MNcdLoadNodeOperation

Public Member Functions
void	NodesUpdated(MNcdLoadNodeOperation &, RCatalogsArray< MNcdNode > &)
void	OperationComplete(MNcdLoadNodeOperation &, TInt)
void	QueryReceived(MNcdLoadNodeOperation &, MNcdQuery *)

Member Functions Documentation

NodesUpdated(MNcdLoadNodeOperation &, RCatalogsArray< MNcdNode > &)

void	NodesUpdated	(	MNcdLoadNodeOperation &	aOperation,
			RCatalogsArray< MNcdNode > &	aNodes
		)	[pure virtual]

Called when nodes have been updated. This may be called numerous times during one operation. The nodes can now be queried for name, description etc. information.

Parameters

MNcdLoadNodeOperation & aOperation	Reference to the operation reporting the updates. Uncounted; if the observer implementation wants to save the operation pointer for later use, it must call AddRef() for it first, and Release() after use.
RCatalogsArray< MNcdNode > & aNodes	Array of pointers to updated nodes. The references in the array are uncounted; if the observer implementation wants to save a node pointer for later use, it must call AddRef() for it first, and Relese() after is no longer needed.

OperationComplete(MNcdLoadNodeOperation &, TInt)

void	OperationComplete	(	MNcdLoadNodeOperation &	aOperation,
			TInt	aError
		)	[pure virtual]

Called when an operation has been completed.

Parameters

MNcdLoadNodeOperation & aOperation	Reference to the operation that sent the event. Uncounted; if the observer implementation wants to save the operation pointer for later use, it must call AddRef() for it first, and Release() after use.
TInt aError	Error code for operation completion. KErrNone for successful completion, KErrNoMasterServerUri if the master server URI has not been set (possible only when loading root node), otherwise a system wide error code.

QueryReceived(MNcdLoadNodeOperation &, MNcdQuery *)

void	QueryReceived	(	MNcdLoadNodeOperation &	aOperation,
			MNcdQuery *	aQuery
		)	[pure virtual]

Called when a query has been received for an operation. The query object can be obtained from the operation object with MNcdOperation::QueryL().

Note:

Querys need to be completed with MNcdOperation::CompleteQueryL() to continue the operation! Alternatively, the operation must be cancelled.

MNcdOperation MNcdQuery MNcdOperation::CompleteQueryL()

Parameters

MNcdLoadNodeOperation & aOperation	Uncounted reference to the operation object that sent the event.
MNcdQuery * aQuery	Pointer to the query that must be completed. Counted, Release() must be called after use.