IGraphicStateAccessor.h

//========================================================================================
// 
// $File$
// 
// Owner: Michael_Martz
// 
// $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 _IGraphicStateAccessor_
#define _IGraphicStateAccessor_
//========================================================================================
//________________________________________________________________________________________
// INCLUDES
//________________________________________________________________________________________
 #include "IPMUnknown.h"
 #include "GraphicStylesID.h"
//========================================================================================
//________________________________________________________________________________________
// CLASS DECLARATION
//
// NOTE:
// There are two implementations of this interface. One is added to the 
// workspace (session and document) to make the workspace's graphic state object
// persistent. The second is created by the graphic state context observer and 
// is added to the active context. This is a session based object (database = nil),
// and therefore is non-persistent.
//
// Originally, there was just the workspace based accessor which was also 
// added to the active context. Unfortunately, this forced the workspace object
// to be held in memory, which prevented the purging of unneeded plugins. 
//________________________________________________________________________________________

class IGraphicStateAccessor : public IPMUnknown
 {
 //____________________________________________________________________________________
 // Data Types
 //____________________________________________________________________________________
 public:
 enum { kDefaultIID = IID_IGRAPHICSTATE_ACCESSOR};
 
 //____________________________________________________________________________________
 // Accessor memeber functions
 //____________________________________________________________________________________
 public:

 virtual UID GetGraphicStateUID (void) = 0;
 virtual void SetGraphicStateUID (UID gfxStateUID) = 0;
 
 virtual UIDRef GetOwningWorkspace (void) = 0;

 virtual void SetOwningWorkspace (const UIDRef& workspaceRef) = 0;
 
 virtual IPMUnknown* QueryGraphicStateInterface (const PMIID& interfaceIID) = 0;
 };
 
#endif // _IGraphicStateAccessor_