SystemUIEvents.h 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389
  1. //
  2. // Copyright (c) 2008-2015 the Urho3D project.
  3. //
  4. // Permission is hereby granted, free of charge, to any person obtaining a copy
  5. // of this software and associated documentation files (the "Software"), to deal
  6. // in the Software without restriction, including without limitation the rights
  7. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  8. // copies of the Software, and to permit persons to whom the Software is
  9. // furnished to do so, subject to the following conditions:
  10. //
  11. // The above copyright notice and this permission notice shall be included in
  12. // all copies or substantial portions of the Software.
  13. //
  14. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  17. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  18. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  19. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  20. // THE SOFTWARE.
  21. //
  22. #pragma once
  23. #include "../../Core/Object.h"
  24. namespace Atomic
  25. {
  26. namespace SystemUI
  27. {
  28. /// Mouse click in the UI.
  29. ATOMIC_EVENT(E_UIMOUSECLICK, UIMouseClick)
  30. {
  31. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  32. ATOMIC_PARAM(P_X, X); // int
  33. ATOMIC_PARAM(P_Y, Y); // int
  34. ATOMIC_PARAM(P_BUTTON, Button); // int
  35. ATOMIC_PARAM(P_BUTTONS, Buttons); // int
  36. ATOMIC_PARAM(P_QUALIFIERS, Qualifiers); // int
  37. }
  38. /// Mouse click end in the UI.
  39. ATOMIC_EVENT(E_UIMOUSECLICKEND, UIMouseClickEnd)
  40. {
  41. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  42. ATOMIC_PARAM(P_BEGINELEMENT, BeginElement); // UIElement pointer
  43. ATOMIC_PARAM(P_X, X); // int
  44. ATOMIC_PARAM(P_Y, Y); // int
  45. ATOMIC_PARAM(P_BUTTON, Button); // int
  46. ATOMIC_PARAM(P_BUTTONS, Buttons); // int
  47. ATOMIC_PARAM(P_QUALIFIERS, Qualifiers); // int
  48. }
  49. /// Mouse double click in the UI.
  50. ATOMIC_EVENT(E_UIMOUSEDOUBLECLICK, UIMouseDoubleClick)
  51. {
  52. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  53. ATOMIC_PARAM(P_X, X); // int
  54. ATOMIC_PARAM(P_Y, Y); // int
  55. ATOMIC_PARAM(P_BUTTON, Button); // int
  56. ATOMIC_PARAM(P_BUTTONS, Buttons); // int
  57. ATOMIC_PARAM(P_QUALIFIERS, Qualifiers); // int
  58. }
  59. /// Drag and drop test.
  60. ATOMIC_EVENT(E_DRAGDROPTEST, DragDropTest)
  61. {
  62. ATOMIC_PARAM(P_SOURCE, Source); // UIElement pointer
  63. ATOMIC_PARAM(P_TARGET, Target); // UIElement pointer
  64. ATOMIC_PARAM(P_ACCEPT, Accept); // bool
  65. };
  66. /// Drag and drop finish.
  67. ATOMIC_EVENT(E_DRAGDROPFINISH, DragDropFinish)
  68. {
  69. ATOMIC_PARAM(P_SOURCE, Source); // UIElement pointer
  70. ATOMIC_PARAM(P_TARGET, Target); // UIElement pointer
  71. ATOMIC_PARAM(P_ACCEPT, Accept); // bool
  72. };
  73. /// Focus element changed.
  74. ATOMIC_EVENT(E_FOCUSCHANGED, FocusChanged)
  75. {
  76. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  77. ATOMIC_PARAM(P_CLICKEDELEMENT, ClickedElement); // UIElement pointer
  78. }
  79. /// UI element name changed.
  80. ATOMIC_EVENT(E_NAMECHANGED, NameChanged)
  81. {
  82. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  83. }
  84. /// UI element resized.
  85. ATOMIC_EVENT(E_RESIZED, Resized)
  86. {
  87. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  88. ATOMIC_PARAM(P_WIDTH, Width); // int
  89. ATOMIC_PARAM(P_HEIGHT, Height); // int
  90. }
  91. /// UI element positioned.
  92. ATOMIC_EVENT(E_POSITIONED, Positioned)
  93. {
  94. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  95. ATOMIC_PARAM(P_X, X); // int
  96. ATOMIC_PARAM(P_Y, Y); // int
  97. }
  98. /// UI element visibility changed.
  99. ATOMIC_EVENT(E_VISIBLECHANGED, VisibleChanged)
  100. {
  101. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  102. ATOMIC_PARAM(P_VISIBLE, Visible); // bool
  103. }
  104. /// UI element focused.
  105. ATOMIC_EVENT(E_FOCUSED, Focused)
  106. {
  107. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  108. ATOMIC_PARAM(P_BYKEY, ByKey); // bool
  109. }
  110. /// UI element defocused.
  111. ATOMIC_EVENT(E_DEFOCUSED, Defocused)
  112. {
  113. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  114. }
  115. /// UI element layout updated.
  116. ATOMIC_EVENT(E_LAYOUTUPDATED, LayoutUpdated)
  117. {
  118. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  119. }
  120. /// UI button pressed.
  121. ATOMIC_EVENT(E_PRESSED, Pressed)
  122. {
  123. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  124. }
  125. /// UI button was pressed, then released.
  126. ATOMIC_EVENT(E_RELEASED, Released)
  127. {
  128. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  129. }
  130. /// UI checkbox toggled.
  131. ATOMIC_EVENT(E_TOGGLED, Toggled)
  132. {
  133. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  134. ATOMIC_PARAM(P_STATE, State); // bool
  135. }
  136. /// UI slider value changed
  137. ATOMIC_EVENT(E_SLIDERCHANGED, SliderChanged)
  138. {
  139. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  140. ATOMIC_PARAM(P_VALUE, Value); // float
  141. }
  142. /// UI slider being paged.
  143. ATOMIC_EVENT(E_SLIDERPAGED, SliderPaged)
  144. {
  145. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  146. ATOMIC_PARAM(P_OFFSET, Offset); // int
  147. ATOMIC_PARAM(P_PRESSED, Pressed); // bool
  148. }
  149. /// UI scrollbar value changed.
  150. ATOMIC_EVENT(E_SCROLLBARCHANGED, ScrollBarChanged)
  151. {
  152. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  153. ATOMIC_PARAM(P_VALUE, Value); // float
  154. }
  155. /// UI scrollview position changed.
  156. ATOMIC_EVENT(E_VIEWCHANGED, ViewChanged)
  157. {
  158. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  159. ATOMIC_PARAM(P_X, X); // int
  160. ATOMIC_PARAM(P_Y, Y); // int
  161. }
  162. /// UI modal changed (currently only Window has modal flag).
  163. ATOMIC_EVENT(E_MODALCHANGED, ModalChanged)
  164. {
  165. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  166. ATOMIC_PARAM(P_MODAL, Modal); // bool
  167. }
  168. /// Text entry into a LineEdit. The char can be modified in the event data.
  169. ATOMIC_EVENT(E_TEXTENTRY, CharEntry)
  170. {
  171. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  172. ATOMIC_PARAM(P_TEXT, Text); // String
  173. ATOMIC_PARAM(P_BUTTONS, Buttons); // int
  174. ATOMIC_PARAM(P_QUALIFIERS, Qualifiers); // int
  175. }
  176. /// Editable text changed
  177. ATOMIC_EVENT(E_TEXTCHANGED, TextChanged)
  178. {
  179. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  180. ATOMIC_PARAM(P_TEXT, Text); // String
  181. }
  182. /// Text editing finished (enter pressed on a LineEdit)
  183. ATOMIC_EVENT(E_TEXTFINISHED, TextFinished)
  184. {
  185. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  186. ATOMIC_PARAM(P_TEXT, Text); // String
  187. ATOMIC_PARAM(P_VALUE, Value); // Float
  188. }
  189. /// Menu selected.
  190. ATOMIC_EVENT(E_MENUSELECTED, MenuSelected)
  191. {
  192. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  193. }
  194. /// Listview or DropDownList item selected.
  195. ATOMIC_EVENT(E_ITEMSELECTED, ItemSelected)
  196. {
  197. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  198. ATOMIC_PARAM(P_SELECTION, Selection); // int
  199. }
  200. /// Listview item deselected.
  201. ATOMIC_EVENT(E_ITEMDESELECTED, ItemDeselected)
  202. {
  203. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  204. ATOMIC_PARAM(P_SELECTION, Selection); // int
  205. }
  206. /// Listview selection change finished.
  207. ATOMIC_EVENT(E_SELECTIONCHANGED, SelectionChanged)
  208. {
  209. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  210. }
  211. /// Listview item clicked. If this is a left-click, also ItemSelected event will be sent. If this is a right-click, only this event is sent.
  212. ATOMIC_EVENT(E_ITEMCLICKED, ItemClicked)
  213. {
  214. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  215. ATOMIC_PARAM(P_ITEM, Item); // UIElement pointer
  216. ATOMIC_PARAM(P_SELECTION, Selection); // int
  217. ATOMIC_PARAM(P_BUTTON, Button); // int
  218. ATOMIC_PARAM(P_BUTTONS, Buttons); // int
  219. ATOMIC_PARAM(P_QUALIFIERS, Qualifiers); // int
  220. }
  221. /// Listview item double clicked.
  222. ATOMIC_EVENT(E_ITEMDOUBLECLICKED, ItemDoubleClicked)
  223. {
  224. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  225. ATOMIC_PARAM(P_ITEM, Item); // UIElement pointer
  226. ATOMIC_PARAM(P_SELECTION, Selection); // int
  227. ATOMIC_PARAM(P_BUTTON, Button); // int
  228. ATOMIC_PARAM(P_BUTTONS, Buttons); // int
  229. ATOMIC_PARAM(P_QUALIFIERS, Qualifiers); // int
  230. }
  231. /// LineEdit or ListView unhandled key pressed.
  232. ATOMIC_EVENT(E_UNHANDLEDKEY, UnhandledKey)
  233. {
  234. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  235. ATOMIC_PARAM(P_KEY, Key); // int
  236. ATOMIC_PARAM(P_BUTTONS, Buttons); // int
  237. ATOMIC_PARAM(P_QUALIFIERS, Qualifiers); // int
  238. }
  239. /// Fileselector choice.
  240. ATOMIC_EVENT(E_FILESELECTED, FileSelected)
  241. {
  242. ATOMIC_PARAM(P_FILENAME, FileName); // String
  243. ATOMIC_PARAM(P_FILTER, Filter); // String
  244. ATOMIC_PARAM(P_OK, Ok); // bool
  245. }
  246. /// MessageBox acknowlegement.
  247. ATOMIC_EVENT(E_MESSAGEACK, MessageACK)
  248. {
  249. ATOMIC_PARAM(P_OK, Ok); // bool
  250. }
  251. /// A child element has been added to an element. Sent by the UI root element, or element-event-sender if set.
  252. ATOMIC_EVENT(E_ELEMENTADDED, ElementAdded)
  253. {
  254. ATOMIC_PARAM(P_ROOT, Root); // UIElement pointer
  255. ATOMIC_PARAM(P_PARENT, Parent); // UIElement pointer
  256. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  257. }
  258. /// A child element is about to be removed from an element. Sent by the UI root element, or element-event-sender if set.
  259. ATOMIC_EVENT(E_ELEMENTREMOVED, ElementRemoved)
  260. {
  261. ATOMIC_PARAM(P_ROOT, Root); // UIElement pointer
  262. ATOMIC_PARAM(P_PARENT, Parent); // UIElement pointer
  263. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  264. }
  265. /// Hovering on an UI element has started
  266. ATOMIC_EVENT(E_HOVERBEGIN, HoverBegin)
  267. {
  268. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  269. ATOMIC_PARAM(P_X, X); // int
  270. ATOMIC_PARAM(P_Y, Y); // int
  271. ATOMIC_PARAM(P_ELEMENTX, ElementX); // int
  272. ATOMIC_PARAM(P_ELEMENTY, ElementY); // int
  273. }
  274. /// Hovering on an UI element has ended
  275. ATOMIC_EVENT(E_HOVEREND, HoverEnd)
  276. {
  277. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  278. }
  279. /// Drag behavior of a UI Element has started
  280. ATOMIC_EVENT(E_DRAGBEGIN, DragBegin)
  281. {
  282. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  283. ATOMIC_PARAM(P_X, X); // int
  284. ATOMIC_PARAM(P_Y, Y); // int
  285. ATOMIC_PARAM(P_ELEMENTX, ElementX); // int
  286. ATOMIC_PARAM(P_ELEMENTY, ElementY); // int
  287. ATOMIC_PARAM(P_BUTTONS, Buttons); // int
  288. ATOMIC_PARAM(P_NUMBUTTONS, NumButtons); // int
  289. }
  290. /// Drag behavior of a UI Element when the input device has moved
  291. ATOMIC_EVENT(E_DRAGMOVE, DragMove)
  292. {
  293. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  294. ATOMIC_PARAM(P_X, X); // int
  295. ATOMIC_PARAM(P_Y, Y); // int
  296. ATOMIC_PARAM(P_DX, DX); // int
  297. ATOMIC_PARAM(P_DY, DY); // int
  298. ATOMIC_PARAM(P_ELEMENTX, ElementX); // int
  299. ATOMIC_PARAM(P_ELEMENTY, ElementY); // int
  300. ATOMIC_PARAM(P_BUTTONS, Buttons); // int
  301. ATOMIC_PARAM(P_NUMBUTTONS, NumButtons); // int
  302. }
  303. /// Drag behavior of a UI Element has finished
  304. ATOMIC_EVENT(E_DRAGEND, DragEnd)
  305. {
  306. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  307. ATOMIC_PARAM(P_X, X); // int
  308. ATOMIC_PARAM(P_Y, Y); // int
  309. ATOMIC_PARAM(P_ELEMENTX, ElementX); // int
  310. ATOMIC_PARAM(P_ELEMENTY, ElementY); // int
  311. ATOMIC_PARAM(P_BUTTONS, Buttons); // int
  312. ATOMIC_PARAM(P_NUMBUTTONS, NumButtons); // int
  313. }
  314. /// Drag of a UI Element was canceled by pressing ESC
  315. ATOMIC_EVENT(E_DRAGCANCEL, DragCancel)
  316. {
  317. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  318. ATOMIC_PARAM(P_X, X); // int
  319. ATOMIC_PARAM(P_Y, Y); // int
  320. ATOMIC_PARAM(P_ELEMENTX, ElementX); // int
  321. ATOMIC_PARAM(P_ELEMENTY, ElementY); // int
  322. ATOMIC_PARAM(P_BUTTONS, Buttons); // int
  323. ATOMIC_PARAM(P_NUMBUTTONS, NumButtons); // int
  324. }
  325. /// A file was drag-dropped into the application window. Includes also coordinates and UI element if applicable
  326. ATOMIC_EVENT(E_UIDROPFILE, UIDropFile)
  327. {
  328. ATOMIC_PARAM(P_FILENAME, FileName); // String
  329. ATOMIC_PARAM(P_ELEMENT, Element); // UIElement pointer
  330. ATOMIC_PARAM(P_X, X); // int
  331. ATOMIC_PARAM(P_Y, Y); // int
  332. ATOMIC_PARAM(P_ELEMENTX, ElementX); // int (only if element is non-null)
  333. ATOMIC_PARAM(P_ELEMENTY, ElementY); // int (only if element is non-null)
  334. }
  335. ATOMIC_EVENT(E_CONSOLECLOSED, ConsoleClosed)
  336. {
  337. }
  338. }
  339. }