This commit is contained in:
HueByte
2026-02-22 15:32:40 +00:00
parent bacd2a3fd5
commit bd22be4181
25 changed files with 471 additions and 498 deletions
@@ -119,7 +119,7 @@ Class ChatListSource <a class="header-action link-secondary" title="View source
<dl class="typelist implements">
<dt>Implements</dt>
<dd>
<div><a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/IListDataSource.cs">IListDataSource</a></div>
<div><span class="xref">IListDataSource</span></div>
<div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.idisposable">IDisposable</a></div>
</dd>
</dl>
@@ -197,8 +197,7 @@ Class ChatListSource <a class="header-action link-secondary" title="View source
<a class="header-action link-secondary" title="View source" href="https://github.com/HueByte/EchoHub/blob/master/src/EchoHub.Client/UI/Chat/ChatListSource.cs"><i class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Gets the number of items in the data source.</p>
</div>
<div class="markdown level1 summary"></div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
@@ -229,8 +228,7 @@ Class ChatListSource <a class="header-action link-secondary" title="View source
<a class="header-action link-secondary" title="View source" href="https://github.com/HueByte/EchoHub/blob/master/src/EchoHub.Client/UI/Chat/ChatListSource.cs"><i class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Gets the width in columns of the widest item in the data source.</p>
</div>
<div class="markdown level1 summary"></div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
@@ -250,9 +248,6 @@ Class ChatListSource <a class="header-action link-secondary" title="View source
<h4 class="section" id="EchoHub_Client_UI_Chat_ChatListSource_MaxItemLength_remarks">Remarks</h4>
<div class="markdown level1 remarks"><p><a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Commands.cs">ListView</a> uses this value to set its horizontal content size for scrolling.</p>
</div>
@@ -264,8 +259,7 @@ Class ChatListSource <a class="header-action link-secondary" title="View source
<a class="header-action link-secondary" title="View source" href="https://github.com/HueByte/EchoHub/blob/master/src/EchoHub.Client/UI/Chat/ChatListSource.cs"><i class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Gets or sets whether the <a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/IListDataSource.cs">CollectionChanged</a> event should be suppressed.</p>
</div>
<div class="markdown level1 summary"></div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
@@ -285,10 +279,6 @@ Class ChatListSource <a class="header-action link-secondary" title="View source
<h4 class="section" id="EchoHub_Client_UI_Chat_ChatListSource_SuspendCollectionChangedEvent_remarks">Remarks</h4>
<div class="markdown level1 remarks"><p>Set to <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">true</a> to prevent <a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/IListDataSource.cs">CollectionChanged</a> from being raised during bulk
operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">false</a> to resume event notifications.</p>
</div>
@@ -487,8 +477,7 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<a class="header-action link-secondary" title="View source" href="https://github.com/HueByte/EchoHub/blob/master/src/EchoHub.Client/UI/Chat/ChatListSource.cs"><i class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Determines whether the specified item is marked.</p>
</div>
<div class="markdown level1 summary"></div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
@@ -498,15 +487,13 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<h4 class="section">Parameters</h4>
<dl class="parameters">
<dt><code>item</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
<dd><p>The zero-based index of the item.</p>
</dd>
<dd></dd>
</dl>
<h4 class="section">Returns</h4>
<dl class="parameters">
<dt><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.boolean">bool</a></dt>
<dd><p><a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">true</a> if the item is marked; otherwise <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">false</a>.</p>
</dd>
<dd></dd>
</dl>
@@ -515,10 +502,6 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<h4 class="section" id="EchoHub_Client_UI_Chat_ChatListSource_IsMarked_System_Int32__remarks">Remarks</h4>
<div class="markdown level1 remarks"><p><a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Commands.cs">ListView</a> calls this method to determine whether to render the item with a mark indicator when
<a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Selection.cs">ShowMarks</a> is <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">true</a>.</p>
</div>
@@ -530,8 +513,7 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<a class="header-action link-secondary" title="View source" href="https://github.com/HueByte/EchoHub/blob/master/src/EchoHub.Client/UI/Chat/ChatListSource.cs"><i class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Renders the specified item to the <a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Commands.cs">ListView</a>.</p>
</div>
<div class="markdown level1 summary"></div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
@@ -540,27 +522,20 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<h4 class="section">Parameters</h4>
<dl class="parameters">
<dt><code>listView</code> <a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Commands.cs">ListView</a></dt>
<dd><p>The <a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Commands.cs">ListView</a> to render to.</p>
</dd>
<dt><code>listView</code> <span class="xref">ListView</span></dt>
<dd></dd>
<dt><code>selected</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.boolean">bool</a></dt>
<dd><p><a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">true</a> if the item is currently selected; otherwise <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">false</a>.</p>
</dd>
<dd></dd>
<dt><code>item</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
<dd><p>The zero-based index of the item to render.</p>
</dd>
<dd></dd>
<dt><code>col</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
<dd><p>The column in <code class="paramref">listView</code> Viewport where rendering starts.</p>
</dd>
<dd></dd>
<dt><code>row</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
<dd><p>The row in <code class="paramref">listView</code> Viewport where rendering starts.</p>
</dd>
<dd></dd>
<dt><code>width</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
<dd><p>The width available for rendering.</p>
</dd>
<dd></dd>
<dt><code>viewportX</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
<dd><p>The horizontal scroll offset.</p>
</dd>
<dd></dd>
</dl>
@@ -570,15 +545,6 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<h4 class="section" id="EchoHub_Client_UI_Chat_ChatListSource_Render_Terminal_Gui_Views_ListView_System_Boolean_System_Int32_System_Int32_System_Int32_System_Int32_System_Int32__remarks">Remarks</h4>
<div class="markdown level1 remarks"><p>
<a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Commands.cs">ListView</a> calls this method for each visible item during rendering. The color scheme will be
set based on selection state before this method is called.
</p>
<p>
Implementations must fill the entire <code class="paramref">width</code> to avoid rendering artifacts.
</p>
</div>
@@ -590,8 +556,7 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<a class="header-action link-secondary" title="View source" href="https://github.com/HueByte/EchoHub/blob/master/src/EchoHub.Client/UI/Chat/ChatListSource.cs"><i class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Sets the marked state of the specified item.</p>
</div>
<div class="markdown level1 summary"></div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
@@ -601,11 +566,9 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<h4 class="section">Parameters</h4>
<dl class="parameters">
<dt><code>item</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
<dd><p>The zero-based index of the item.</p>
</dd>
<dd></dd>
<dt><code>value</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.boolean">bool</a></dt>
<dd><p><a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">true</a> to mark the item; <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">false</a> to unmark it.</p>
</dd>
<dd></dd>
</dl>
@@ -615,10 +578,6 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<h4 class="section" id="EchoHub_Client_UI_Chat_ChatListSource_SetMark_System_Int32_System_Boolean__remarks">Remarks</h4>
<div class="markdown level1 remarks"><p><a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Commands.cs">ListView</a> calls this method when the user toggles marking (e.g., via the SPACE key) if
<a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Selection.cs">ShowMarks</a> is <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">true</a>.</p>
</div>
@@ -630,8 +589,7 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<a class="header-action link-secondary" title="View source" href="https://github.com/HueByte/EchoHub/blob/master/src/EchoHub.Client/UI/Chat/ChatListSource.cs"><i class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Returns the underlying data source as an <span class="xref">System.Collections.IList</span>.</p>
</div>
<div class="markdown level1 summary"></div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
@@ -642,8 +600,7 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<h4 class="section">Returns</h4>
<dl class="parameters">
<dt><span class="xref">IList</span></dt>
<dd><p>The data source as an <span class="xref">System.Collections.IList</span>.</p>
</dd>
<dd></dd>
</dl>
@@ -652,11 +609,6 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<h4 class="section" id="EchoHub_Client_UI_Chat_ChatListSource_ToList_remarks">Remarks</h4>
<div class="markdown level1 remarks"><p><a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Commands.cs">ListView</a> uses this method to access individual items for events like
<a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Commands.cs">ValueChanged</a> and to enable keyboard search via
<a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.cs">KeystrokeNavigator</a>.</p>
</div>
@@ -671,8 +623,7 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<a class="header-action link-secondary" title="View source" href="https://github.com/HueByte/EchoHub/blob/master/src/EchoHub.Client/UI/Chat/ChatListSource.cs"><i class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Raised when items are added, removed, moved, or the entire collection is refreshed.</p>
</div>
<div class="markdown level1 summary"></div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
@@ -692,11 +643,6 @@ operations. Set back to <a href="https://learn.microsoft.com/dotnet/csharp/langu
<h4 class="section" id="EchoHub_Client_UI_Chat_ChatListSource_CollectionChanged_remarks">Remarks</h4>
<div class="markdown level1 remarks"><p><a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/ListView.Commands.cs">ListView</a> subscribes to this event to update its display and content size when the data
changes. Implementations should raise this event whenever the underlying collection changes, unless
<a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/IListDataSource.cs">SuspendCollectionChangedEvent</a> is <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">true</a>.</p>
</div>