This commit is contained in:
2025-12-06 02:38:22 +08:00
parent 9de88d2db0
commit 8e6a52be15
28 changed files with 204 additions and 176 deletions
@@ -87,8 +87,8 @@
<article data-uid="">
<h1 id="message-section-on-main-panel">Message Section on Main Panel</h1>
<h2 id="initialize--with-message-section">Initialize &lt;xref:Hi.Common.Messages.MessageKit&gt;.&lt;xref:Hi.Common.Messages.MessageKit.Default&gt; with Message Section</h2>
<p>To show and save the message on <code>Brief Message Text Field</code>, add event to &lt;xref:Hi.Common.Messages.MessageKit.Default&gt;.&lt;xref:Hi.Common.Messages.MessageKit.OnAdding&gt;.</p>
<h2 id="initialize--with-message-section">Initialize <a class="xref" href="../../../api/Hi.Common.Messages.MessageHost.html">MessageHost</a>.<a class="xref" href="../../../api/Hi.Common.Messages.MessageHost.html#Hi_Common_Messages_MessageHost_Default">Default</a> with Message Section</h2>
<p>To show and save the message on <code>Brief Message Text Field</code>, add event to <a class="xref" href="../../../api/Hi.Common.Messages.MessageHost.html#Hi_Common_Messages_MessageHost_Default">Default</a>.<code>OnAdding</code>.</p>
<p>The event contains:</p>
<ul>
<li>update the text content of <code>Brief Message Text Field</code></li>
@@ -98,7 +98,7 @@
<h5>Tip</h5>
<ul>
<li>Handle the situation that logs over one day.</li>
<li>Check if passing argument of &lt;xref:Hi.Common.Messages.MessageKit.OnAdding&gt; is <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.exception">Exception</a>. If the it is Exception, update text content by <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.exception">Exception</a>.<a class="xref" href="https://learn.microsoft.com/dotnet/api/system.exception.message">Message</a> but log to file with the full Exception information.</li>
<li>Check if passing argument of <code>OnAdding</code> event is <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.exception">Exception</a>. If the it is Exception, update text content by <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.exception.message">Message</a> but log to file with the full Exception information.</li>
<li>Consider <a class="xref" href="../../../api/Hi.Common.Messages.MessageFlag.html">MessageFlag</a> to set the behavior of Message Section. For example, apply alert style if passing argument is exception. The <a class="xref" href="../../../api/Hi.Common.Messages.MessageFlag.html#Hi_Common_Messages_MessageFlag_Info">Info</a> (and the other flags that the priority lower than it) should only record in the logs but not shows in the Message Section.</li>
</ul>
</div>