<?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=DCheckList</id>
	<title>DCheckList - 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=DCheckList"/>
	<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=DCheckList&amp;action=history"/>
	<updated>2026-11-21T17:16:51Z</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=DCheckList&amp;diff=4088&amp;oldid=prev</id>
		<title>Ed: Created page with &quot;dCheckList is a variation of a dListBox that allows you to select/deselect items by means of a checkbox on each row.  ----  Some of the more useful properties for dCheckLi...&quot;</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=DCheckList&amp;diff=4088&amp;oldid=prev"/>
		<updated>2020-05-12T16:11:03Z</updated>

		<summary type="html">&lt;p&gt;Created page with &amp;quot;dCheckList is a variation of a &lt;a href=&quot;/index.php?title=DListBox&quot; title=&quot;DListBox&quot;&gt;dListBox&lt;/a&gt; that allows you to select/deselect items by means of a checkbox on each row.  ----  Some of the more useful properties for dCheckLi...&amp;quot;&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;dCheckList is a variation of a [[dListBox]] that allows you to select/deselect items by means of a checkbox on each row.&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
Some of the more useful properties for dCheckList:&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;MultipleSelect&amp;#039;&amp;#039;&amp;#039; - (bool): When &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;, the user can select multiple items at once. When &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;, selection is limited to a single item.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Choices&amp;#039;&amp;#039;&amp;#039; (list): This determines the options available for the control. You can only get/set this, not append.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Keys&amp;#039;&amp;#039;&amp;#039; (dict / list / tuple): Value that is associated with the &amp;lt;code&amp;gt;Choices&amp;lt;/code&amp;gt;. Many times you want to present the user with a list of choices that mean something to them, but internally in your program, you really need the ID or primary key or some other identifying value that is associated with the choice that the user made. The easiest way to set up the &amp;lt;code&amp;gt;Keys&amp;lt;/code&amp;gt; property is to make it a 1:1 list of values that correspond position-wise to the &amp;lt;code&amp;gt;Choices&amp;lt;/code&amp;gt; list. This way, when the user selects, say, the third choice in the list, &amp;lt;code&amp;gt;KeyValue&amp;lt;/code&amp;gt; will return the third value in the Keys list.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;StringValue&amp;#039;&amp;#039;&amp;#039; (str): Returns the text displayed by the control for the selected item.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;PositionValue&amp;#039;&amp;#039;&amp;#039; (int): Returns the position of the selected item in the list of available &amp;lt;code&amp;gt;Choices&amp;lt;/code&amp;gt;.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;KeyValue&amp;#039;&amp;#039;&amp;#039; (varies): Returns the value in &amp;lt;code&amp;gt;Keys&amp;lt;/code&amp;gt; that corresponds to the selected item.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;ValueMode&amp;#039;&amp;#039;&amp;#039; (str): Can be one of &amp;lt;code&amp;gt;String&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Position&amp;lt;/code&amp;gt;, or &amp;lt;code&amp;gt;Key&amp;lt;/code&amp;gt;. Determines the result returned by accessing the &amp;lt;code&amp;gt;Value&amp;lt;/code&amp;gt; property: either &amp;lt;code&amp;gt;StringValue&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;PositionValue&amp;lt;/code&amp;gt; or &amp;lt;code&amp;gt;KeyValue&amp;lt;/code&amp;gt;. You can always refer to any of those different value types, but when you know which value your program will be needing, you can set &amp;lt;code&amp;gt;ValueMode&amp;lt;/code&amp;gt;, and afterwards just have the normal &amp;lt;code&amp;gt;Value&amp;lt;/code&amp;gt; binding work correctly.&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
Some of the more useful methods for dCheckList:&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;selectAll()&amp;#039;&amp;#039;&amp;#039; - (None): Sets all of the items to be marked as selected.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;selectNone()&amp;#039;&amp;#039;&amp;#039; and &amp;#039;&amp;#039;&amp;#039;clearSelections()&amp;#039;&amp;#039;&amp;#039; - (None): Sets all of the items to be marked as not selected. Both method names refer to the same method; they are included for naming consistency across classes.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;invertSelections()&amp;#039;&amp;#039;&amp;#039; - (None): Reverses the selection state for all items in the list.&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>