deploy: 17e64293b5

2026-09-04 16:46:08 +02:00 · 2026-02-22 04:57:18 +00:00
parent fca77ea92f
commit 03bcf194d6
63 changed files with 8871 additions and 743 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><span class="xref">IListDataSource</span></div>
+      <div><a class="xref" href="https://github.com/HueByte/Terminal.Gui/blob/master/Terminal.Gui/Views/ListView/IListDataSource.cs">IListDataSource</a></div>
      <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.idisposable">IDisposable</a></div>
    </dd>
  </dl>
@@ -197,7 +197,8 @@ 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/ChatRenderer.cs"><i class="bi bi-code-slash"></i></a>
  </h3>

-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Gets the number of items in the data source.</p>
+</div>
  <div class="markdown level1 conceptual"></div>

  <div class="codewrapper">
@@ -228,7 +229,8 @@ 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/ChatRenderer.cs"><i class="bi bi-code-slash"></i></a>
  </h3>

-  <div class="markdown level1 summary"></div>
+  <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 conceptual"></div>

  <div class="codewrapper">
@@ -248,6 +250,9 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source



+  <h4 class="section" id="EchoHub_Client_UI_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>



@@ -259,7 +264,8 @@ 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/ChatRenderer.cs"><i class="bi bi-code-slash"></i></a>
  </h3>

-  <div class="markdown level1 summary"></div>
+  <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 conceptual"></div>

  <div class="codewrapper">
@@ -279,6 +285,10 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source



+  <h4 class="section" id="EchoHub_Client_UI_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>



@@ -401,6 +411,42 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source



+  <a id="EchoHub_Client_UI_ChatListSource_GetLine_" data-uid="EchoHub.Client.UI.ChatListSource.GetLine*"></a>
+
+  <h3 id="EchoHub_Client_UI_ChatListSource_GetLine_System_Int32_" data-uid="EchoHub.Client.UI.ChatListSource.GetLine(System.Int32)">
+  GetLine(int)
+  <a class="header-action link-secondary" title="View source" href="https://github.com/HueByte/EchoHub/blob/master/src/EchoHub.Client/UI/ChatRenderer.cs"><i class="bi bi-code-slash"></i></a>
+  </h3>
+
+  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 conceptual"></div>
+
+  <div class="codewrapper">
+    <pre><code class="lang-csharp hljs">public ChatLine? GetLine(int index)</code></pre>
+  </div>
+
+  <h4 class="section">Parameters</h4>
+  <dl class="parameters">
+    <dt><code>index</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
+    <dd></dd>
+  </dl>
+
+  <h4 class="section">Returns</h4>
+  <dl class="parameters">
+    <dt><a class="xref" href="EchoHub.Client.UI.ChatLine.html">ChatLine</a></dt>
+    <dd></dd>
+  </dl>
+
+
+
+
+
+
+
+
+
+
+
  <a id="EchoHub_Client_UI_ChatListSource_InsertRange_" data-uid="EchoHub.Client.UI.ChatListSource.InsertRange*"></a>

  <h3 id="EchoHub_Client_UI_ChatListSource_InsertRange_System_Int32_System_Collections_Generic_IEnumerable_EchoHub_Client_UI_ChatLine__" data-uid="EchoHub.Client.UI.ChatListSource.InsertRange(System.Int32,System.Collections.Generic.IEnumerable{EchoHub.Client.UI.ChatLine})">
@@ -441,7 +487,8 @@ 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/ChatRenderer.cs"><i class="bi bi-code-slash"></i></a>
  </h3>

-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Determines whether the specified item is marked.</p>
+</div>
  <div class="markdown level1 conceptual"></div>

  <div class="codewrapper">
@@ -451,13 +498,15 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source
  <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></dd>
+    <dd><p>The zero-based index of the item.</p>
+</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></dd>
+    <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>
  </dl>


@@ -466,6 +515,10 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source



+  <h4 class="section" id="EchoHub_Client_UI_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>



@@ -477,7 +530,8 @@ 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/ChatRenderer.cs"><i class="bi bi-code-slash"></i></a>
  </h3>

-  <div class="markdown level1 summary"></div>
+  <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 conceptual"></div>

  <div class="codewrapper">
@@ -486,20 +540,27 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source

  <h4 class="section">Parameters</h4>
  <dl class="parameters">
-    <dt><code>listView</code> <span class="xref">ListView</span></dt>
-    <dd></dd>
+    <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>selected</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.boolean">bool</a></dt>
-    <dd></dd>
+    <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>
    <dt><code>item</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
-    <dd></dd>
+    <dd><p>The zero-based index of the item to render.</p>
+</dd>
    <dt><code>col</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
-    <dd></dd>
+    <dd><p>The column in <code class="paramref">listView</code> Viewport where rendering starts.</p>
+</dd>
    <dt><code>row</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
-    <dd></dd>
+    <dd><p>The row in <code class="paramref">listView</code> Viewport where rendering starts.</p>
+</dd>
    <dt><code>width</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
-    <dd></dd>
+    <dd><p>The width available for rendering.</p>
+</dd>
    <dt><code>viewportX</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
-    <dd></dd>
+    <dd><p>The horizontal scroll offset.</p>
+</dd>
  </dl>


@@ -509,6 +570,15 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source



+  <h4 class="section" id="EchoHub_Client_UI_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>



@@ -520,7 +590,8 @@ 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/ChatRenderer.cs"><i class="bi bi-code-slash"></i></a>
  </h3>

-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Sets the marked state of the specified item.</p>
+</div>
  <div class="markdown level1 conceptual"></div>

  <div class="codewrapper">
@@ -530,9 +601,11 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source
  <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></dd>
+    <dd><p>The zero-based index of the item.</p>
+</dd>
    <dt><code>value</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.boolean">bool</a></dt>
-    <dd></dd>
+    <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>
  </dl>


@@ -542,6 +615,10 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source



+  <h4 class="section" id="EchoHub_Client_UI_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>



@@ -553,7 +630,8 @@ 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/ChatRenderer.cs"><i class="bi bi-code-slash"></i></a>
  </h3>

-  <div class="markdown level1 summary"></div>
+  <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 conceptual"></div>

  <div class="codewrapper">
@@ -564,7 +642,8 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source
  <h4 class="section">Returns</h4>
  <dl class="parameters">
    <dt><span class="xref">IList</span></dt>
-    <dd></dd>
+    <dd><p>The data source as an <span class="xref">System.Collections.IList</span>.</p>
+</dd>
  </dl>


@@ -573,6 +652,11 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source



+  <h4 class="section" id="EchoHub_Client_UI_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>



@@ -587,7 +671,8 @@ 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/ChatRenderer.cs"><i class="bi bi-code-slash"></i></a>
  </h3>

-  <div class="markdown level1 summary"></div>
+  <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 conceptual"></div>

  <div class="codewrapper">
@@ -607,6 +692,11 @@ Class ChatListSource  <a class="header-action link-secondary" title="View source



+  <h4 class="section" id="EchoHub_Client_UI_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>