PreferenceUtils.h

//========================================================================================
// 
// $File$
// 
// Owner: Tommy Donovan
// 
// $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 __PreferenceUtils__
#define __PreferenceUtils__

class IPMUnknown;
class IActiveContext;


template <class FACE> 
inline FACE* QuerySessionPreferences() 
{ 
 IPMUnknown* face = QuerySessionPreferences(FACE::kDefaultIID);
 
 return static_cast<FACE*>(face);
}

// ---- Query for a preferences interface from either the workspace of the document
// or Session, whichever is active.
 IPMUnknown* QueryPreferences(PMIID prefInterfaceID, IActiveContext* activeContext);

// ---- Query for a preferences interface in the session workspace.
 IPMUnknown* QuerySessionPreferences(PMIID prefInterfaceID);

// ---- Query for a preferences interface in the workspace of the document in which
// "object" resides.
 IPMUnknown* QueryPreferences(PMIID prefInterfaceID, const IPMUnknown* object);
 IPMUnknown* QueryPreferences(PMIID prefInterfaceID, const UIDRef& ref);


#endif