Terminal.Gui.html 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373
  1. <!DOCTYPE html>
  2. <!--[if IE]><![endif]-->
  3. <html>
  4. <head>
  5. <meta charset="utf-8">
  6. <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  7. <title>Namespace Terminal.Gui
  8. </title>
  9. <meta name="viewport" content="width=device-width">
  10. <meta name="title" content="Namespace Terminal.Gui
  11. ">
  12. <meta name="generator" content="docfx 2.53.1.0">
  13. <link rel="shortcut icon" href="../../favicon.ico">
  14. <link rel="stylesheet" href="../../styles/docfx.vendor.css">
  15. <link rel="stylesheet" href="../../styles/docfx.css">
  16. <link rel="stylesheet" href="../../styles/main.css">
  17. <link href="https://fonts.googleapis.com/css?family=Roboto" rel="stylesheet">
  18. <meta property="docfx:navrel" content="">
  19. <meta property="docfx:tocrel" content="toc.html">
  20. <meta property="docfx:rel" content="../../">
  21. </head> <body data-spy="scroll" data-target="#affix" data-offset="120">
  22. <div id="wrapper">
  23. <header>
  24. <nav id="autocollapse" class="navbar navbar-inverse ng-scope" role="navigation">
  25. <div class="container">
  26. <div class="navbar-header">
  27. <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#navbar">
  28. <span class="sr-only">Toggle navigation</span>
  29. <span class="icon-bar"></span>
  30. <span class="icon-bar"></span>
  31. <span class="icon-bar"></span>
  32. </button>
  33. <a class="navbar-brand" href="../../index.html">
  34. <img id="logo" class="svg" src="../../images/logo48.png" alt="">
  35. </a>
  36. </div>
  37. <div class="collapse navbar-collapse" id="navbar">
  38. <form class="navbar-form navbar-right" role="search" id="search">
  39. <div class="form-group">
  40. <input type="text" class="form-control" id="search-query" placeholder="Search" autocomplete="off">
  41. </div>
  42. </form>
  43. </div>
  44. </div>
  45. </nav>
  46. <div class="subnav navbar navbar-default">
  47. <div class="container hide-when-search" id="breadcrumb">
  48. <ul class="breadcrumb">
  49. <li></li>
  50. </ul>
  51. </div>
  52. </div>
  53. </header>
  54. <div class="container body-content">
  55. <div id="search-results">
  56. <div class="search-list"></div>
  57. <div class="sr-items">
  58. <p><i class="glyphicon glyphicon-refresh index-loading"></i></p>
  59. </div>
  60. <ul id="pagination"></ul>
  61. </div>
  62. </div>
  63. <div role="main" class="container body-content hide-when-search">
  64. <div class="sidenav hide-when-search">
  65. <a class="btn toc-toggle collapse" data-toggle="collapse" href="#sidetoggle" aria-expanded="false" aria-controls="sidetoggle">Show / Hide Table of Contents</a>
  66. <div class="sidetoggle collapse" id="sidetoggle">
  67. <div id="sidetoc"></div>
  68. </div>
  69. </div>
  70. <div class="article row grid-right">
  71. <div class="col-md-10">
  72. <article class="content wrap" id="_content" data-uid="Terminal.Gui">
  73. <h1 id="Terminal_Gui" data-uid="Terminal.Gui" class="text-break">Namespace Terminal.Gui
  74. </h1>
  75. <div class="markdown level0 summary"></div>
  76. <div class="markdown level0 conceptual"></div>
  77. <div class="markdown level0 remarks"></div>
  78. <h3 id="classes">Classes
  79. </h3>
  80. <h4><a class="xref" href="Terminal.Gui.Application.html">Application</a></h4>
  81. <section>
  82. The application driver for Terminal.Gui.
  83. </section>
  84. <h4><a class="xref" href="Terminal.Gui.Application.ResizedEventArgs.html">Application.ResizedEventArgs</a></h4>
  85. <section>
  86. Event arguments for the <a class="xref" href="Terminal.Gui.Application.html#Terminal_Gui_Application_Resized">Resized</a> event.
  87. </section>
  88. <h4><a class="xref" href="Terminal.Gui.Application.RunState.html">Application.RunState</a></h4>
  89. <section>
  90. Captures the execution state for the provided <span class="xref">Terminal.Gui.Application.RunState.Toplevel</span> view.
  91. </section>
  92. <h4><a class="xref" href="Terminal.Gui.Button.html">Button</a></h4>
  93. <section>
  94. Button is a <a class="xref" href="Terminal.Gui.View.html">View</a> that provides an item that invokes an <span class="xref">System.Action</span> when activated by the user.
  95. </section>
  96. <h4><a class="xref" href="Terminal.Gui.CheckBox.html">CheckBox</a></h4>
  97. <section>
  98. The <a class="xref" href="Terminal.Gui.CheckBox.html">CheckBox</a> <a class="xref" href="Terminal.Gui.View.html">View</a> shows an on/off toggle that the user can set
  99. </section>
  100. <h4><a class="xref" href="Terminal.Gui.Clipboard.html">Clipboard</a></h4>
  101. <section>
  102. Provides cut, copy, and paste support for the clipboard.
  103. NOTE: Currently not implemented.
  104. </section>
  105. <h4><a class="xref" href="Terminal.Gui.Colors.html">Colors</a></h4>
  106. <section>
  107. The default ColorSchemes for the application.
  108. </section>
  109. <h4><a class="xref" href="Terminal.Gui.ColorScheme.html">ColorScheme</a></h4>
  110. <section>
  111. Color scheme definitions, they cover some common scenarios and are used
  112. typically in toplevel containers to set the scheme that is used by all the
  113. views contained inside.
  114. </section>
  115. <h4><a class="xref" href="Terminal.Gui.ComboBox.html">ComboBox</a></h4>
  116. <section>
  117. ComboBox control
  118. </section>
  119. <h4><a class="xref" href="Terminal.Gui.ConsoleDriver.html">ConsoleDriver</a></h4>
  120. <section>
  121. ConsoleDriver is an abstract class that defines the requirements for a console driver. One implementation if the CursesDriver, and another one uses the .NET Console one.
  122. </section>
  123. <h4><a class="xref" href="Terminal.Gui.CursesDriver.html">CursesDriver</a></h4>
  124. <section>
  125. This is the Curses driver for the gui.cs/Terminal framework.
  126. </section>
  127. <h4><a class="xref" href="Terminal.Gui.DateField.html">DateField</a></h4>
  128. <section>
  129. Date editing <a class="xref" href="Terminal.Gui.View.html">View</a>
  130. </section>
  131. <h4><a class="xref" href="Terminal.Gui.Dialog.html">Dialog</a></h4>
  132. <section>
  133. The <a class="xref" href="Terminal.Gui.Dialog.html">Dialog</a> <a class="xref" href="Terminal.Gui.View.html">View</a> is a <a class="xref" href="Terminal.Gui.Window.html">Window</a> that by default is centered and contains one
  134. or more <a class="xref" href="Terminal.Gui.Button.html">Button</a>. It defaults to the <a class="xref" href="Terminal.Gui.Colors.html#Terminal_Gui_Colors_Dialog">Dialog</a> color scheme and has a 1 cell padding around the edges.
  135. </section>
  136. <h4><a class="xref" href="Terminal.Gui.Dim.html">Dim</a></h4>
  137. <section>
  138. Dim properties of a <a class="xref" href="Terminal.Gui.View.html">View</a> to control the position.
  139. </section>
  140. <h4><a class="xref" href="Terminal.Gui.FileDialog.html">FileDialog</a></h4>
  141. <section>
  142. Base class for the <a class="xref" href="Terminal.Gui.OpenDialog.html">OpenDialog</a> and the <a class="xref" href="Terminal.Gui.SaveDialog.html">SaveDialog</a>
  143. </section>
  144. <h4><a class="xref" href="Terminal.Gui.FrameView.html">FrameView</a></h4>
  145. <section>
  146. The FrameView is a container frame that draws a frame around the contents. It is similar to
  147. a GroupBox in Windows.
  148. </section>
  149. <h4><a class="xref" href="Terminal.Gui.HexView.html">HexView</a></h4>
  150. <section>
  151. An hex viewer and editor <a class="xref" href="Terminal.Gui.View.html">View</a> over a <span class="xref">System.IO.Stream</span>
  152. </section>
  153. <h4><a class="xref" href="Terminal.Gui.KeyEvent.html">KeyEvent</a></h4>
  154. <section>
  155. Describes a keyboard event.
  156. </section>
  157. <h4><a class="xref" href="Terminal.Gui.Label.html">Label</a></h4>
  158. <section>
  159. The Label <a class="xref" href="Terminal.Gui.View.html">View</a> displays a string at a given position and supports multiple lines separted by newline characters.
  160. </section>
  161. <h4><a class="xref" href="Terminal.Gui.ListView.html">ListView</a></h4>
  162. <section>
  163. ListView <a class="xref" href="Terminal.Gui.View.html">View</a> renders a scrollable list of data where each item can be activated to perform an action.
  164. </section>
  165. <h4><a class="xref" href="Terminal.Gui.ListViewItemEventArgs.html">ListViewItemEventArgs</a></h4>
  166. <section>
  167. <span class="xref">System.EventArgs</span> for <a class="xref" href="Terminal.Gui.ListView.html">ListView</a> events.
  168. </section>
  169. <h4><a class="xref" href="Terminal.Gui.ListWrapper.html">ListWrapper</a></h4>
  170. <section>
  171. Implements an <a class="xref" href="Terminal.Gui.IListDataSource.html">IListDataSource</a> that renders arbitrary <span class="xref">System.Collections.IList</span> instances for <a class="xref" href="Terminal.Gui.ListView.html">ListView</a>.
  172. </section>
  173. <h4><a class="xref" href="Terminal.Gui.MenuBar.html">MenuBar</a></h4>
  174. <section>
  175. The MenuBar provides a menu for Terminal.Gui applications.
  176. </section>
  177. <h4><a class="xref" href="Terminal.Gui.MenuBarItem.html">MenuBarItem</a></h4>
  178. <section>
  179. A <a class="xref" href="Terminal.Gui.MenuBarItem.html">MenuBarItem</a> contains <a class="xref" href="Terminal.Gui.MenuBarItem.html">MenuBarItem</a>s or <a class="xref" href="Terminal.Gui.MenuItem.html">MenuItem</a>s.
  180. </section>
  181. <h4><a class="xref" href="Terminal.Gui.MenuItem.html">MenuItem</a></h4>
  182. <section>
  183. A <a class="xref" href="Terminal.Gui.MenuItem.html">MenuItem</a> has a title, an associated help text, and an action to execute on activation.
  184. </section>
  185. <h4><a class="xref" href="Terminal.Gui.MessageBox.html">MessageBox</a></h4>
  186. <section>
  187. MessageBox displays a modal message to the user, with a title, a message and a series of options that the user can choose from.
  188. </section>
  189. <h4><a class="xref" href="Terminal.Gui.OpenDialog.html">OpenDialog</a></h4>
  190. <section>
  191. The <a class="xref" href="Terminal.Gui.OpenDialog.html">OpenDialog</a>provides an interactive dialog box for users to select files or directories.
  192. </section>
  193. <h4><a class="xref" href="Terminal.Gui.Pos.html">Pos</a></h4>
  194. <section>
  195. Describes the position of a <a class="xref" href="Terminal.Gui.View.html">View</a> which can be an absolute value, a percentage, centered, or
  196. relative to the ending dimension. Integer values are implicitly convertible to
  197. an absolute <a class="xref" href="Terminal.Gui.Pos.html">Pos</a>. These objects are created using the static methods Percent,
  198. AnchorEnd, and Center. The <a class="xref" href="Terminal.Gui.Pos.html">Pos</a> objects can be combined with the addition and
  199. subtraction operators.
  200. </section>
  201. <h4><a class="xref" href="Terminal.Gui.ProgressBar.html">ProgressBar</a></h4>
  202. <section>
  203. A Progress Bar view that can indicate progress of an activity visually.
  204. </section>
  205. <h4><a class="xref" href="Terminal.Gui.RadioGroup.html">RadioGroup</a></h4>
  206. <section>
  207. <a class="xref" href="Terminal.Gui.RadioGroup.html">RadioGroup</a> shows a group of radio labels, only one of those can be selected at a given time
  208. </section>
  209. <h4><a class="xref" href="Terminal.Gui.Responder.html">Responder</a></h4>
  210. <section>
  211. Responder base class implemented by objects that want to participate on keyboard and mouse input.
  212. </section>
  213. <h4><a class="xref" href="Terminal.Gui.SaveDialog.html">SaveDialog</a></h4>
  214. <section>
  215. The <a class="xref" href="Terminal.Gui.SaveDialog.html">SaveDialog</a> provides an interactive dialog box for users to pick a file to
  216. save.
  217. </section>
  218. <h4><a class="xref" href="Terminal.Gui.ScrollBarView.html">ScrollBarView</a></h4>
  219. <section>
  220. ScrollBarViews are views that display a 1-character scrollbar, either horizontal or vertical
  221. </section>
  222. <h4><a class="xref" href="Terminal.Gui.ScrollView.html">ScrollView</a></h4>
  223. <section>
  224. Scrollviews are views that present a window into a virtual space where children views are added. Similar to the iOS UIScrollView.
  225. </section>
  226. <h4><a class="xref" href="Terminal.Gui.StatusBar.html">StatusBar</a></h4>
  227. <section>
  228. A status bar is a <a class="xref" href="Terminal.Gui.View.html">View</a> that snaps to the bottom of a <a class="xref" href="Terminal.Gui.Toplevel.html">Toplevel</a> displaying set of <a class="xref" href="Terminal.Gui.StatusItem.html">StatusItem</a>s.
  229. The <a class="xref" href="Terminal.Gui.StatusBar.html">StatusBar</a> should be context sensitive. This means, if the main menu and an open text editor are visible, the items probably shown will
  230. be ~F1~ Help ~F2~ Save ~F3~ Load. While a dialog to ask a file to load is executed, the remaining commands will probably be ~F1~ Help.
  231. So for each context must be a new instance of a statusbar.
  232. </section>
  233. <h4><a class="xref" href="Terminal.Gui.StatusItem.html">StatusItem</a></h4>
  234. <section>
  235. <a class="xref" href="Terminal.Gui.StatusItem.html">StatusItem</a> objects are contained by <a class="xref" href="Terminal.Gui.StatusBar.html">StatusBar</a> <a class="xref" href="Terminal.Gui.View.html">View</a>s.
  236. Each <a class="xref" href="Terminal.Gui.StatusItem.html">StatusItem</a> has a title, a shortcut (hotkey), and an <a class="xref" href="Terminal.Gui.StatusItem.html#Terminal_Gui_StatusItem_Action">Action</a> that will be invoked when the
  237. <a class="xref" href="Terminal.Gui.StatusItem.html#Terminal_Gui_StatusItem_Shortcut">Shortcut</a> is pressed.
  238. The <a class="xref" href="Terminal.Gui.StatusItem.html#Terminal_Gui_StatusItem_Shortcut">Shortcut</a> will be a global hotkey for the application in the current context of the screen.
  239. The colour of the <a class="xref" href="Terminal.Gui.StatusItem.html#Terminal_Gui_StatusItem_Title">Title</a> will be changed after each ~.
  240. A <a class="xref" href="Terminal.Gui.StatusItem.html#Terminal_Gui_StatusItem_Title">Title</a> set to `~F1~ Help` will render as *F1* using <a class="xref" href="Terminal.Gui.ColorScheme.html#Terminal_Gui_ColorScheme_HotNormal">HotNormal</a> and
  241. *Help* as <a class="xref" href="Terminal.Gui.ColorScheme.html#Terminal_Gui_ColorScheme_HotNormal">HotNormal</a>.
  242. </section>
  243. <h4><a class="xref" href="Terminal.Gui.TextField.html">TextField</a></h4>
  244. <section>
  245. Single-line text entry <a class="xref" href="Terminal.Gui.View.html">View</a>
  246. </section>
  247. <h4><a class="xref" href="Terminal.Gui.TextView.html">TextView</a></h4>
  248. <section>
  249. Multi-line text editing <a class="xref" href="Terminal.Gui.View.html">View</a>
  250. </section>
  251. <h4><a class="xref" href="Terminal.Gui.TimeField.html">TimeField</a></h4>
  252. <section>
  253. Time editing <a class="xref" href="Terminal.Gui.View.html">View</a>
  254. </section>
  255. <h4><a class="xref" href="Terminal.Gui.Toplevel.html">Toplevel</a></h4>
  256. <section>
  257. Toplevel views can be modally executed.
  258. </section>
  259. <h4><a class="xref" href="Terminal.Gui.View.html">View</a></h4>
  260. <section>
  261. View is the base class for all views on the screen and represents a visible element that can render itself and contains zero or more nested views.
  262. </section>
  263. <h4><a class="xref" href="Terminal.Gui.View.KeyEventEventArgs.html">View.KeyEventEventArgs</a></h4>
  264. <section>
  265. Specifies the event arguments for <a class="xref" href="Terminal.Gui.View.KeyEventEventArgs.html#Terminal_Gui_View_KeyEventEventArgs_KeyEvent">KeyEvent</a>
  266. </section>
  267. <h4><a class="xref" href="Terminal.Gui.Window.html">Window</a></h4>
  268. <section>
  269. A <a class="xref" href="Terminal.Gui.Toplevel.html">Toplevel</a> <a class="xref" href="Terminal.Gui.View.html">View</a> that draws a frame around its region and has a &quot;ContentView&quot; subview where the contents are added.
  270. </section>
  271. <h3 id="structs">Structs
  272. </h3>
  273. <h4><a class="xref" href="Terminal.Gui.Attribute.html">Attribute</a></h4>
  274. <section>
  275. Attributes are used as elements that contain both a foreground and a background or platform specific features
  276. </section>
  277. <h4><a class="xref" href="Terminal.Gui.MouseEvent.html">MouseEvent</a></h4>
  278. <section>
  279. Describes a mouse event
  280. </section>
  281. <h4><a class="xref" href="Terminal.Gui.Point.html">Point</a></h4>
  282. <section>
  283. Represents an ordered pair of integer x- and y-coordinates that defines a point in a two-dimensional plane.
  284. </section>
  285. <h4><a class="xref" href="Terminal.Gui.Rect.html">Rect</a></h4>
  286. <section>
  287. Stores a set of four integers that represent the location and size of a rectangle
  288. </section>
  289. <h4><a class="xref" href="Terminal.Gui.Size.html">Size</a></h4>
  290. <section>
  291. Stores an ordered pair of integers, which specify a Height and Width.
  292. </section>
  293. <h3 id="interfaces">Interfaces
  294. </h3>
  295. <h4><a class="xref" href="Terminal.Gui.IListDataSource.html">IListDataSource</a></h4>
  296. <section>
  297. Implement <a class="xref" href="Terminal.Gui.IListDataSource.html">IListDataSource</a> to provide custom rendering for a <a class="xref" href="Terminal.Gui.ListView.html">ListView</a>.
  298. </section>
  299. <h3 id="enums">Enums
  300. </h3>
  301. <h4><a class="xref" href="Terminal.Gui.Color.html">Color</a></h4>
  302. <section>
  303. Basic colors that can be used to set the foreground and background colors in console applications. These can only be
  304. </section>
  305. <h4><a class="xref" href="Terminal.Gui.Key.html">Key</a></h4>
  306. <section>
  307. The <a class="xref" href="Terminal.Gui.Key.html">Key</a> enumeration contains special encoding for some keys, but can also
  308. encode all the unicode values that can be passed.
  309. </section>
  310. <h4><a class="xref" href="Terminal.Gui.LayoutStyle.html">LayoutStyle</a></h4>
  311. <section>
  312. Determines the LayoutStyle for a view, if Absolute, during LayoutSubviews, the
  313. value from the Frame will be used, if the value is Computer, then the Frame
  314. will be updated from the X, Y Pos objects and the Width and Height Dim objects.
  315. </section>
  316. <h4><a class="xref" href="Terminal.Gui.MouseFlags.html">MouseFlags</a></h4>
  317. <section>
  318. Mouse flags reported in MouseEvent.
  319. </section>
  320. <h4><a class="xref" href="Terminal.Gui.SpecialChar.html">SpecialChar</a></h4>
  321. <section>
  322. Special characters that can be drawn with Driver.AddSpecial.
  323. </section>
  324. <h4><a class="xref" href="Terminal.Gui.TextAlignment.html">TextAlignment</a></h4>
  325. <section>
  326. Text alignment enumeration, controls how text is displayed.
  327. </section>
  328. </article>
  329. </div>
  330. <div class="hidden-sm col-md-2" role="complementary">
  331. <div class="sideaffix">
  332. <div class="contribution">
  333. <ul class="nav">
  334. </ul>
  335. </div>
  336. <nav class="bs-docs-sidebar hidden-print hidden-xs hidden-sm affix" id="affix">
  337. <!-- <p><a class="back-to-top" href="#top">Back to top</a><p> -->
  338. </nav>
  339. </div>
  340. </div>
  341. </div>
  342. </div>
  343. <footer>
  344. <div class="grad-bottom"></div>
  345. <div class="footer">
  346. <div class="container">
  347. <span class="pull-right">
  348. <a href="#top">Back to top</a>
  349. </span>
  350. <span>Generated by <strong>DocFX</strong></span>
  351. </div>
  352. </div>
  353. </footer>
  354. </div>
  355. <script type="text/javascript" src="../../styles/docfx.vendor.js"></script>
  356. <script type="text/javascript" src="../../styles/docfx.js"></script>
  357. <script type="text/javascript" src="../../styles/main.js"></script>
  358. </body>
  359. </html>