CPathCreationTracker.h

//========================================================================================
// 
// $File$
// 
// Owner: Lonnie Millett
// 
// $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 __CPathCreationTracker__
#define __CPathCreationTracker__

#include "CTracker.h"
#include "IPlaceBehavior.h"
#include "IDynamicTrackerData.h"
#include "PMPoint.h"
#include "PMRect.h"
#include "UIDRef.h"
#include "TransformTypes.h"

//----------------------------------------------------------------------------------------
// Forward Declarations
//----------------------------------------------------------------------------------------

class ICommand;
class PMPoint;
class IPathGeometry;
class ICmdCollection;

//----------------------------------------------------------------------------------------
// CPathCreationTracker: Tracker for creating new page items
//----------------------------------------------------------------------------------------


class CPathCreationTracker : public CTracker
{
 public:
 // Dynamic cursor options for specifying what gets drawn in the cursor while tracking
 enum CursorOptions
 {
 kDefaultCursor = 0, // do not modify the cursor
 kShowWidthHeight, // Add width/height information to cursor
 kShowXPosition, // Add X Position information to cursor (useful for vertical guides)
 kShowYPosition, // Add Y Position information to cursor (useful for horizontal guides)
 kShowXYPosition, // Add X,Y Position information to cursor
 kShowLineLength, // Add Line length information to cursor
 kShowScale // Add Scale information to cursor
 };

 CPathCreationTracker(IPMUnknown *boss);

 virtual ~CPathCreationTracker();
 
 virtual bool16 BeginTracking(IEvent* theEvent);
 
 virtual void ContinueTracking(const PBPMPoint& where, bool16 mouseDidMove);
 
 virtual bool16 EndTracking(IEvent* theEvent);

 virtual void AbortTracking(IEvent* theEvent);
 
 protected:
 virtual void CleanupTracking();

 virtual CursorOptions GetCursorOption(void) const;

 virtual void HandleMove(PMPoint& where);
 virtual PMPoint AutoScroll(const PMPoint& scrollBy, const PMPoint& scrolledPoint);

 virtual void MakePath (const PMPoint& startPt, const PMPoint& endPoint, IPathGeometry* pathGeometry);
 
 virtual void ShiftConstrainPoint(PMPoint& where);

 
 virtual bool16 MovedMinimumDistance (const PBPMPoint& newLocation);
 
 
 virtual bool16 IsGraphicFrame();
 
 
 virtual void ProcessAdditionalCreationCommands (const UIDRef& newItem, const UIDRef& parent, const PMPointList& points, IPlaceBehavior::eAfterPlace afterPlace);
 
 // 
 virtual UIDRef CreatePageItem (const UIDRef& parent, const PMPointList& points, const IEvent& theEvent, IPlaceBehavior::eAfterPlace *afterPlace = nil);
 
 
 virtual void SetBoundingBox (const UIDRef& newItem, const UIDRef& parent, const PMPointList& points);

 
 virtual void AddToHierarchy (const UIDRef& parent, const UIDRef& newItem);
 
 
 virtual void ProcessAdditionalSelectionCommands (const UIDRef& newItem);

 virtual void ProcessAddToSelectionCommand(IControlView *view, const UIDRef& newItem);

 virtual void CompletelyCreateItem(IEvent* theEvent);

 
 virtual bool16 SufficientSize(const PMPointList& points);

 virtual void ConvertToPasteboardConstrained(PMPoint thePoint, PMPoint& convertedPoint);
 virtual void ConvertToPasteboardConstrained(GSysPoint thePoint, PMPoint& convertedPoint);
 
 virtual void SetUpParentTransforms(PMPoint *endPoint);
 
 virtual UIDRef GetParent();
 
 private:
 
 bool16 DrawingCursorFeedback();
 PMPointList GetEffectiveBoundsUsingObjectStyle(const PMPointList& currentPoints, const UIDRef pageItem);
 protected:
 virtual void CheckSmartDimensions(PBPMPoint& endPoint,
 PBPMPoint& startPoint,
 SnapType& snapType,
 const IControlView* view);
 virtual Geometry::BoundsKind GetPathCreationBoundsKind();

 ClassID fClassID; // the class of the item we're creating
 PMPoint fStartPnt; // location of first mouse down, constrained to paste board
 PMPoint fStartGlobalPt; // stored global location of first mouse down.
 PMRect fPasteBoardBoundaries;
 PMRect fPasteBoardBoundsSpreadCoordinates;
 bool16 fShiftKeyPressed; // True if shift key is currently pressed
 bool16 fShownFirstTime;
 bool16 fOptionAltKeyPressed; // True if option/alt key is currently pressed
 bool16 fCmdCtrlKeyPressed; // True if command/control key is currently pressed
 bool16 fCreatingFromCenter; // True when user has option/alt key pressed
 PMMatrix fSpreadToPasteboardMatrix;
 PMMatrix fPasteboardToSpreadMatrix;
 PMMatrix fTransformMatrix;
 PMMatrix fBackTransformMatrix;
 IAbortableCmdSeq* fTrackerSequence;

 PMRect fGraphicBBox;
 bool32 fCreateMultiple;
 int32 fRows;
 int32 fColumns;
 static PMReal fHSpacing;
 static PMReal fVSpacing;
};


#endif