KiCad PCB EDA Suite
tool_event.h File Reference
#include <cstdio>
#include <deque>
#include <iterator>
#include <math/vector2d.h>
#include <core/optional.h>
#include <tool/tool_action.h>

Go to the source code of this file.

Classes

class  TOOL_EVENT
 Generic, UI-independent tool event. More...
 
class  TOOL_EVENT_LIST
 A list of TOOL_EVENTs, with overloaded || operators allowing for concatenating TOOL_EVENTs with little code. More...
 

Typedefs

typedef OPT< TOOL_EVENTOPT_TOOL_EVENT
 

Enumerations

enum  TOOL_EVENT_CATEGORY {
  TC_NONE = 0x00, TC_MOUSE = 0x01, TC_KEYBOARD = 0x02, TC_COMMAND = 0x04,
  TC_MESSAGE = 0x08, TC_VIEW = 0x10, TC_ANY = 0xffffffff
}
 Internal (GUI-independent) event definitions. More...
 
enum  TOOL_ACTIONS {
  TA_NONE = 0x0000, TA_MOUSE_CLICK = 0x0001, TA_MOUSE_DBLCLICK = 0x0002, TA_MOUSE_UP = 0x0004,
  TA_MOUSE_DOWN = 0x0008, TA_MOUSE_DRAG = 0x0010, TA_MOUSE_MOTION = 0x0020, TA_MOUSE_WHEEL = 0x0040,
  TA_MOUSE = 0x007f, TA_KEY_PRESSED = 0x0080, TA_KEYBOARD = TA_KEY_PRESSED, TA_VIEW_REFRESH = 0x0100,
  TA_VIEW_ZOOM = 0x0200, TA_VIEW_PAN = 0x0400, TA_VIEW_DIRTY = 0x0800, TA_VIEW = 0x0f00,
  TA_CHANGE_LAYER = 0x1000, TA_CANCEL_TOOL = 0x2000, TA_CHOICE_MENU_UPDATE = 0x4000, TA_CHOICE_MENU_CHOICE = 0x8000,
  TA_CHOICE_MENU_CLOSED = 0x10000, TA_CHOICE_MENU = TA_CHOICE_MENU_UPDATE | TA_CHOICE_MENU_CHOICE | TA_CHOICE_MENU_CLOSED, TA_UNDO_REDO_PRE = 0x20000, TA_UNDO_REDO_POST = 0x40000,
  TA_ACTION = 0x80000, TA_ACTIVATE = 0x100000, TA_REACTIVATE = 0x200000, TA_MODEL_CHANGE = 0x400000,
  TA_PRIME = 0x800001, TA_ANY = 0xffffffff
}
 
enum  TOOL_MOUSE_BUTTONS {
  BUT_NONE = 0x0, BUT_LEFT = 0x1, BUT_RIGHT = 0x2, BUT_MIDDLE = 0x4,
  BUT_BUTTON_MASK = BUT_LEFT | BUT_RIGHT | BUT_MIDDLE, BUT_ANY = 0xffffffff
}
 
enum  TOOL_MODIFIERS { MD_SHIFT = 0x1000, MD_CTRL = 0x2000, MD_ALT = 0x4000, MD_MODIFIER_MASK = MD_SHIFT | MD_CTRL | MD_ALT }
 
enum  CONTEXT_MENU_TRIGGER { CMENU_BUTTON = 0, CMENU_NOW, CMENU_OFF }
 Defines when a context menu is opened. More...
 

Functions

const TOOL_EVENT_LIST operator|| (const TOOL_EVENT &aEventA, const TOOL_EVENT &aEventB)
 
const TOOL_EVENT_LIST operator|| (const TOOL_EVENT &aEvent, const TOOL_EVENT_LIST &aEventList)
 

Typedef Documentation

◆ OPT_TOOL_EVENT

Definition at line 548 of file tool_event.h.

Enumeration Type Documentation

◆ CONTEXT_MENU_TRIGGER

Defines when a context menu is opened.

Enumerator
CMENU_BUTTON 
CMENU_NOW 
CMENU_OFF 

Definition at line 142 of file tool_event.h.

143 {
144  CMENU_BUTTON = 0, // On the right button
145  CMENU_NOW, // Right now (after TOOL_INTERACTIVE::SetContextMenu)
146  CMENU_OFF // Never
147 };

◆ TOOL_ACTIONS

Enumerator
TA_NONE 
TA_MOUSE_CLICK 
TA_MOUSE_DBLCLICK 
TA_MOUSE_UP 
TA_MOUSE_DOWN 
TA_MOUSE_DRAG 
TA_MOUSE_MOTION 
TA_MOUSE_WHEEL 
TA_MOUSE 
TA_KEY_PRESSED 
TA_KEYBOARD 
TA_VIEW_REFRESH 
TA_VIEW_ZOOM 
TA_VIEW_PAN 
TA_VIEW_DIRTY 
TA_VIEW 
TA_CHANGE_LAYER 
TA_CANCEL_TOOL 
TA_CHOICE_MENU_UPDATE 
TA_CHOICE_MENU_CHOICE 
TA_CHOICE_MENU_CLOSED 
TA_CHOICE_MENU 
TA_UNDO_REDO_PRE 
TA_UNDO_REDO_POST 
TA_ACTION 
TA_ACTIVATE 
TA_REACTIVATE 
TA_MODEL_CHANGE 
TA_PRIME 
TA_ANY 

