MainLoop.xml 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340
  1. <Type Name="MainLoop" FullName="Mono.Terminal.MainLoop">
  2. <TypeSignature Language="C#" Value="public class MainLoop" />
  3. <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit MainLoop extends System.Object" />
  4. <AssemblyInfo>
  5. <AssemblyName>Terminal.Gui</AssemblyName>
  6. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  7. </AssemblyInfo>
  8. <Base>
  9. <BaseTypeName>System.Object</BaseTypeName>
  10. </Base>
  11. <Interfaces />
  12. <Docs>
  13. <summary>
  14. Simple main loop implementation that can be used to monitor
  15. file descriptor, run timers and idle handlers.
  16. </summary>
  17. <remarks>
  18. Monitoring of file descriptors is only available on Unix, there
  19. does not seem to be a way of supporting this on Windows.
  20. </remarks>
  21. </Docs>
  22. <Members>
  23. <Member MemberName=".ctor">
  24. <MemberSignature Language="C#" Value="public MainLoop ();" />
  25. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
  26. <MemberType>Constructor</MemberType>
  27. <Parameters />
  28. <Docs>
  29. <summary>
  30. Default constructor
  31. </summary>
  32. <remarks>To be added.</remarks>
  33. </Docs>
  34. </Member>
  35. <Member MemberName=".ctor">
  36. <MemberSignature Language="C#" Value="public MainLoop (Mono.Terminal.IMainLoopDriver driver);" />
  37. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class Mono.Terminal.IMainLoopDriver driver) cil managed" />
  38. <MemberType>Constructor</MemberType>
  39. <AssemblyInfo>
  40. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  41. </AssemblyInfo>
  42. <Parameters>
  43. <Parameter Name="driver" Type="Mono.Terminal.IMainLoopDriver" />
  44. </Parameters>
  45. <Docs>
  46. <param name="driver">To be added.</param>
  47. <summary>
  48. Creates a new Mainloop, to run it you must provide a driver, and choose
  49. one of the implementations UnixMainLoop, NetMainLoop or WindowsMainLoop.
  50. </summary>
  51. <remarks>To be added.</remarks>
  52. </Docs>
  53. </Member>
  54. <Member MemberName="AddIdle">
  55. <MemberSignature Language="C#" Value="public Func&lt;bool&gt; AddIdle (Func&lt;bool&gt; idleHandler);" />
  56. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Func`1&lt;bool&gt; AddIdle(class System.Func`1&lt;bool&gt; idleHandler) cil managed" />
  57. <MemberType>Method</MemberType>
  58. <AssemblyInfo>
  59. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  60. </AssemblyInfo>
  61. <ReturnValue>
  62. <ReturnType>System.Func&lt;System.Boolean&gt;</ReturnType>
  63. </ReturnValue>
  64. <Parameters>
  65. <Parameter Name="idleHandler" Type="System.Func&lt;System.Boolean&gt;" />
  66. </Parameters>
  67. <Docs>
  68. <param name="idleHandler">To be added.</param>
  69. <summary>
  70. Executes the specified @idleHandler on the idle loop. The return value is a token to remove it.
  71. </summary>
  72. <returns>To be added.</returns>
  73. <remarks>To be added.</remarks>
  74. </Docs>
  75. </Member>
  76. <Member MemberName="AddTimeout">
  77. <MemberSignature Language="C#" Value="public object AddTimeout (TimeSpan time, Func&lt;Mono.Terminal.MainLoop,bool&gt; callback);" />
  78. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance object AddTimeout(valuetype System.TimeSpan time, class System.Func`2&lt;class Mono.Terminal.MainLoop, bool&gt; callback) cil managed" />
  79. <MemberType>Method</MemberType>
  80. <AssemblyInfo>
  81. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  82. </AssemblyInfo>
  83. <ReturnValue>
  84. <ReturnType>System.Object</ReturnType>
  85. </ReturnValue>
  86. <Parameters>
  87. <Parameter Name="time" Type="System.TimeSpan" />
  88. <Parameter Name="callback" Type="System.Func&lt;Mono.Terminal.MainLoop,System.Boolean&gt;" />
  89. </Parameters>
  90. <Docs>
  91. <param name="time">To be added.</param>
  92. <param name="callback">To be added.</param>
  93. <summary>
  94. Adds a timeout to the mainloop.
  95. </summary>
  96. <returns>To be added.</returns>
  97. <remarks>
  98. When time time specified passes, the callback will be invoked.
  99. If the callback returns true, the timeout will be reset, repeating
  100. the invocation. If it returns false, the timeout will stop.
  101. The returned value is a token that can be used to stop the timeout
  102. by calling RemoveTimeout.
  103. </remarks>
  104. </Docs>
  105. </Member>
  106. <Member MemberName="AddWatch">
  107. <MemberSignature Language="C#" Value="public object AddWatch (int fileDescriptor, Mono.Terminal.MainLoop.Condition condition, Func&lt;Mono.Terminal.MainLoop,bool&gt; callback);" />
  108. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance object AddWatch(int32 fileDescriptor, valuetype Mono.Terminal.MainLoop/Condition condition, class System.Func`2&lt;class Mono.Terminal.MainLoop, bool&gt; callback) cil managed" />
  109. <MemberType>Method</MemberType>
  110. <ReturnValue>
  111. <ReturnType>System.Object</ReturnType>
  112. </ReturnValue>
  113. <Parameters>
  114. <Parameter Name="fileDescriptor" Type="System.Int32" />
  115. <Parameter Name="condition" Type="Mono.Terminal.MainLoop+Condition" />
  116. <Parameter Name="callback" Type="System.Func&lt;Mono.Terminal.MainLoop,System.Boolean&gt;" />
  117. </Parameters>
  118. <Docs>
  119. <param name="fileDescriptor">To be added.</param>
  120. <param name="condition">To be added.</param>
  121. <param name="callback">To be added.</param>
  122. <summary>
  123. Watches a file descriptor for activity.
  124. </summary>
  125. <returns>To be added.</returns>
  126. <remarks>
  127. When the condition is met, the provided callback
  128. is invoked. If the callback returns false, the
  129. watch is automatically removed.
  130. The return value is a token that represents this watch, you can
  131. use this token to remove the watch by calling RemoveWatch.
  132. </remarks>
  133. </Docs>
  134. </Member>
  135. <Member MemberName="Driver">
  136. <MemberSignature Language="C#" Value="public Mono.Terminal.IMainLoopDriver Driver { get; }" />
  137. <MemberSignature Language="ILAsm" Value=".property instance class Mono.Terminal.IMainLoopDriver Driver" />
  138. <MemberType>Property</MemberType>
  139. <AssemblyInfo>
  140. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  141. </AssemblyInfo>
  142. <ReturnValue>
  143. <ReturnType>Mono.Terminal.IMainLoopDriver</ReturnType>
  144. </ReturnValue>
  145. <Docs>
  146. <summary>
  147. The current IMainLoopDriver in use.
  148. </summary>
  149. <value>The driver.</value>
  150. <remarks>To be added.</remarks>
  151. </Docs>
  152. </Member>
  153. <Member MemberName="EventsPending">
  154. <MemberSignature Language="C#" Value="public bool EventsPending (bool wait = false);" />
  155. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool EventsPending(bool wait) cil managed" />
  156. <MemberType>Method</MemberType>
  157. <AssemblyInfo>
  158. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  159. </AssemblyInfo>
  160. <ReturnValue>
  161. <ReturnType>System.Boolean</ReturnType>
  162. </ReturnValue>
  163. <Parameters>
  164. <Parameter Name="wait" Type="System.Boolean" />
  165. </Parameters>
  166. <Docs>
  167. <param name="wait">To be added.</param>
  168. <summary>
  169. Determines whether there are pending events to be processed.
  170. </summary>
  171. <returns>To be added.</returns>
  172. <remarks>
  173. You can use this method if you want to probe if events are pending.
  174. Typically used if you need to flush the input queue while still
  175. running some of your own code in your main thread.
  176. </remarks>
  177. </Docs>
  178. </Member>
  179. <Member MemberName="Invoke">
  180. <MemberSignature Language="C#" Value="public void Invoke (Action action);" />
  181. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Invoke(class System.Action action) cil managed" />
  182. <MemberType>Method</MemberType>
  183. <AssemblyInfo>
  184. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  185. </AssemblyInfo>
  186. <ReturnValue>
  187. <ReturnType>System.Void</ReturnType>
  188. </ReturnValue>
  189. <Parameters>
  190. <Parameter Name="action" Type="System.Action" />
  191. </Parameters>
  192. <Docs>
  193. <param name="action">To be added.</param>
  194. <summary>
  195. Runs @action on the thread that is processing events
  196. </summary>
  197. <remarks>To be added.</remarks>
  198. </Docs>
  199. </Member>
  200. <Member MemberName="MainIteration">
  201. <MemberSignature Language="C#" Value="public void MainIteration ();" />
  202. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void MainIteration() cil managed" />
  203. <MemberType>Method</MemberType>
  204. <AssemblyInfo>
  205. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  206. </AssemblyInfo>
  207. <ReturnValue>
  208. <ReturnType>System.Void</ReturnType>
  209. </ReturnValue>
  210. <Parameters />
  211. <Docs>
  212. <summary>
  213. Runs one iteration of timers and file watches
  214. </summary>
  215. <remarks>
  216. You use this to process all pending events (timers, idle handlers and file watches).
  217. You can use it like this:
  218. while (main.EvensPending ()) MainIteration ();
  219. </remarks>
  220. </Docs>
  221. </Member>
  222. <Member MemberName="RemoveIdle">
  223. <MemberSignature Language="C#" Value="public void RemoveIdle (Func&lt;bool&gt; idleHandler);" />
  224. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void RemoveIdle(class System.Func`1&lt;bool&gt; idleHandler) cil managed" />
  225. <MemberType>Method</MemberType>
  226. <AssemblyInfo>
  227. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  228. </AssemblyInfo>
  229. <ReturnValue>
  230. <ReturnType>System.Void</ReturnType>
  231. </ReturnValue>
  232. <Parameters>
  233. <Parameter Name="idleHandler" Type="System.Func&lt;System.Boolean&gt;" />
  234. </Parameters>
  235. <Docs>
  236. <param name="idleHandler">To be added.</param>
  237. <summary>
  238. Removes the specified idleHandler from processing.
  239. </summary>
  240. <remarks>To be added.</remarks>
  241. </Docs>
  242. </Member>
  243. <Member MemberName="RemoveTimeout">
  244. <MemberSignature Language="C#" Value="public void RemoveTimeout (object token);" />
  245. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void RemoveTimeout(object token) cil managed" />
  246. <MemberType>Method</MemberType>
  247. <AssemblyInfo>
  248. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  249. </AssemblyInfo>
  250. <ReturnValue>
  251. <ReturnType>System.Void</ReturnType>
  252. </ReturnValue>
  253. <Parameters>
  254. <Parameter Name="token" Type="System.Object" />
  255. </Parameters>
  256. <Docs>
  257. <param name="token">To be added.</param>
  258. <summary>
  259. Removes a previously scheduled timeout
  260. </summary>
  261. <remarks>
  262. The token parameter is the value returned by AddTimeout.
  263. </remarks>
  264. </Docs>
  265. </Member>
  266. <Member MemberName="RemoveWatch">
  267. <MemberSignature Language="C#" Value="public void RemoveWatch (object token);" />
  268. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void RemoveWatch(object token) cil managed" />
  269. <MemberType>Method</MemberType>
  270. <ReturnValue>
  271. <ReturnType>System.Void</ReturnType>
  272. </ReturnValue>
  273. <Parameters>
  274. <Parameter Name="token" Type="System.Object" />
  275. </Parameters>
  276. <Docs>
  277. <param name="token">To be added.</param>
  278. <summary>
  279. Removes an active watch from the mainloop.
  280. </summary>
  281. <remarks>
  282. The token parameter is the value returned from AddWatch
  283. </remarks>
  284. </Docs>
  285. </Member>
  286. <Member MemberName="Run">
  287. <MemberSignature Language="C#" Value="public void Run ();" />
  288. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Run() cil managed" />
  289. <MemberType>Method</MemberType>
  290. <AssemblyInfo>
  291. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  292. </AssemblyInfo>
  293. <ReturnValue>
  294. <ReturnType>System.Void</ReturnType>
  295. </ReturnValue>
  296. <Parameters />
  297. <Docs>
  298. <summary>
  299. Runs the mainloop.
  300. </summary>
  301. <remarks>To be added.</remarks>
  302. </Docs>
  303. </Member>
  304. <Member MemberName="Stop">
  305. <MemberSignature Language="C#" Value="public void Stop ();" />
  306. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Stop() cil managed" />
  307. <MemberType>Method</MemberType>
  308. <AssemblyInfo>
  309. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  310. </AssemblyInfo>
  311. <ReturnValue>
  312. <ReturnType>System.Void</ReturnType>
  313. </ReturnValue>
  314. <Parameters />
  315. <Docs>
  316. <summary>
  317. Stops the mainloop.
  318. </summary>
  319. <remarks>To be added.</remarks>
  320. </Docs>
  321. </Member>
  322. <Member MemberName="WindowsKeyPressed">
  323. <MemberSignature Language="C#" Value="public Action&lt;ConsoleKeyInfo&gt; WindowsKeyPressed;" />
  324. <MemberSignature Language="ILAsm" Value=".field public class System.Action`1&lt;valuetype System.ConsoleKeyInfo&gt; WindowsKeyPressed" />
  325. <MemberType>Field</MemberType>
  326. <ReturnValue>
  327. <ReturnType>System.Action&lt;System.ConsoleKeyInfo&gt;</ReturnType>
  328. </ReturnValue>
  329. <Docs>
  330. <summary>
  331. This event is raised when a key is pressed when using the Windows driver.
  332. </summary>
  333. <remarks>To be added.</remarks>
  334. </Docs>
  335. </Member>
  336. </Members>
  337. </Type>