openshot-audio  0.1.6
Public Member Functions | Static Public Member Functions | Public Attributes | List of all members
MouseEvent Class Reference

#include <juce_MouseEvent.h>

Public Member Functions

 MouseEvent (MouseInputSource source, Point< float > position, ModifierKeys modifiers, Component *eventComponent, Component *originator, Time eventTime, Point< float > mouseDownPos, Time mouseDownTime, int numberOfClicks, bool mouseWasDragged) noexcept
 
 ~MouseEvent () noexcept
 
int getMouseDownX () const noexcept
 
int getMouseDownY () const noexcept
 
Point< intgetMouseDownPosition () const noexcept
 
int getDistanceFromDragStart () const noexcept
 
int getDistanceFromDragStartX () const noexcept
 
int getDistanceFromDragStartY () const noexcept
 
Point< intgetOffsetFromDragStart () const noexcept
 
bool mouseWasClicked () const noexcept
 
int getNumberOfClicks () const noexcept
 
int getLengthOfMousePress () const noexcept
 
Point< intgetPosition () const noexcept
 
int getScreenX () const
 
int getScreenY () const
 
Point< intgetScreenPosition () const
 
int getMouseDownScreenX () const
 
int getMouseDownScreenY () const
 
Point< intgetMouseDownScreenPosition () const
 
MouseEvent getEventRelativeTo (Component *newComponent) const noexcept
 
MouseEvent withNewPosition (Point< float > newPosition) const noexcept
 
MouseEvent withNewPosition (Point< int > newPosition) const noexcept
 

Static Public Member Functions

static void setDoubleClickTimeout (int timeOutMilliseconds) noexcept
 
static int getDoubleClickTimeout () noexcept
 

Public Attributes

const Point< float > position
 
const int x
 
const int y
 
const ModifierKeys mods
 
Component *const eventComponent
 
Component *const originalComponent
 
const Time eventTime
 
const Time mouseDownTime
 
MouseInputSource source
 

Detailed Description

Contains position and status information about a mouse event.

See also
MouseListener, Component::mouseMove, Component::mouseEnter, Component::mouseExit, Component::mouseDown, Component::mouseUp, Component::mouseDrag

Constructor & Destructor Documentation

MouseEvent::MouseEvent ( MouseInputSource  source,
Point< float >  position,
ModifierKeys  modifiers,
Component eventComponent,
Component originator,
Time  eventTime,
Point< float >  mouseDownPos,
Time  mouseDownTime,
int  numberOfClicks,
bool  mouseWasDragged 
)
noexcept

Creates a MouseEvent.

Normally an application will never need to use this.

Parameters
sourcethe source that's invoking the event
positionthe position of the mouse, relative to the component that is passed-in
modifiersthe key modifiers at the time of the event
eventComponentthe component that the mouse event applies to
originatorthe component that originally received the event
eventTimethe time the event happened
mouseDownPosthe position of the corresponding mouse-down event (relative to the component that is passed-in). If there isn't a corresponding mouse-down (e.g. for a mouse-move), this will just be the same as the current mouse-x position.
mouseDownTimethe time at which the corresponding mouse-down event happened If there isn't a corresponding mouse-down (e.g. for a mouse-move), this will just be the same as the current mouse-event time.
numberOfClickshow many clicks, e.g. a double-click event will be 2, a triple-click will be 3, etc
mouseWasDraggedwhether the mouse has been dragged significantly since the previous mouse-down
MouseEvent::~MouseEvent ( )
noexcept

Destructor.

Member Function Documentation

int MouseEvent::getDistanceFromDragStart ( ) const
noexcept

Returns the straight-line distance between where the mouse is now and where it was the last time the button was pressed.

This is quite handy for things like deciding whether the user has moved far enough for it to be considered a drag operation.

See also
getDistanceFromDragStartX
int MouseEvent::getDistanceFromDragStartX ( ) const
noexcept

Returns the difference between the mouse's current x postion and where it was when the button was last pressed.

See also
getDistanceFromDragStart
int MouseEvent::getDistanceFromDragStartY ( ) const
noexcept

Returns the difference between the mouse's current y postion and where it was when the button was last pressed.

See also
getDistanceFromDragStart
int MouseEvent::getDoubleClickTimeout ( )
staticnoexcept

Returns the application-wide setting for the double-click time limit.

This is the maximum length of time between mouse-clicks for it to be considered a double-click. It's used by the Component class.

See also
setDoubleClickTimeout, MouseListener::mouseDoubleClick
MouseEvent MouseEvent::getEventRelativeTo ( Component newComponent) const
noexcept

Creates a version of this event that is relative to a different component.

The x and y positions of the event that is returned will have been adjusted to be relative to the new component. The component pointer that is passed-in must not be null.

int MouseEvent::getLengthOfMousePress ( ) const
noexcept

Returns the time that the mouse button has been held down for.

If called from a mouseDrag or mouseUp callback, this will return the number of milliseconds since the corresponding mouseDown event occurred. If called in other contexts, e.g. a mouseMove, then the returned value may be 0 or an undefined value.

Point< int > MouseEvent::getMouseDownPosition ( ) const
noexcept

Returns the coordinates of the last place that a mouse was pressed. The coordinates are relative to the component specified in MouseEvent::component.

See also
getDistanceFromDragStart, getDistanceFromDragStartX, mouseWasClicked
Point< int > MouseEvent::getMouseDownScreenPosition ( ) const

Returns the coordinates at which the mouse button was last pressed. The coordinates are relative to the top-left of the main monitor.

