NetEvents.cs 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738
  1. #nullable enable
  2. using System.Diagnostics.CodeAnalysis;
  3. namespace Terminal.Gui;
  4. internal class NetEvents : IDisposable
  5. {
  6. private readonly ManualResetEventSlim _inputReady = new (false);
  7. private CancellationTokenSource? _inputReadyCancellationTokenSource;
  8. private readonly Queue<InputResult> _inputQueue = new ();
  9. private readonly ConsoleDriver _consoleDriver;
  10. private ConsoleKeyInfo []? _cki;
  11. private bool _isEscSeq;
  12. #if PROCESS_REQUEST
  13. bool _neededProcessRequest;
  14. #endif
  15. public NetEvents (ConsoleDriver consoleDriver)
  16. {
  17. _consoleDriver = consoleDriver ?? throw new ArgumentNullException (nameof (consoleDriver));
  18. _inputReadyCancellationTokenSource = new ();
  19. Task.Run (ProcessInputQueue, _inputReadyCancellationTokenSource.Token);
  20. Task.Run (CheckWindowSizeChange, _inputReadyCancellationTokenSource.Token);
  21. }
  22. public InputResult? DequeueInput ()
  23. {
  24. while (_inputReadyCancellationTokenSource is { Token.IsCancellationRequested: false })
  25. {
  26. try
  27. {
  28. if (!_inputReadyCancellationTokenSource.Token.IsCancellationRequested)
  29. {
  30. if (_inputQueue.Count == 0)
  31. {
  32. _inputReady.Wait (_inputReadyCancellationTokenSource.Token);
  33. }
  34. }
  35. if (_inputQueue.Count > 0)
  36. {
  37. return _inputQueue.Dequeue ();
  38. }
  39. }
  40. catch (OperationCanceledException)
  41. {
  42. return null;
  43. }
  44. finally
  45. {
  46. if (_inputReadyCancellationTokenSource is { IsCancellationRequested: false })
  47. {
  48. _inputReady.Reset ();
  49. }
  50. }
  51. #if PROCESS_REQUEST
  52. _neededProcessRequest = false;
  53. #endif
  54. }
  55. return null;
  56. }
  57. private ConsoleKeyInfo ReadConsoleKeyInfo (CancellationToken cancellationToken, bool intercept = true)
  58. {
  59. while (!cancellationToken.IsCancellationRequested)
  60. {
  61. // if there is a key available, return it without waiting
  62. // (or dispatching work to the thread queue)
  63. if (Console.KeyAvailable)
  64. {
  65. return Console.ReadKey (intercept);
  66. }
  67. // The delay must be here because it may have a request response after a while
  68. // In WSL it takes longer for keys to be available.
  69. Task.Delay (100, cancellationToken).Wait (cancellationToken);
  70. ProcessResponse ();
  71. }
  72. cancellationToken.ThrowIfCancellationRequested ();
  73. return default (ConsoleKeyInfo);
  74. }
  75. //internal bool _forceRead;
  76. private int _retries;
  77. private void ProcessResponse ()
  78. {
  79. if (!Console.KeyAvailable && AnsiEscapeSequenceRequestUtils.IncompleteCkInfos is null && AnsiEscapeSequenceRequests.Statuses.Count > 0)
  80. {
  81. if (_retries > 1)
  82. {
  83. if (AnsiEscapeSequenceRequests.Statuses.TryPeek (out AnsiEscapeSequenceRequestStatus? seqReqStatus)
  84. && string.IsNullOrEmpty (seqReqStatus.AnsiRequest.AnsiEscapeSequenceResponse?.Response))
  85. {
  86. lock (seqReqStatus.AnsiRequest._responseLock)
  87. {
  88. AnsiEscapeSequenceRequests.Statuses.TryDequeue (out _);
  89. seqReqStatus.AnsiRequest.RaiseResponseFromInput (null);
  90. }
  91. }
  92. _retries = 0;
  93. }
  94. else
  95. {
  96. _retries++;
  97. }
  98. }
  99. else
  100. {
  101. _retries = 0;
  102. }
  103. }
  104. private void ProcessInputQueue ()
  105. {
  106. while (_inputReadyCancellationTokenSource is { IsCancellationRequested: false })
  107. {
  108. try
  109. {
  110. ConsoleKey key = 0;
  111. ConsoleModifiers mod = 0;
  112. ConsoleKeyInfo newConsoleKeyInfo = default;
  113. while (_inputReadyCancellationTokenSource is { IsCancellationRequested: false })
  114. {
  115. ConsoleKeyInfo consoleKeyInfo;
  116. try
  117. {
  118. consoleKeyInfo = ReadConsoleKeyInfo (_inputReadyCancellationTokenSource.Token);
  119. }
  120. catch (OperationCanceledException)
  121. {
  122. return;
  123. }
  124. var ckiAlreadyResized = false;
  125. if (AnsiEscapeSequenceRequestUtils.IncompleteCkInfos is { })
  126. {
  127. ckiAlreadyResized = true;
  128. _cki = AnsiEscapeSequenceRequestUtils.ResizeArray (consoleKeyInfo, _cki);
  129. _cki = AnsiEscapeSequenceRequestUtils.InsertArray (AnsiEscapeSequenceRequestUtils.IncompleteCkInfos, _cki);
  130. AnsiEscapeSequenceRequestUtils.IncompleteCkInfos = null;
  131. if (_cki.Length > 1 && _cki [0].KeyChar == '\u001B')
  132. {
  133. _isEscSeq = true;
  134. }
  135. }
  136. if ((consoleKeyInfo.KeyChar == (char)KeyCode.Esc && !_isEscSeq)
  137. || (consoleKeyInfo.KeyChar != (char)KeyCode.Esc && _isEscSeq))
  138. {
  139. if (_cki is null && consoleKeyInfo.KeyChar != (char)KeyCode.Esc && _isEscSeq)
  140. {
  141. _cki = AnsiEscapeSequenceRequestUtils.ResizeArray (
  142. new (
  143. (char)KeyCode.Esc,
  144. 0,
  145. false,
  146. false,
  147. false
  148. ),
  149. _cki
  150. );
  151. }
  152. _isEscSeq = true;
  153. if ((_cki is { } && _cki [^1].KeyChar != Key.Esc && consoleKeyInfo.KeyChar != Key.Esc && consoleKeyInfo.KeyChar <= Key.Space)
  154. || (_cki is { } && _cki [^1].KeyChar != '\u001B' && consoleKeyInfo.KeyChar == 127)
  155. || (_cki is { }
  156. && char.IsLetter (_cki [^1].KeyChar)
  157. && char.IsLower (consoleKeyInfo.KeyChar)
  158. && char.IsLetter (consoleKeyInfo.KeyChar))
  159. || (_cki is { Length: > 2 } && char.IsLetter (_cki [^1].KeyChar) && char.IsLetterOrDigit (consoleKeyInfo.KeyChar))
  160. || (_cki is { Length: > 2 } && char.IsLetter (_cki [^1].KeyChar) && char.IsPunctuation (consoleKeyInfo.KeyChar))
  161. || (_cki is { Length: > 2 } && char.IsLetter (_cki [^1].KeyChar) && char.IsSymbol (consoleKeyInfo.KeyChar)))
  162. {
  163. ProcessRequestResponse (ref newConsoleKeyInfo, ref key, _cki, ref mod);
  164. _cki = null;
  165. _isEscSeq = false;
  166. ProcessResponse ();
  167. ProcessMapConsoleKeyInfo (consoleKeyInfo);
  168. }
  169. else
  170. {
  171. newConsoleKeyInfo = consoleKeyInfo;
  172. if (!ckiAlreadyResized)
  173. {
  174. _cki = AnsiEscapeSequenceRequestUtils.ResizeArray (consoleKeyInfo, _cki);
  175. }
  176. if (Console.KeyAvailable)
  177. {
  178. continue;
  179. }
  180. ProcessRequestResponse (ref newConsoleKeyInfo, ref key, _cki!, ref mod);
  181. _cki = null;
  182. _isEscSeq = false;
  183. ProcessResponse ();
  184. }
  185. break;
  186. }
  187. if (consoleKeyInfo.KeyChar == (char)KeyCode.Esc && _isEscSeq && _cki is { })
  188. {
  189. ProcessRequestResponse (ref newConsoleKeyInfo, ref key, _cki, ref mod);
  190. _cki = null;
  191. ProcessResponse ();
  192. if (Console.KeyAvailable)
  193. {
  194. _cki = AnsiEscapeSequenceRequestUtils.ResizeArray (consoleKeyInfo, _cki);
  195. }
  196. else
  197. {
  198. ProcessMapConsoleKeyInfo (consoleKeyInfo);
  199. }
  200. break;
  201. }
  202. ProcessMapConsoleKeyInfo (consoleKeyInfo);
  203. if (_retries > 0)
  204. {
  205. _retries = 0;
  206. }
  207. break;
  208. }
  209. if (_inputQueue.Count > 0)
  210. {
  211. _inputReady.Set ();
  212. }
  213. }
  214. catch (OperationCanceledException)
  215. {
  216. return;
  217. }
  218. }
  219. void ProcessMapConsoleKeyInfo (ConsoleKeyInfo consoleKeyInfo)
  220. {
  221. _inputQueue.Enqueue (
  222. new ()
  223. {
  224. EventType = EventType.Key, ConsoleKeyInfo = AnsiEscapeSequenceRequestUtils.MapConsoleKeyInfo (consoleKeyInfo)
  225. }
  226. );
  227. _isEscSeq = false;
  228. }
  229. }
  230. private void CheckWindowSizeChange ()
  231. {
  232. void RequestWindowSize (CancellationToken cancellationToken)
  233. {
  234. while (!cancellationToken.IsCancellationRequested)
  235. {
  236. // Wait for a while then check if screen has changed sizes
  237. Task.Delay (500, cancellationToken).Wait (cancellationToken);
  238. int buffHeight, buffWidth;
  239. if (((NetDriver)_consoleDriver).IsWinPlatform)
  240. {
  241. buffHeight = Math.Max (Console.BufferHeight, 0);
  242. buffWidth = Math.Max (Console.BufferWidth, 0);
  243. }
  244. else
  245. {
  246. buffHeight = _consoleDriver.Rows;
  247. buffWidth = _consoleDriver.Cols;
  248. }
  249. if (EnqueueWindowSizeEvent (
  250. Math.Max (Console.WindowHeight, 0),
  251. Math.Max (Console.WindowWidth, 0),
  252. buffHeight,
  253. buffWidth
  254. ))
  255. {
  256. return;
  257. }
  258. }
  259. cancellationToken.ThrowIfCancellationRequested ();
  260. }
  261. while (_inputReadyCancellationTokenSource is { IsCancellationRequested: false })
  262. {
  263. try
  264. {
  265. RequestWindowSize (_inputReadyCancellationTokenSource.Token);
  266. if (_inputQueue.Count > 0)
  267. {
  268. _inputReady.Set ();
  269. }
  270. }
  271. catch (OperationCanceledException)
  272. {
  273. return;
  274. }
  275. }
  276. }
  277. /// <summary>Enqueue a window size event if the window size has changed.</summary>
  278. /// <param name="winHeight"></param>
  279. /// <param name="winWidth"></param>
  280. /// <param name="buffHeight"></param>
  281. /// <param name="buffWidth"></param>
  282. /// <returns></returns>
  283. private bool EnqueueWindowSizeEvent (int winHeight, int winWidth, int buffHeight, int buffWidth)
  284. {
  285. if (winWidth == _consoleDriver.Cols && winHeight == _consoleDriver.Rows)
  286. {
  287. return false;
  288. }
  289. int w = Math.Max (winWidth, 0);
  290. int h = Math.Max (winHeight, 0);
  291. _inputQueue.Enqueue (
  292. new ()
  293. {
  294. EventType = EventType.WindowSize, WindowSizeEvent = new () { Size = new (w, h) }
  295. }
  296. );
  297. return true;
  298. }
  299. // Process a CSI sequence received by the driver (key pressed, mouse event, or request/response event)
  300. private void ProcessRequestResponse (
  301. ref ConsoleKeyInfo newConsoleKeyInfo,
  302. ref ConsoleKey key,
  303. ConsoleKeyInfo [] cki,
  304. ref ConsoleModifiers mod
  305. )
  306. {
  307. // isMouse is true if it's CSI<, false otherwise
  308. AnsiEscapeSequenceRequestUtils.DecodeEscSeq (
  309. ref newConsoleKeyInfo,
  310. ref key,
  311. cki,
  312. ref mod,
  313. out string c1Control,
  314. out string code,
  315. out string [] values,
  316. out string terminating,
  317. out bool isMouse,
  318. out List<MouseFlags> mouseFlags,
  319. out Point pos,
  320. out AnsiEscapeSequenceRequestStatus? seqReqStatus,
  321. (f, p) => HandleMouseEvent (MapMouseFlags (f), p)
  322. );
  323. if (isMouse)
  324. {
  325. foreach (MouseFlags mf in mouseFlags)
  326. {
  327. HandleMouseEvent (MapMouseFlags (mf), pos);
  328. }
  329. return;
  330. }
  331. if (seqReqStatus is { })
  332. {
  333. //HandleRequestResponseEvent (c1Control, code, values, terminating);
  334. return;
  335. }
  336. if (newConsoleKeyInfo != default)
  337. {
  338. HandleKeyboardEvent (newConsoleKeyInfo);
  339. }
  340. }
  341. [UnconditionalSuppressMessage ("AOT", "IL3050:Calling members annotated with 'RequiresDynamicCodeAttribute' may break functionality when AOT compiling.", Justification = "<Pending>")]
  342. private MouseButtonState MapMouseFlags (MouseFlags mouseFlags)
  343. {
  344. MouseButtonState mbs = default;
  345. foreach (object flag in Enum.GetValues (mouseFlags.GetType ()))
  346. {
  347. if (mouseFlags.HasFlag ((MouseFlags)flag))
  348. {
  349. switch (flag)
  350. {
  351. case MouseFlags.Button1Pressed:
  352. mbs |= MouseButtonState.Button1Pressed;
  353. break;
  354. case MouseFlags.Button1Released:
  355. mbs |= MouseButtonState.Button1Released;
  356. break;
  357. case MouseFlags.Button1Clicked:
  358. mbs |= MouseButtonState.Button1Clicked;
  359. break;
  360. case MouseFlags.Button1DoubleClicked:
  361. mbs |= MouseButtonState.Button1DoubleClicked;
  362. break;
  363. case MouseFlags.Button1TripleClicked:
  364. mbs |= MouseButtonState.Button1TripleClicked;
  365. break;
  366. case MouseFlags.Button2Pressed:
  367. mbs |= MouseButtonState.Button2Pressed;
  368. break;
  369. case MouseFlags.Button2Released:
  370. mbs |= MouseButtonState.Button2Released;
  371. break;
  372. case MouseFlags.Button2Clicked:
  373. mbs |= MouseButtonState.Button2Clicked;
  374. break;
  375. case MouseFlags.Button2DoubleClicked:
  376. mbs |= MouseButtonState.Button2DoubleClicked;
  377. break;
  378. case MouseFlags.Button2TripleClicked:
  379. mbs |= MouseButtonState.Button2TripleClicked;
  380. break;
  381. case MouseFlags.Button3Pressed:
  382. mbs |= MouseButtonState.Button3Pressed;
  383. break;
  384. case MouseFlags.Button3Released:
  385. mbs |= MouseButtonState.Button3Released;
  386. break;
  387. case MouseFlags.Button3Clicked:
  388. mbs |= MouseButtonState.Button3Clicked;
  389. break;
  390. case MouseFlags.Button3DoubleClicked:
  391. mbs |= MouseButtonState.Button3DoubleClicked;
  392. break;
  393. case MouseFlags.Button3TripleClicked:
  394. mbs |= MouseButtonState.Button3TripleClicked;
  395. break;
  396. case MouseFlags.WheeledUp:
  397. mbs |= MouseButtonState.ButtonWheeledUp;
  398. break;
  399. case MouseFlags.WheeledDown:
  400. mbs |= MouseButtonState.ButtonWheeledDown;
  401. break;
  402. case MouseFlags.WheeledLeft:
  403. mbs |= MouseButtonState.ButtonWheeledLeft;
  404. break;
  405. case MouseFlags.WheeledRight:
  406. mbs |= MouseButtonState.ButtonWheeledRight;
  407. break;
  408. case MouseFlags.Button4Pressed:
  409. mbs |= MouseButtonState.Button4Pressed;
  410. break;
  411. case MouseFlags.Button4Released:
  412. mbs |= MouseButtonState.Button4Released;
  413. break;
  414. case MouseFlags.Button4Clicked:
  415. mbs |= MouseButtonState.Button4Clicked;
  416. break;
  417. case MouseFlags.Button4DoubleClicked:
  418. mbs |= MouseButtonState.Button4DoubleClicked;
  419. break;
  420. case MouseFlags.Button4TripleClicked:
  421. mbs |= MouseButtonState.Button4TripleClicked;
  422. break;
  423. case MouseFlags.ButtonShift:
  424. mbs |= MouseButtonState.ButtonShift;
  425. break;
  426. case MouseFlags.ButtonCtrl:
  427. mbs |= MouseButtonState.ButtonCtrl;
  428. break;
  429. case MouseFlags.ButtonAlt:
  430. mbs |= MouseButtonState.ButtonAlt;
  431. break;
  432. case MouseFlags.ReportMousePosition:
  433. mbs |= MouseButtonState.ReportMousePosition;
  434. break;
  435. case MouseFlags.AllEvents:
  436. mbs |= MouseButtonState.AllEvents;
  437. break;
  438. }
  439. }
  440. }
  441. return mbs;
  442. }
  443. //private Point _lastCursorPosition;
  444. //private void HandleRequestResponseEvent (string c1Control, string code, string [] values, string terminating)
  445. //{
  446. // if (terminating ==
  447. // // BUGBUG: I can't find where we send a request for cursor position (ESC[?6n), so I'm not sure if this is needed.
  448. // // The observation is correct because the response isn't immediate and this is useless
  449. // EscSeqUtils.CSI_RequestCursorPositionReport.Terminator)
  450. // {
  451. // var point = new Point { X = int.Parse (values [1]) - 1, Y = int.Parse (values [0]) - 1 };
  452. // if (_lastCursorPosition.Y != point.Y)
  453. // {
  454. // _lastCursorPosition = point;
  455. // var eventType = EventType.WindowPosition;
  456. // var winPositionEv = new WindowPositionEvent { CursorPosition = point };
  457. // _inputQueue.Enqueue (
  458. // new InputResult { EventType = eventType, WindowPositionEvent = winPositionEv }
  459. // );
  460. // }
  461. // else
  462. // {
  463. // return;
  464. // }
  465. // }
  466. // else if (terminating == EscSeqUtils.CSI_ReportTerminalSizeInChars.Terminator)
  467. // {
  468. // if (values [0] == EscSeqUtils.CSI_ReportTerminalSizeInChars.Value)
  469. // {
  470. // EnqueueWindowSizeEvent (
  471. // Math.Max (int.Parse (values [1]), 0),
  472. // Math.Max (int.Parse (values [2]), 0),
  473. // Math.Max (int.Parse (values [1]), 0),
  474. // Math.Max (int.Parse (values [2]), 0)
  475. // );
  476. // }
  477. // else
  478. // {
  479. // EnqueueRequestResponseEvent (c1Control, code, values, terminating);
  480. // }
  481. // }
  482. // else
  483. // {
  484. // EnqueueRequestResponseEvent (c1Control, code, values, terminating);
  485. // }
  486. // _inputReady.Set ();
  487. //}
  488. //private void EnqueueRequestResponseEvent (string c1Control, string code, string [] values, string terminating)
  489. //{
  490. // var eventType = EventType.RequestResponse;
  491. // var requestRespEv = new RequestResponseEvent { ResultTuple = (c1Control, code, values, terminating) };
  492. // _inputQueue.Enqueue (
  493. // new InputResult { EventType = eventType, RequestResponseEvent = requestRespEv }
  494. // );
  495. //}
  496. private void HandleMouseEvent (MouseButtonState buttonState, Point pos)
  497. {
  498. var mouseEvent = new MouseEvent { Position = pos, ButtonState = buttonState };
  499. _inputQueue.Enqueue (
  500. new () { EventType = EventType.Mouse, MouseEvent = mouseEvent }
  501. );
  502. }
  503. public enum EventType
  504. {
  505. Key = 1,
  506. Mouse = 2,
  507. WindowSize = 3,
  508. WindowPosition = 4,
  509. RequestResponse = 5
  510. }
  511. [Flags]
  512. public enum MouseButtonState
  513. {
  514. Button1Pressed = 0x1,
  515. Button1Released = 0x2,
  516. Button1Clicked = 0x4,
  517. Button1DoubleClicked = 0x8,
  518. Button1TripleClicked = 0x10,
  519. Button2Pressed = 0x20,
  520. Button2Released = 0x40,
  521. Button2Clicked = 0x80,
  522. Button2DoubleClicked = 0x100,
  523. Button2TripleClicked = 0x200,
  524. Button3Pressed = 0x400,
  525. Button3Released = 0x800,
  526. Button3Clicked = 0x1000,
  527. Button3DoubleClicked = 0x2000,
  528. Button3TripleClicked = 0x4000,
  529. ButtonWheeledUp = 0x8000,
  530. ButtonWheeledDown = 0x10000,
  531. ButtonWheeledLeft = 0x20000,
  532. ButtonWheeledRight = 0x40000,
  533. Button4Pressed = 0x80000,
  534. Button4Released = 0x100000,
  535. Button4Clicked = 0x200000,
  536. Button4DoubleClicked = 0x400000,
  537. Button4TripleClicked = 0x800000,
  538. ButtonShift = 0x1000000,
  539. ButtonCtrl = 0x2000000,
  540. ButtonAlt = 0x4000000,
  541. ReportMousePosition = 0x8000000,
  542. AllEvents = -1
  543. }
  544. public struct MouseEvent
  545. {
  546. public Point Position;
  547. public MouseButtonState ButtonState;
  548. }
  549. public struct WindowSizeEvent
  550. {
  551. public Size Size;
  552. }
  553. public struct WindowPositionEvent
  554. {
  555. public int Top;
  556. public int Left;
  557. public Point CursorPosition;
  558. }
  559. public struct RequestResponseEvent
  560. {
  561. public (string c1Control, string code, string [] values, string terminating) ResultTuple;
  562. }
  563. public struct InputResult
  564. {
  565. public EventType EventType;
  566. public ConsoleKeyInfo ConsoleKeyInfo;
  567. public MouseEvent MouseEvent;
  568. public WindowSizeEvent WindowSizeEvent;
  569. public WindowPositionEvent WindowPositionEvent;
  570. public RequestResponseEvent RequestResponseEvent;
  571. public readonly override string ToString ()
  572. {
  573. return (EventType switch
  574. {
  575. EventType.Key => ToString (ConsoleKeyInfo),
  576. EventType.Mouse => MouseEvent.ToString (),
  577. //EventType.WindowSize => WindowSize.ToString (),
  578. //EventType.RequestResponse => RequestResponse.ToString (),
  579. _ => "Unknown event type: " + EventType
  580. })!;
  581. }
  582. /// <summary>Prints a ConsoleKeyInfoEx structure</summary>
  583. /// <param name="cki"></param>
  584. /// <returns></returns>
  585. public readonly string ToString (ConsoleKeyInfo cki)
  586. {
  587. var ke = new Key ((KeyCode)cki.KeyChar);
  588. var sb = new StringBuilder ();
  589. sb.Append ($"Key: {(KeyCode)cki.Key} ({cki.Key})");
  590. sb.Append ((cki.Modifiers & ConsoleModifiers.Shift) != 0 ? " | Shift" : string.Empty);
  591. sb.Append ((cki.Modifiers & ConsoleModifiers.Control) != 0 ? " | Control" : string.Empty);
  592. sb.Append ((cki.Modifiers & ConsoleModifiers.Alt) != 0 ? " | Alt" : string.Empty);
  593. sb.Append ($", KeyChar: {ke.AsRune.MakePrintable ()} ({(uint)cki.KeyChar}) ");
  594. string s = sb.ToString ().TrimEnd (',').TrimEnd (' ');
  595. return $"[ConsoleKeyInfo({s})]";
  596. }
  597. }
  598. private void HandleKeyboardEvent (ConsoleKeyInfo cki)
  599. {
  600. var inputResult = new InputResult { EventType = EventType.Key, ConsoleKeyInfo = cki };
  601. _inputQueue.Enqueue (inputResult);
  602. }
  603. public void Dispose ()
  604. {
  605. _inputReadyCancellationTokenSource?.Cancel ();
  606. _inputReadyCancellationTokenSource?.Dispose ();
  607. _inputReadyCancellationTokenSource = null;
  608. _inputReady.Dispose ();
  609. try
  610. {
  611. // throws away any typeahead that has been typed by
  612. // the user and has not yet been read by the program.
  613. while (Console.KeyAvailable)
  614. {
  615. Console.ReadKey (true);
  616. }
  617. }
  618. catch (InvalidOperationException)
  619. {
  620. // Ignore - Console input has already been closed
  621. }
  622. }
  623. }