Hot Door CORE  0.7.0
Adobe® Illustrator® Plug-in Library
Public Types | Public Member Functions | Static Public Member Functions | Friends | List of all members
hdi::core::Cursor Class Reference

Represents a cursor that can be shown on the screen, as well as metadata about the current cursor. More...

#include <hdicoreCursor.h>

Public Types

enum  AdobeCursor {
  BrushCursor = 10, CrosshairsCursor = 20, CrosshairsAddCursor = 30, CrosshairsAnchorCursor = 40,
  CrosshairsCircleBoldCursor = 50, CrosshairsCircleBrokenCursor = 60, CrosshairsCircleWholeCursor = 70, CrosshairsCloseCursor = 80,
  CrosshairsContinueCursor = 90, CrosshairsDeleteCursor = 100, CrosshairsEllipsisCursor = 110, CrosshairsNoCursor = 120,
  CrosshairsSquareBrokenCursor = 130, DirectMoveCursor = 140, DirectMoveCopyCursor = 150, DirectSelectCursor = 160,
  DirectSelectAddCursor = 170, DirectSelectBehindCursor = 180, EyeDropperCursor = 190, EyeDropperFilledCursor = 200,
  FistCursor = 210, HandCursor = 220, MoveCursor = 230, MoveCopyCursor = 240,
  PenCursor = 250, PenAddCursor = 260, PencilCursor = 270, PenCloseCursor = 280,
  PenContinueCursor = 290, PenCornerCursor = 300, PenNewCursor = 310, PenSubstractCursor = 320,
  PenWeldCursor = 330, RotateBottomCenterCursor = 340, RotateBottomLeftCursor = 350, RotateBottomRightCursor = 360,
  RotateMidLeftCursor = 370, RotateMidRightCursor = 380, RotateTopCenterCursor = 390, RotateTopLeftCursor = 400,
  RotateTopRightCursor = 410, ScaleDeclineCursor = 420, ScaleHorizontalCursor = 430, ScaleInclineCursor = 440,
  ScaleVerticalCursor = 450, SelectCursor = 460, SelectBehindCursor = 470, WatchCursor = 480,
  ZoomInCursor = 490, ZoomNoneCursor = 500, ZoomOutCursor = 510
}
 Describes the built-in Adobe cursors that can be acquired.
 

Public Member Functions

 Cursor ()
 Constructs an empty Cursor object. More...
 
 Cursor (const Cursor &c_)
 Constructs a new Cursor object from an existing Cursor object (copy constructor) More...
 
 Cursor (const AdobeCursor cursor_)
 Constructs a new Cursor object from a built-in Illustrator cursor. More...
 
 Cursor (const int16_t cursorID_, const Point &hotSpot_)
 Constructs a new Cursor object from a PNG image and a hot spot. More...
 
Cursoroperator= (const Cursor &rhs_)
 Assigns one Cursor object to another. More...
 
virtual ~Cursor ()
 Destructs a Cursor object. More...
 
virtual bool isEmpty () const
 Gets whether the target Cursor object is empty (constructed with the default ctor) More...
 
virtual void enable ()
 Shows the cursor (sets it as current) More...
 
virtual Point hotSpot () const
 Gets the cursor hot spot. More...
 
virtual bool operator== (const Cursor &rhs_) const
 Tests whether a given Cursor object is the same as another. More...
 
virtual bool operator!= (const Cursor &rhs_) const
 Tests whether a given Cursor object is not the same as another. More...
 

Static Public Member Functions

static Cursor CurrentCursor ()
 Named constructor to acquire a Cursor object for whichever cursor image is current. More...
 
static Point screenLoc ()
 Gets the absolute location of the cursor on the screen. More...
 
static void mouseDown (const Point &pt_)
 Simulates a mouse down (with no modifier keys) at an absolute location on the screen. More...
 
static void mouseUp (const Point &pt_)
 Simulates a mouse up (with no modifier keys) at an absolute location on the screen. More...
 
static void click (const Point &pt_)
 Simulates a click (with no modifier keys) at an absolute location on the screen. More...
 

Friends

plugin::Cursor * __accessImpl (const Cursor &)
 

