IDragDropTarget.h

//========================================================================================
// 
// $File$
// 
// Owner: Dave Burnard 
// 
// $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.
// 
// 
// Interface definition for Drag and Drop targets
// 
//========================================================================================

#ifndef __IDragDropTarget__
#define __IDragDropTarget__

#include "DragDropID.h"
#include "DragDropConstants.h"

#include "IPMUnknown.h"

class IDragDropSource;
class IDragDropController;
class ICommand;
class PMMatrix;
class DataObjectIterator;
class PMPoint;
class IDocument;
class IDropTargetCallback;
class ICommandSequence;
class IDataBase;

class IDragDropTarget : public IPMUnknown
{
 public:
 enum { kDefaultIID = IID_IDRAGDROPTARGET };
 
 public:
 virtual SysWireframe DoMakeDropHiliteRegion() const = 0;

 virtual DragDrop::TargetResponse
 HandleCouldAcceptTypes(DataObjectIterator*, const IDragDropSource*, const IDragDropController*) = 0;
 virtual void HandleDoDragEnter() = 0;
 virtual void HandleDoDragWithin(const PMPoint& localPt) = 0;
 virtual void HandleDoDragLeave() = 0;
 virtual ErrorCode HandleProcessDragDropCommand(IDragDropController*, DragDrop::eCommandType) = 0;
 virtual IDataBase* GetTargetDataBase() const = 0;

 virtual bool16 SameAsDragSource(const IDragDropSource* dragSource) const = 0;

 virtual bool16 AffectsSameDataAsDragSource(const IDragDropSource* dragSource) const = 0;

 virtual bool16 HitTest_OutsideBounds(const SysPoint&) const = 0;

 virtual IDragDropTarget* QueryInternalDropTarget(const SysPoint& windowPoint, 
 PMPoint& localPoint, 
 DataObjectIterator*, 
 const IDragDropSource*, 
 const IDragDropController*) = 0;
 
 virtual PMMatrix GetInternalTransform() const = 0;
 virtual void SetInternalTransform( PMMatrix) = 0;
 
 virtual void RegisterTargetCallback(IDropTargetCallback*) = 0;

 virtual void ReleaseTargetCallback(IDropTargetCallback*) = 0;
 
 virtual void SetActiveContext() = 0;
 virtual void ResetActiveContext() = 0;
 virtual void SetDocument(IDocument*) = 0;
 
 virtual void DrawTargetOutline() = 0;

 virtual bool16 IsTargetModifiable() const = 0; 

protected:
 virtual DragDrop::TargetResponse
 CouldAcceptTypes(DataObjectIterator*, const IDragDropSource*, const IDragDropController*) const = 0;
 
 friend class CDragDropTargetFlavorHelper; // Used so it can inherit targets drag handling behavior
 
 virtual void DoDragEnter() = 0;

 virtual void DoDragWithin(const PMPoint& localPt) = 0;

 virtual void DoDragLeave() = 0;

 virtual ErrorCode ProcessDragDropCommand(IDragDropController*, DragDrop::eCommandType) = 0;
 
};

#endif