Log.xml 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373
  1. <Type Name="Log" FullName="Urho.IO.Log">
  2. <TypeSignature Language="C#" Value="public class Log : Urho.UrhoObject" />
  3. <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit Log extends Urho.UrhoObject" />
  4. <AssemblyInfo>
  5. <AssemblyName>Urho</AssemblyName>
  6. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  7. </AssemblyInfo>
  8. <Base>
  9. <BaseTypeName>Urho.UrhoObject</BaseTypeName>
  10. </Base>
  11. <Interfaces />
  12. <Docs>
  13. <summary>
  14. Logging subsystem.
  15. </summary>
  16. <remarks>To be added.</remarks>
  17. </Docs>
  18. <Members>
  19. <Member MemberName=".ctor">
  20. <MemberSignature Language="C#" Value="public Log ();" />
  21. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
  22. <MemberType>Constructor</MemberType>
  23. <AssemblyInfo>
  24. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  25. </AssemblyInfo>
  26. <Parameters />
  27. <Docs>
  28. <summary>
  29. <para>Constructs a new instance of Urho.IO.Log which is tied to the <see cref="P:Urho.Application.CurrentContext" />.</para>
  30. </summary>
  31. <remarks></remarks>
  32. </Docs>
  33. </Member>
  34. <Member MemberName=".ctor">
  35. <MemberSignature Language="C#" Value="public Log (IntPtr handle);" />
  36. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(native int handle) cil managed" />
  37. <MemberType>Constructor</MemberType>
  38. <AssemblyInfo>
  39. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  40. </AssemblyInfo>
  41. <Parameters>
  42. <Parameter Name="handle" Type="System.IntPtr" />
  43. </Parameters>
  44. <Docs>
  45. <param name="handle">Pointer to the raw unmanaged Urho object.</param>
  46. <summary>Constructs a new instance of Urho.IO.Log, given a raw pointer to an unmanaged object</summary>
  47. <remarks>
  48. <para>This creates a new managed wrapper for the type using the raw pointer to an unmanaged object.</para>
  49. <para>Objects that are created in this fashion get registered with the UrhoSharp runtime.</para>
  50. <para>This is intended to be used by the UrhoSharp runtime, and is not intended to be used by users.</para>
  51. </remarks>
  52. </Docs>
  53. </Member>
  54. <Member MemberName=".ctor">
  55. <MemberSignature Language="C#" Value="public Log (Urho.Context context);" />
  56. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class Urho.Context context) cil managed" />
  57. <MemberType>Constructor</MemberType>
  58. <AssemblyInfo>
  59. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  60. </AssemblyInfo>
  61. <Parameters>
  62. <Parameter Name="context" Type="Urho.Context" />
  63. </Parameters>
  64. <Docs>
  65. <param name="context">The context that this object will be attached to.</param>
  66. <summary>
  67. <para>Constructs a new instance of Urho.IO.Log linked to a specific <see cref="T:Urho.Context" />.</para>
  68. </summary>
  69. <remarks></remarks>
  70. </Docs>
  71. </Member>
  72. <Member MemberName=".ctor">
  73. <MemberSignature Language="C#" Value="protected Log (Urho.UrhoObjectFlag emptyFlag);" />
  74. <MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor(valuetype Urho.UrhoObjectFlag emptyFlag) cil managed" />
  75. <MemberType>Constructor</MemberType>
  76. <AssemblyInfo>
  77. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  78. </AssemblyInfo>
  79. <Parameters>
  80. <Parameter Name="emptyFlag" Type="Urho.UrhoObjectFlag" />
  81. </Parameters>
  82. <Docs>
  83. <param name="emptyFlag">Pass UrhoObjectFlag.Empty.</param>
  84. <summary>Empty constructor, chain to this constructor when you provide your own constructor that sets the handle field.</summary>
  85. <remarks>
  86. <para>This constructor should be invoked by your code if you provide your own constructor that sets the handle field.</para>
  87. <para>This essentially circumvents the default path that creates a new object and sets the handle and does not call RegisterObject on the target, you must do this on your own constructor.</para>
  88. <para>You would typically chain to this constructor from your own, and then set the handle to the unmanaged object from your code, and then register your object.</para>
  89. </remarks>
  90. </Docs>
  91. </Member>
  92. <Member MemberName="Close">
  93. <MemberSignature Language="C#" Value="public void Close ();" />
  94. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Close() cil managed" />
  95. <MemberType>Method</MemberType>
  96. <AssemblyInfo>
  97. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  98. </AssemblyInfo>
  99. <ReturnValue>
  100. <ReturnType>System.Void</ReturnType>
  101. </ReturnValue>
  102. <Parameters />
  103. <Docs>
  104. <summary>
  105. Close the log file.
  106. </summary>
  107. <remarks>To be added.</remarks>
  108. </Docs>
  109. </Member>
  110. <Member MemberName="LastMessage">
  111. <MemberSignature Language="C#" Value="public string LastMessage { get; }" />
  112. <MemberSignature Language="ILAsm" Value=".property instance string LastMessage" />
  113. <MemberType>Property</MemberType>
  114. <AssemblyInfo>
  115. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  116. </AssemblyInfo>
  117. <ReturnValue>
  118. <ReturnType>System.String</ReturnType>
  119. </ReturnValue>
  120. <Docs>
  121. <summary>
  122. Return last log message.
  123. </summary>
  124. <value>To be added.</value>
  125. <remarks>To be added.</remarks>
  126. </Docs>
  127. </Member>
  128. <Member MemberName="Level">
  129. <MemberSignature Language="C#" Value="public int Level { get; set; }" />
  130. <MemberSignature Language="ILAsm" Value=".property instance int32 Level" />
  131. <MemberType>Property</MemberType>
  132. <AssemblyInfo>
  133. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  134. </AssemblyInfo>
  135. <ReturnValue>
  136. <ReturnType>System.Int32</ReturnType>
  137. </ReturnValue>
  138. <Docs>
  139. <summary>
  140. Return logging level.
  141. Or
  142. Set logging level.
  143. </summary>
  144. <value>To be added.</value>
  145. <remarks>To be added.</remarks>
  146. </Docs>
  147. </Member>
  148. <Member MemberName="LogLevel">
  149. <MemberSignature Language="C#" Value="public Urho.LogLevel LogLevel { get; set; }" />
  150. <MemberSignature Language="ILAsm" Value=".property instance valuetype Urho.LogLevel LogLevel" />
  151. <MemberType>Property</MemberType>
  152. <AssemblyInfo>
  153. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  154. </AssemblyInfo>
  155. <ReturnValue>
  156. <ReturnType>Urho.LogLevel</ReturnType>
  157. </ReturnValue>
  158. <Docs>
  159. <summary>To be added.</summary>
  160. <value>To be added.</value>
  161. <remarks>To be added.</remarks>
  162. </Docs>
  163. </Member>
  164. <Member MemberName="LogMessage">
  165. <MemberSignature Language="C#" Value="public event Action&lt;Urho.IO.LogMessageEventArgs&gt; LogMessage;" />
  166. <MemberSignature Language="ILAsm" Value=".event class System.Action`1&lt;valuetype Urho.IO.LogMessageEventArgs&gt; LogMessage" />
  167. <MemberType>Event</MemberType>
  168. <AssemblyInfo>
  169. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  170. </AssemblyInfo>
  171. <ReturnValue>
  172. <ReturnType>System.Action&lt;Urho.IO.LogMessageEventArgs&gt;</ReturnType>
  173. </ReturnValue>
  174. <Docs>
  175. <summary>To be added.</summary>
  176. <remarks>
  177. <para>The event can register multiple callbacks and invoke all of them. If this is not desired, and you only need a single shot callback, you can use the <see cref="M:Urho.SubscribeToLogMessage" /> method. That one will force that callback and will ignore any previously set events here.</para>
  178. </remarks>
  179. </Docs>
  180. </Member>
  181. <Member MemberName="Open">
  182. <MemberSignature Language="C#" Value="public void Open (string fileName);" />
  183. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Open(string fileName) cil managed" />
  184. <MemberType>Method</MemberType>
  185. <AssemblyInfo>
  186. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  187. </AssemblyInfo>
  188. <ReturnValue>
  189. <ReturnType>System.Void</ReturnType>
  190. </ReturnValue>
  191. <Parameters>
  192. <Parameter Name="fileName" Type="System.String" />
  193. </Parameters>
  194. <Docs>
  195. <param name="fileName">To be added.</param>
  196. <summary>
  197. Open the log file.
  198. </summary>
  199. <remarks>To be added.</remarks>
  200. </Docs>
  201. </Member>
  202. <Member MemberName="Quiet">
  203. <MemberSignature Language="C#" Value="public bool Quiet { get; set; }" />
  204. <MemberSignature Language="ILAsm" Value=".property instance bool Quiet" />
  205. <MemberType>Property</MemberType>
  206. <AssemblyInfo>
  207. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  208. </AssemblyInfo>
  209. <ReturnValue>
  210. <ReturnType>System.Boolean</ReturnType>
  211. </ReturnValue>
  212. <Docs>
  213. <summary>Return whether log is in quiet mode (only errors printed to standard error stream).</summary>
  214. <value>To be added.</value>
  215. <remarks>To be added.</remarks>
  216. </Docs>
  217. </Member>
  218. <Member MemberName="SubscribeToLogMessage">
  219. <MemberSignature Language="C#" Value="public Urho.Subscription SubscribeToLogMessage (Action&lt;Urho.IO.LogMessageEventArgs&gt; handler);" />
  220. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance class Urho.Subscription SubscribeToLogMessage(class System.Action`1&lt;valuetype Urho.IO.LogMessageEventArgs&gt; handler) cil managed" />
  221. <MemberType>Method</MemberType>
  222. <AssemblyInfo>
  223. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  224. </AssemblyInfo>
  225. <ReturnValue>
  226. <ReturnType>Urho.Subscription</ReturnType>
  227. </ReturnValue>
  228. <Parameters>
  229. <Parameter Name="handler" Type="System.Action&lt;Urho.IO.LogMessageEventArgs&gt;" />
  230. </Parameters>
  231. <Docs>
  232. <param name="handler">The handler to invoke when this event is raised.</param>
  233. <summary>Subscribes to the LogMessage event raised by the Log.</summary>
  234. <returns>Returns an Urho.Subscription that can be used to cancel the subscription.</returns>
  235. <remarks>
  236. <para>This method will override any prior subscription, including those assigned to on event handlers.</para>
  237. <para>This has the advantage that it does a straight connection and returns a handle that is easy to unsubscribe from.</para>
  238. <para>For a more event-like approach, use the <see cref="E:Urho.IO.Log.LogMessage" /> event.</para>
  239. </remarks>
  240. </Docs>
  241. </Member>
  242. <Member MemberName="TimeStamp">
  243. <MemberSignature Language="C#" Value="public bool TimeStamp { get; set; }" />
  244. <MemberSignature Language="ILAsm" Value=".property instance bool TimeStamp" />
  245. <MemberType>Property</MemberType>
  246. <AssemblyInfo>
  247. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  248. </AssemblyInfo>
  249. <ReturnValue>
  250. <ReturnType>System.Boolean</ReturnType>
  251. </ReturnValue>
  252. <Docs>
  253. <summary>
  254. Return whether log messages are timestamped.
  255. Or
  256. Set whether to timestamp log messages.
  257. </summary>
  258. <value>To be added.</value>
  259. <remarks>To be added.</remarks>
  260. </Docs>
  261. </Member>
  262. <Member MemberName="Type">
  263. <MemberSignature Language="C#" Value="public override Urho.StringHash Type { get; }" />
  264. <MemberSignature Language="ILAsm" Value=".property instance valuetype Urho.StringHash Type" />
  265. <MemberType>Property</MemberType>
  266. <AssemblyInfo>
  267. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  268. </AssemblyInfo>
  269. <ReturnValue>
  270. <ReturnType>Urho.StringHash</ReturnType>
  271. </ReturnValue>
  272. <Docs>
  273. <summary>Urho's type system type.</summary>
  274. <value>StringHash representing the type for this C# type.</value>
  275. <remarks>This returns the Urho's type and is surfaced for low-level Urho code.</remarks>
  276. </Docs>
  277. </Member>
  278. <Member MemberName="TypeName">
  279. <MemberSignature Language="C#" Value="public override string TypeName { get; }" />
  280. <MemberSignature Language="ILAsm" Value=".property instance string TypeName" />
  281. <MemberType>Property</MemberType>
  282. <AssemblyInfo>
  283. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  284. </AssemblyInfo>
  285. <ReturnValue>
  286. <ReturnType>System.String</ReturnType>
  287. </ReturnValue>
  288. <Docs>
  289. <summary>Urho's low-level type name.</summary>
  290. <value>Stringified low-level type name.</value>
  291. <remarks></remarks>
  292. </Docs>
  293. </Member>
  294. <Member MemberName="TypeNameStatic">
  295. <MemberSignature Language="C#" Value="public static string TypeNameStatic { get; }" />
  296. <MemberSignature Language="ILAsm" Value=".property string TypeNameStatic" />
  297. <MemberType>Property</MemberType>
  298. <AssemblyInfo>
  299. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  300. </AssemblyInfo>
  301. <ReturnValue>
  302. <ReturnType>System.String</ReturnType>
  303. </ReturnValue>
  304. <Docs>
  305. <summary>Urho's low-level type name, accessible as a static method.</summary>
  306. <value>Stringified low-level type name.</value>
  307. <remarks></remarks>
  308. </Docs>
  309. </Member>
  310. <Member MemberName="TypeStatic">
  311. <MemberSignature Language="C#" Value="public static Urho.StringHash TypeStatic { get; }" />
  312. <MemberSignature Language="ILAsm" Value=".property valuetype Urho.StringHash TypeStatic" />
  313. <MemberType>Property</MemberType>
  314. <AssemblyInfo>
  315. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  316. </AssemblyInfo>
  317. <ReturnValue>
  318. <ReturnType>Urho.StringHash</ReturnType>
  319. </ReturnValue>
  320. <Docs>
  321. <summary>Urho's low-level type, accessible as a static method.</summary>
  322. <value>This returns the Urho's type and is surface for the low-level Urho code.</value>
  323. <remarks></remarks>
  324. </Docs>
  325. </Member>
  326. <Member MemberName="Write">
  327. <MemberSignature Language="C#" Value="public static void Write (Urho.LogLevel level, string message);" />
  328. <MemberSignature Language="ILAsm" Value=".method public static hidebysig void Write(valuetype Urho.LogLevel level, string message) cil managed" />
  329. <MemberType>Method</MemberType>
  330. <AssemblyInfo>
  331. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  332. </AssemblyInfo>
  333. <ReturnValue>
  334. <ReturnType>System.Void</ReturnType>
  335. </ReturnValue>
  336. <Parameters>
  337. <Parameter Name="level" Type="Urho.LogLevel" />
  338. <Parameter Name="message" Type="System.String" />
  339. </Parameters>
  340. <Docs>
  341. <param name="level">To be added.</param>
  342. <param name="message">To be added.</param>
  343. <summary>
  344. Write to the log. If logging level is higher than the level of the message, the message is ignored.
  345. </summary>
  346. <remarks>To be added.</remarks>
  347. </Docs>
  348. </Member>
  349. <Member MemberName="WriteRaw">
  350. <MemberSignature Language="C#" Value="public static void WriteRaw (string message, bool error);" />
  351. <MemberSignature Language="ILAsm" Value=".method public static hidebysig void WriteRaw(string message, bool error) cil managed" />
  352. <MemberType>Method</MemberType>
  353. <AssemblyInfo>
  354. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  355. </AssemblyInfo>
  356. <ReturnValue>
  357. <ReturnType>System.Void</ReturnType>
  358. </ReturnValue>
  359. <Parameters>
  360. <Parameter Name="message" Type="System.String" />
  361. <Parameter Name="error" Type="System.Boolean" />
  362. </Parameters>
  363. <Docs>
  364. <param name="message">To be added.</param>
  365. <param name="error">To be added.</param>
  366. <summary>
  367. Write raw output to the log.
  368. </summary>
  369. <remarks>To be added.</remarks>
  370. </Docs>
  371. </Member>
  372. </Members>
  373. </Type>