Log.xml 16 KB

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