CreateObject.h

//========================================================================================
// 
// $File$
// 
// Owner: rbriggs
// 
// $Author$
// 
// $DateTime$
// 
// $Revision$
// 
// $Change$
// 
// Copyright 1997-2010 Adobe Systems Incorporated. All rights reserved.
// 
// NOTICE: Adobe permits you to use, modify, and distribute this file in accordance 
// with the terms of the Adobe license agreement accompanying it. If you have received
// this file from a source other than Adobe, then your use, modification, or 
// distribution of it requires the prior written permission of Adobe.
// 
//========================================================================================

#ifndef __CreateObject__
#define __CreateObject__

#include "IObjectModel.h"
#include "ISession.h"
#include "IPMUnknown.h" // for the definition of 


class ICreateObjectFunctor
{
public:
 virtual IPMUnknown *CreateObject(ClassID clsID, PMIID interfaceID) = 0;
};


#ifdef PUBLIC_BUILD
#endif

class RsrcSpec;
class IResourceAccess;




 IPMUnknown* CreateObject(ClassID clsID, PMIID iid = IID_IUNKNOWN, const IObjectModel*om = GetObjectModelInstance());
 
 IPMUnknown* CreateObject(IDataBase* db, ClassID id, PMIID iid = IID_IUNKNOWN);

 IPMUnknown* CreateObject(IDataBase* db, const RsrcSpec& spec, PMIID iid = IID_IUNKNOWN, const IObjectModel*om = GetObjectModelInstance());

 IPMUnknown* CreateObjectNoInit (IDataBase* db, const RsrcSpec& spec, PMIID returnIID, const IObjectModel*om = GetObjectModelInstance());


// ***************************************************************************************************
// Drover based widgets created/read from resources need a context to indicate to the panel control
// data that there is an underlying UI_Node off this boss. This is so things get addref'd properly.
// During stream resource read, an extra addref on the IControlView interface keeps the drover based
// widget boss from being immediately destroyed since at present, unlike our old platform based
// widgets, we don't allow drover based widgets in the instance cache. This AddRef is compensated
// for in DVControlPanelData::ReadWrite.

namespace ResourceStreamReadContext
{
 bool16 IsResourceStreamReadContextActive();
}
 
// ***************************************************************************************************






// These work like CreateObject(ClassID, PMIID), but you can omit the interface ID if the 
// face defines kDefaultIID and the correct face pointer is returned. Usage is like this:
// ::CreateObject2<ITableTarget>(kTableSelectionBoss).

template <class FACE> 
inline FACE* CreateObject2(ClassID clsID) // do not forward declare these: CW Pro 5 won't inline them if they're forward declared...
{ 
 IPMUnknown* face = CreateObject(clsID, FACE::kDefaultIID);
 
 return static_cast<FACE*>(face);
}

template <class FACE> 
inline FACE* CreateObject2(ClassID clsID, PMIID iid)
{ 
 IPMUnknown* face = CreateObject(clsID, iid);
 
 return static_cast<FACE*>(face);
}

template <class FACE> 
inline FACE* CreateObject2(IDataBase* db, ClassID clsID)
{ 
 IPMUnknown* face = CreateObject(db, clsID, FACE::kDefaultIID);
 
 return static_cast<FACE*>(face);
}

template <class FACE> 
inline FACE* CreateObject2(IDataBase* db, ClassID clsID, PMIID iid)
{ 
 IPMUnknown* face = CreateObject(db, clsID, iid);
 
 return static_cast<FACE*>(face);
}

template <class FACE> 
inline FACE* CreateObject2(IDataBase* db, const RsrcSpec& spec)
{ 
 IPMUnknown* face = CreateObject(db, spec, FACE::kDefaultIID);
 
 return static_cast<FACE*>(face);
}



#endif // __CreateObject__