Detailed Description

Represents a cursor that can be shown on the screen, as well as metadata about the current cursor.

Constructor & Destructor Documentation

hdi::core::Cursor::Cursor ( )

Constructs an empty Cursor object.

Author
GW
Date
09/2014
Note
To test if a Cursor object is empty, call isEmpty() on it
Empty Cursor objects do not relate to any UI cursor; they are designed to be "receivers" of some other Cursor object via the overloaded assignment operator. Empty Cursor objects are useless until such time (though it is safe to call any of their methods)
hdi::core::Cursor::Cursor ( const Cursor c_)

Constructs a new Cursor object from an existing Cursor object (copy constructor)

Author
GW
Date
09/2014
Parameters
c_Existing Cursor object
hdi::core::Cursor::Cursor ( const AdobeCursor  cursor_)

Constructs a new Cursor object from a built-in Illustrator cursor.

Author
GW
Date
09/2014
Parameters
cursor_Illustrator cursor identifier
hdi::core::Cursor::Cursor ( const int16_t  cursorID_,
const Point hotSpot_ 
)

Constructs a new Cursor object from a PNG image and a hot spot.

Author
GW
Date
08/2013
Parameters
cursorID_PNGI resource ID for the cursor
hotSpot_Coordinate within the cursor that acts as the hot spot
virtual hdi::core::Cursor::~Cursor ( )
virtual

Destructs a Cursor object.

Author
GW
Date
08/2013

Member Function Documentation

static void hdi::core::Cursor::click ( const Point pt_)
static

Simulates a click (with no modifier keys) at an absolute location on the screen.

Author
GW
Date
08/2013
Parameters
pt_Point to click
Note
A click event is simply a mouse down immediately followed by a mouse up
static Cursor hdi::core::Cursor::CurrentCursor ( )
static

Named constructor to acquire a Cursor object for whichever cursor image is current.

Author
GW
Date
11/2015
Returns
A Cursor object for the current UI cursor
virtual void hdi::core::Cursor::enable ( )
virtual

Shows the cursor (sets it as current)

Author
GW
Date
08/2013
virtual Point hdi::core::Cursor::hotSpot ( ) const
virtual

Gets the cursor hot spot.

Author
GW
Date
09/2014
Returns
The hot spot for the target cursor
virtual bool hdi::core::Cursor::isEmpty ( ) const
virtual

Gets whether the target Cursor object is empty (constructed with the default ctor)

Author
GW
Date
09/2014
Returns
true if the target Cursor object is empty, false otherwise
static void hdi::core::Cursor::mouseDown ( const Point pt_)
static

Simulates a mouse down (with no modifier keys) at an absolute location on the screen.

Author
GW
Date
08/2013
Parameters
pt_Point at which to create the mouse down event
static void hdi::core::Cursor::mouseUp ( const Point pt_)
static

Simulates a mouse up (with no modifier keys) at an absolute location on the screen.

Author
GW
Date
08/2013
Parameters
pt_Point at which to create the mouse up event
virtual bool hdi::core::Cursor::operator!= ( const Cursor rhs_) const
virtual

Tests whether a given Cursor object is not the same as another.

Author
GW
Date
09/2014
Parameters
rhs_Cursor to compare against (righthand side of inequality operator)
Returns
true for the target and rhs_ being different cursors, false otherwise
Cursor& hdi::core::Cursor::operator= ( const Cursor rhs_)

Assigns one Cursor object to another.

Author
GW
Date
09/2014
Parameters
rhs_Existing Cursor object to copy values from
Returns
The target Cursor object, but with its values updated to match that of the rhs_ argument
virtual bool hdi::core::Cursor::operator== ( const Cursor rhs_) const
virtual

Tests whether a given Cursor object is the same as another.

Author
GW
Date
09/2014
Parameters
rhs_Cursor to compare against (righthand side of equality operator)
Returns
true for the target and rhs_ being the same cursor, false otherwise
static Point hdi::core::Cursor::screenLoc ( )
static

Gets the absolute location of the cursor on the screen.

Author
GW
Date
08/2013
Returns
The location of the cursor on the screen, with the origin being top-left