2
0

binding.cs 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460
  1. //
  2. // TODO:
  3. // * FindNCurses needs to remove the old probing code
  4. // * Removal of that proxy code
  5. // * Need to implement reading pointers with the new API
  6. // * Can remove the manual Dlopen features
  7. // * initscr() diagnostics based on DLL can be fixed
  8. //
  9. // binding.cs.in: Core binding for curses.
  10. //
  11. // This file attempts to call into ncurses without relying on Mono's
  12. // dllmap, so it will work with .NET Core. This means that it needs
  13. // two sets of bindings, one for "ncurses" which works on OSX, and one
  14. // that works against "libncursesw.so.5" which is what you find on
  15. // assorted Linux systems.
  16. //
  17. // Additionally, I do not want to rely on an external native library
  18. // which is why all this pain to bind two separate ncurses is here.
  19. //
  20. // Authors:
  21. // Miguel de Icaza ([email protected])
  22. //
  23. // Copyright (C) 2007 Novell (http://www.novell.com)
  24. //
  25. // Permission is hereby granted, free of charge, to any person obtaining
  26. // a copy of this software and associated documentation files (the
  27. // "Software"), to deal in the Software without restriction, including
  28. // without limitation the rights to use, copy, modify, merge, publish,
  29. // distribute, sublicense, and/or sell copies of the Software, and to
  30. // permit persons to whom the Software is furnished to do so, subject to
  31. // the following conditions:
  32. //
  33. // The above copyright notice and this permission notice shall be
  34. // included in all copies or substantial portions of the Software.
  35. //
  36. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  37. // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  38. // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  39. // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  40. // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  41. // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  42. // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  43. //
  44. using System;
  45. using System.Runtime.InteropServices;
  46. namespace Unix.Terminal {
  47. #pragma warning disable CS1591 // Missing XML comment for publicly visible type or member
  48. public partial class Curses {
  49. [StructLayout (LayoutKind.Sequential)]
  50. public struct MouseEvent {
  51. public short ID;
  52. public int X, Y, Z;
  53. public Event ButtonState;
  54. }
  55. static int lines, cols;
  56. static Window main_window;
  57. static IntPtr curses_handle, curscr_ptr, lines_ptr, cols_ptr;
  58. // If true, uses the DllImport into "ncurses", otherwise "libncursesw.so.5"
  59. //static bool use_naked_driver;
  60. static UnmanagedLibrary curses_library;
  61. static NativeMethods methods;
  62. [DllImport("libc")]
  63. public extern static int setlocale(int cate, [MarshalAs(UnmanagedType.LPStr)] string locale);
  64. static void LoadMethods ()
  65. {
  66. var libs = UnmanagedLibrary.IsMacOSPlatform ? new string [] { "libncurses.dylib" } : new string [] { "libncursesw.so.6", "libncursesw.so.5" };
  67. curses_library = new UnmanagedLibrary (libs, false);
  68. methods = new NativeMethods (curses_library);
  69. }
  70. static void FindNCurses ()
  71. {
  72. LoadMethods ();
  73. curses_handle = methods.UnmanagedLibrary.NativeLibraryHandle;
  74. stdscr = read_static_ptr ("stdscr");
  75. curscr_ptr = get_ptr ("curscr");
  76. lines_ptr = get_ptr ("LINES");
  77. cols_ptr = get_ptr ("COLS");
  78. }
  79. static public Window initscr ()
  80. {
  81. setlocale(LC_ALL, "");
  82. FindNCurses ();
  83. main_window = new Window (methods.initscr ());
  84. try {
  85. console_sharp_get_dims (out lines, out cols);
  86. } catch (DllNotFoundException){
  87. endwin ();
  88. Console.Error.WriteLine ("Unable to find the @MONO_CURSES@ native library\n" +
  89. "this is different than the managed mono-curses.dll\n\n" +
  90. "Typically you need to install to a LD_LIBRARY_PATH directory\n" +
  91. "or DYLD_LIBRARY_PATH directory or run /sbin/ldconfig");
  92. Environment.Exit (1);
  93. }
  94. return main_window;
  95. }
  96. public static int Lines {
  97. get {
  98. return lines;
  99. }
  100. }
  101. public static int Cols {
  102. get {
  103. return cols;
  104. }
  105. }
  106. //
  107. // Returns true if the window changed since the last invocation, as a
  108. // side effect, the Lines and Cols properties are updated
  109. //
  110. public static bool CheckWinChange ()
  111. {
  112. int l, c;
  113. console_sharp_get_dims (out l, out c);
  114. if (l != lines || c != cols){
  115. lines = l;
  116. cols = c;
  117. return true;
  118. }
  119. return false;
  120. }
  121. public static int addstr (string format, params object [] args)
  122. {
  123. var s = string.Format (format, args);
  124. return addwstr (s);
  125. }
  126. static char [] r = new char [1];
  127. //
  128. // Have to wrap the native addch, as it can not
  129. // display unicode characters, we have to use addstr
  130. // for that. but we need addch to render special ACS
  131. // characters
  132. //
  133. public static int addch (int ch)
  134. {
  135. if (ch < 127 || ch > 0xffff )
  136. return methods.addch (ch);
  137. char c = (char) ch;
  138. return addwstr (new String (c, 1));
  139. }
  140. static IntPtr stdscr;
  141. static IntPtr get_ptr (string key)
  142. {
  143. var ptr = curses_library.LoadSymbol (key);
  144. if (ptr == IntPtr.Zero)
  145. throw new Exception ("Could not load the key " + key);
  146. return ptr;
  147. }
  148. internal static IntPtr read_static_ptr (string key)
  149. {
  150. var ptr = get_ptr (key);
  151. return Marshal.ReadIntPtr (ptr);
  152. }
  153. internal static IntPtr console_sharp_get_stdscr () => stdscr;
  154. internal static IntPtr console_sharp_get_curscr ()
  155. {
  156. return Marshal.ReadIntPtr (curscr_ptr);
  157. }
  158. internal static void console_sharp_get_dims (out int lines, out int cols)
  159. {
  160. lines = Marshal.ReadInt32 (lines_ptr);
  161. cols = Marshal.ReadInt32 (cols_ptr);
  162. }
  163. public static Event mousemask (Event newmask, out Event oldmask)
  164. {
  165. IntPtr e;
  166. var ret = (Event) (methods.mousemask ((IntPtr) newmask, out e));
  167. oldmask = (Event) e;
  168. return ret;
  169. }
  170. // We encode ESC + char (what Alt-char generates) as 0x2000 + char
  171. public const int KeyAlt = 0x2000;
  172. static public int IsAlt (int key)
  173. {
  174. if ((key & KeyAlt) != 0)
  175. return key & ~KeyAlt;
  176. return 0;
  177. }
  178. public static int StartColor () => methods.start_color ();
  179. public static bool HasColors => methods.has_colors ();
  180. public static int InitColorPair (short pair, short foreground, short background) => methods.init_pair (pair, foreground, background);
  181. public static int UseDefaultColors () => methods.use_default_colors ();
  182. public static int ColorPairs => methods.COLOR_PAIRS();
  183. //
  184. // The proxy methods to call into each version
  185. //
  186. static public int endwin () => methods.endwin ();
  187. static public bool isendwin () => methods.isendwin ();
  188. static public int cbreak () => methods.cbreak ();
  189. static public int nocbreak () => methods.nocbreak ();
  190. static public int echo () => methods.echo ();
  191. static public int noecho () => methods.noecho ();
  192. static public int halfdelay (int t) => methods.halfdelay (t);
  193. static public int raw () => methods.raw ();
  194. static public int noraw () => methods.noraw ();
  195. static public void noqiflush () => methods.noqiflush ();
  196. static public void qiflush () => methods.qiflush ();
  197. static public int typeahead (IntPtr fd) => methods.typeahead (fd);
  198. static public int timeout (int delay) => methods.timeout (delay);
  199. static public int wtimeout (IntPtr win, int delay) => methods.wtimeout (win, delay);
  200. static public int notimeout (IntPtr win, bool bf) => methods.notimeout (win, bf);
  201. static public int keypad (IntPtr win, bool bf) => methods.keypad (win, bf);
  202. static public int meta (IntPtr win, bool bf) => methods.meta (win, bf);
  203. static public int intrflush (IntPtr win, bool bf) => methods.intrflush (win, bf);
  204. static public int clearok (IntPtr win, bool bf) => methods.clearok (win, bf);
  205. static public int idlok (IntPtr win, bool bf) => methods.idlok (win, bf);
  206. static public void idcok (IntPtr win, bool bf) => methods.idcok (win, bf);
  207. static public void immedok (IntPtr win, bool bf) => methods.immedok (win, bf);
  208. static public int leaveok (IntPtr win, bool bf) => methods.leaveok (win, bf);
  209. static public int wsetscrreg (IntPtr win, int top, int bot) => methods.wsetscrreg (win, top, bot);
  210. static public int scrollok (IntPtr win, bool bf) => methods.scrollok (win, bf);
  211. static public int nl() => methods.nl();
  212. static public int nonl() => methods.nonl();
  213. static public int setscrreg (int top, int bot) => methods.setscrreg (top, bot);
  214. static public int refresh () => methods.refresh ();
  215. static public int doupdate() => methods.doupdate();
  216. static public int wrefresh (IntPtr win) => methods.wrefresh (win);
  217. static public int redrawwin (IntPtr win) => methods.redrawwin (win);
  218. //static public int wredrawwin (IntPtr win, int beg_line, int num_lines) => methods.wredrawwin (win, beg_line, num_lines);
  219. static public int wnoutrefresh (IntPtr win) => methods.wnoutrefresh (win);
  220. static public int move (int line, int col) => methods.move (line, col);
  221. static public int curs_set (int visibility) => methods.curs_set (visibility);
  222. //static public int addch (int ch) => methods.addch (ch);
  223. static public int addwstr (string s) => methods.addwstr (s);
  224. static public int wmove (IntPtr win, int line, int col) => methods.wmove (win, line, col);
  225. static public int waddch (IntPtr win, int ch) => methods.waddch (win, ch);
  226. static public int attron (int attrs) => methods.attron (attrs);
  227. static public int attroff (int attrs) => methods.attroff (attrs);
  228. static public int attrset (int attrs) => methods.attrset (attrs);
  229. static public int getch () => methods.getch ();
  230. static public int get_wch (out int sequence) => methods.get_wch (out sequence);
  231. static public int ungetch (int ch) => methods.ungetch (ch);
  232. static public int mvgetch (int y, int x) => methods.mvgetch (y, x);
  233. static public bool has_colors () => methods.has_colors ();
  234. static public int start_color () => methods.start_color ();
  235. static public int init_pair (short pair, short f, short b) => methods.init_pair (pair, f, b);
  236. static public int use_default_colors () => methods.use_default_colors ();
  237. static public int COLOR_PAIRS() => methods.COLOR_PAIRS();
  238. static public uint getmouse (out MouseEvent ev) => methods.getmouse (out ev);
  239. static public uint ungetmouse (ref MouseEvent ev) => methods.ungetmouse (ref ev);
  240. static public int mouseinterval (int interval) => methods.mouseinterval (interval);
  241. }
  242. #pragma warning disable RCS1102 // Make class static.
  243. internal class Delegates {
  244. #pragma warning restore RCS1102 // Make class static.
  245. public delegate IntPtr initscr ();
  246. public delegate int endwin ();
  247. public delegate bool isendwin ();
  248. public delegate int cbreak ();
  249. public delegate int nocbreak ();
  250. public delegate int echo ();
  251. public delegate int noecho ();
  252. public delegate int halfdelay (int t);
  253. public delegate int raw ();
  254. public delegate int noraw ();
  255. public delegate void noqiflush ();
  256. public delegate void qiflush ();
  257. public delegate int typeahead (IntPtr fd);
  258. public delegate int timeout (int delay);
  259. public delegate int wtimeout (IntPtr win, int delay);
  260. public delegate int notimeout (IntPtr win, bool bf);
  261. public delegate int keypad (IntPtr win, bool bf);
  262. public delegate int meta (IntPtr win, bool bf);
  263. public delegate int intrflush (IntPtr win, bool bf);
  264. public delegate int clearok (IntPtr win, bool bf);
  265. public delegate int idlok (IntPtr win, bool bf);
  266. public delegate void idcok (IntPtr win, bool bf);
  267. public delegate void immedok (IntPtr win, bool bf);
  268. public delegate int leaveok (IntPtr win, bool bf);
  269. public delegate int wsetscrreg (IntPtr win, int top, int bot);
  270. public delegate int scrollok (IntPtr win, bool bf);
  271. public delegate int nl ();
  272. public delegate int nonl ();
  273. public delegate int setscrreg (int top, int bot);
  274. public delegate int refresh ();
  275. public delegate int doupdate ();
  276. public delegate int wrefresh (IntPtr win);
  277. public delegate int redrawwin (IntPtr win);
  278. //public delegate int wredrawwin (IntPtr win, int beg_line, int num_lines);
  279. public delegate int wnoutrefresh (IntPtr win);
  280. public delegate int move (int line, int col);
  281. public delegate int curs_set (int visibility);
  282. public delegate int addch (int ch);
  283. public delegate int addwstr([MarshalAs(UnmanagedType.LPWStr)]string s);
  284. public delegate int wmove (IntPtr win, int line, int col);
  285. public delegate int waddch (IntPtr win, int ch);
  286. public delegate int attron (int attrs);
  287. public delegate int attroff (int attrs);
  288. public delegate int attrset (int attrs);
  289. public delegate int getch ();
  290. public delegate int get_wch (out int sequence);
  291. public delegate int ungetch (int ch);
  292. public delegate int mvgetch (int y, int x);
  293. public delegate bool has_colors ();
  294. public delegate int start_color ();
  295. public delegate int init_pair (short pair, short f, short b);
  296. public delegate int use_default_colors ();
  297. public delegate int COLOR_PAIRS ();
  298. public delegate uint getmouse (out Curses.MouseEvent ev);
  299. public delegate uint ungetmouse (ref Curses.MouseEvent ev);
  300. public delegate int mouseinterval (int interval);
  301. public delegate IntPtr mousemask (IntPtr newmask, out IntPtr oldMask);
  302. }
  303. internal class NativeMethods {
  304. public readonly Delegates.initscr initscr;
  305. public readonly Delegates.endwin endwin;
  306. public readonly Delegates.isendwin isendwin;
  307. public readonly Delegates.cbreak cbreak;
  308. public readonly Delegates.nocbreak nocbreak;
  309. public readonly Delegates.echo echo;
  310. public readonly Delegates.noecho noecho;
  311. public readonly Delegates.halfdelay halfdelay;
  312. public readonly Delegates.raw raw;
  313. public readonly Delegates.noraw noraw;
  314. public readonly Delegates.noqiflush noqiflush;
  315. public readonly Delegates.qiflush qiflush;
  316. public readonly Delegates.typeahead typeahead;
  317. public readonly Delegates.timeout timeout;
  318. public readonly Delegates.wtimeout wtimeout;
  319. public readonly Delegates.notimeout notimeout;
  320. public readonly Delegates.keypad keypad;
  321. public readonly Delegates.meta meta;
  322. public readonly Delegates.intrflush intrflush;
  323. public readonly Delegates.clearok clearok;
  324. public readonly Delegates.idlok idlok;
  325. public readonly Delegates.idcok idcok;
  326. public readonly Delegates.immedok immedok;
  327. public readonly Delegates.leaveok leaveok;
  328. public readonly Delegates.wsetscrreg wsetscrreg;
  329. public readonly Delegates.scrollok scrollok;
  330. public readonly Delegates.nl nl;
  331. public readonly Delegates.nonl nonl;
  332. public readonly Delegates.setscrreg setscrreg;
  333. public readonly Delegates.refresh refresh;
  334. public readonly Delegates.doupdate doupdate;
  335. public readonly Delegates.wrefresh wrefresh;
  336. public readonly Delegates.redrawwin redrawwin;
  337. //public readonly Delegates.wredrawwin wredrawwin;
  338. public readonly Delegates.wnoutrefresh wnoutrefresh;
  339. public readonly Delegates.move move;
  340. public readonly Delegates.curs_set curs_set;
  341. public readonly Delegates.addch addch;
  342. public readonly Delegates.addwstr addwstr;
  343. public readonly Delegates.wmove wmove;
  344. public readonly Delegates.waddch waddch;
  345. public readonly Delegates.attron attron;
  346. public readonly Delegates.attroff attroff;
  347. public readonly Delegates.attrset attrset;
  348. public readonly Delegates.getch getch;
  349. public readonly Delegates.get_wch get_wch;
  350. public readonly Delegates.ungetch ungetch;
  351. public readonly Delegates.mvgetch mvgetch;
  352. public readonly Delegates.has_colors has_colors;
  353. public readonly Delegates.start_color start_color;
  354. public readonly Delegates.init_pair init_pair;
  355. public readonly Delegates.use_default_colors use_default_colors;
  356. public readonly Delegates.COLOR_PAIRS COLOR_PAIRS;
  357. public readonly Delegates.getmouse getmouse;
  358. public readonly Delegates.ungetmouse ungetmouse;
  359. public readonly Delegates.mouseinterval mouseinterval;
  360. public readonly Delegates.mousemask mousemask;
  361. public UnmanagedLibrary UnmanagedLibrary;
  362. public NativeMethods (UnmanagedLibrary lib)
  363. {
  364. this.UnmanagedLibrary = lib;
  365. initscr = lib.GetNativeMethodDelegate<Delegates.initscr> ("initscr");
  366. endwin = lib.GetNativeMethodDelegate<Delegates.endwin> ("endwin");
  367. isendwin = lib.GetNativeMethodDelegate<Delegates.isendwin> ("isendwin");
  368. cbreak = lib.GetNativeMethodDelegate<Delegates.cbreak> ("cbreak");
  369. nocbreak = lib.GetNativeMethodDelegate<Delegates.nocbreak> ("nocbreak");
  370. echo = lib.GetNativeMethodDelegate<Delegates.echo> ("echo");
  371. noecho = lib.GetNativeMethodDelegate<Delegates.noecho> ("noecho");
  372. halfdelay = lib.GetNativeMethodDelegate<Delegates.halfdelay> ("halfdelay");
  373. raw = lib.GetNativeMethodDelegate<Delegates.raw> ("raw");
  374. noraw = lib.GetNativeMethodDelegate<Delegates.noraw> ("noraw");
  375. noqiflush = lib.GetNativeMethodDelegate<Delegates.noqiflush> ("noqiflush");
  376. qiflush = lib.GetNativeMethodDelegate<Delegates.qiflush> ("qiflush");
  377. typeahead = lib.GetNativeMethodDelegate<Delegates.typeahead> ("typeahead");
  378. timeout = lib.GetNativeMethodDelegate<Delegates.timeout> ("timeout");
  379. wtimeout = lib.GetNativeMethodDelegate<Delegates.wtimeout> ("wtimeout");
  380. notimeout = lib.GetNativeMethodDelegate<Delegates.notimeout> ("notimeout");
  381. keypad = lib.GetNativeMethodDelegate<Delegates.keypad> ("keypad");
  382. meta = lib.GetNativeMethodDelegate<Delegates.meta> ("meta");
  383. intrflush = lib.GetNativeMethodDelegate<Delegates.intrflush> ("intrflush");
  384. clearok = lib.GetNativeMethodDelegate<Delegates.clearok> ("clearok");
  385. idlok = lib.GetNativeMethodDelegate<Delegates.idlok> ("idlok");
  386. idcok = lib.GetNativeMethodDelegate<Delegates.idcok> ("idcok");
  387. immedok = lib.GetNativeMethodDelegate<Delegates.immedok> ("immedok");
  388. leaveok = lib.GetNativeMethodDelegate<Delegates.leaveok> ("leaveok");
  389. wsetscrreg = lib.GetNativeMethodDelegate<Delegates.wsetscrreg> ("wsetscrreg");
  390. scrollok = lib.GetNativeMethodDelegate<Delegates.scrollok> ("scrollok");
  391. nl = lib.GetNativeMethodDelegate<Delegates.nl> ("nl");
  392. nonl = lib.GetNativeMethodDelegate<Delegates.nonl> ("nonl");
  393. setscrreg = lib.GetNativeMethodDelegate<Delegates.setscrreg> ("setscrreg");
  394. refresh = lib.GetNativeMethodDelegate<Delegates.refresh> ("refresh");
  395. doupdate = lib.GetNativeMethodDelegate<Delegates.doupdate> ("doupdate");
  396. wrefresh = lib.GetNativeMethodDelegate<Delegates.wrefresh> ("wrefresh");
  397. redrawwin = lib.GetNativeMethodDelegate<Delegates.redrawwin> ("redrawwin");
  398. //wredrawwin = lib.GetNativeMethodDelegate<Delegates.wredrawwin> ("wredrawwin");
  399. wnoutrefresh = lib.GetNativeMethodDelegate<Delegates.wnoutrefresh> ("wnoutrefresh");
  400. move = lib.GetNativeMethodDelegate<Delegates.move> ("move");
  401. curs_set = lib.GetNativeMethodDelegate<Delegates.curs_set> ("curs_set");
  402. addch = lib.GetNativeMethodDelegate<Delegates.addch>("addch");
  403. addwstr = lib.GetNativeMethodDelegate<Delegates.addwstr> ("addwstr");
  404. wmove = lib.GetNativeMethodDelegate<Delegates.wmove> ("wmove");
  405. waddch = lib.GetNativeMethodDelegate<Delegates.waddch> ("waddch");
  406. attron = lib.GetNativeMethodDelegate<Delegates.attron> ("attron");
  407. attroff = lib.GetNativeMethodDelegate<Delegates.attroff> ("attroff");
  408. attrset = lib.GetNativeMethodDelegate<Delegates.attrset> ("attrset");
  409. getch = lib.GetNativeMethodDelegate<Delegates.getch> ("getch");
  410. get_wch = lib.GetNativeMethodDelegate<Delegates.get_wch> ("get_wch");
  411. ungetch = lib.GetNativeMethodDelegate<Delegates.ungetch> ("ungetch");
  412. mvgetch = lib.GetNativeMethodDelegate<Delegates.mvgetch> ("mvgetch");
  413. has_colors = lib.GetNativeMethodDelegate<Delegates.has_colors> ("has_colors");
  414. start_color = lib.GetNativeMethodDelegate<Delegates.start_color> ("start_color");
  415. init_pair = lib.GetNativeMethodDelegate<Delegates.init_pair> ("init_pair");
  416. use_default_colors = lib.GetNativeMethodDelegate<Delegates.use_default_colors> ("use_default_colors");
  417. COLOR_PAIRS = lib.GetNativeMethodDelegate<Delegates.COLOR_PAIRS> ("COLOR_PAIRS");
  418. getmouse = lib.GetNativeMethodDelegate<Delegates.getmouse> ("getmouse");
  419. ungetmouse = lib.GetNativeMethodDelegate<Delegates.ungetmouse> ("ungetmouse");
  420. mouseinterval = lib.GetNativeMethodDelegate<Delegates.mouseinterval> ("mouseinterval");
  421. mousemask = lib.GetNativeMethodDelegate<Delegates.mousemask> ("mousemask");
  422. }
  423. }
  424. #pragma warning restore CS1591 // Missing XML comment for publicly visible type or member
  425. }