Symbian^3 Application Developer Library >

TApaDocCleanupItem Class Reference

class TApaDocCleanupItem

Allows CApaDocument-derived objects to be safely put onto the cleanup stack, by calling CApaProcess::DestroyDocument() should a leave or a call to CleanupStack::PopAndDestroy() occur.

It is used as follows. 
        TApaDocCleanupItem cleanup(iEikonEnv->Process(),doc);
CleanupStack::PushL(cleanup);
// some potentially leaving code here ...
CleanupStack::Pop(cleanup);
Public Member Functions
TApaDocCleanupItem ( CApaProcess *, CApaDocument *)
operator TCleanupItem ()
Private Member Functions
IMPORT_C void DoCleanup ( TAny *)
Public Attributes
CApaDocument * iApaDoc
CApaProcess * iApaProcess

Constructor & Destructor Documentation

TApaDocCleanupItem(CApaProcess *, CApaDocument *)

TApaDocCleanupItem ( CApaProcess * aProcess,
CApaDocument * aDoc
) [inline]

Constructs a cleanup item object for the specified document.

Parameters

CApaProcess * aProcess A pointer to the process object that will be used to destroy the document.
CApaDocument * aDoc The document to destroy as part of cleanup.

Member Functions Documentation

DoCleanup(TAny *)

IMPORT_C void DoCleanup ( TAny * aPtr ) [private, static]

Parameters

TAny * aPtr

operator TCleanupItem()

operator TCleanupItem ( ) [inline]

A TCleanupItem cast operator that enables the TApaDocCleanupItem object to be pushed to the cleanup stack as a TCleanupItem , so that the document will be properly destroyed (by a call to CApaProcess::DestroyDocument() ) should a leave or a call to CleanupStack::PopAndDestroy() occur.

Member Data Documentation

CApaDocument * iApaDoc

CApaDocument * iApaDoc

The document to destroy as part of cleanup.

CApaProcess * iApaProcess

CApaProcess * iApaProcess

The process object that will be used to destroy the document.

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.