Definition at line 57 of file tool_event.h.

58 {
59  // UI input events
60  TA_NONE = 0x0000,
61  TA_MOUSE_CLICK = 0x0001,
62  TA_MOUSE_DBLCLICK = 0x0002,
63  TA_MOUSE_UP = 0x0004,
64  TA_MOUSE_DOWN = 0x0008,
65  TA_MOUSE_DRAG = 0x0010,
66  TA_MOUSE_MOTION = 0x0020,
67  TA_MOUSE_WHEEL = 0x0040,
68  TA_MOUSE = 0x007f,
69 
70  TA_KEY_PRESSED = 0x0080,
72 
73  // View related events
74  TA_VIEW_REFRESH = 0x0100,
75  TA_VIEW_ZOOM = 0x0200,
76  TA_VIEW_PAN = 0x0400,
77  TA_VIEW_DIRTY = 0x0800,
78  TA_VIEW = 0x0f00,
79 
80  TA_CHANGE_LAYER = 0x1000,
81 
82  // Tool cancel event. Issued automagically when the user hits escape or selects End Tool from
83  // the context menu.
84  TA_CANCEL_TOOL = 0x2000,
85 
86  // Context menu update. Issued whenever context menu is open and the user hovers the mouse
87  // over one of choices. Used in dynamic highlighting in disambiguation menu
88  TA_CHOICE_MENU_UPDATE = 0x4000,
89 
90  // Context menu choice. Sent if the user picked something from the context menu or
91  // closed it without selecting anything.
92  TA_CHOICE_MENU_CHOICE = 0x8000,
93 
94  // Context menu is closed, no matter whether anything has been chosen or not.
95  TA_CHOICE_MENU_CLOSED = 0x10000,
96 
98 
99  // This event is sent *before* undo/redo command is performed.
100  TA_UNDO_REDO_PRE = 0x20000,
101 
102  // This event is sent *after* undo/redo command is performed.
103  TA_UNDO_REDO_POST = 0x40000,
104 
105  // Tool action (allows one to control tools).
106  TA_ACTION = 0x80000,
107 
108  // Tool activation event.
109  TA_ACTIVATE = 0x100000,
110 
111  // Tool re-activation event for tools already on the stack
112  TA_REACTIVATE = 0x200000,
113 
114  // Model has changed (partial update).
115  TA_MODEL_CHANGE = 0x400000,
116 
117  // Tool priming event (a special mouse click)
118  TA_PRIME = 0x800001,
119 
120  TA_ANY = 0xffffffff
121 };

◆ TOOL_EVENT_CATEGORY

Internal (GUI-independent) event definitions.

Enumerator
TC_NONE 
TC_MOUSE 
TC_KEYBOARD 
TC_COMMAND 
TC_MESSAGE 
TC_VIEW 
TC_ANY 

Definition at line 46 of file tool_event.h.

47 {
48  TC_NONE = 0x00,
49  TC_MOUSE = 0x01,
50  TC_KEYBOARD = 0x02,
51  TC_COMMAND = 0x04,
52  TC_MESSAGE = 0x08,
53  TC_VIEW = 0x10,
54  TC_ANY = 0xffffffff
55 };

◆ TOOL_MODIFIERS

Enumerator
MD_SHIFT 
MD_CTRL 
MD_ALT 
MD_MODIFIER_MASK 

Definition at line 133 of file tool_event.h.

134 {
135  MD_SHIFT = 0x1000,
136  MD_CTRL = 0x2000,
137  MD_ALT = 0x4000,
139 };

◆ TOOL_MOUSE_BUTTONS

Enumerator
BUT_NONE 
BUT_LEFT 
BUT_RIGHT 
BUT_MIDDLE 
BUT_BUTTON_MASK 
BUT_ANY 

Definition at line 123 of file tool_event.h.

124 {
125  BUT_NONE = 0x0,
126  BUT_LEFT = 0x1,
127  BUT_RIGHT = 0x2,
128  BUT_MIDDLE = 0x4,
130  BUT_ANY = 0xffffffff
131 };

Function Documentation

◆ operator||() [1/2]

const TOOL_EVENT_LIST operator|| ( const TOOL_EVENT aEventA,
const TOOL_EVENT aEventB 
)
inline

Definition at line 673 of file tool_event.h.

674 {
675  TOOL_EVENT_LIST l;
676 
677  l.Add( aEventA );
678  l.Add( aEventB );
679 
680  return l;
681 }
A list of TOOL_EVENTs, with overloaded || operators allowing for concatenating TOOL_EVENTs with littl...
Definition: tool_event.h:554
void Add(const TOOL_EVENT &aEvent)
Add a tool event to the list.
Definition: tool_event.h:604

References TOOL_EVENT_LIST::Add().

◆ operator||() [2/2]

const TOOL_EVENT_LIST operator|| ( const TOOL_EVENT aEvent,
const TOOL_EVENT_LIST aEventList 
)
inline

Definition at line 684 of file tool_event.h.

686 {
687  TOOL_EVENT_LIST l( aEventList );
688 
689  l.Add( aEvent );
690  return l;
691 }
A list of TOOL_EVENTs, with overloaded || operators allowing for concatenating TOOL_EVENTs with littl...
Definition: tool_event.h:554

References TOOL_EVENT_LIST::Add().