Public Member Functions | List of all members
HPS::SelectAreaOperator Class Reference

#include <sprk_ops.h>

Inheritance diagram for HPS::SelectAreaOperator:
HPS::ConstructRectangleOperator HPS::Operator HPS::Sprocket HPS::Object HPS::HighlightAreaOperator

Public Member Functions

 SelectAreaOperator (MouseButtons in_mouse_trigger=MouseButtons::ButtonLeft(), ModifierKeys in_modifier_trigger=ModifierKeys())
 
virtual HPS::UTF8 GetName () const
 
virtual void OnViewAttached ()
 
virtual bool OnMouseUp (MouseState const &in_state)
 
virtual bool OnTouchUp (TouchState const &in_state)
 
HPS::SelectionResults GetActiveSelection () const
 
void SetSelectionOptions (HPS::SelectionOptionsKit const &in_options)
 
HPS::SelectionOptionsKit GetSelectionOptions () const
 
- Public Member Functions inherited from HPS::ConstructRectangleOperator
 ConstructRectangleOperator (MouseButtons in_mouse_trigger=MouseButtons::ButtonLeft(), ModifierKeys in_modifier_trigger=ModifierKeys(), bool draw_faces=false)
 
virtual bool OnMouseDown (MouseState const &in_state)
 
virtual bool OnMouseMove (MouseState const &in_state)
 
virtual bool OnTouchDown (TouchState const &in_state)
 
virtual bool OnTouchMove (TouchState const &in_state)
 
bool IsRectangleValid () const
 
HPS::Rectangle GetRectangle () const
 
- Public Member Functions inherited from HPS::Operator
 Operator (MouseButtons in_mouse_trigger=MouseButtons::ButtonLeft(), ModifierKeys in_modifier_trigger=ModifierKeys())
 
 Operator (Operator const &in_that)
 
HPS::Type ObjectType () const
 
virtual Operatoroperator= (Operator const &in_that)
 
virtual void Assign (Operator const &in_that)
 
virtual bool Equals (Operator const &in_that) const
 
virtual bool operator!= (Operator const &in_that) const
 
virtual bool operator== (Operator const &in_that) const
 
void DetachView ()
 
View GetAttachedView () const
 
virtual bool OnMouseWheel (MouseState const &in_state)
 
virtual bool OnMouseEnter (MouseState const &in_state)
 
virtual bool OnMouseLeave (MouseState const &in_state)
 
virtual bool OnKeyDown (KeyboardState const &in_state)
 
virtual bool OnKeyUp (KeyboardState const &in_state)
 
virtual bool OnTimerTick (HPS::TimerTickEvent const &in_event)
 
virtual void OnViewDetached ()
 
virtual void OnModelAttached ()
 
virtual void OnModelDetached ()
 
void SetMouseTrigger (MouseButtons in_buttons)
 
MouseButtons GetMouseTrigger () const
 
void SetModifierTrigger (ModifierKeys in_modifiers)
 
ModifierKeys GetModifierTrigger () const
 
virtual bool IsMouseTriggered (MouseState const &in_state)
 
- Public Member Functions inherited from HPS::Sprocket
 Sprocket (HPS::Sprocket const &in_that)=default
 
 Sprocket (Sprocket &&in_that)
 
- Public Member Functions inherited from HPS::Object
 Object (Object const &that)
 
Objectoperator= (Object const &other_object)
 
 Object (Object &&in_that)
 
Objectoperator= (Object &&in_that)
 
HPS::Type Type () const
 
virtual bool Empty () const
 
virtual void Reset ()
 
bool HasType (HPS::Type in_mask) const
 
intptr_t GetClassID () const
 
intptr_t GetInstanceID () const
 

Additional Inherited Members

- Public Types inherited from HPS::Operator
enum  Priority { Low, Normal, High }
 
- Public Types inherited from HPS::Sprocket
enum  UpdateType { Synchronous, Asynchronous }
 
- Static Public Member Functions inherited from HPS::Object
template<typename T >
static intptr_t ClassID ()
 
- Protected Attributes inherited from HPS::Operator
HPS::MouseButtons mouse_trigger
 
HPS::ModifierKeys modifier_trigger
 

Detailed Description

The HPS::SelectAreaOperator class is a selection mechanism that operates on a rectangle input. As with all operators, this operator must be made active on a HPS::View object before it can be used. The results of the last selection can be obtained by calling GetActiveSelection(). Selection options such as granularity, algorithm, proximity, and more are set using a HPS::SelectionOptionsKit passed to SetSelectionOptions. See Programming Guide section "User Interaction" for more details on how to use operators.

Constructor & Destructor Documentation

HPS::SelectAreaOperator::SelectAreaOperator ( MouseButtons  in_mouse_trigger = MouseButtons::ButtonLeft(),
ModifierKeys  in_modifier_trigger = ModifierKeys() 
)

SelectAreaOperator constructor. The operator is not active until it is attached to a HPS::View. Even after being attached, operator must remain in scope until you're done using it.

Parameters
in_mouse_triggerThe mouse button that will trigger this operator. Defaults to left mouse button.
in_modifier_triggerThe modifier key that, when used with the in_mouse_trigger, will trigger this operator. Passing an empty ModifierKeys object means no modifier key is necessary to trigger the operator.

Member Function Documentation

HPS::SelectionResults HPS::SelectAreaOperator::GetActiveSelection ( ) const

This method returns the results of the last selection action. If no objects were selected, the SelectionResults object returned will be have a count of 0.

virtual HPS::UTF8 HPS::SelectAreaOperator::GetName ( ) const
inlinevirtual

Returns the name of the Operator.

Reimplemented from HPS::ConstructRectangleOperator.

Reimplemented in HPS::HighlightAreaOperator.

HPS::SelectionOptionsKit HPS::SelectAreaOperator::GetSelectionOptions ( ) const
inline

Gets the selection options kit that was set on this operator.

virtual bool HPS::SelectAreaOperator::OnMouseUp ( MouseState const &  in_state)
virtual

This function is called whenever HPS receives a MouseEvent that signals a mouse button was released.

Parameters
in_stateA MouseState object describing the current mouse state.
Returns
true if the input event was handled, false otherwise.

Reimplemented from HPS::ConstructRectangleOperator.

Reimplemented in HPS::HighlightAreaOperator.

virtual bool HPS::SelectAreaOperator::OnTouchUp ( TouchState const &  in_state)
virtual

This function is called whenever HPS receives a TouchEvent that signals a point of contact has been released.

Parameters
in_stateA TouchState object describing the current touch state.
Returns
true if the input event was handled, false otherwise.

Reimplemented from HPS::ConstructRectangleOperator.

Reimplemented in HPS::HighlightAreaOperator.

virtual void HPS::SelectAreaOperator::OnViewAttached ( )
virtual

This function is called whenever a view is attached to this operator.

Reimplemented from HPS::ConstructRectangleOperator.

Reimplemented in HPS::HighlightAreaOperator.

void HPS::SelectAreaOperator::SetSelectionOptions ( HPS::SelectionOptionsKit const &  in_options)
inline

Sets the selection options that will be used as selection criteria for this operator.

Parameters
in_optionsThe HPS::SelectionOptionsKit that contains the selection options for this operator

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