<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://wiki.dabo.leafe.com/index.php?action=history&amp;feed=atom&amp;title=DListControl</id>
	<title>DListControl - Revision history</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.dabo.leafe.com/index.php?action=history&amp;feed=atom&amp;title=DListControl"/>
	<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=DListControl&amp;action=history"/>
	<updated>2026-11-21T17:44:17Z</updated>
	<subtitle>Revision history for this page on the wiki</subtitle>
	<generator>MediaWiki 1.39.12</generator>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=DListControl&amp;diff=4089&amp;oldid=prev</id>
		<title>Ed: Created page with &quot;&#039;&#039;&#039;dListControl&#039;&#039;&#039; is sort of a cross between a grid and a list box. It&#039;s like a grid in that you can display rows and columns of data, but like a list box in that you can onl...&quot;</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=DListControl&amp;diff=4089&amp;oldid=prev"/>
		<updated>2020-05-12T16:17:54Z</updated>

		<summary type="html">&lt;p&gt;Created page with &amp;quot;&amp;#039;&amp;#039;&amp;#039;dListControl&amp;#039;&amp;#039;&amp;#039; is sort of a cross between a grid and a list box. It&amp;#039;s like a grid in that you can display rows and columns of data, but like a list box in that you can onl...&amp;quot;&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;&amp;#039;&amp;#039;&amp;#039;dListControl&amp;#039;&amp;#039;&amp;#039; is sort of a cross between a grid and a list box. It&amp;#039;s like a grid in that you can display rows and columns of data, but like a list box in that you can only select a row at a time, not individual cells.&lt;br /&gt;
&lt;br /&gt;
To populate a &amp;lt;code&amp;gt;dListControl&amp;lt;/code&amp;gt;, you must first set its column structure, and then append the rows of data you want. There is currently no way to change the caption of a column once it has been created, so specify the column caption in any of these methods:&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;addColumn(caption)&amp;#039;&amp;#039;&amp;#039;: appends a column to the end of the existing columns&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;insertColumn(position, caption)&amp;#039;&amp;#039;&amp;#039;: adds a column in specified position&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;setColumns(captionList)&amp;#039;&amp;#039;&amp;#039;: clears out any existing columns, and creates new ones with the specified list/tuple of captions.&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
Data is then added to the control by calling one of the following:&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;append(val, col=0)&amp;#039;&amp;#039;&amp;#039;: creates a new row with val in the specified column. If &amp;lt;code&amp;gt;val&amp;lt;/code&amp;gt; is a list/tuple, the values will be set in the columns starting with the passed value of &amp;lt;code&amp;gt;col&amp;lt;/code&amp;gt;. If either case results in an attempt to add to a column beyond those that have already been created, no error will be raised, but the value will be ignored.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;appendRows(val, col=0)&amp;#039;&amp;#039;&amp;#039;: just like &amp;lt;code&amp;gt;append()&amp;lt;/code&amp;gt;, but &amp;lt;code&amp;gt;val&amp;lt;/code&amp;gt; should be a list/tuple of row elements. It is equivalent to calling &amp;lt;code&amp;gt;append()&amp;lt;/code&amp;gt; once for each element in &amp;lt;code&amp;gt;val&amp;lt;/code&amp;gt;.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;insert(val, row=0, col=0)&amp;#039;&amp;#039;&amp;#039; and &amp;#039;&amp;#039;&amp;#039;insertRows(val, row=0, col=0)&amp;#039;&amp;#039;&amp;#039;: analogous to the append methods, except you can specify the row to use for the data.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;removeRow(rownum)&amp;#039;&amp;#039;&amp;#039;: removes the specified row.&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
Some of the more useful properties:&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;ValueColumn&amp;#039;&amp;#039;&amp;#039; - (int): This determines which column in a multi-column list is returned when the &amp;lt;code&amp;gt;Value&amp;lt;/code&amp;gt; property is accessed. Default=&amp;lt;code&amp;gt;0&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Value&amp;#039;&amp;#039;&amp;#039; - (str / list of str): Returns the text in the selected row that is in the column specified by &amp;lt;code&amp;gt;ValueColumn&amp;lt;/code&amp;gt;. If &amp;lt;code&amp;gt;MultipleSelect&amp;lt;/code&amp;gt; is &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;, it returns a list containing the value for each selected row.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;ColumnCount&amp;#039;&amp;#039;&amp;#039; - (int): Number of columns in the control.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;RowCount&amp;#039;&amp;#039;&amp;#039; - (int): Number of rows in the control. There is also a &amp;lt;code&amp;gt;Count&amp;lt;/code&amp;gt; property; it&amp;#039;s just an alias for &amp;lt;code&amp;gt;RowCount&amp;lt;/code&amp;gt;.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;HeaderVisible&amp;#039;&amp;#039;&amp;#039; - (bool): Determines if the column headers are shown. Default=&amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;HorizontalRules,&amp;#039;&amp;#039;&amp;#039; &amp;#039;&amp;#039;&amp;#039;VerticalRules&amp;#039;&amp;#039;&amp;#039; (bool): Determine if the gridlines are shown in the respective directions.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;MultipleSelect&amp;#039;&amp;#039;&amp;#039; - (bool): When True, the user can select multiple rows.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;SelectedIndices&amp;#039;&amp;#039;&amp;#039; - (list of int): Returns a list containing the row numbers that are currently selected.&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
See the [https://web.archive.org/web/20110909131047/http://paul.dabodev.com/doc/api/dabodoc/ Dabo Class Documentation] for an exhaustive documentation of this control&amp;#039;s Properties, Events and Methods. (Note that this documentation is no longer live, but it&amp;#039;s still available via the Internet Archive).&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
</feed>