See also
getScreenPosition
int MouseEvent::getMouseDownScreenX ( ) const

Returns the x coordinate at which the mouse button was last pressed. The coordinates are relative to the top-left of the main monitor.

See also
getMouseDownScreenPosition
int MouseEvent::getMouseDownScreenY ( ) const

Returns the y coordinate at which the mouse button was last pressed. The coordinates are relative to the top-left of the main monitor.

See also
getMouseDownScreenPosition
int MouseEvent::getMouseDownX ( ) const
noexcept

Returns the x coordinate of the last place that a mouse was pressed. The coordinate is relative to the component specified in MouseEvent::component.

See also
getDistanceFromDragStart, getDistanceFromDragStartX, mouseWasClicked
int MouseEvent::getMouseDownY ( ) const
noexcept

Returns the y coordinate of the last place that a mouse was pressed. The coordinate is relative to the component specified in MouseEvent::component.

See also
getDistanceFromDragStart, getDistanceFromDragStartX, mouseWasClicked
int MouseEvent::getNumberOfClicks ( ) const
inlinenoexcept

For a click event, the number of times the mouse was clicked in succession.

So for example a double-click event will return 2, a triple-click 3, etc.

Point< int > MouseEvent::getOffsetFromDragStart ( ) const
noexcept

Returns the difference between the mouse's current postion and where it was when the button was last pressed.

See also
getDistanceFromDragStart
Point< int > MouseEvent::getPosition ( ) const
noexcept

The position of the mouse when the event occurred.

This position is relative to the top-left of the component to which the event applies (as indicated by the MouseEvent::eventComponent field).

For a floating-point position, see MouseEvent::position

Point< int > MouseEvent::getScreenPosition ( ) const

Returns the mouse position of this event, in global screen coordinates. The coordinates are relative to the top-left of the main monitor.

See also
getMouseDownScreenPosition
int MouseEvent::getScreenX ( ) const

Returns the mouse x position of this event, in global screen coordinates. The coordinates are relative to the top-left of the main monitor.

See also
getScreenPosition
int MouseEvent::getScreenY ( ) const

Returns the mouse y position of this event, in global screen coordinates. The coordinates are relative to the top-left of the main monitor.

See also
getScreenPosition
bool MouseEvent::mouseWasClicked ( ) const
noexcept

Returns true if the mouse has just been clicked.

Used in either your mouseUp() or mouseDrag() methods, this will tell you whether the user has dragged the mouse more than a few pixels from the place where the mouse-down occurred.

Once they have dragged it far enough for this method to return false, it will continue to return false until the mouse-up, even if they move the mouse back to the same position where they originally pressed it. This means that it's very handy for objects that can either be clicked on or dragged, as you can use it in the mouseDrag() callback to ignore any small movements they might make while clicking.

Returns
true if the mouse wasn't dragged by more than a few pixels between the last time the button was pressed and released.
void MouseEvent::setDoubleClickTimeout ( int  timeOutMilliseconds)
staticnoexcept

Changes the application-wide setting for the double-click time limit.

This is the maximum length of time between mouse-clicks for it to be considered a double-click. It's used by the Component class.

See also
getDoubleClickTimeout, MouseListener::mouseDoubleClick
MouseEvent MouseEvent::withNewPosition ( Point< float >  newPosition) const
noexcept

Creates a copy of this event with a different position. All other members of the event object are the same, but the x and y are replaced with these new values.

MouseEvent MouseEvent::withNewPosition ( Point< int newPosition) const
noexcept

Creates a copy of this event with a different position. All other members of the event object are the same, but the x and y are replaced with these new values.

Member Data Documentation

Component* const MouseEvent::eventComponent

The component that this event applies to.

This is usually the component that the mouse was over at the time, but for mouse-drag events the mouse could actually be over a different component and the events are still sent to the component that the button was originally pressed on.

The x and y member variables are relative to this component's position.

If you use getEventRelativeTo() to retarget this object to be relative to a different component, this pointer will be updated, but originalComponent remains unchanged.

See also
originalComponent
const Time MouseEvent::eventTime

The time that this mouse-event occurred.

const ModifierKeys MouseEvent::mods

The key modifiers associated with the event.

This will let you find out which mouse buttons were down, as well as which modifier keys were held down.

When used for mouse-up events, this will indicate the state of the mouse buttons just before they were released, so that you can tell which button they let go of.

const Time MouseEvent::mouseDownTime

The time that the corresponding mouse-down event occurred.

Component* const MouseEvent::originalComponent

The component that the event first occurred on.

If you use getEventRelativeTo() to retarget this object to be relative to a different component, this value remains unchanged to indicate the first component that received it.

See also
eventComponent
const Point<float> MouseEvent::position

The position of the mouse when the event occurred.

This value is relative to the top-left of the component to which the event applies (as indicated by the MouseEvent::eventComponent field).

This is a more accurate floating-point version of the position returned by getPosition() and the integer x and y member variables.

MouseInputSource MouseEvent::source

The source device that generated this event.

const int MouseEvent::x

The x-position of the mouse when the event occurred.

This value is relative to the top-left of the component to which the event applies (as indicated by the MouseEvent::eventComponent field).

For a floating-point coordinate, see MouseEvent::position

const int MouseEvent::y

The y-position of the mouse when the event occurred.

This value is relative to the top-left of the component to which the event applies (as indicated by the MouseEvent::eventComponent field).

For a floating-point coordinate, see MouseEvent::position


The documentation for this class was generated from the following files: