<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://wiki.dabo.leafe.com/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Ed</id>
	<title>Dabo Wiki - User contributions [en]</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.dabo.leafe.com/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Ed"/>
	<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Special:Contributions/Ed"/>
	<updated>2026-11-21T10:13:49Z</updated>
	<subtitle>User contributions</subtitle>
	<generator>MediaWiki 1.39.12</generator>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Settings.py&amp;diff=4198</id>
		<title>Settings.py</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Settings.py&amp;diff=4198"/>
		<updated>2020-05-17T16:16:45Z</updated>

		<summary type="html">&lt;p&gt;Ed: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== What it is ==&lt;br /&gt;
&lt;br /&gt;
There is a file in the main directory of the dabo module named &amp;lt;code&amp;gt;settings.py&amp;lt;/code&amp;gt;; it contains many settings that control the behavior of the framework. It should never be modified; instead, if a setting needs to be changed, create a &amp;lt;code&amp;gt;settings_override.py&amp;lt;/code&amp;gt; file and make your changes there.&lt;br /&gt;
&lt;br /&gt;
== The Most Common Settings ==&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;allNativeEventInfo&#039;&#039;&#039;: Only needed if you are are developing UI wrappings for the framework. Never needed in application development. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;autoBindEvents&#039;&#039;&#039;: Dabo will automatically detect methods whose names begin with the letters &amp;lt;code&amp;gt;on&amp;lt;/code&amp;gt;, followed by the name of an event class, and if found, will automatically bind that method to the event. Example: if your class has a method named &amp;lt;code&amp;gt;onHit()&amp;lt;/code&amp;gt;, Dabo will assume that it is an event handler for the &amp;lt;code&amp;gt;Hit&amp;lt;/code&amp;gt; method, and bind that method to &amp;lt;code&amp;gt;Hit&amp;lt;/code&amp;gt; events. While this is desireable behavior most of the time, you may occasionally need to turn it off if you need (or want) more explicit control. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;checkForWebUpdates&#039;&#039;&#039;: If you have the general Dabo package installed (i.e., not from Subversion), Dabo will regularly check for updates and ask if you want any updates installed. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;createDbFiles&#039;&#039;&#039;: When using [[SQLite]], if you create a connection to a file that does not exist, Dabo will raise an error. You can override that behavior by changing this setting to True. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;cryptoKeyDES&#039;&#039;&#039;: If you are using the [[PyCrypto]] package for creating encrypted ciphers, you need to set this to a string that will be used to encrypt and decrypt the cipher values. If you do use this, keep this value confidential, or anyone could potentially decrypt your ciphertext passwords. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;custom_extensions&#039;&#039;&#039;: Dabo defines several file types and common descriptions. If you want to add additional values for custom file types your app needs, define them in this dictionary, with the extension as the key and the desciption as the value. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;{}&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;dateFormat&#039;&#039;&#039;: Custom format for date values. If set to &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;, the current locale settings will be used. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;dateTimeFormat&#039;&#039;&#039;: Custom format for datetime values. If set to &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;, the current locale settings will be used. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;defaultEncoding&#039;&#039;&#039;: When non-ASCII values are encountered, this determines what encoding shall be used to store values where strings are needed. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;&amp;quot;utf-8&amp;quot;&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;defaultFontSize&#039;&#039;&#039;: A common base for displayed fonts. If you need a larger/smaller font size across the board, set it here. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;10&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;defaultLanguage&#039;&#039;&#039;: Used in the localization code. Change this if you work in something other than English. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;&amp;quot;en&amp;quot;&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;firstDayOfWeek&#039;&#039;&#039;: When showing calendars, this controls the day of week displayed in the leftmost column. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;&amp;quot;Sunday&amp;quot;&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;loadUserLocale&#039;&#039;&#039;: Normally &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt; should work fine, but if you have custom locale needs that you want to handle explicitly, set this to &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;MDI&#039;&#039;&#039;: &amp;lt;code&amp;gt;Multiple Document Interface&amp;lt;/code&amp;gt;; common in Windows, in which multiple child documents are displayed within a single parent frame. If you want this behavior, change this to &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;timeFormat&#039;&#039;&#039;: Custom format for time values. If set to &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;, the current locale settings will be used. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;verboseLogging&#039;&#039;&#039;: Dabo logs many messages, but only those for the error log display. If you set &amp;lt;code&amp;gt;verboseLogging&amp;lt;/code&amp;gt; to &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;, though, you will get all the info level messages too. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Rarely-used Settings ==&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;allNativeEventInfo&#039;&#039;&#039;: Only needed if you are are developing UI wrappings for the framework. Never needed in application development. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;eatBizExceptions&#039;&#039;&#039;: If you need to override the default behavior of having the form class handle business object exceptions, change this to &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;eventLogging&#039;&#039;&#039;: Used to turn on global event logging. You also need to set the [[LogEvents]] property of the object in question to a list of the string name of the events you wish to log. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;fastNameSet&#039;&#039;&#039;: Objects in a UI should have unique names. Dabo has code to check the name of each object, and if not explicitly set, adds an integer suffix to guarantee uniquess. However, in complex UIs with many objects, this can add substantial overhead. If you can guarantee that your code will result in unique names, set this to True, and the framework will not check for uniqueness, speeding up instantiation. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;loggitFile&#039;&#039;&#039;: Dabo has a @loggit decorator that records function calls to any method with this decorator. You can control the log location with this setting. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;&amp;quot;functionCall.log&amp;quot;&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;macFontScaling&#039;&#039;&#039;: Font sizes that look correct in Windows and Linux look very small on Mac. Dabo handles that by automatically scaling your fonts bigger when run on a Mac, but if you don&#039;t want this behavior, set this to &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;webupdate_urlbase&#039;&#039;&#039;: The URL used for the web update server. This should never change, and if it does, the new URL will have to be included in the previous update. &#039;&#039;&#039;Default&#039;&#039;&#039;: &amp;lt;code&amp;gt;&amp;quot;http://daboserver.com/webupdate&amp;quot;&amp;lt;/code&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Settings.py&amp;diff=4197</id>
		<title>Settings.py</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Settings.py&amp;diff=4197"/>
		<updated>2020-05-17T16:15:45Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== What it is ==  There is a file in the main directory of the dabo module named &amp;lt;code&amp;gt;settings.py&amp;lt;/code&amp;gt;; it contains many settings that control the behavior of the framework...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== What it is ==&lt;br /&gt;
&lt;br /&gt;
There is a file in the main directory of the dabo module named &amp;lt;code&amp;gt;settings.py&amp;lt;/code&amp;gt;; it contains many settings that control the behavior of the framework. It should never be modified; instead, if a setting needs to be changed, create a &amp;lt;code&amp;gt;settings_override.py&amp;lt;/code&amp;gt; file and make your changes there.&lt;br /&gt;
&lt;br /&gt;
== The Most Common Settings ==&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;allNativeEventInfo&#039;&#039;&#039;: Only needed if you are are developing UI wrappings for the framework. Never needed in application development. Default: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;autoBindEvents&#039;&#039;&#039;: Dabo will automatically detect methods whose names begin with the letters &amp;lt;code&amp;gt;on&amp;lt;/code&amp;gt;, followed by the name of an event class, and if found, will automatically bind that method to the event. Example: if your class has a method named &amp;lt;code&amp;gt;onHit()&amp;lt;/code&amp;gt;, Dabo will assume that it is an event handler for the &amp;lt;code&amp;gt;Hit&amp;lt;/code&amp;gt; method, and bind that method to &amp;lt;code&amp;gt;Hit&amp;lt;/code&amp;gt; events. While this is desireable behavior most of the time, you may occasionally need to turn it off if you need (or want) more explicit control. Default: &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;checkForWebUpdates&#039;&#039;&#039;: If you have the general Dabo package installed (i.e., not from Subversion), Dabo will regularly check for updates and ask if you want any updates installed. Default: &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;createDbFiles&#039;&#039;&#039;: When using [[SQLite]], if you create a connection to a file that does not exist, Dabo will raise an error. You can override that behavior by changing this setting to True. Default: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;cryptoKeyDES&#039;&#039;&#039;: If you are using the [[PyCrypto]] package for creating encrypted ciphers, you need to set this to a string that will be used to encrypt and decrypt the cipher values. If you do use this, keep this value confidential, or anyone could potentially decrypt your ciphertext passwords. Default: &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;custom_extensions&#039;&#039;&#039;: Dabo defines several file types and common descriptions. If you want to add additional values for custom file types your app needs, define them in this dictionary, with the extension as the key and the desciption as the value. Default: &amp;lt;code&amp;gt;{}&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;dateFormat&#039;&#039;&#039;: Custom format for date values. If set to &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;, the current locale settings will be used. Default: &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;dateTimeFormat&#039;&#039;&#039;: Custom format for datetime values. If set to &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;, the current locale settings will be used. Default: &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;defaultEncoding&#039;&#039;&#039;: When non-ASCII values are encountered, this determines what encoding shall be used to store values where strings are needed. Default: &amp;lt;code&amp;gt;&amp;quot;utf-8&amp;quot;&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;defaultFontSize&#039;&#039;&#039;: A common base for displayed fonts. If you need a larger/smaller font size across the board, set it here. Default: &amp;lt;code&amp;gt;10&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;defaultLanguage&#039;&#039;&#039;: Used in the localization code. Change this if you work in something other than English. Default: &amp;lt;code&amp;gt;&amp;quot;en&amp;quot;&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;firstDayOfWeek&#039;&#039;&#039;: When showing calendars, this controls the day of week displayed in the leftmost column. Default: &amp;lt;code&amp;gt;&amp;quot;Sunday&amp;quot;&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;loadUserLocale&#039;&#039;&#039;: Normally &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt; should work fine, but if you have custom locale needs that you want to handle explicitly, set this to &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;. Default: &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;MDI&#039;&#039;&#039;: &amp;lt;code&amp;gt;Multiple Document Interface&amp;lt;/code&amp;gt;; common in Windows, in which multiple child documents are displayed within a single parent frame. If you want this behavior, change this to &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;. Default: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;timeFormat&#039;&#039;&#039;: Custom format for time values. If set to &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;, the current locale settings will be used. Default: &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;verboseLogging&#039;&#039;&#039;: Dabo logs many messages, but only those for the error log display. If you set &amp;lt;code&amp;gt;verboseLogging&amp;lt;/code&amp;gt; to &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;, though, you will get all the info level messages too. Default: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Rarely-used Settings ==&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;allNativeEventInfo&#039;&#039;&#039;: Only needed if you are are developing UI wrappings for the framework. Never needed in application development. Default: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;eatBizExceptions&#039;&#039;&#039;: If you need to override the default behavior of having the form class handle business object exceptions, change this to &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;. Default: &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;eventLogging&#039;&#039;&#039;: Used to turn on global event logging. You also need to set the [[LogEvents]] property of the object in question to a list of the string name of the events you wish to log. Default: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;fastNameSet&#039;&#039;&#039;: Objects in a UI should have unique names. Dabo has code to check the name of each object, and if not explicitly set, adds an integer suffix to guarantee uniquess. However, in complex UIs with many objects, this can add substantial overhead. If you can guarantee that your code will result in unique names, set this to True, and the framework will not check for uniqueness, speeding up instantiation. Default: &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;loggitFile&#039;&#039;&#039;: Dabo has a @loggit decorator that records function calls to any method with this decorator. You can control the log location with this setting. Default: &amp;lt;code&amp;gt;&amp;quot;functionCall.log&amp;quot;&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;macFontScaling&#039;&#039;&#039;: Font sizes that look correct in Windows and Linux look very small on Mac. Dabo handles that by automatically scaling your fonts bigger when run on a Mac, but if you don&#039;t want this behavior, set this to &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt;. Default: &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;&lt;br /&gt;
: &#039;&#039;&#039;webupdate_urlbase&#039;&#039;&#039;: The URL used for the web update server. This should never change, and if it does, the new URL will have to be included in the previous update. Default: &amp;lt;code&amp;gt;&amp;quot;http://daboserver.com/webupdate&amp;quot;&amp;lt;/code&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Settings_override.py&amp;diff=4196</id>
		<title>Settings override.py</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Settings_override.py&amp;diff=4196"/>
		<updated>2020-05-17T15:57:19Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;Dabo has several settings that are imported to the main dabo module&amp;#039;s namespace; these are configured in the &amp;lt;code&amp;gt;settings.py&amp;lt;/code&amp;gt; file in the main dabo module directory....&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Dabo has several settings that are imported to the main dabo module&#039;s namespace; these are configured in the &amp;lt;code&amp;gt;settings.py&amp;lt;/code&amp;gt; file in the main dabo module directory.&lt;br /&gt;
&lt;br /&gt;
This file should not be modified; however, you may need to change some of the settings to match your needs. To do that, create a file named &amp;lt;code&amp;gt;&#039;&#039;&#039;settings_override.py&#039;&#039;&#039;&amp;lt;/code&amp;gt; in your application&#039;s main directory (or anywhere in &amp;lt;code&amp;gt;sys.path&amp;lt;/code&amp;gt;). Dabo will try to import this file during startup, and any settings in this file can override the defaults in the main &amp;lt;code&amp;gt;settings.py&amp;lt;/code&amp;gt; file.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=PyCrypto&amp;diff=4195</id>
		<title>PyCrypto</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=PyCrypto&amp;diff=4195"/>
		<updated>2020-05-17T15:56:04Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;A common name for the &amp;#039;&amp;#039;&amp;#039;Python Cryptography Toolkit&amp;#039;&amp;#039;&amp;#039;, available at https://www.dlitz.net/software/pycrypto/&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;A common name for the &#039;&#039;&#039;Python Cryptography Toolkit&#039;&#039;&#039;, available at https://www.dlitz.net/software/pycrypto/&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=SempliceCriptazione_(SimpleCrypt)&amp;diff=4194</id>
		<title>SempliceCriptazione (SimpleCrypt)</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=SempliceCriptazione_(SimpleCrypt)&amp;diff=4194"/>
		<updated>2020-05-17T15:54:45Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;SimpleCrypt che ho tradotto in &amp;#039;&amp;#039;&amp;#039;Semplice Criptazione&amp;#039;&amp;#039;&amp;#039; e&amp;#039; un grazioso tool (attrezzo),come il nome vuol significare, per criptare e decriptare parole, password, file e...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[SimpleCrypt]] che ho tradotto in &#039;&#039;&#039;Semplice Criptazione&#039;&#039;&#039; e&#039; un grazioso tool (attrezzo),come il nome vuol significare, per criptare e decriptare parole, password, file e quant&#039;altro. Viene incluso in Dabo, ed e&#039; il tool che viene utilizzato per criptare e decriptare le password memorizzate nel file delle connessioni.&lt;br /&gt;
E&#039; utilissimo per testare e sviluppare,ma &amp;lt;span style=&amp;quot;font-weight: bold; color: red;&amp;quot;&amp;gt;NON USATELO IN AMBIENTE DI PRODUZIONE&amp;lt;/span&amp;gt;. Due sono i motivi principali:&lt;br /&gt;
&lt;br /&gt;
# Chiunque puo&#039; decriptare la vostra password se possiede Dabo&lt;br /&gt;
# Attenzione non c&#039;e&#039; compatibilita&#039; tra criptazione eseguita con Python a 32 bit e decriptazione eseguita con Python a 64 bit e viceversa. A tal proposito vedasi http://trac.dabodev.com/ticket/1179 per maggiori informazioni.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Possiamo dire che [[SimpleCrypt]] permette il mascheramento (oscuramento) dei vostri dati piuttosto che la criptazione degli stessi&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=SimpleCrypt&amp;diff=4193</id>
		<title>SimpleCrypt</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=SimpleCrypt&amp;diff=4193"/>
		<updated>2020-05-17T15:52:40Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;&amp;#039;&amp;#039;&amp;#039;SimpleCrypt&amp;#039;&amp;#039;&amp;#039; is pretty much what its name implies: a very simple tool for encrypting stuff. Technically, what we are doing is taking plaintext and turning it into ciphert...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&#039;&#039;&#039;SimpleCrypt&#039;&#039;&#039; is pretty much what its name implies: a very simple tool for encrypting stuff. Technically, what we are doing is taking plaintext and turning it into ciphertext. &#039;&#039;&#039;SimpleCrypt&#039;&#039;&#039; is included with Dabo, and is the default tool for encrypting/decrypting passwords stored in connection files.&lt;br /&gt;
&lt;br /&gt;
This is great for testing and development, but you should not use it in production environments. There are two main reasons:&lt;br /&gt;
&lt;br /&gt;
# Anyone with a copy of Dabo could decrypt your password.&lt;br /&gt;
# It isn&#039;t portable between 32-bit and 64-bit python. See the trac ticket at http://trac.dabodev.com/ticket/1179 for more information.&lt;br /&gt;
&lt;br /&gt;
Essentially, this makes what &#039;&#039;&#039;SimpleCrypt&#039;&#039;&#039; does more like &amp;quot;obscuring&amp;quot; your data, and not actually encrypting it.&lt;br /&gt;
&lt;br /&gt;
A better choice to use for creating the encrypted ciphers is the &#039;&#039;&#039;The Python Cryptography Toolkit&#039;&#039;&#039;, otherwise known as [https://www.dlitz.net/software/pycrypto/ PyCrypto]. If this is installed on a system running a Dabo application, and you&#039;ve set the encryption key, Dabo will use the DES algorithm in this library instead of the much weaker algorithm that SimpleCrypt uses.&lt;br /&gt;
&lt;br /&gt;
The key is set by setting the value of &amp;lt;code&amp;gt;dabo.cryptoKeyDES&amp;lt;/code&amp;gt;; this is typically done by including the line:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
crytoKeyDES = &amp;quot;Some Text Value&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
in your application&#039;s &amp;lt;code&amp;gt;settings_override.py&amp;lt;/code&amp;gt; file, or by setting it early in your application. Be sure that it is set before the first call to &amp;lt;code&amp;gt;dApp.encrypt()&amp;lt;/code&amp;gt; or &amp;lt;code&amp;gt;dApp.decrypt()&amp;lt;/code&amp;gt;.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Framework_Level&amp;diff=4192</id>
		<title>Framework Level</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Framework_Level&amp;diff=4192"/>
		<updated>2020-05-17T15:49:19Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;===== subtopics: =====  * SimpleCrypt ** SempliceCriptazione (SimpleCrypt) ** PyCrypto * settings_override.py * settings.py&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;===== subtopics: =====&lt;br /&gt;
&lt;br /&gt;
* [[SimpleCrypt]]&lt;br /&gt;
** [[SempliceCriptazione (SimpleCrypt)]]&lt;br /&gt;
** [[PyCrypto]]&lt;br /&gt;
* [[settings_override.py]]&lt;br /&gt;
* [[settings.py]]&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Framework_Documentation&amp;diff=4191</id>
		<title>Framework Documentation</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Framework_Documentation&amp;diff=4191"/>
		<updated>2020-05-17T15:11:01Z</updated>

		<summary type="html">&lt;p&gt;Ed: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;===== subtopics: =====&lt;br /&gt;
&lt;br /&gt;
* [[DB and BizObjects]]&lt;br /&gt;
** [[BizObject DataSource]]&lt;br /&gt;
** [[BusinessRules]]&lt;br /&gt;
*** [[bizobj]]&lt;br /&gt;
*** [[BusinessRules ...Versione Italiana]]&lt;br /&gt;
** [[DataSet]]&lt;br /&gt;
** [[DataTypes]]&lt;br /&gt;
** [[KeyField]]&lt;br /&gt;
*** [[PrimaryKey]]&lt;br /&gt;
** [[LinkField]]&lt;br /&gt;
*** [[ForeignKey]]&lt;br /&gt;
** [[ParentLinkField]]&lt;br /&gt;
** [[Virtual Fields]]&lt;br /&gt;
** [[Tricks with Virtual Fields]]&lt;br /&gt;
* [[Databases]]&lt;br /&gt;
** [[Firebird]]&lt;br /&gt;
** [[MSDE]]&lt;br /&gt;
** [[MS-SQL]]&lt;br /&gt;
** [[MicrosoftSQLServer]]&lt;br /&gt;
** [[MySQL]]&lt;br /&gt;
*** [[MySQLdb]]&lt;br /&gt;
** [[ODBC]]&lt;br /&gt;
*** [[mxODBC]]&lt;br /&gt;
** [[PostgreSQL]]&lt;br /&gt;
*** [[psycopg2]]&lt;br /&gt;
** [[PySQLite]]&lt;br /&gt;
** [[SQLite]]&lt;br /&gt;
* [[Localization]]&lt;br /&gt;
* [[UI]]&lt;br /&gt;
** [[BoxSizers]]&lt;br /&gt;
** [[ColorExamples]]&lt;br /&gt;
** [[dabo.ui.bitmapFromData]]&lt;br /&gt;
** [[Command Window]]&lt;br /&gt;
** [[dPemMixin]]&lt;br /&gt;
** [[dabo.ui Widgets]]&lt;br /&gt;
*** [[dComboBox]]&lt;br /&gt;
*** [[dDateTextBox]]&lt;br /&gt;
*** [[dDropdownList]]&lt;br /&gt;
*** [[dEditBox]]&lt;br /&gt;
*** [[dGridSizer]]&lt;br /&gt;
**** [[dGridSizerMethods]]&lt;br /&gt;
**** [[dGridSizerProperties]]&lt;br /&gt;
*** [[dListBox]]&lt;br /&gt;
*** [[dSizer]]&lt;br /&gt;
**** [[dSizerMethods]]&lt;br /&gt;
**** [[dSizerProperties]]&lt;br /&gt;
**** [[SizerItem]]&lt;br /&gt;
*** [[dSpinner]]&lt;br /&gt;
*** [[dTextBox]]&lt;br /&gt;
*** [[dListControl]]&lt;br /&gt;
*** [[dGrid]]&lt;br /&gt;
*** [[dTreeView]]&lt;br /&gt;
*** [[dCheckBox]]&lt;br /&gt;
*** [[dCheckList]]&lt;br /&gt;
*** [[dToggleButton]]&lt;br /&gt;
*** [[dRadioList]]&lt;br /&gt;
*** [[dButton]]&lt;br /&gt;
*** [[dBitmapButton]]&lt;br /&gt;
*** [[dPageFrame]]&lt;br /&gt;
*** [[dPageSelect]]&lt;br /&gt;
*** [[dPageList]]&lt;br /&gt;
*** [[dPageNoTabs]]&lt;br /&gt;
*** [[dSlider]]&lt;br /&gt;
*** [[dLabel]]&lt;br /&gt;
*** [[dPanel]]&lt;br /&gt;
*** [[dScrollPanel]]&lt;br /&gt;
*** [[dDialog]]&lt;br /&gt;
*** [[dMediaControl]]&lt;br /&gt;
** [[DataField]]&lt;br /&gt;
** [[DataSource]]&lt;br /&gt;
** [[DrawObjects]]&lt;br /&gt;
** [[PyObjC]]&lt;br /&gt;
** [[RegID]]&lt;br /&gt;
** [[ValueMode]]&lt;br /&gt;
** [[dabo.ui Functions]]&lt;br /&gt;
*** [[dabo.ui.browse]]&lt;br /&gt;
*** [[dabo.ui.busyInfo]]&lt;br /&gt;
*** [[dabo.ui.callAfter]]&lt;br /&gt;
*** [[dabo.ui.callAfterInterval]]&lt;br /&gt;
*** [[dabo.ui.callEvery]]&lt;br /&gt;
*** [[dabo.ui.continueEvent]]&lt;br /&gt;
*** [[dabo.ui.createForm]]&lt;br /&gt;
*** [[dabo.ui.discontinueEvent]]&lt;br /&gt;
*** [[dabo.ui.fontMetric]]&lt;br /&gt;
*** [[dabo.ui.fontMetricFromDrawObject]]&lt;br /&gt;
*** [[dabo.ui.fontMetricFromFont]]&lt;br /&gt;
*** [[dabo.ui.getAvailableFonts]]&lt;br /&gt;
*** [[dabo.ui.getColor]]&lt;br /&gt;
*** [[dabo.ui.getCommonBitmap]]&lt;br /&gt;
*** [[dabo.ui.getDate]]&lt;br /&gt;
*** [[dabo.ui.getEventData]]&lt;br /&gt;
*** [[dabo.ui.getFile]]&lt;br /&gt;
*** [[dabo.ui.getFileAndType]]&lt;br /&gt;
*** [[dabo.ui.getFolder]]&lt;br /&gt;
*** [[dabo.ui.getFont]]&lt;br /&gt;
*** [[dabo.ui.getInt]]&lt;br /&gt;
*** [[dabo.ui.getMouseObject]]&lt;br /&gt;
*** [[dabo.ui.getMousePosition]]&lt;br /&gt;
*** [[dabo.ui.getSaveAs]]&lt;br /&gt;
*** [[dabo.ui.getSaveAsAndType]]&lt;br /&gt;
*** [[dabo.ui.getString]]&lt;br /&gt;
*** [[dabo.ui.imageFromData]]&lt;br /&gt;
*** [[dabo.ui.pathToBmp]]&lt;br /&gt;
*** [[dabo.ui.resizeBmp]]&lt;br /&gt;
*** [[dabo.ui.saveScreenShot]]&lt;br /&gt;
*** [[dabo.ui.setAfter]]&lt;br /&gt;
*** [[dabo.ui.setdFormClass]]&lt;br /&gt;
*** [[dabo.ui.setAfterInterval]]&lt;br /&gt;
*** [[dabo.ui.sortList]]&lt;br /&gt;
*** [[dabo.ui.strToBmp]]&lt;br /&gt;
*** [[dabo.ui.yieldUI]]&lt;br /&gt;
*** [[dabo.ui.info]]&lt;br /&gt;
*** [[dabo.ui.exclaim]]&lt;br /&gt;
*** [[dabo.ui.stop]]&lt;br /&gt;
*** [[dabo.ui.areYouSure]]&lt;br /&gt;
*** [[dabo.ui.isControlDown]]&lt;br /&gt;
*** [[dabo.ui.isCommandDown]]&lt;br /&gt;
*** [[dabo.ui.isShiftDown]]&lt;br /&gt;
*** [[dabo.ui.isAltDown]]&lt;br /&gt;
*** [[dabo.ui.isMouseLeftDown]]&lt;br /&gt;
*** [[dabo.ui.isMouseRightDown]]&lt;br /&gt;
*** [[dabo.ui.isMouseMiddleDown]]&lt;br /&gt;
** [[PreferenceDialog]]&lt;br /&gt;
* [[HowTos]]&lt;br /&gt;
** [[HowToAddBLOBValuesWithMySQL]]&lt;br /&gt;
** [[HowToReturnAValueFromAModalForm]]&lt;br /&gt;
** [[How to Visually Float a Control]]&lt;br /&gt;
** [[HowToPopulateAndUseListControls]]&lt;br /&gt;
** [[HowToLimitInputCharactersInATextBox]]&lt;br /&gt;
** [[HowToCreateAFormWithAGridAndPopulateItWithData]]&lt;br /&gt;
** [[How To Log Executed SQL]]&lt;br /&gt;
** [[How To Get Foreign Keys Set]]&lt;br /&gt;
** [[HowToSetupParent-Child-Grandchild]]&lt;br /&gt;
** [[How To Overlay Controls]]&lt;br /&gt;
** [[HowToCreateANumbersOnlyControl]]&lt;br /&gt;
** [[HowToTurnPreferencesOff]]&lt;br /&gt;
** [[HowToCreateATempCursor]]&lt;br /&gt;
** [[Create an OpenOffice SpreadSheet]]&lt;br /&gt;
** [[How to use a cdxml file in hand coded forms]]&lt;br /&gt;
** [[HowToCustomizeCheckboxes]]&lt;br /&gt;
** [[HowToUseMultipleToolbars]]&lt;br /&gt;
** [[HowToUseAGridSizer]]&lt;br /&gt;
* [[Reserved Words]]&lt;br /&gt;
* [[GeneralDaboPractices]]&lt;br /&gt;
** [[Object Creation Methods]]&lt;br /&gt;
*** [[Hook Methods]]&lt;br /&gt;
* [[Framework Level]]&lt;br /&gt;
** [[SimpleCrypt]]&lt;br /&gt;
*** [[SempliceCriptazione (SimpleCrypt)]]&lt;br /&gt;
*** [[PyCrypto]]&lt;br /&gt;
** [[settings_override.py]]&lt;br /&gt;
** [[settings.py]]&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToUseAGridSizer&amp;diff=4190</id>
		<title>HowToUseAGridSizer</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToUseAGridSizer&amp;diff=4190"/>
		<updated>2020-05-17T15:08:52Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== How To Use a dGridSizer == The easiest way to make use of a dGridSizer has to use the ClassDesigner. It is a piece of genius that will take the headache out of desi...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== How To Use a dGridSizer ==&lt;br /&gt;
The easiest way to make use of a [[dGridSizer]] has to use the [[ClassDesigner]]. It is a piece of genius that will take the headache out of designing a form to meet your desires.&lt;br /&gt;
&lt;br /&gt;
But if you want to do it in code, or perhaps just to understand it a little better, this is what you need to know.&lt;br /&gt;
&lt;br /&gt;
== What is a dGridSizer? ==&lt;br /&gt;
[[dGridSizer]] is a sizer that can lay out items in a virtual grid arrangement. Items can be placed in specific row/column positions if that position is unoccupied. You can specify either &amp;lt;code&amp;gt;MaxCols&amp;lt;/code&amp;gt; or &amp;lt;code&amp;gt;MaxRows&amp;lt;/code&amp;gt;, and then append items to the grid sizer; it will place them in the first open row/col position, until the Max* dimension is reached; after that, it starts over in the next row/col. This allows for easily adding items without having to explicitly track each one&#039;s row/col. For example, if I have a bunch of labels and edit controls to add, and I want them in a grid arrangement with labels on the left and controls on the right, I can set &amp;lt;code&amp;gt;MaxCols&amp;lt;/code&amp;gt; to 2, and then append label, control, label, control, ..., and the [[dGridSizer]] will automatically arrange them as desired.&lt;br /&gt;
&lt;br /&gt;
== What you need to do: ==&lt;br /&gt;
# Create a form with a sizer on it.&lt;br /&gt;
# Create an instance of a grid sizer.&lt;br /&gt;
# Create instances of the controls you want to place in the cells of the grid.&lt;br /&gt;
# Append the controls to the grid.&lt;br /&gt;
# Append the dGridSizer to your parent control.&lt;br /&gt;
&lt;br /&gt;
== Example: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
import dabo&lt;br /&gt;
dabo.ui.loadUI(&amp;quot;wx&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class MainForm(dabo.ui.dForm):&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        # Create a initial sizer to add to&lt;br /&gt;
        self.Sizer = dabo.ui.dSizer(&amp;quot;horizontal&amp;quot;)&lt;br /&gt;
        # Create the dGridSizer with gaps between the rows and columns&lt;br /&gt;
        gs = self.mygrid = dabo.ui.dGridSizer(HGap=12, VGap=15)&lt;br /&gt;
        # Create some labels and textboxes&lt;br /&gt;
        self.lblFirst = dabo.ui.dLabel(self, Caption=&amp;quot;First Name:&amp;quot;)&lt;br /&gt;
        self.txtboxFirst = dabo.ui.dTextBox(self)&lt;br /&gt;
        self.lblSecond = dabo.ui.dLabel(self, Caption=&amp;quot;Last Name:&amp;quot;)&lt;br /&gt;
        self.txtboxSecond = dabo.ui.dTextBox(self)&lt;br /&gt;
&lt;br /&gt;
        # Append the controls to the dGridSizer by specifying location cell (in this example)&lt;br /&gt;
        gs.append(self.lblFirst, row=0, col=0, halign=&amp;quot;right&amp;quot;)&lt;br /&gt;
        gs.append(self.txtboxFirst, row=0, col=1)&lt;br /&gt;
        gs.append(self.lblSecond, row=1, col=0, halign=&amp;quot;right&amp;quot;)&lt;br /&gt;
        gs.append(self.txtboxSecond, row=1, col=1)&lt;br /&gt;
&lt;br /&gt;
        # Append the sizer to its parent. To show it halfway down,&lt;br /&gt;
        # we set &#039;valign&#039; to &#039;middle&#039;.&lt;br /&gt;
        self.Sizer.append(gs, proportion=1, valign=&amp;quot;middle&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
if __name__ == &amp;quot;__main__&amp;quot;:&lt;br /&gt;
    app = dabo.dApp()&lt;br /&gt;
    app.MainFormClass = MainForm&lt;br /&gt;
    app.start()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Now if you prefer to just fill up the rows without having to specifically index the locations, you can write the &amp;lt;code&amp;gt;MainForm&amp;lt;/code&amp;gt; class from above, this way:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
class MainForm(dabo.ui.dForm):&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        # Create a initial sizer to add to&lt;br /&gt;
        self.Sizer = dabo.ui.dSizer(&amp;quot;horizontal&amp;quot;)&lt;br /&gt;
        # Create the dGridSizer with only 2 Columns&lt;br /&gt;
        gs = self.mygrid = dabo.ui.dGridSizer(MaxCols=2, HGap=12, VGap=15)&lt;br /&gt;
&lt;br /&gt;
        # Create some labels and textboxes&lt;br /&gt;
        self.lblFirst = dabo.ui.dLabel(self, Caption=&amp;quot;First Name:&amp;quot;)&lt;br /&gt;
        self.txtboxFirst = dabo.ui.dTextBox(self)&lt;br /&gt;
        self.lblSecond = dabo.ui.dLabel(self, Caption=&amp;quot;Last Name:&amp;quot;)&lt;br /&gt;
        self.txtboxSecond = dabo.ui.dTextBox(self)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        # Append the controls to the dGridSizer by making use of the MaxCol setting (in this example)&lt;br /&gt;
        # As each row fills, it automatically moves to the next row.&lt;br /&gt;
        gs.append(self.lblFirst, halign=&amp;quot;right&amp;quot;)&lt;br /&gt;
        gs.append(self.txtboxFirst)&lt;br /&gt;
        gs.append(self.lblSecond, halign=&amp;quot;right&amp;quot;)&lt;br /&gt;
        gs.append(self.txtboxSecond)&lt;br /&gt;
&lt;br /&gt;
        # Append the sizer to its parent&lt;br /&gt;
        self.Sizer.append(gs, proportion=1, valign=&amp;quot;middle&amp;quot;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== How to make an expandable column on a dGridSizer ==&lt;br /&gt;
You need to understand the previous two examples first.&lt;br /&gt;
&lt;br /&gt;
Here is what you do:&lt;br /&gt;
&lt;br /&gt;
Define a [[dGridSizer]] as you did above but with two differences:&lt;br /&gt;
&lt;br /&gt;
The &amp;lt;code&amp;gt;append()&amp;lt;/code&amp;gt; argument to [[dGridSizer]] takes an optional layout parameter; by default this is &amp;quot;&#039;&#039;&#039;normal&#039;&#039;&#039;&amp;quot;, which means just layout the control using its natural size, but if you want the control to expand to take up any available space, pass this parameter as &amp;quot;&#039;&#039;&#039;expand&#039;&#039;&#039;&amp;quot; (or simple pass &amp;quot;&#039;&#039;&#039;x&#039;&#039;&#039;&amp;quot;, which is interpreted as an alias for &amp;quot;&#039;&#039;&#039;expand&#039;&#039;&#039;&amp;quot;).&lt;br /&gt;
Once the control has been appended to the [[dGridSizer]], the column now exists as far as the grid sizer is concerned, and you can call the &amp;lt;code&amp;gt;setColExpand()&amp;lt;/code&amp;gt; method for the column that you require. This causes all controls in the specified column to expand, providing that control had the &amp;quot;&#039;&#039;&#039;expand&#039;&#039;&#039;&amp;quot; setting when you added it to the sizer. It also allows the grid sizer to expand that column to use the available width.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;NB&#039;&#039;&#039;: Add the controls to the grid sizer FIRST, then call &amp;lt;code&amp;gt;setColExpand()&amp;lt;/code&amp;gt; for whatever columns you want to be &amp;quot;growable&amp;quot;. It is good practice to make the &amp;lt;code&amp;gt;setColExpand()&amp;lt;/code&amp;gt; calls at the end of the code that defines the grid sizer.&lt;br /&gt;
&lt;br /&gt;
The Signature for the method is: &amp;lt;code&amp;gt;setColExpand(self, expand, colNum, proportion=0)&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;expand&amp;lt;/code&amp;gt; is a boolean argument. Passing &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt; enables the column to expand; &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt; disables it.&lt;br /&gt;
* &amp;lt;code&amp;gt;colNum&amp;lt;/code&amp;gt; is the single column that you are setting this for. You can also replace &amp;lt;code&amp;gt;colNum&amp;lt;/code&amp;gt; with a tuple of column numbers, and it will set all of them to the passed value (remember that column numbers start at 0). And as an even further convenience, you can pass &amp;lt;code&amp;gt;all&amp;lt;/code&amp;gt; for this argument, and it will enable the expanded state for all columns.&lt;br /&gt;
* &amp;lt;code&amp;gt;proportion&amp;lt;/code&amp;gt; in an integer value that affects the relative weighting of the column compared to the other expandable columns. In other words, if you have two expandable columns, but want the second one to appear twice as wide as the first, you&#039;d pass proportion=1 for the first, and proportion=2 for the second. If you simply accept the default of 0 for all columns, they are sized equally.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Example 1:&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
# Define the control as usual&lt;br /&gt;
self.txtboxFirst = dabo.ui.dTextBox(self)&lt;br /&gt;
# Append the control to the dGridSizer, but add the parameter to &amp;quot;expand&amp;quot;.&lt;br /&gt;
self.mygrid.append(self.txtboxFirst, &amp;quot;expand&amp;quot;, row=0, col=1, BorderStyle=&amp;quot;sunken&amp;quot;)&lt;br /&gt;
# Make Column 1 expandable (growable) for any of its controls already set to expand.&lt;br /&gt;
self.mygrid.setColExpand(True, 1)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Example 2:&amp;lt;/i&amp;gt;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
# Make colums 1 and 2 expandable by specifying multiple columns in a tuple.&lt;br /&gt;
self.mygrid.setColExpand(True, (1, 2))&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Example 3:&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
# Make all colums expandable.&lt;br /&gt;
self.mygrid.setColExpand(True, &amp;quot;all&amp;quot;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Here is the entire example from above with the [[dTextBox]] control on the first line made expandable.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Example 4:&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
import dabo&lt;br /&gt;
dabo.ui.loadUI(&amp;quot;wx&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class MainForm(dabo.ui.dForm):&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        # Create a initial sizer to add to&lt;br /&gt;
        self.Sizer = dabo.ui.dSizer(&amp;quot;horizontal&amp;quot;)&lt;br /&gt;
        gs = self.mygrid = dabo.ui.dGridSizer(HGap=12, VGap=15)&lt;br /&gt;
        # Define some Controls e.g. labels and textboxes&lt;br /&gt;
        self.lblFirst = dabo.ui.dLabel(self, Caption=&amp;quot;First Name:&amp;quot;)&lt;br /&gt;
        self.txtboxFirst = dabo.ui.dTextBox(self)&lt;br /&gt;
        self.lblSecond = dabo.ui.dLabel(self, Caption=&amp;quot;Last Name:&amp;quot;)&lt;br /&gt;
        self.txtboxSecond = dabo.ui.dTextBox(self)&lt;br /&gt;
&lt;br /&gt;
        # Append the controls to the dGridSizer by location (in this example)&lt;br /&gt;
        gs.append(self.lblFirst, row=0, col=0, halign=&amp;quot;right&amp;quot;)&lt;br /&gt;
        # This next control will be set to expand&lt;br /&gt;
        gs.append(self.txtboxFirst, &amp;quot;expand&amp;quot;, row=0, col=1)&lt;br /&gt;
        gs.append(self.lblSecond, row=1, col=0, halign=&amp;quot;right&amp;quot;)&lt;br /&gt;
        # This textbox will not expand&lt;br /&gt;
        gs.append(self.txtboxSecond, row=1, col=1)&lt;br /&gt;
        # Now set column 1 to expand&lt;br /&gt;
        gs.setColExpand(True, 1)&lt;br /&gt;
&lt;br /&gt;
        # Append the sizer to its parent&lt;br /&gt;
        self.Sizer.append(gs, proportion=1, valign=&amp;quot;middle&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
if __name__ == &amp;quot;__main__&amp;quot;:&lt;br /&gt;
    app = dabo.dApp()&lt;br /&gt;
    app.MainFormClass = MainForm&lt;br /&gt;
    app.start()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The equivalent methods also exist for Rows: &amp;lt;code&amp;gt;setRowExpand()&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
These notes written by &#039;&#039;&#039;Fraser Burns&#039;&#039;&#039; and amended by those who know more.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToCreateANumbersOnlyControl&amp;diff=4189</id>
		<title>HowToCreateANumbersOnlyControl</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToCreateANumbersOnlyControl&amp;diff=4189"/>
		<updated>2020-05-17T14:58:28Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;The following class was writtern by &amp;#039;&amp;#039;&amp;#039;Larry Long&amp;#039;&amp;#039;&amp;#039;, &amp;#039;&amp;#039;&amp;#039;Nate Lowrie&amp;#039;&amp;#039;&amp;#039; and &amp;#039;&amp;#039;&amp;#039;John Fabiani&amp;#039;&amp;#039;&amp;#039;.  &amp;lt;code&amp;gt;RANumBox(self, RegID=ncostID, MinValue=0.00, MaxValue=999999.99, Integer...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;The following class was writtern by &#039;&#039;&#039;Larry Long&#039;&#039;&#039;, &#039;&#039;&#039;Nate Lowrie&#039;&#039;&#039; and &#039;&#039;&#039;John Fabiani&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;RANumBox(self, RegID=ncostID, MinValue=0.00, MaxValue=999999.99, IntegerWidth=6, DecimalWidth=2, Alignment=&amp;quot;R&amp;quot;)&amp;lt;/code&amp;gt; is the line of code that uses the class.&lt;br /&gt;
&lt;br /&gt;
Where &amp;lt;code&amp;gt;MinValue&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;MaxValue&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;IntegerWidth&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;DecimalWidth&amp;lt;/code&amp;gt; will determine the imput mask. Run the code below (you may not see the background color change on linux)&lt;br /&gt;
&lt;br /&gt;
The class is sub-classed on [[dTextBox]].&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
import re&lt;br /&gt;
import dabo&lt;br /&gt;
import dabo.dEvents as dEvents&lt;br /&gt;
import dabo.dException as dException&lt;br /&gt;
from dabo.dLocalize import _&lt;br /&gt;
dabo.ui.loadUI(&#039;wx&#039;)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class RANumBox(dabo.ui.dTextBox):&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        self.Alignment=&#039;Right&#039;&lt;br /&gt;
&lt;br /&gt;
    def onKeyChar(self,evt):&lt;br /&gt;
        from dabo.ui import dKeys as dKeys&lt;br /&gt;
        keyChar = evt.keyChar&lt;br /&gt;
        if evt.keyCode in range(32,126) and not str.isdigit(keyChar) and not keyChar==&#039;.&#039;:&lt;br /&gt;
            evt.stop()&lt;br /&gt;
        if keyChar==&#039;.&#039; and not self.GetValue().find(&#039;.&#039;)==-1:&lt;br /&gt;
            evt.stop()&lt;br /&gt;
        dabo.ui.callAfter(self.Validate)&lt;br /&gt;
&lt;br /&gt;
    def Validate(self):&lt;br /&gt;
        try:&lt;br /&gt;
            value = float(self.GetValue())&lt;br /&gt;
        except:&lt;br /&gt;
            return&lt;br /&gt;
&lt;br /&gt;
        if (self.MinValue is not None and value &amp;lt; self.MinValue) or (&lt;br /&gt;
                self.MaxValue is not None and value &amp;gt; self.MaxValue):&lt;br /&gt;
            self.BackColor = &amp;quot;pink&amp;quot;&lt;br /&gt;
            return&lt;br /&gt;
        else:&lt;br /&gt;
            self.BackColor = &amp;quot;white&amp;quot;&lt;br /&gt;
&lt;br /&gt;
        pattern = &#039;&#039;&lt;br /&gt;
        if self.IntegerWidth is not None:&lt;br /&gt;
            pattern=&#039;^([0-9]{0,%s})&#039; % (self.IntegerWidth,)&lt;br /&gt;
        else:&lt;br /&gt;
            pattern=&#039;^([0-9]{0,})&#039;&lt;br /&gt;
&lt;br /&gt;
        if self.DecimalWidth is not None:&lt;br /&gt;
            pattern = pattern + &#039;(\.[0-9]{0,%s})&#039; % (self.DecimalWidth,)&lt;br /&gt;
        else:&lt;br /&gt;
            pattern=pattern +&#039;(\.[0-9]{0,})&#039;&lt;br /&gt;
        pattern = pattern +&#039;?$&#039;&lt;br /&gt;
&lt;br /&gt;
        if re.match(pattern, self.GetValue())==None:&lt;br /&gt;
            self.BackColor = &amp;quot;pink&amp;quot;&lt;br /&gt;
        else:&lt;br /&gt;
            self.BackColor = &amp;quot;white&amp;quot;&lt;br /&gt;
&lt;br /&gt;
    def _getDecimalWidth(self):&lt;br /&gt;
        try:&lt;br /&gt;
            return(self._decimalWidth)&lt;br /&gt;
        except:&lt;br /&gt;
            return(None)&lt;br /&gt;
&lt;br /&gt;
    def _setDecimalWidth(self, val):&lt;br /&gt;
        self._decimalWidth = val&lt;br /&gt;
&lt;br /&gt;
    def _getIntegerWidth(self):&lt;br /&gt;
        try:&lt;br /&gt;
            return(self._integerWidth)&lt;br /&gt;
        except:&lt;br /&gt;
            return None&lt;br /&gt;
&lt;br /&gt;
    def _setIntegerWidth(self, val):&lt;br /&gt;
        self._integerWidth = val&lt;br /&gt;
&lt;br /&gt;
    def _getMinValue(self):&lt;br /&gt;
        try:&lt;br /&gt;
            return(self._minValue)&lt;br /&gt;
        except:&lt;br /&gt;
            return(None)&lt;br /&gt;
&lt;br /&gt;
    def _setMinValue(self, val):&lt;br /&gt;
        self._minValue = val&lt;br /&gt;
&lt;br /&gt;
    def _getMaxValue(self):&lt;br /&gt;
        try:&lt;br /&gt;
            return(self._maxValue)&lt;br /&gt;
        except:&lt;br /&gt;
            return(None)&lt;br /&gt;
&lt;br /&gt;
    def _setMaxValue(self, val):&lt;br /&gt;
        self._maxValue = val&lt;br /&gt;
    def _getEditable(self):&lt;br /&gt;
        try:&lt;br /&gt;
            return getattr(self, &amp;quot;_Editable&amp;quot;, None)&lt;br /&gt;
        except:&lt;br /&gt;
            return(None)&lt;br /&gt;
&lt;br /&gt;
    def _setEditable(self, val):&lt;br /&gt;
        self._Editable = val&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
    DecimalWidth = property(_getDecimalWidth, _setDecimalWidth, None,&lt;br /&gt;
           &amp;quot;The number of digits after the decimal point (int)&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
    Editable = property(_getEditable, _setEditable)&lt;br /&gt;
&lt;br /&gt;
    IntegerWidth = property(_getIntegerWidth, _setIntegerWidth, None,&lt;br /&gt;
           &amp;quot;The number of digits before the decimal point (int)&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
    MinValue = property(_getMinValue, _setMinValue, None,&lt;br /&gt;
           &amp;quot;The minimum value that the entered data can be (int)&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
    MaxValue = property(_getMaxValue, _setMaxValue, None,&lt;br /&gt;
           &amp;quot;The maximum value that the entered data can be (int)&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class MainForm(dabo.ui.dForm):&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        self.Sizer = hs = dabo.ui.dSizer(&#039;h&#039;)&lt;br /&gt;
        hs.append(dabo.ui.dLabel(self, Caption=&#039;Cost   &#039;),alignment=&#039;Right&#039;)&lt;br /&gt;
        hs.append(RANumBox(self,RegID=&#039;ncostID&#039;, MinValue=0.00, MaxValue=999999.99,&lt;br /&gt;
                IntegerWidth=6, DecimalWidth=2, Alignment=&#039;R&#039;))&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
if __name__ == &amp;quot;__main__&amp;quot;:&lt;br /&gt;
        app = dabo.dApp()&lt;br /&gt;
        app.BasePrefKey = &amp;quot;NumberBox Test&amp;quot;&lt;br /&gt;
        app.setAppInfo(&amp;quot;appName&amp;quot;, &amp;quot;NumberBox Test&amp;quot;)&lt;br /&gt;
        app.MainFormClass = MainForm&lt;br /&gt;
        app.start()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToCreateATempCursor&amp;diff=4188</id>
		<title>HowToCreateATempCursor</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToCreateATempCursor&amp;diff=4188"/>
		<updated>2020-05-17T14:52:50Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;Occasionally you may need a temporary cursor to access tables. There are several ways to access the database via cursors. But the best way does not violate Dabo&amp;#039;s 3 tier desig...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Occasionally you may need a temporary cursor to access tables. There are several ways to access the database via cursors. But the best way does not violate Dabo&#039;s 3 tier design and most importantly does not cause other issues with Dabo.&lt;br /&gt;
&lt;br /&gt;
Below is an example of how I did it.&lt;br /&gt;
&lt;br /&gt;
I add the following to the form&#039;s &amp;lt;code&amp;gt;createBizobjs()&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
self.biztmp = dabo.biz.dBizobj(self.Connection)&lt;br /&gt;
self.tmpbiz = self.biztmp.getTempCursor()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
Note: &amp;lt;code&amp;gt;self.Connection&amp;lt;/code&amp;gt; is the name of the Form&#039;s connection to the database. And I did not add the bizobj to the form (do not -&amp;gt; &amp;lt;code&amp;gt;self.addBizobj(self.biztmp)&amp;lt;/code&amp;gt;)&lt;br /&gt;
&lt;br /&gt;
Now I can use &amp;lt;code&amp;gt;self.tmpbiz&amp;lt;/code&amp;gt; anywhere on the form as I would any other bizobj. So I can:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
self.tmpbiz.execute(&amp;quot;select somefield from sometable&amp;quot;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
and the bizobj &amp;lt;code&amp;gt;self.tmpbiz&amp;lt;/code&amp;gt; will contain the retreived data in the [[DataSet]].&lt;br /&gt;
&lt;br /&gt;
In my case I decided to create a special bizobj to make it easier to identify in code. But you could have used any bizobj that the form knows about. So if the form has a bizobj named &amp;lt;code&amp;gt;CustomerBizObj&amp;lt;/code&amp;gt; you can use it to create a temporary cursor.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
myTempCursor = self.Form.CustomerBizObj.getTempCursor()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The above will not change/touch/overwrite the &amp;lt;code&amp;gt;CustomerBizObj&amp;lt;/code&amp;gt; data.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowTos&amp;diff=4187</id>
		<title>HowTos</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowTos&amp;diff=4187"/>
		<updated>2020-05-17T14:52:16Z</updated>

		<summary type="html">&lt;p&gt;Ed: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=== &amp;lt;span style=&amp;quot;color: blue; text-align: center;&amp;quot;&amp;gt;If how to do something isn&#039;t obvious to you, it probably isn&#039;t obvious to others, too.&amp;lt;/span&amp;gt; ===&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
So if you run into a programming question in Dabo, don&#039;t just suffer through figuring it out; add it here! We can then answer the question for you in a way that can help someone else in the future. This will become the heart of the functional documentation for Dabo. Add new questions at the top so that they are easy to spot; we can always move them around into a better order later.&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I use a checkbox to manage a generic pair of values?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToCustomizeCheckboxes]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I turn preferences off?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToTurnPreferencesOff]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I set up a Parent-Child-Grandchild (PCG) relationship?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToSetupParent-Child-Grandchild]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How can I determine the dNode selected from a dTreeView (there is no itemID)?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: &amp;lt;code&amp;gt;tree.Selection&amp;lt;/code&amp;gt; will return the selected node.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How can i get dabo to set foreign keys for datail records when creating new records?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[How To Get Foreign Keys Set]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I log all database sql statements executed from Dabo?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[How To Log Executed SQL]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: I don&#039;t understand how to use picklists. I want to display the name of the thing the user is selecting, but I need the associated primary key for that choice. How do I do both?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToPopulateAndUseListControls]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: I need to prompt the user for a value before they continue. What&#039;s the best way of doing that?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToReturnAValueFromAModalForm]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: I want to only allow upper-case characters in a textbox. Can I do that in Dabo?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToLimitInputCharactersInATextBox]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: I have some data that I want to display in a grid. How do I do that?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToCreateAFormWithAGridAndPopulateItWithData]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I add BLOB values when using MySQL?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToAddBLOBValuesWithMySQL]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I center an object visually using sizers?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToVisuallyFloatAControl]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I create controls that overlay each other?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[How To Overlay Controls]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: Can I create an OpenOffice.org spreadsheet within Dabo?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[Create an OpenOffice SpreadSheet]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How does one use a cdxml file as class to be used in a hand coded form?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[How to use a cdxml file in hand coded forms]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How to use multiple toolbars in different place (e.g. on panels)?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToUseMultipleToolbars]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===== subtopics =====&lt;br /&gt;
*  [[HowToCustomizeCheckboxes]]&lt;br /&gt;
*  [[HowToTurnPreferencesOff]]&lt;br /&gt;
*  [[HowToSetupParent-Child-Grandchild]]&lt;br /&gt;
*  [[How To Get Foreign Keys Set]]&lt;br /&gt;
*  [[How To Log Executed SQL]]&lt;br /&gt;
*  [[HowToPopulateAndUseListControls]]&lt;br /&gt;
*  [[HowToReturnAValueFromAModalForm]]&lt;br /&gt;
*  [[HowToLimitInputCharactersInATextBox]]&lt;br /&gt;
*  [[HowToCreateAFormWithAGridAndPopulateItWithData]]&lt;br /&gt;
*  [[HowToAddBLOBValuesWithMySQL]]&lt;br /&gt;
*  [[HowToVisuallyFloatAControl]]&lt;br /&gt;
*  [[How To Overlay Controls]]&lt;br /&gt;
*  [[Create an OpenOffice SpreadSheet]]&lt;br /&gt;
*  [[How to use a cdxml file in hand coded forms]]&lt;br /&gt;
*  [[HowToUseMultipleToolbars]]&lt;br /&gt;
*  [[HowToCreateATempCursor]]&lt;br /&gt;
*  [[HowToCreateANumbersOnlyControl]]&lt;br /&gt;
*  [[HowToUseAGridSizer]]&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Framework_Documentation&amp;diff=4186</id>
		<title>Framework Documentation</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Framework_Documentation&amp;diff=4186"/>
		<updated>2020-05-17T14:45:41Z</updated>

		<summary type="html">&lt;p&gt;Ed: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;===== subtopics: =====&lt;br /&gt;
&lt;br /&gt;
* [[DB and BizObjects]]&lt;br /&gt;
** [[BizObject DataSource]]&lt;br /&gt;
** [[BusinessRules]]&lt;br /&gt;
*** [[bizobj]]&lt;br /&gt;
*** [[BusinessRules ...Versione Italiana]]&lt;br /&gt;
** [[DataSet]]&lt;br /&gt;
** [[DataTypes]]&lt;br /&gt;
** [[KeyField]]&lt;br /&gt;
*** [[PrimaryKey]]&lt;br /&gt;
** [[LinkField]]&lt;br /&gt;
*** [[ForeignKey]]&lt;br /&gt;
** [[ParentLinkField]]&lt;br /&gt;
** [[Virtual Fields]]&lt;br /&gt;
** [[Tricks with Virtual Fields]]&lt;br /&gt;
* [[Databases]]&lt;br /&gt;
** [[Firebird]]&lt;br /&gt;
** [[MSDE]]&lt;br /&gt;
** [[MS-SQL]]&lt;br /&gt;
** [[MicrosoftSQLServer]]&lt;br /&gt;
** [[MySQL]]&lt;br /&gt;
*** [[MySQLdb]]&lt;br /&gt;
** [[ODBC]]&lt;br /&gt;
*** [[mxODBC]]&lt;br /&gt;
** [[PostgreSQL]]&lt;br /&gt;
*** [[psycopg2]]&lt;br /&gt;
** [[PySQLite]]&lt;br /&gt;
** [[SQLite]]&lt;br /&gt;
* [[Localization]]&lt;br /&gt;
* [[UI]]&lt;br /&gt;
** [[BoxSizers]]&lt;br /&gt;
** [[ColorExamples]]&lt;br /&gt;
** [[dabo.ui.bitmapFromData]]&lt;br /&gt;
** [[Command Window]]&lt;br /&gt;
** [[dPemMixin]]&lt;br /&gt;
** [[dabo.ui Widgets]]&lt;br /&gt;
*** [[dComboBox]]&lt;br /&gt;
*** [[dDateTextBox]]&lt;br /&gt;
*** [[dDropdownList]]&lt;br /&gt;
*** [[dEditBox]]&lt;br /&gt;
*** [[dGridSizer]]&lt;br /&gt;
**** [[dGridSizerMethods]]&lt;br /&gt;
**** [[dGridSizerProperties]]&lt;br /&gt;
*** [[dListBox]]&lt;br /&gt;
*** [[dSizer]]&lt;br /&gt;
**** [[dSizerMethods]]&lt;br /&gt;
**** [[dSizerProperties]]&lt;br /&gt;
**** [[SizerItem]]&lt;br /&gt;
*** [[dSpinner]]&lt;br /&gt;
*** [[dTextBox]]&lt;br /&gt;
*** [[dListControl]]&lt;br /&gt;
*** [[dGrid]]&lt;br /&gt;
*** [[dTreeView]]&lt;br /&gt;
*** [[dCheckBox]]&lt;br /&gt;
*** [[dCheckList]]&lt;br /&gt;
*** [[dToggleButton]]&lt;br /&gt;
*** [[dRadioList]]&lt;br /&gt;
*** [[dButton]]&lt;br /&gt;
*** [[dBitmapButton]]&lt;br /&gt;
*** [[dPageFrame]]&lt;br /&gt;
*** [[dPageSelect]]&lt;br /&gt;
*** [[dPageList]]&lt;br /&gt;
*** [[dPageNoTabs]]&lt;br /&gt;
*** [[dSlider]]&lt;br /&gt;
*** [[dLabel]]&lt;br /&gt;
*** [[dPanel]]&lt;br /&gt;
*** [[dScrollPanel]]&lt;br /&gt;
*** [[dDialog]]&lt;br /&gt;
*** [[dMediaControl]]&lt;br /&gt;
** [[DataField]]&lt;br /&gt;
** [[DataSource]]&lt;br /&gt;
** [[DrawObjects]]&lt;br /&gt;
** [[PyObjC]]&lt;br /&gt;
** [[RegID]]&lt;br /&gt;
** [[ValueMode]]&lt;br /&gt;
** [[dabo.ui Functions]]&lt;br /&gt;
*** [[dabo.ui.browse]]&lt;br /&gt;
*** [[dabo.ui.busyInfo]]&lt;br /&gt;
*** [[dabo.ui.callAfter]]&lt;br /&gt;
*** [[dabo.ui.callAfterInterval]]&lt;br /&gt;
*** [[dabo.ui.callEvery]]&lt;br /&gt;
*** [[dabo.ui.continueEvent]]&lt;br /&gt;
*** [[dabo.ui.createForm]]&lt;br /&gt;
*** [[dabo.ui.discontinueEvent]]&lt;br /&gt;
*** [[dabo.ui.fontMetric]]&lt;br /&gt;
*** [[dabo.ui.fontMetricFromDrawObject]]&lt;br /&gt;
*** [[dabo.ui.fontMetricFromFont]]&lt;br /&gt;
*** [[dabo.ui.getAvailableFonts]]&lt;br /&gt;
*** [[dabo.ui.getColor]]&lt;br /&gt;
*** [[dabo.ui.getCommonBitmap]]&lt;br /&gt;
*** [[dabo.ui.getDate]]&lt;br /&gt;
*** [[dabo.ui.getEventData]]&lt;br /&gt;
*** [[dabo.ui.getFile]]&lt;br /&gt;
*** [[dabo.ui.getFileAndType]]&lt;br /&gt;
*** [[dabo.ui.getFolder]]&lt;br /&gt;
*** [[dabo.ui.getFont]]&lt;br /&gt;
*** [[dabo.ui.getInt]]&lt;br /&gt;
*** [[dabo.ui.getMouseObject]]&lt;br /&gt;
*** [[dabo.ui.getMousePosition]]&lt;br /&gt;
*** [[dabo.ui.getSaveAs]]&lt;br /&gt;
*** [[dabo.ui.getSaveAsAndType]]&lt;br /&gt;
*** [[dabo.ui.getString]]&lt;br /&gt;
*** [[dabo.ui.imageFromData]]&lt;br /&gt;
*** [[dabo.ui.pathToBmp]]&lt;br /&gt;
*** [[dabo.ui.resizeBmp]]&lt;br /&gt;
*** [[dabo.ui.saveScreenShot]]&lt;br /&gt;
*** [[dabo.ui.setAfter]]&lt;br /&gt;
*** [[dabo.ui.setdFormClass]]&lt;br /&gt;
*** [[dabo.ui.setAfterInterval]]&lt;br /&gt;
*** [[dabo.ui.sortList]]&lt;br /&gt;
*** [[dabo.ui.strToBmp]]&lt;br /&gt;
*** [[dabo.ui.yieldUI]]&lt;br /&gt;
*** [[dabo.ui.info]]&lt;br /&gt;
*** [[dabo.ui.exclaim]]&lt;br /&gt;
*** [[dabo.ui.stop]]&lt;br /&gt;
*** [[dabo.ui.areYouSure]]&lt;br /&gt;
*** [[dabo.ui.isControlDown]]&lt;br /&gt;
*** [[dabo.ui.isCommandDown]]&lt;br /&gt;
*** [[dabo.ui.isShiftDown]]&lt;br /&gt;
*** [[dabo.ui.isAltDown]]&lt;br /&gt;
*** [[dabo.ui.isMouseLeftDown]]&lt;br /&gt;
*** [[dabo.ui.isMouseRightDown]]&lt;br /&gt;
*** [[dabo.ui.isMouseMiddleDown]]&lt;br /&gt;
** [[PreferenceDialog]]&lt;br /&gt;
* [[HowTos]]&lt;br /&gt;
** [[HowToAddBLOBValuesWithMySQL]]&lt;br /&gt;
** [[HowToReturnAValueFromAModalForm]]&lt;br /&gt;
** [[How to Visually Float a Control]]&lt;br /&gt;
** [[HowToPopulateAndUseListControls]]&lt;br /&gt;
** [[HowToLimitInputCharactersInATextBox]]&lt;br /&gt;
** [[HowToCreateAFormWithAGridAndPopulateItWithData]]&lt;br /&gt;
** [[How To Log Executed SQL]]&lt;br /&gt;
** [[How To Get Foreign Keys Set]]&lt;br /&gt;
** [[HowToSetupParent-Child-Grandchild]]&lt;br /&gt;
** [[How To Overlay Controls]]&lt;br /&gt;
** [[How to create a number only control]]&lt;br /&gt;
** [[HowToTurnPreferencesOff]]&lt;br /&gt;
** [[HowToCreateATempCursor]]&lt;br /&gt;
** [[Create an OpenOffice SpreadSheet]]&lt;br /&gt;
** [[How to use a cdxml file in hand coded forms]]&lt;br /&gt;
** [[HowToCustomizeCheckboxes]]&lt;br /&gt;
** [[HowToUseMultipleToolbars]]&lt;br /&gt;
** [[How To Use a dGridSizer]]&lt;br /&gt;
* [[Reserved Words]]&lt;br /&gt;
* [[GeneralDaboPractices]]&lt;br /&gt;
** [[Object Creation Methods]]&lt;br /&gt;
*** [[Hook Methods]]&lt;br /&gt;
* [[Framework Level]]&lt;br /&gt;
** [[SimpleCrypt]]&lt;br /&gt;
*** [[SempliceCriptazione (SimpleCrypt)]]&lt;br /&gt;
*** [[PyCrypto]]&lt;br /&gt;
** [[settings_override.py]]&lt;br /&gt;
** [[settings.py]]&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToUseMultipleToolbars&amp;diff=4185</id>
		<title>HowToUseMultipleToolbars</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToUseMultipleToolbars&amp;diff=4185"/>
		<updated>2020-05-17T14:41:18Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;Using multiple toolbars in other places than right bellow the title bar is relatively common. For example on a panel to gather panel related functionality, on to of a grid for...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Using multiple toolbars in other places than right bellow the title bar is relatively common. For example on a panel to gather panel related functionality, on to of a grid for navigation and other grid related tasks. However, not many people seem to know that &#039;&#039;&#039;wxPython&#039;&#039;&#039; and thus Dabo (on the wx version series) supports this usage. At least in OS X and MS Windows (XP).&lt;br /&gt;
&lt;br /&gt;
Please note this is untested in Linux.&lt;br /&gt;
&lt;br /&gt;
The example is a little long but hopefully it will inspire you to the power of Toolbars in sizers.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
#!/usr/bin/env python&lt;br /&gt;
# -*- coding: utf-8 -*-&lt;br /&gt;
import dabo&lt;br /&gt;
import dabo.ui as dui&lt;br /&gt;
dabo.ui.loadUI(&amp;quot;wx&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class Panel1(dui.dPanel):&lt;br /&gt;
    def initProperties(self):&lt;br /&gt;
        self.RegID = &amp;quot;panel1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        sv = self.Sizer = dui.dSizer(&#039;v&#039;, DefaultBorder=10)&lt;br /&gt;
        lblPanel = dui.dLabel(self, Caption=&amp;quot;Panel 1 - No Toolbar&amp;quot;)&lt;br /&gt;
        sv.append(lblPanel)&lt;br /&gt;
&lt;br /&gt;
        hs = dui.dSizer(&#039;h&#039;)&lt;br /&gt;
        lbl = dui.dLabel(self, Caption=&amp;quot;Label&amp;quot;)&lt;br /&gt;
        txt = dui.dTextBox(self)&lt;br /&gt;
        hs.append(lbl, border=10, borderSides=&#039;right&#039;)&lt;br /&gt;
        hs.append(txt)&lt;br /&gt;
        sv.append(hs)&lt;br /&gt;
&lt;br /&gt;
        btnWhatever = dui.dButton(self, Caption=&amp;quot;Whatever&amp;quot;)&lt;br /&gt;
        sv.append(btnWhatever)&lt;br /&gt;
        sv.layout()&lt;br /&gt;
&lt;br /&gt;
        btnWhatever.bindEvent(dabo.dEvents.Hit, self.onBtnWhatever)&lt;br /&gt;
&lt;br /&gt;
    def onBtnWhatever(self, evt):&lt;br /&gt;
        print &amp;quot;Whatever&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class PanelWithToolbar(dui.dPanel):&lt;br /&gt;
    def initProperties(self):&lt;br /&gt;
        self.RegID = &amp;quot;panel2&amp;quot;&lt;br /&gt;
        self.Visible = False&lt;br /&gt;
&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        sv = self.Sizer = dui.dSizer(&#039;v&#039;)&lt;br /&gt;
        # Create Toolbar&lt;br /&gt;
        tb = dui.dToolBar(self)&lt;br /&gt;
&lt;br /&gt;
        if self.Application.Platform == &amp;quot;Mac&amp;quot;: iconSize = (32, 32) ## Yes Mac HIG specifies 32x32&lt;br /&gt;
        else: iconSize = (22, 22)&lt;br /&gt;
        iconPath = &amp;quot;themes/tango/%sx%s&amp;quot; % iconSize&lt;br /&gt;
        tb.SetToolBitmapSize(iconSize)&lt;br /&gt;
&lt;br /&gt;
        tb.appendButton(u&amp;quot;First&amp;quot;, pic=&amp;quot;%s/actions/go-first.png&amp;quot; % iconPath,&lt;br /&gt;
                        OnHit=self.Form.onFirst, tip=u&amp;quot;First record&amp;quot;)&lt;br /&gt;
        tb.appendButton(u&amp;quot;Previous&amp;quot;, pic=&amp;quot;%s/actions/go-previous.png&amp;quot; % iconPath,&lt;br /&gt;
                        OnHit=self.Form.onPrior, tip=u&amp;quot;Previous record&amp;quot;)&lt;br /&gt;
        tb.appendButton(u&amp;quot;Next&amp;quot;, pic=&amp;quot;%s/actions/go-next.png&amp;quot; % iconPath,&lt;br /&gt;
                        OnHit=self.Form.onNext, tip=u&amp;quot;Next record&amp;quot;)&lt;br /&gt;
        tb.appendButton(u&amp;quot;Last&amp;quot;, pic=&amp;quot;%s/actions/go-last.png&amp;quot; % iconPath,&lt;br /&gt;
                        OnHit=self.Form.onLast, tip=u&amp;quot;Last record&amp;quot;)&lt;br /&gt;
        sv.append(tb, layout=&#039;x&#039;)&lt;br /&gt;
&lt;br /&gt;
        lblPanel = dui.dLabel(self, Caption=&amp;quot;Panel 2 - Contacts&amp;quot;)&lt;br /&gt;
        sv.append(lblPanel, border=20, borderSides=(&#039;left&#039;, &#039;top&#039;))&lt;br /&gt;
&lt;br /&gt;
        hs = dui.dSizer(&#039;h&#039;)&lt;br /&gt;
        lbl = dui.dLabel(self, Caption=&amp;quot;Contact:&amp;quot;)&lt;br /&gt;
        txt = dui.dTextBox(self)&lt;br /&gt;
        hs.append(lbl, border=10, borderSides=&#039;right&#039;)&lt;br /&gt;
        hs.append(txt)&lt;br /&gt;
        sv.append(hs, border=20, borderSides=(&#039;left&#039;, &#039;top&#039;), layout=&#039;x&#039;)&lt;br /&gt;
&lt;br /&gt;
        btnWhatever = dui.dButton(self, Caption=&amp;quot;Whatever&amp;quot;)&lt;br /&gt;
        sv.append(btnWhatever, border=20, borderSides=(&#039;left&#039;, &#039;top&#039;))&lt;br /&gt;
        sv.layout()&lt;br /&gt;
&lt;br /&gt;
        btnWhatever.bindEvent(dabo.dEvents.Hit, self.Form.onBtnWhatever2)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class MainForm(dui.dForm):&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        # Create Toolbar&lt;br /&gt;
        self.ToolBar = tb = dui.dToolBar(self)&lt;br /&gt;
        if self.Application.Platform == &amp;quot;Mac&amp;quot;: iconSize = (32, 32) ## Yes Mac HIG specifies 32x32&lt;br /&gt;
        else: iconSize = (22, 22)&lt;br /&gt;
        iconPath = &amp;quot;themes/tango/%sx%s&amp;quot; % iconSize&lt;br /&gt;
        tb.SetToolBitmapSize(iconSize)&lt;br /&gt;
&lt;br /&gt;
        tb.appendButton(&#039;Click Me&#039;, &amp;quot;%s/actions/document-open.png&amp;quot; % iconPath,&lt;br /&gt;
                        OnHit=self.onAppTbButton)&lt;br /&gt;
&lt;br /&gt;
    def afterInitAll(self):&lt;br /&gt;
        self.Sizer = dui.dSizer(&#039;v&#039;)&lt;br /&gt;
        self.topPanel = dui.dPanel(self)&lt;br /&gt;
        self.Sizer.append1x(self.topPanel)&lt;br /&gt;
        vs = self.topPanel.Sizer = dui.dSizer(&#039;v&#039;)&lt;br /&gt;
        vs.append1x(Panel1(self))&lt;br /&gt;
        vs.append1x(PanelWithToolbar(self))&lt;br /&gt;
&lt;br /&gt;
        hs = dui.dSizer(&#039;h&#039;, DefaultBorder=15, DefaultBorderLeft=True,&lt;br /&gt;
                        DefaultBorderBottom=True)&lt;br /&gt;
        btn1 = dui.dButton(self.topPanel, Caption=&#039;Toggle Panel 1&#039;)&lt;br /&gt;
        btn2 = dui.dButton(self.topPanel, Caption=&#039;Toggle Panel 2&#039;)&lt;br /&gt;
        hs.append(btn1)&lt;br /&gt;
        hs.append(btn2)&lt;br /&gt;
        vs.append(hs)&lt;br /&gt;
        self.layout()&lt;br /&gt;
&lt;br /&gt;
        btn1.bindEvent(dabo.dEvents.Hit, self.panel1Toggle)&lt;br /&gt;
        btn2.bindEvent(dabo.dEvents.Hit, self.panel2Toggle)&lt;br /&gt;
&lt;br /&gt;
    def onAppTbButton(self, evt):&lt;br /&gt;
        print &amp;quot;Application toolbar button click&amp;quot;&lt;br /&gt;
&lt;br /&gt;
    def onFirst(self, evt): print &#039;First&#039;&lt;br /&gt;
    def onPrior(self, evt): print &#039;Previous&#039;&lt;br /&gt;
    def onNext(self, evt):  print &#039;Next&#039;&lt;br /&gt;
    def onLast(self, evt):  print &#039;Last&#039;&lt;br /&gt;
&lt;br /&gt;
    def onBtnWhatever2(self, evt):&lt;br /&gt;
        print &amp;quot;Whatever 2 defined on MainForm&amp;quot;&lt;br /&gt;
&lt;br /&gt;
    def panel1Toggle(self, evt):&lt;br /&gt;
        panel1 = self.getObjectByRegID(&amp;quot;panel1&amp;quot;)&lt;br /&gt;
        panel1.Visible = not panel1.Visible&lt;br /&gt;
        self.layout()&lt;br /&gt;
&lt;br /&gt;
    def panel2Toggle(self, evt):&lt;br /&gt;
        panel2 = self.getObjectByRegID(&amp;quot;panel2&amp;quot;)&lt;br /&gt;
        panel2.Visible = not panel2.Visible&lt;br /&gt;
        self.layout()&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
if __name__ == &#039;__main__&#039;:&lt;br /&gt;
    app = dabo.dApp()&lt;br /&gt;
    app.MainFormClass = MainForm&lt;br /&gt;
    app.start()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Discussion&#039;&#039;&#039;: If set on a panel the Toolbar&#039;s parent must be the panel - in fact this is the same as any other widget.&lt;br /&gt;
&lt;br /&gt;
It is interesting to note that forms are the natural mediators between dabo controls and bizobjects, thus offer a lot of bizobj related functionality that should be explored. A conclusion is that most code should be defined at the form level and not at panel level. A good example of this is the bizobj navigation supplied by the panel2 toolbar.&lt;br /&gt;
&lt;br /&gt;
Also note that conceptually the Toolbar in fact behaves just like any other sizer element!&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=How_to_use_a_cdxml_file_in_hand_coded_forms&amp;diff=4184</id>
		<title>How to use a cdxml file in hand coded forms</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=How_to_use_a_cdxml_file_in_hand_coded_forms&amp;diff=4184"/>
		<updated>2020-05-17T14:35:51Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;&amp;#039;&amp;#039;&amp;#039;&amp;lt;span style=&amp;quot;color: red;&amp;quot;&amp;gt;NOTE&amp;lt;/span&amp;gt;&amp;#039;&amp;#039;&amp;#039;: as of revision &amp;#039;&amp;#039;&amp;#039;4384&amp;#039;&amp;#039;&amp;#039;, you can now do the following:  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; # Assuming that &amp;#039;pth&amp;#039; is the path to the...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&#039;&#039;&#039;&amp;lt;span style=&amp;quot;color: red;&amp;quot;&amp;gt;NOTE&amp;lt;/span&amp;gt;&#039;&#039;&#039;: as of revision &#039;&#039;&#039;4384&#039;&#039;&#039;, you can now do the following:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
# Assuming that &#039;pth&#039; is the path to the cdxml class&lt;br /&gt;
cls = dabo.ui.createClass(pth)&lt;br /&gt;
instance = cls(self, Foo=&amp;quot;Bar&amp;quot;, ...)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
For earlier revisions:&lt;br /&gt;
&lt;br /&gt;
Here is an example on how to use a cdxml file as class in a hand coded form:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
from dabo.lib.DesignerXmlConverter import DesignerXmlConverter&lt;br /&gt;
conv = DesignerXmlConverter()&lt;br /&gt;
# Assuming that &#039;pth&#039; is the path to the cdxml class&lt;br /&gt;
cls = conv.classFromXml(pth)&lt;br /&gt;
instance = cls(self, Foo=&amp;quot;Bar&amp;quot;, ...)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Create_an_OpenOffice_SpreadSheet&amp;diff=4183</id>
		<title>Create an OpenOffice SpreadSheet</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Create_an_OpenOffice_SpreadSheet&amp;diff=4183"/>
		<updated>2020-05-17T14:34:05Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;Reporting from Dabo is normally done by using &amp;lt;code&amp;gt;reportWriter.py&amp;lt;/code&amp;gt;. It works very well for document type reports, but often our clients require a spreadsheet. Since my...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Reporting from Dabo is normally done by using &amp;lt;code&amp;gt;reportWriter.py&amp;lt;/code&amp;gt;. It works very well for document type reports, but often our clients require a spreadsheet. Since my clients are using &#039;&#039;&#039;OpenOffice&#039;&#039;&#039; I needed a way to create spreadsheet from Dabo. Turns out that creating an OpenOffice spreadsheet from Dabo is very easy.&lt;br /&gt;
&lt;br /&gt;
Turns out a fellow Pythonian &#039;&#039;&#039;Joseph Colton&#039;&#039;&#039; has written a module to create both OpenOffice spreadsheets and documents. It does not interface with OpenOffice like a COM object in the MS windows worldut creates a file that OpenOffice can read. It can be download from http://ooolib.sourceforge.net&lt;br /&gt;
&lt;br /&gt;
I have created a Dabo self contained example. For you MS windows users you will have to change the path and the OpenOffice executable.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
#!/usr/bin/python&lt;br /&gt;
import os&lt;br /&gt;
import ooolib&lt;br /&gt;
#http://ooolib.sourceforge.net&lt;br /&gt;
import dabo&lt;br /&gt;
import dabo&lt;br /&gt;
dabo.ui.loadUI(&amp;quot;wx&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
# app:&lt;br /&gt;
app = dabo.dApp(MainFormClass=None)&lt;br /&gt;
app.setup()&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
# db:&lt;br /&gt;
con = dabo.db.dConnection(DbType=&#039;sqlite&#039;, Database=&#039;:memory:&#039;)&lt;br /&gt;
cur = con.getDaboCursor()&lt;br /&gt;
cur.execute(&amp;quot;create table customers (id INTEGER PRIMARY KEY, name CHAR, valid INT)&amp;quot;)&lt;br /&gt;
cur.execute(&amp;quot;insert into customers (name, valid) values (&#039;Paul&#039;, 0)&amp;quot;)&lt;br /&gt;
cur.execute(&amp;quot;insert into customers (name, valid) values (&#039;John&#039;, 1)&amp;quot;)&lt;br /&gt;
cur.execute(&amp;quot;insert into customers (name, valid) values (&#039;Larry&#039;, 2)&amp;quot;)&lt;br /&gt;
cur.execute(&amp;quot;insert into customers (name, valid) values (&#039;Ed&#039;, 3)&amp;quot;)&lt;br /&gt;
cur.execute(&amp;quot;insert into customers (name, valid) values (&#039;Viola&#039;, 4)&amp;quot;)&lt;br /&gt;
cur.execute(&amp;quot;insert into customers (name, valid) values (&#039;Bill&#039;, 5)&amp;quot;)&lt;br /&gt;
cur.execute(&amp;quot;insert into customers (name, valid) values (&#039;Pascale&#039;, 6)&amp;quot;)&lt;br /&gt;
cur.execute(&amp;quot;insert into customers (name, valid) values (&#039;Donna&#039;, 7)&amp;quot;)&lt;br /&gt;
cur.flush()&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
# biz:&lt;br /&gt;
biz = dabo.biz.dBizobj(con)&lt;br /&gt;
biz.DataSource = &amp;quot;customers&amp;quot;&lt;br /&gt;
biz.KeyField = &amp;quot;id&amp;quot;&lt;br /&gt;
biz.UserSQL = &amp;quot;select id, name, valid from customers&amp;quot;&lt;br /&gt;
biz.DataStructure = (&lt;br /&gt;
        # (field_alias, field_type, pk, table_name, field_name, field_scale)&lt;br /&gt;
        (&amp;quot;id&amp;quot;, &amp;quot;I&amp;quot;, True, &amp;quot;customers&amp;quot;, &amp;quot;id&amp;quot;),&lt;br /&gt;
        (&amp;quot;name&amp;quot;, &amp;quot;C&amp;quot;, False, &amp;quot;customers&amp;quot;, &amp;quot;name&amp;quot;),&lt;br /&gt;
        (&amp;quot;valid&amp;quot;, &amp;quot;B&amp;quot;, False, &amp;quot;customers&amp;quot;, &amp;quot;valid&amp;quot;))&lt;br /&gt;
&lt;br /&gt;
biz.requery()&lt;br /&gt;
#the UI&lt;br /&gt;
frm = dabo.ui.dForm()&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
def btnCreate(evt):&lt;br /&gt;
    &amp;quot;&amp;quot;&amp;quot; Set values.  The values are set in column, row order, but the values are&lt;br /&gt;
    not in the traditional &amp;quot;A5&amp;quot; style format.  Instead we require two integers.&lt;br /&gt;
    set_cell_value(col, row, datatype, value)&amp;quot;&amp;quot;&amp;quot;&lt;br /&gt;
    doc = ooolib.Calc()&lt;br /&gt;
    ds=biz.getDataSet()&lt;br /&gt;
    row_num=1  ## start with 1 = A1&lt;br /&gt;
    for row in ds:&lt;br /&gt;
        col_num=1&lt;br /&gt;
        for cols in row.keys():&lt;br /&gt;
            if type(row[cols]) is bool:&lt;br /&gt;
                columntype=&#039;bool&#039;&lt;br /&gt;
            elif type(row[cols]) is int:&lt;br /&gt;
                columntype=&#039;float&#039;&lt;br /&gt;
            elif type(row[cols]) is unicode:&lt;br /&gt;
                columntype=&#039;string&#039;&lt;br /&gt;
            # OK let&#039;s write out the data to spreadsheet&lt;br /&gt;
            doc.set_cell_value(col_num, row_num, columntype, row[cols])&lt;br /&gt;
            col_num=col_num+1&lt;br /&gt;
            row_num=row_num+1&lt;br /&gt;
&lt;br /&gt;
    # Save the document to the file you want to create.&lt;br /&gt;
    # You need to change the path to match your environment&lt;br /&gt;
    doc.save(&amp;quot;/home/johnf/dabo-example01.ods&amp;quot;)&lt;br /&gt;
    #below will allow me to open the spreadsheet using OpenOffice (linux)&lt;br /&gt;
    # I believe windows users need &#039;scalc.exe&#039;&lt;br /&gt;
    os.popen2(&#039;/usr/bin/oocalc /home/johnf/dabo-example01.ods&#039;)&lt;br /&gt;
&lt;br /&gt;
theButton = dabo.ui.dButton(frm,Caption=&amp;quot;Push Me&amp;quot;,OnHit=btnCreate)&lt;br /&gt;
frm.Sizer.append1x(theButton)&lt;br /&gt;
&lt;br /&gt;
#run it&lt;br /&gt;
frm.show()&lt;br /&gt;
app.start()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=How_To_Overlay_Controls&amp;diff=4182</id>
		<title>How To Overlay Controls</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=How_To_Overlay_Controls&amp;diff=4182"/>
		<updated>2020-05-17T14:27:49Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;A small example of using dPageFrameNoTabs to allow overlaying textboxes on a form. Written by &amp;#039;&amp;#039;&amp;#039;Larry Long&amp;#039;&amp;#039;&amp;#039; and &amp;#039;&amp;#039;&amp;#039;John Fabiani&amp;#039;&amp;#039;&amp;#039; (the suggestion of using dPageFrame...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;A small example of using [[dPageFrameNoTabs]] to allow overlaying textboxes on a form. Written by &#039;&#039;&#039;Larry Long&#039;&#039;&#039; and &#039;&#039;&#039;John Fabiani&#039;&#039;&#039; (the suggestion of using [[dPageFrameNoTabs]] came from &#039;&#039;&#039;Ed Leafe&#039;&#039;&#039;)&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
import dabo&lt;br /&gt;
dabo.ui.loadUI(&amp;quot;wx&amp;quot;)&lt;br /&gt;
import dabo.dEvents as dEvents&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class KiloPanel(dabo.ui.dPanel):&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        self.Sizer = hs = dabo.ui.dSizer(&amp;quot;h&amp;quot;)&lt;br /&gt;
        hs.append(dabo.ui.dTextBox(self),proportion=3,alignment=&#039;right&#039;)&lt;br /&gt;
        hs.append(dabo.ui.dLabel(self,Caption=&#039; Kg&#039;))&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class LbsPanel(dabo.ui.dPanel):&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        self.Sizer = hs = dabo.ui.dSizer(&amp;quot;h&amp;quot;)&lt;br /&gt;
        hs.append(dabo.ui.dTextBox(self),proportion=3,alignment=&#039;right&#039;)&lt;br /&gt;
        hs.append(dabo.ui.dLabel(self,Caption=&#039; Lbs  &#039;))&lt;br /&gt;
        hs.append(dabo.ui.dTextBox(self),proportion=1,alignment=&#039;right&#039;)&lt;br /&gt;
        hs.append(dabo.ui.dLabel(self,Caption=&#039; Oz&#039;))&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class Wtpgf(dabo.ui.dPanel):&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        self.Sizer = hs = dabo.ui.dSizer(&amp;quot;h&amp;quot;)&lt;br /&gt;
        #hs.append(dabo.ui.dLabel(self,Caption=&#039;hellow worl;d&#039;))&lt;br /&gt;
        pageFrame = pgf = dabo.ui.dPageFrameNoTabs(self,DynamicSelectedPageNumber=self.GetDisplayMode,RegID=&#039;WtPgf&#039;)&lt;br /&gt;
        pgf.appendPage(pgCls=KiloPanel)&lt;br /&gt;
        pgf.appendPage(pgCls=LbsPanel)&lt;br /&gt;
        hs.append(pgf, 1,&amp;quot;x&amp;quot;) &lt;br /&gt;
    def GetDisplayMode(self):&lt;br /&gt;
        return(self.Form.WtDisplayMode) &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class TestForm(dabo.ui.dForm):&lt;br /&gt;
    def afterInit(self):&lt;br /&gt;
        self.WtDisplayMode=1&lt;br /&gt;
        self.Sizer = dabo.ui.dSizer(&amp;quot;vertical&amp;quot;)&lt;br /&gt;
        self.Sizer.append1x(Wtpgf(self))&lt;br /&gt;
        self.Sizer.append(dabo.ui.dButton(self,Caption=&#039;Click me&#039;,OnHit=self.clickme))&lt;br /&gt;
        self.layout()&lt;br /&gt;
    def clickme(self,evt):&lt;br /&gt;
        if self.WtDisplayMode:&lt;br /&gt;
            self.WtDisplayMode=0&lt;br /&gt;
        else:&lt;br /&gt;
            self.WtDisplayMode=1&lt;br /&gt;
        self.update()       &lt;br /&gt;
        evt.stop()  &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
def main():&lt;br /&gt;
   app = dabo.dApp()&lt;br /&gt;
   app.MainFormClass = TestForm&lt;br /&gt;
   app.start()&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
if __name__ == &#039;__main__&#039;:&lt;br /&gt;
   main()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToVisuallyFloatAControl&amp;diff=4181</id>
		<title>HowToVisuallyFloatAControl</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToVisuallyFloatAControl&amp;diff=4181"/>
		<updated>2020-05-17T14:26:04Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; from dabo import dApp from MySQLdb import escape_string  # Set up dabo app = dApp() app.setup(False)  # Set up connection connection = app.getC...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
from dabo import dApp&lt;br /&gt;
from MySQLdb import escape_string&lt;br /&gt;
&lt;br /&gt;
# Set up dabo&lt;br /&gt;
app = dApp()&lt;br /&gt;
app.setup(False)&lt;br /&gt;
&lt;br /&gt;
# Set up connection&lt;br /&gt;
connection = app.getConnectionByName(&amp;quot;Your connection name&amp;quot;)&lt;br /&gt;
crs = connection.getDaboCursor()&lt;br /&gt;
&lt;br /&gt;
binarydata = &amp;quot;This could be anything, including pictures, executables etc.&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# Make sure the blob type is large enough to hold your binary data&lt;br /&gt;
crs.execute(&amp;quot;&amp;quot;&amp;quot;CREATE TEMPORARY TABLE blobtable (b BLOB)&amp;quot;&amp;quot;&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
# We need to escape our binary value so MySQLdb doesn&#039;t try to add it as a string&lt;br /&gt;
#crs.execute(&amp;quot;&amp;quot;&amp;quot;INSERT INTO blobtable SET b=&amp;quot;%s&amp;quot; &amp;quot;&amp;quot;&amp;quot; % escape_string(binarydata))&lt;br /&gt;
&lt;br /&gt;
# PKM: actually, I&#039;ve found that this step isn&#039;t necessary. Just &lt;br /&gt;
# remove the quotes, e.g.:&lt;br /&gt;
crs.execute(&amp;quot;INSERT INTO blobtable SET b=%s&amp;quot; % binarydata)&lt;br /&gt;
&lt;br /&gt;
# A normal error here is &amp;quot;MySQL server has gone away&amp;quot;. This could mean that&lt;br /&gt;
# the server has lost connection, or that the query is larger than MySQL is&lt;br /&gt;
# configured to accept. To change this value edit My.ini (in the MySQL server directory),&lt;br /&gt;
# and add the line &amp;quot;max_allowed_packet=xM&amp;quot; where x is the allowed size of the query.&lt;br /&gt;
# This should be at least the size of the file you are trying to add.&lt;br /&gt;
&lt;br /&gt;
# Print our data and verify that it is right&lt;br /&gt;
crs.execute(&amp;quot;&amp;quot;&amp;quot;SELECT b FROM blobtable&amp;quot;&amp;quot;&amp;quot;)&lt;br /&gt;
bindata = crs.getDataSet()[0][&amp;quot;b&amp;quot;]&lt;br /&gt;
print &amp;quot;Retrieved data:&amp;quot;, bindata&lt;br /&gt;
print &amp;quot;It has the same value?&amp;quot;, binarydata == bindata&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToCreateAFormWithAGridAndPopulateItWithData&amp;diff=4180</id>
		<title>HowToCreateAFormWithAGridAndPopulateItWithData</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToCreateAFormWithAGridAndPopulateItWithData&amp;diff=4180"/>
		<updated>2020-05-17T14:24:37Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;First, create a directory to hold the files. I&amp;#039;m calling mine &amp;lt;code&amp;gt;test&amp;lt;/code&amp;gt;.  Next, define the connection to the database by running the &amp;lt;code&amp;gt;CxnEditor.py&amp;lt;/code&amp;gt; script i...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;First, create a directory to hold the files. I&#039;m calling mine &amp;lt;code&amp;gt;test&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Next, define the connection to the database by running the &amp;lt;code&amp;gt;CxnEditor.py&amp;lt;/code&amp;gt; script in the Dabo IDE directory. I&#039;m defining a connection to the public &#039;&#039;&#039;MySQL&#039;&#039;&#039; webtest database on the &#039;&#039;&#039;dabodev.com&#039;&#039;&#039; server. Once the connection is working (click the &amp;lt;code&amp;gt;Test...&amp;lt;/code&amp;gt; button to check it!), click the &amp;lt;code&amp;gt;Save&amp;lt;/code&amp;gt; button to save the connection information into your app directory. It creates a small XML file with a &#039;&#039;&#039;.cnxml&#039;&#039;&#039; extension that holds all the information Dabo needs to connect to that database. Make sure to give the connection a meaningful name, since that&#039;s what is used to load it later on; I called mine &#039;&#039;&#039;main&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
OK, now we&#039;re ready to fire up the &#039;&#039;&#039;Class Designer&#039;&#039;&#039;. I&#039;m going to add a grid to the form by right-clicking on the main surface, and selecting &#039;&#039;&#039;Data Controls/ Add Grid&#039;&#039;&#039; from the popup menu, and accepting the default of 3 columns for the grid. I then select the &amp;lt;code&amp;gt;Property Sheet&amp;lt;/code&amp;gt;, which shows that &#039;&#039;&#039;dGrid&#039;&#039;&#039; is the current selection. I want to give the grid a [[RegID]], so that I can more easily refer to it in code, so I enter &amp;lt;code&amp;gt;gridZip&amp;lt;/code&amp;gt; as the value in the [[RegID]] property.&lt;br /&gt;
&lt;br /&gt;
Next I want to customize the &amp;lt;code&amp;gt;Columns&amp;lt;/code&amp;gt;. I can select each by clicking on them in the Designer surface, or by selecting them in the &#039;&#039;&#039;Object Tree&#039;&#039;&#039;, or by pressing &amp;lt;code&amp;gt;Ctrl-PageUp/Down&amp;lt;/code&amp;gt; (&amp;lt;code&amp;gt;Cmd-PageUp/Down&amp;lt;/code&amp;gt; on OSX) to change the selected object. For each column I want to set the &amp;lt;code&amp;gt;Caption&amp;lt;/code&amp;gt; property to something meaningful, and set the [[DataField]] property to the name of the field in the zipcodes table that will be displayed in that column. So the columns are set so that their &amp;lt;code&amp;gt;Captions&amp;lt;/code&amp;gt; are &#039;&#039;&#039;City&#039;&#039;&#039;, &#039;&#039;&#039;State&#039;&#039;&#039; and &#039;&#039;&#039;Zip&#039;&#039;&#039;, respectively, while the [[DataField]] properties are set to &#039;&#039;&#039;ccity&#039;&#039;&#039;, &#039;&#039;&#039;cstateprov&#039;&#039;&#039; and &#039;&#039;&#039;czip&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
If desired, you can set the column widths by dragging the vertical separator lines in the Designer surface, or by manually setting the &amp;lt;code&amp;gt;Width&amp;lt;/code&amp;gt; property in the prop sheet for each.&lt;br /&gt;
&lt;br /&gt;
Now comes the fun part! Select the &#039;&#039;&#039;Code Editor&#039;&#039;&#039; window, and with the &#039;&#039;&#039;Object&#039;&#039;&#039; dropdown set to the form, select &amp;lt;code&amp;gt;afterInitAll&amp;lt;/code&amp;gt; from the &#039;&#039;&#039;Method&#039;&#039;&#039; dropdown.&lt;br /&gt;
&lt;br /&gt;
What we want to do is get the connection, create the bizobj from that connection, configure it to get the data we want, and then populate the grid with that data. Here&#039;s the &amp;lt;code&amp;gt;afterInitAll()&amp;lt;/code&amp;gt; code that is needed to do just that; the comments explain what each bit of code does.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
def afterInitAll(self):&lt;br /&gt;
    # The app may automatically load this connection definition,&lt;br /&gt;
    # but just in case it isn&#039;t in the path, we can load it manually. No&lt;br /&gt;
    # connection is made, so there is no harm in adding a connection&lt;br /&gt;
    # definition more than once.&lt;br /&gt;
    self.Application.addConnectFile(&amp;quot;test.cnxml&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
    # This call will actually create the connection if it hasn&#039;t already&lt;br /&gt;
    # been made. If it has, it returns the existing connection, so that &lt;br /&gt;
    # multiple connections aren&#039;t used up.&lt;br /&gt;
    conn = self.Application.getConnectionByName(&amp;quot;main&amp;quot;)&lt;br /&gt;
    # Now create the bizobj, using the connection.&lt;br /&gt;
    biz = dabo.biz.dBizobj(conn)&lt;br /&gt;
    # These two properties are essential for every bizobj.&lt;br /&gt;
    biz.DataSource = &amp;quot;zipcodes&amp;quot;&lt;br /&gt;
    biz.KeyField = &amp;quot;iid&amp;quot;&lt;br /&gt;
    # Add it to the form&#039;s collection of bizobj references&lt;br /&gt;
    self.addBizobj(biz)&lt;br /&gt;
&lt;br /&gt;
    # Now set up the fields &lt;br /&gt;
    biz.addField(&amp;quot;iid&amp;quot;)&lt;br /&gt;
    biz.addField(&amp;quot;ccity&amp;quot;)&lt;br /&gt;
    biz.addField(&amp;quot;cstateprov&amp;quot;)&lt;br /&gt;
    biz.addField(&amp;quot;czip&amp;quot;)&lt;br /&gt;
    # Add a WHERE clause to limit the result set&lt;br /&gt;
    biz.addWhere(&amp;quot;ccity = &#039;Springfield&#039; &amp;quot;)&lt;br /&gt;
    # Run the query&lt;br /&gt;
    self.requery()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
That&#039;s it! Save the class design into your app directory. You can test it directly from the &#039;&#039;&#039;Class Designer&#039;&#039;&#039; by selecting &amp;lt;code&amp;gt;Run...&amp;lt;/code&amp;gt; from the &#039;&#039;&#039;File&#039;&#039;&#039; menu, or you can select &amp;lt;code&amp;gt;Save Runnable App&amp;lt;/code&amp;gt; to create a &#039;&#039;&#039;.py&#039;&#039;&#039; file you can run directly. Either way, when you run the form, you&#039;ll have a fully-functional grid, populated with the data you specified.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToLimitInputCharactersInATextBox&amp;diff=4179</id>
		<title>HowToLimitInputCharactersInATextBox</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToLimitInputCharactersInATextBox&amp;diff=4179"/>
		<updated>2020-05-17T14:18:21Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;Right now the only way is to use the new &amp;lt;code&amp;gt;ForceCase&amp;lt;/code&amp;gt; property, which can be one of:  * &amp;quot;&amp;#039;&amp;#039;&amp;#039;upper&amp;#039;&amp;#039;&amp;#039;&amp;quot;, &amp;quot;&amp;#039;&amp;#039;&amp;#039;u&amp;#039;&amp;#039;&amp;#039;&amp;quot; - all alpha characters forced to UPPER CASE * &amp;quot;&amp;#039;&amp;#039;&amp;#039;lo...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Right now the only way is to use the new &amp;lt;code&amp;gt;ForceCase&amp;lt;/code&amp;gt; property, which can be one of:&lt;br /&gt;
&lt;br /&gt;
* &amp;quot;&#039;&#039;&#039;upper&#039;&#039;&#039;&amp;quot;, &amp;quot;&#039;&#039;&#039;u&#039;&#039;&#039;&amp;quot; - all alpha characters forced to UPPER CASE&lt;br /&gt;
* &amp;quot;&#039;&#039;&#039;lower&#039;&#039;&#039;&amp;quot;, &amp;quot;&#039;&#039;&#039;l&#039;&#039;&#039;&amp;quot; - all alpha characters forced to lower case.&lt;br /&gt;
* &amp;quot;&#039;&#039;&#039;title&#039;&#039;&#039;&amp;quot;, &amp;quot;&#039;&#039;&#039;t&#039;&#039;&#039;&amp;quot; - all alpha characters forced to Title Case&lt;br /&gt;
* &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;, &amp;quot;&amp;quot; (default) - no change made to characters&lt;br /&gt;
&lt;br /&gt;
We are looking into adding more such features, such as an InputMask property that will allow input of formatted text, such as telephone numbers, SSNs, and the like, as well as character filter expressions to limit the characters that can be entered. Nothing definite yet; stay tuned!&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Added March 07&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;TextLength = integer&amp;lt;/code&amp;gt; - limits the total number of chars allowed.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToPopulateAndUseListControls&amp;diff=4178</id>
		<title>HowToPopulateAndUseListControls</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToPopulateAndUseListControls&amp;diff=4178"/>
		<updated>2020-05-17T14:15:35Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;A common need in an application is to create a list of choices for the user, who makes a selection. The items in the list correspond to a lookup table, and what is stored in t...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;A common need in an application is to create a list of choices for the user, who makes a selection. The items in the list correspond to a lookup table, and what is stored in the current table&#039;s record is a foreign key (FK) that points to the entry in the lookup table.&lt;br /&gt;
&lt;br /&gt;
There are three controls that can be used to display a list of choices like this: ([[dListBox]], [[dDropdownList]], and [[dComboBox]]). They all share the same properties to control list selection behavior, so no matter which one you use in your app, the steps are the same.&lt;br /&gt;
&lt;br /&gt;
First, create a method in your bizobj to get the available choices and their corresponding key values. Exactly how you get them depends on your database design, but something like this should get you started:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
# This is in your bizobj class&lt;br /&gt;
def getAvailableTypes(self):&lt;br /&gt;
    &amp;quot;&amp;quot;&amp;quot;Return a 2-tuple of lists of the types and their keys.&amp;quot;&amp;quot;&amp;quot;&lt;br /&gt;
    crs = self.getTempCursor()&lt;br /&gt;
    crs.execute(&amp;quot;select pk, typename from mytable order by typename&amp;quot;)&lt;br /&gt;
    ds = crs.getDataSet()&lt;br /&gt;
    # Create the lists&lt;br /&gt;
    names = [rec[&amp;quot;typename&amp;quot;] for rec in ds]&lt;br /&gt;
    keys = [rec[&amp;quot;pk&amp;quot;] for rec in ds]&lt;br /&gt;
    return (names, keys)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Then create your list with the following properties:&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;DataSource&#039;&#039;&#039; = &amp;lt;bizobj&#039;s [[DataSource]]&amp;gt;&lt;br /&gt;
* &#039;&#039;&#039;DataField&#039;&#039;&#039; = &amp;lt;name of the FK field in your table&amp;gt;&lt;br /&gt;
* &#039;&#039;&#039;ValueMode&#039;&#039;&#039; = &amp;quot;&amp;lt;code&amp;gt;Key&amp;lt;/code&amp;gt;&amp;quot;&lt;br /&gt;
* &#039;&#039;&#039;Choices&#039;&#039;&#039; = &amp;lt;list of values (without keys) that should appear in the list&amp;gt;&lt;br /&gt;
* &#039;&#039;&#039;Keys&#039;&#039;&#039; = &amp;lt;list of keys for the &amp;lt;code&amp;gt;Choices&amp;lt;/code&amp;gt; values&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Note that the lists for &amp;lt;code&amp;gt;Choices&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;Keys&amp;lt;/code&amp;gt; should be in the same order, so that the first element of &amp;lt;code&amp;gt;Keys&amp;lt;/code&amp;gt; is the key for the first element of &amp;lt;code&amp;gt;Choices&amp;lt;/code&amp;gt;, and the second element of &amp;lt;code&amp;gt;Keys&amp;lt;/code&amp;gt;... etc.&lt;br /&gt;
&lt;br /&gt;
Now when you navigate to a record, the FK value in the [[DataField]] of that record will cause the list control to show the corresponding name. If the user selects a different item from the list, the FK will be updated with the new choice&#039;s key.&lt;br /&gt;
&lt;br /&gt;
(Newbie [[AppWizard]] users: see http://leafe.com/archives/msg/342481 to access your bizObj from the ui)&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=How_To_Log_Executed_SQL&amp;diff=4177</id>
		<title>How To Log Executed SQL</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=How_To_Log_Executed_SQL&amp;diff=4177"/>
		<updated>2020-05-17T14:11:20Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;By default, Dabo does not log database activity. However, you can change this by setting the Application object&amp;#039;s &amp;lt;code&amp;gt;DatabaseActivityLog&amp;lt;/code&amp;gt; property to either:  # the p...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;By default, Dabo does not log database activity. However, you can change this by setting the Application object&#039;s &amp;lt;code&amp;gt;DatabaseActivityLog&amp;lt;/code&amp;gt; property to either:&lt;br /&gt;
&lt;br /&gt;
# the path to the log file or&lt;br /&gt;
# an open file-like object (e.g., &amp;lt;code&amp;gt;sys.stdout&amp;lt;/code&amp;gt;)&lt;br /&gt;
&lt;br /&gt;
Once this is set, all database execution, including any parameters, will be written to that log. To turn off logging, simply set the &amp;lt;code&amp;gt;DatabaseActivityLog&amp;lt;/code&amp;gt; property to &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=How_To_Get_Foreign_Keys_Set&amp;diff=4176</id>
		<title>How To Get Foreign Keys Set</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=How_To_Get_Foreign_Keys_Set&amp;diff=4176"/>
		<updated>2020-05-17T14:09:48Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;You need to set &amp;lt;code&amp;gt;bizobj.FillLinkFromParent&amp;lt;/code&amp;gt; to &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;.  Of cause you also have to supply the usual information for the parent-child relation:  &amp;lt;syntaxhig...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;You need to set &amp;lt;code&amp;gt;bizobj.FillLinkFromParent&amp;lt;/code&amp;gt; to &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Of cause you also have to supply the usual information for the parent-child relation:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
childBizobj.FillLinkFromParent = True&lt;br /&gt;
childBizobj.LinkField = &amp;quot;parent_iid&amp;quot;&lt;br /&gt;
parentBizobj.addChild(childBizobj)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToSetupParent-Child-Grandchild&amp;diff=4175</id>
		<title>HowToSetupParent-Child-Grandchild</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToSetupParent-Child-Grandchild&amp;diff=4175"/>
		<updated>2020-05-17T14:08:26Z</updated>

		<summary type="html">&lt;p&gt;Ed: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;You will get the full benefit of this document by first watching the screencasts &amp;quot;Using the Data Environment&amp;quot; parts 1 &amp;amp; 2.&lt;br /&gt;
&lt;br /&gt;
First, create the bizobjs. I&#039;m assuming that you&#039;ve specified the [[KeyField]] and [[LinkField]] properties in the bizobj classes. If using the [[ClassDesigner]], this would be located near the end of the &amp;lt;code&amp;gt;createBizobjs()&amp;lt;/code&amp;gt; method of the Form.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
bizParent = MyParentBizobjClass(conn)&lt;br /&gt;
bizChild = MyChildBizobjClass(conn)&lt;br /&gt;
bizGrandchild = MyGrandchildBizobjClass(conn)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Now add each to its parent:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
bizParent.addChild(bizChild)&lt;br /&gt;
bizChild.addChild(bizGrandchild)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Setting up an Parent-Child relationship, like a customer and his/her orders, is very easily done, as shown by Ed Leafe in the screencast, but what if you want to be able to not only choose a customer and order, but also view/edit the particular items in that order? I&#039;ll start by giving you some helpful hints and fill in more information, screenshots, etc, at a later date.&lt;br /&gt;
&lt;br /&gt;
In the screencast, Ed adds the code &amp;lt;code&amp;gt;self.Form.next()&amp;lt;/code&amp;gt; to the &amp;lt;code&amp;gt;onHit()&amp;lt;/code&amp;gt; method of his &#039;&#039;&#039;Next&#039;&#039;&#039; button for advancing to the next customer. If you build a similar interface for the orders, with navigation buttons and text fields, you cannot use a plain &amp;lt;code&amp;gt;self.Form.next()&amp;lt;/code&amp;gt; because it will advance to the next customer rather than the next order. You need to explicitly tell it the order&#039;s datasource:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
def onHit(self):&lt;br /&gt;
   self.Form.next(&#039;orders&#039;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
More hints to come...&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToSetupParent-Child-Grandchild&amp;diff=4174</id>
		<title>HowToSetupParent-Child-Grandchild</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToSetupParent-Child-Grandchild&amp;diff=4174"/>
		<updated>2020-05-17T14:07:53Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;You will get the full benefit of this document by first watching the screencasts &amp;quot;Using the Data Environment&amp;quot; parts 1 &amp;amp; 2.  First, create the bizobjs. I&amp;#039;m assuming that you&amp;#039;ve...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;You will get the full benefit of this document by first watching the screencasts &amp;quot;Using the Data Environment&amp;quot; parts 1 &amp;amp; 2.&lt;br /&gt;
&lt;br /&gt;
First, create the bizobjs. I&#039;m assuming that you&#039;ve specified the KeyField and LinkField properties in the bizobj classes. If using the ClassDesigner, this would be located near the end of the .createBizobjs() method of the Form.&lt;br /&gt;
&lt;br /&gt;
bizParent = MyParentBizobjClass(conn)&lt;br /&gt;
bizChild = MyChildBizobjClass(conn)&lt;br /&gt;
bizGrandchild = MyGrandchildBizobjClass(conn)&lt;br /&gt;
Now add each to its parent:&lt;br /&gt;
&lt;br /&gt;
bizParent.addChild(bizChild)&lt;br /&gt;
bizChild.addChild(bizGrandchild)&lt;br /&gt;
Setting up an Parent-Child relationship, like a customer and his/her orders, is very easily done, as shown by Ed Leafe in the screencast, but what if you want to be able to not only choose a customer and order, but also view/edit the particular items in that order? I&#039;ll start by giving you some helpful hints and fill in more information, screenshots, etc, at a later date.&lt;br /&gt;
&lt;br /&gt;
In the screencast, Ed adds the code self.Form.next() to the .onHit() method of his Next button for advancing to the next customer. If you build a similar interface for the orders, with navigation buttons and text fields, you cannot use a plain self.Form.next() because it will advance to the next customer rather than the next order. You need to explicitly tell it the order&#039;s datasource:&lt;br /&gt;
def onHit(self):&lt;br /&gt;
   self.Form.next(&#039;orders&#039;)&lt;br /&gt;
More hints to come...&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToTurnPreferencesOff&amp;diff=4173</id>
		<title>HowToTurnPreferencesOff</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToTurnPreferencesOff&amp;diff=4173"/>
		<updated>2020-05-17T14:04:55Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;If you do not want to use Preferences at all, set  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; app.UserSettingProviderClass = None &amp;lt;/syntaxhighlight&amp;gt;  in the initProperties() of your app...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;If you do not want to use Preferences at all, set&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
app.UserSettingProviderClass = None&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
in the initProperties() of your app class. If you want to use it during runtime, use&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
app.UserSettingProvider = None&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToCustomizeCheckboxes&amp;diff=4172</id>
		<title>HowToCustomizeCheckboxes</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToCustomizeCheckboxes&amp;diff=4172"/>
		<updated>2020-05-17T14:03:37Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;How To Customize a Check Box  If you need a column that can assume only one of two mutually exclusive values, a way to manage it in the front end is to use a dCheckbox.  Nativ...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;How To Customize a Check Box&lt;br /&gt;
&lt;br /&gt;
If you need a column that can assume only one of two mutually exclusive values, a way to manage it in the front end is to use a dCheckbox.&lt;br /&gt;
&lt;br /&gt;
Natively dCheckbox binds to a boolean (true/false) column , but sometimes is useful to have two values for the field and may be another couple of values to display to the user, and both of them sometimes cannot be boolean. An example can clarify this situation (the database is postgres 8.1);&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;sql&amp;quot;&amp;gt;&lt;br /&gt;
  CREATE TABLE t_preferences (&lt;br /&gt;
    c_username character varying(30) NOT NULL,&lt;br /&gt;
    c_likes_salty_food character(1) NOT NULL DEFAULT &#039;N&#039;::bpchar,&lt;br /&gt;
    CONSTRAINT t_preferences_pk PRIMARY KEY (c_username),&lt;br /&gt;
    CONSTRAINT t_preferences_ck_likes_salty_food CHECK c_likes_salty_food = &#039;Y&#039;::bpchar OR c_likes_salty_food = &#039;N&#039;::bpchar) &lt;br /&gt;
    )&lt;br /&gt;
  WITHOUT OIDS;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
So a user can prefer to have an extra salt (character &amp;lt;code&amp;gt;Y&amp;lt;/code&amp;gt;) or a normal amount of salt (character &amp;lt;code&amp;gt;N&amp;lt;/code&amp;gt;) in his food.&lt;br /&gt;
&lt;br /&gt;
And in the front end we would like to have a checkbox that shows &#039;&#039;&#039;Salty&#039;&#039;&#039; if checked or &#039;&#039;&#039;Normal&#039;&#039;&#039; if unchecked.&lt;br /&gt;
&lt;br /&gt;
To bind a checkbox to this column is a two step procedure:&lt;br /&gt;
&lt;br /&gt;
First, you&#039;d create a property (let&#039;s call it &amp;lt;code&amp;gt;LikesSalt&amp;lt;/code&amp;gt; in the bizobj that would handle the conversion, and bind to that property. The bizobj class would contain the following code:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
def _getLikesSalt(self):&lt;br /&gt;
    YorN = self.getFieldVal(&amp;quot;c_likes_salty_food&amp;quot;)&lt;br /&gt;
    l_value = (YorN == &amp;quot;S&amp;quot;)&lt;br /&gt;
    print &amp;quot;getLikesSalt: YorN =&amp;quot;, YorN , &amp;quot; value=&amp;quot;, l_value&lt;br /&gt;
    return l_value&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
def _setLikesSalt(self, val):&lt;br /&gt;
    YorN = {True: &amp;quot;Y&amp;quot;, False: &amp;quot;N&amp;quot;}[val]&lt;br /&gt;
    print  &amp;quot;setLikesSalt: YorN =&amp;quot;, YorN &lt;br /&gt;
    self.setFieldVal(&amp;quot;c_likes_salty_food&amp;quot;, YorN)&lt;br /&gt;
&lt;br /&gt;
LikesSalt = property(_getLikesSalt, _setLikesSalt, None,&lt;br /&gt;
    _(&amp;quot;Intermediate to convert the Y/N column to a boolean  (bool)&amp;quot;))&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Second, you need to open the [[ClassDesigner]] and set the [[DataSource]] property to a reference to the bizobj, and [[DataField]] property to &#039;&#039;&#039;LikesSalt&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
==== Questions for Ed by Luca: ====&lt;br /&gt;
&lt;br /&gt;
1) What is the dabo way to get a reference to the bizobj from the class designer?&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;ed: Just type the [[DataSource]] of the bizobj you want. The framework handles resolving that.&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
2) If &amp;lt;code&amp;gt;A&amp;lt;/code&amp;gt; choice is the right one, how can I force a refresh/redraw of the checkbox to show the mark visible to the user? (I mean [X]? flagged or [ ]? unflagged)&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;ed: I&#039;m not sure what you mean. If the current record&#039;s value for &amp;lt;code&amp;gt;LikesSalt&amp;lt;/code&amp;gt; is &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt;, the calling &amp;lt;code&amp;gt;form.update()&amp;lt;/code&amp;gt; will update any data-bound controls.&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
3) How can I show in the caption of the checkbox the string &amp;quot;&#039;&#039;&#039;Salty&#039;&#039;&#039;&amp;quot; or &amp;quot;&#039;&#039;&#039;Normal&#039;&#039;&#039;&amp;quot;? Should I intercept the click on the checkbox and change the caption? There is no way to say to the [[dCheckbox]] to use these strings using the class designer?&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;ed: You can set the initial value using the prop sheet, but there is no native function in a checkbox to change caption when the value changes. You&#039;ll have to write some code and bind it to the &amp;lt;code&amp;gt;ValueChanged&amp;lt;/code&amp;gt; event, since the value can change programmatically (from navigation, etc.) as well as from clicking.&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
luca: I intercepted the &amp;lt;code&amp;gt;onValueChanged&amp;lt;/code&amp;gt; method, and, when I click on the checkbox, the caption gets changed, but this doesn&#039;t happen if I switch to another record pressing a button that invokes a prior() or next() button. Is this a consequence of question 1?&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;ed: Are you calling &amp;lt;code&amp;gt;self.Form.next()&amp;lt;/code&amp;gt; in the button? That should issue the call to the form&#039;s &amp;lt;code&amp;gt;update()&amp;lt;/code&amp;gt; method.&amp;lt;/span&amp;gt;&lt;br /&gt;
&lt;br /&gt;
4) Is there any way to force a &amp;quot;code generation&amp;quot; of the form as it&#039;s been viewed by the [[ClassDesigner]]? Inspecting this source could be very helpful to understand the inner working of the class designer/dabo runtime, and I think it could avoid many questions...&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: blue;&amp;quot;&amp;gt;ed: It doesn&#039;t generate code that is very helpful or elegant, and it does it on the fly, so the result from run to run can change. But if you really want to see it, go to &amp;lt;code&amp;gt;dabo/lib/DesignerXmlConverter.py&amp;lt;/code&amp;gt;, and uncomment line 73.&amp;lt;/span&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToAddBLOBValuesWithMySQL&amp;diff=4171</id>
		<title>HowToAddBLOBValuesWithMySQL</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToAddBLOBValuesWithMySQL&amp;diff=4171"/>
		<updated>2020-05-15T18:50:47Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; from dabo import dApp from MySQLdb import escape_string   # Set up dabo app = dApp() app.setup(False)  # Set up connection connection = app.get...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
from dabo import dApp&lt;br /&gt;
from MySQLdb import escape_string&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
# Set up dabo&lt;br /&gt;
app = dApp()&lt;br /&gt;
app.setup(False)&lt;br /&gt;
&lt;br /&gt;
# Set up connection&lt;br /&gt;
connection = app.getConnectionByName(&amp;quot;Your connection name&amp;quot;)&lt;br /&gt;
crs = connection.getDaboCursor()&lt;br /&gt;
# Make sure the blob type is large enough to hold your binary data&lt;br /&gt;
crs.execute(&amp;quot;&amp;quot;&amp;quot;CREATE TEMPORARY TABLE blobtable (b BLOB)&amp;quot;&amp;quot;&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
binarydata = &amp;quot;This could be anything, including pictures, executables etc.&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# We need to escape our binary value so MySQLdb doesn&#039;t try to add it as a string&lt;br /&gt;
#crs.execute(&amp;quot;&amp;quot;&amp;quot;INSERT INTO blobtable SET b=&amp;quot;%s&amp;quot; &amp;quot;&amp;quot;&amp;quot; % escape_string(binarydata))&lt;br /&gt;
&lt;br /&gt;
# PKM: actually, I&#039;ve found that this step isn&#039;t necessary. Just &lt;br /&gt;
# remove the quotes, e.g.:&lt;br /&gt;
crs.execute(&amp;quot;INSERT INTO blobtable SET b=%s&amp;quot;, (binarydata, ))&lt;br /&gt;
&lt;br /&gt;
# A normal error here is &amp;quot;MySQL server has gone away&amp;quot;. This could mean that&lt;br /&gt;
# the server has lost connection, or that the query is larger than MySQL is&lt;br /&gt;
# configured to accept. To change this value edit My.ini (in the MySQL server directory),&lt;br /&gt;
# and add the line &amp;quot;max_allowed_packet=xM&amp;quot; where x is the allowed size of the query.&lt;br /&gt;
# This should be at least the size of the file you are trying to add.&lt;br /&gt;
&lt;br /&gt;
# Print our data and verify that it is right&lt;br /&gt;
crs.execute(&amp;quot;&amp;quot;&amp;quot;SELECT b FROM blobtable&amp;quot;&amp;quot;&amp;quot;)&lt;br /&gt;
bindata = crs.getDataSet()[0][&amp;quot;b&amp;quot;]&lt;br /&gt;
print &amp;quot;Retrieved data:&amp;quot;, bindata&lt;br /&gt;
print &amp;quot;It has the same value?&amp;quot;, binarydata == bindata&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowToReturnAValueFromAModalForm&amp;diff=4170</id>
		<title>HowToReturnAValueFromAModalForm</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowToReturnAValueFromAModalForm&amp;diff=4170"/>
		<updated>2020-05-15T18:48:44Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;Normally, you make the value an attribute of the form, or, in the alternative, create a method that returns the value(s) you need. Then when the form is closed, instead of rel...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Normally, you make the value an attribute of the form, or, in the alternative, create a method that returns the value(s) you need. Then when the form is closed, instead of releasing it, simply hide() it. This will end the modal state, and allow processing to continue from the point at which the form was originally shown. You then query the form for the desired values, and when you have them, release the form.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;&amp;lt;span style=&amp;quot;color: red&#039;;&amp;quot;&amp;gt;NOTE&amp;lt;/span&amp;gt;&#039;&#039;&#039;: - as of Feb. 2007, &#039;&#039;&#039;wxPython&#039;&#039;&#039; still does not support modal forms. Please use dialog classes if you need modal behavior.&lt;br /&gt;
&lt;br /&gt;
If you are using the [[dOkCancelDialog]] class as your base, it has a property called &amp;lt;code&amp;gt;Accepted&amp;lt;/code&amp;gt; that is set to &amp;lt;code&amp;gt;True&amp;lt;/code&amp;gt; if they click &amp;lt;code&amp;gt;OK&amp;lt;/code&amp;gt;, and &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt; if they click &amp;lt;code&amp;gt;Cancel&amp;lt;/code&amp;gt;. That way you know whether to process the results or not. It is generally easier to work with dialogs when you need modal states, as wxPython doesn&#039;t handle modal forms very well.&lt;br /&gt;
&lt;br /&gt;
== Examples: ==&lt;br /&gt;
&lt;br /&gt;
==== Dialog: ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
class ExampleDialog(dabo.ui.dOkCancelDialog):&lt;br /&gt;
   def addControls(self):&lt;br /&gt;
      # add your controls here&lt;br /&gt;
&lt;br /&gt;
dlg = ExampleDialog()&lt;br /&gt;
dlg.show()&lt;br /&gt;
if dlg.Accepted:&lt;br /&gt;
   self.doSomethingWithNames(dlg.firstname, dlg.lastname)&lt;br /&gt;
dlg.release()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
==== Modal Form: ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
frm = dabo.ui.dForm(None)&lt;br /&gt;
frm.addObject(whatever...)&lt;br /&gt;
# NOTE: this doesn&#039;t show modally (yet)&lt;br /&gt;
frm.showModal()&lt;br /&gt;
firstname, lastname = frm.getNames()&lt;br /&gt;
if firstname is not None:&lt;br /&gt;
   self.doSomethingWithNames(firstname, lastname)&lt;br /&gt;
frm.release()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=HowTos&amp;diff=4169</id>
		<title>HowTos</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=HowTos&amp;diff=4169"/>
		<updated>2020-05-15T18:43:32Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;=== &amp;lt;span style=&amp;quot;color: blue; text-align: center;&amp;quot;&amp;gt;If how to do something isn&amp;#039;t obvious to you, it probably isn&amp;#039;t obvious to others, too.&amp;lt;/span&amp;gt; ===  ----  So if you run into...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=== &amp;lt;span style=&amp;quot;color: blue; text-align: center;&amp;quot;&amp;gt;If how to do something isn&#039;t obvious to you, it probably isn&#039;t obvious to others, too.&amp;lt;/span&amp;gt; ===&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
So if you run into a programming question in Dabo, don&#039;t just suffer through figuring it out; add it here! We can then answer the question for you in a way that can help someone else in the future. This will become the heart of the functional documentation for Dabo. Add new questions at the top so that they are easy to spot; we can always move them around into a better order later.&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I use a checkbox to manage a generic pair of values?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToCustomizeCheckboxes]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I turn preferences off?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToTurnPreferencesOff]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I set up a Parent-Child-Grandchild (PCG) relationship?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToSetupParent-Child-Grandchild]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How can I determine the dNode selected from a dTreeView (there is no itemID)?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: &amp;lt;code&amp;gt;tree.Selection&amp;lt;/code&amp;gt; will return the selected node.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How can i get dabo to set foreign keys for datail records when creating new records?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[How To Get Foreign Keys Set]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I log all database sql statements executed from Dabo?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[How To Log Executed SQL]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: I don&#039;t understand how to use picklists. I want to display the name of the thing the user is selecting, but I need the associated primary key for that choice. How do I do both?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToPopulateAndUseListControls]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: I need to prompt the user for a value before they continue. What&#039;s the best way of doing that?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToReturnAValueFromAModalForm]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: I want to only allow upper-case characters in a textbox. Can I do that in Dabo?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToLimitInputCharactersInATextBox]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: I have some data that I want to display in a grid. How do I do that?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToCreateAFormWithAGridAndPopulateItWithData]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I add BLOB values when using MySQL?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToAddBLOBValuesWithMySQL]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I center an object visually using sizers?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToVisuallyFloatAControl]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How do I create controls that overlay each other?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[How To Overlay Controls]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: Can I create an OpenOffice.org spreadsheet within Dabo?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[Create an OpenOffice SpreadSheet]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How does one use a cdxml file as class to be used in a hand coded form?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[How to use a cdxml file in hand coded forms]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
: &#039;&#039;&#039;Q&#039;&#039;&#039;: How to use multiple toolbars in different place (e.g. on panels)?&lt;br /&gt;
: &#039;&#039;&#039;A&#039;&#039;&#039;: [[HowToUseMultipleToolbars]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===== subtopics =====&lt;br /&gt;
*  [[HowToCustomizeCheckboxes]]&lt;br /&gt;
*  [[HowToTurnPreferencesOff]]&lt;br /&gt;
*  [[HowToSetupParent-Child-Grandchild]]&lt;br /&gt;
*  [[How To Get Foreign Keys Set]]&lt;br /&gt;
*  [[How To Log Executed SQL]]&lt;br /&gt;
*  [[HowToPopulateAndUseListControls]]&lt;br /&gt;
*  [[HowToReturnAValueFromAModalForm]]&lt;br /&gt;
*  [[HowToLimitInputCharactersInATextBox]]&lt;br /&gt;
*  [[HowToCreateAFormWithAGridAndPopulateItWithData]]&lt;br /&gt;
*  [[HowToAddBLOBValuesWithMySQL]]&lt;br /&gt;
*  [[HowToVisuallyFloatAControl]]&lt;br /&gt;
*  [[How To Overlay Controls]]&lt;br /&gt;
*  [[Create an OpenOffice SpreadSheet]]&lt;br /&gt;
*  [[How to use a cdxml file in hand coded forms]]&lt;br /&gt;
*  [[HowToUseMultipleToolbars]]&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Hook_Methods&amp;diff=4168</id>
		<title>Hook Methods</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Hook_Methods&amp;diff=4168"/>
		<updated>2020-05-15T17:37:50Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;This is a generic term for methods of the framework that are empty by default so that developers can add their code to them without fear of overriding any important framework...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;This is a generic term for methods of the framework that are empty by default so that developers can add their code to them without fear of overriding any important framework code. They are placed at critical parts of framework processes in anticipation of developers needing to influence those processes at those points.&lt;br /&gt;
&lt;br /&gt;
The most common example are &#039;&#039;&#039;beforeXX()&#039;&#039;&#039; and &#039;&#039;&#039;afterXX()&#039;&#039;&#039; methods. Let&#039;s say that there is an important method called &amp;quot;&#039;&#039;&#039;XX()&#039;&#039;&#039;&amp;quot;. As a developer, when you want to modify &#039;&#039;&#039;XX&#039;&#039;&#039; for your own needs, the most common need is to execute code either right before or right after the method, so your code would look like:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
class MySubClass(FrameworkClass):&lt;br /&gt;
    def XX(self):&lt;br /&gt;
        #do your pre-code...&lt;br /&gt;
        super(MySubClass, self).XX()&lt;br /&gt;
        #do your post-code...&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
One of the most common mistakes is to forget the &amp;lt;code&amp;gt;super()&amp;lt;/code&amp;gt; call, which can introduce some extremely hard-to-find bugs into your code. So instead of following this pattern, Dabo adds hook methods that never need to call their superclass versions. Here&#039;s how the &amp;lt;code&amp;gt;XX()&amp;lt;/code&amp;gt; method would be written in Dabo:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
def XX(self):&lt;br /&gt;
    if self.beforeXX() is False:&lt;br /&gt;
        return&lt;br /&gt;
    # Main body of the XX method...&lt;br /&gt;
    self.afterXX()&lt;br /&gt;
&lt;br /&gt;
def beforeXX(self):&lt;br /&gt;
    pass&lt;br /&gt;
&lt;br /&gt;
def afterXX(self):&lt;br /&gt;
    pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Now you are free to override one or the other hook methods, or neither, or both, without ever having to call &amp;lt;code&amp;gt;super()&amp;lt;/code&amp;gt;. What&#039;s more, you also have the chance to abort the &amp;lt;code&amp;gt;XX()&amp;lt;/code&amp;gt; method by returning &amp;lt;code&amp;gt;False&amp;lt;/code&amp;gt; from the &amp;lt;code&amp;gt;beforeXX()&amp;lt;/code&amp;gt; method.&lt;br /&gt;
&lt;br /&gt;
Hook methods are used throughout Dabo; be sure to check the docs or ask on the lists before overriding framework methods.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Object_Creation_Methods&amp;diff=4167</id>
		<title>Object Creation Methods</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Object_Creation_Methods&amp;diff=4167"/>
		<updated>2020-05-15T15:49:28Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;When an object is created in Dabo, there are several methods you can add code to in order to affect the creation process. In general, you should avoid overriding the &amp;lt;code&amp;gt;__i...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;When an object is created in Dabo, there are several methods you can add code to in order to affect the creation process. In general, you should avoid overriding the &amp;lt;code&amp;gt;__init__()&amp;lt;/code&amp;gt; method, since there is a lot of stuff that happens there, and if you don&#039;t call the superclass method at the right time, you could create a mess.&lt;br /&gt;
&lt;br /&gt;
We call these methods [[Hook Methods]], since they allow you to hook in your code without worrying about overriding any framework behavior. They are guaranteed to be empty methods in the framework that are called at specific points; if you don&#039;t use them, nothing happens.&lt;br /&gt;
&lt;br /&gt;
The methods are:&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;beforeInit()&#039;&#039;&#039; - fires before the &amp;lt;code&amp;gt;__init__()&amp;lt;/code&amp;gt; code executes. It gives you a chance to declare any object attributes that subsequent code may rely upon.&lt;br /&gt;
* &#039;&#039;&#039;initProperties()&#039;&#039;&#039; - allows you to specify properties to be set, just as if you had passed them to the constructor. This is typically used when creating a subclass.&lt;br /&gt;
* &#039;&#039;&#039;initEvents()&#039;&#039;&#039; - allows you to specify event bindings to be set. Again, this is typically used when defining subclasses of Dabo objects.&lt;br /&gt;
* &#039;&#039;&#039;afterInit()&#039;&#039;&#039; - is called after the &amp;lt;code&amp;gt;__init__()&amp;lt;/code&amp;gt; method has completed, and allows you to do any post-creation processing you need. Note that if the object contains other objects, such as a form might, the child objects will not yet have been created. If you need to reference those objects, use the &amp;lt;code&amp;gt;afterInitAll()&amp;lt;/code&amp;gt; method instead.&lt;br /&gt;
* &#039;&#039;&#039;afterInitAll()&#039;&#039;&#039; - is called after this object and all its child objects have been created.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=GeneralDaboPractices&amp;diff=4166</id>
		<title>GeneralDaboPractices</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=GeneralDaboPractices&amp;diff=4166"/>
		<updated>2020-05-15T15:47:22Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;Like all frameworks, the authors of Dabo tried to establish a consistent way of doing things. These become &amp;quot;native&amp;quot; practices for working in Dabo. This page collects such prac...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Like all frameworks, the authors of Dabo tried to establish a consistent way of doing things. These become &amp;quot;native&amp;quot; practices for working in Dabo. This page collects such practices and explains them for you.&lt;br /&gt;
&lt;br /&gt;
[[Object Creation Methods]]&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Reserved_Words&amp;diff=4165</id>
		<title>Reserved Words</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Reserved_Words&amp;diff=4165"/>
		<updated>2020-05-15T15:00:13Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;===== The following list contains words that have particular meaning in Dabo, and which may cause problems for you if you name your entities with these words: =====  : addObje...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;===== The following list contains words that have particular meaning in Dabo, and which may cause problems for you if you name your entities with these words: =====&lt;br /&gt;
&lt;br /&gt;
: addObject&lt;br /&gt;
: adopt&lt;br /&gt;
: Angle&lt;br /&gt;
: BackColor&lt;br /&gt;
: bindKey&lt;br /&gt;
: Bitmap&lt;br /&gt;
: BorderColor&lt;br /&gt;
: BorderLineStyle&lt;br /&gt;
: BorderStyle&lt;br /&gt;
: BorderWidth&lt;br /&gt;
: bringToFront&lt;br /&gt;
: Caption&lt;br /&gt;
: Children&lt;br /&gt;
: clear&lt;br /&gt;
: clone&lt;br /&gt;
: copy&lt;br /&gt;
: cut&lt;br /&gt;
: draw&lt;br /&gt;
: DrawMode&lt;br /&gt;
: Enabled&lt;br /&gt;
: FillColor&lt;br /&gt;
: fitToSizer&lt;br /&gt;
: Font&lt;br /&gt;
: FontBold&lt;br /&gt;
: FontDescription&lt;br /&gt;
: FontFace&lt;br /&gt;
: FontInfo&lt;br /&gt;
: FontItalic&lt;br /&gt;
: FontSize&lt;br /&gt;
: FontUnderline&lt;br /&gt;
: ForeColor&lt;br /&gt;
: Height&lt;br /&gt;
: hide&lt;br /&gt;
: Hover&lt;br /&gt;
: iterateCall&lt;br /&gt;
: Left&lt;br /&gt;
: LineStyle&lt;br /&gt;
: lockDisplay&lt;br /&gt;
: MousePointer&lt;br /&gt;
: moveDown&lt;br /&gt;
: moveUp&lt;br /&gt;
: Name&lt;br /&gt;
: NameBase&lt;br /&gt;
: Orientation&lt;br /&gt;
: Parent&lt;br /&gt;
: paste&lt;br /&gt;
: PenColor&lt;br /&gt;
: PenWidth&lt;br /&gt;
: Points&lt;br /&gt;
: Position&lt;br /&gt;
: Radius&lt;br /&gt;
: raiseEvent&lt;br /&gt;
: recreate&lt;br /&gt;
: redraw&lt;br /&gt;
: refresh&lt;br /&gt;
: RegID&lt;br /&gt;
: release&lt;br /&gt;
: sendToBack&lt;br /&gt;
: setAll&lt;br /&gt;
: setFocus&lt;br /&gt;
: Shape&lt;br /&gt;
: show&lt;br /&gt;
: Size&lt;br /&gt;
: Sizer&lt;br /&gt;
: StatusText&lt;br /&gt;
: Tag&lt;br /&gt;
: Text&lt;br /&gt;
: ToolTipText&lt;br /&gt;
: Top&lt;br /&gt;
: Transparent&lt;br /&gt;
: unbindKey&lt;br /&gt;
: unlockDisplay&lt;br /&gt;
: update&lt;br /&gt;
: Visible&lt;br /&gt;
: Width&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=PreferenceDialog&amp;diff=4164</id>
		<title>PreferenceDialog</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=PreferenceDialog&amp;diff=4164"/>
		<updated>2020-05-15T14:37:04Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Overview == The &amp;#039;&amp;#039;&amp;#039;PreferenceDialog&amp;#039;&amp;#039;&amp;#039; class is designed to make it easy for you to present users with options that they can configure. It ties in very nicely with the &amp;lt;cod...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Overview ==&lt;br /&gt;
The &#039;&#039;&#039;PreferenceDialog&#039;&#039;&#039; class is designed to make it easy for you to present users with options that they can configure. It ties in very nicely with the &amp;lt;code&amp;gt;PreferenceManager&amp;lt;/code&amp;gt; class, so you can use a unified approach to managing user preferences and settings.&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;PreferenceDialog&#039;&#039;&#039; class is a dialog with one or more pages that contain controls that are used to adjust preferences and settings for your application. Typically, you group related settings onto their own page to make it easy for your users to find what they want to set.&lt;br /&gt;
&lt;br /&gt;
To do this, create pages using the &amp;lt;code&amp;gt;addCategory()&amp;lt;/code&amp;gt; method, and then populate those pages with controls that are bound to the preference settings you wish to manage. &amp;lt;code&amp;gt;addCategory()&amp;lt;/code&amp;gt; takes two parameters: the &amp;lt;code&amp;gt;caption&amp;lt;/code&amp;gt; (required), and the &amp;lt;code&amp;gt;position&amp;lt;/code&amp;gt; (optional; default is to append to the end).&lt;br /&gt;
&lt;br /&gt;
== Example ==&lt;br /&gt;
Here is a very simple example; we will discuss the code below:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
import wx&lt;br /&gt;
import dabo&lt;br /&gt;
dabo.ui.loadUI(&amp;quot;wx&amp;quot;)&lt;br /&gt;
from dabo.ui.dialogs.PreferenceDialog import PreferenceDialog&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class CustomPrefDlg(PreferenceDialog):&lt;br /&gt;
  def addPages(self):&lt;br /&gt;
    # Set the preference keys that we will be using&lt;br /&gt;
    pm = self.PreferenceManager&lt;br /&gt;
    fontKey = pm.fonts&lt;br /&gt;
    checkChangesKey = pm.checkChanges&lt;br /&gt;
    self.preferenceKeys.append(fontKey)&lt;br /&gt;
    self.preferenceKeys.append(checkChangesKey)&lt;br /&gt;
    # Create one page for font prefs, another for updates&lt;br /&gt;
    fontPage = self.addCategory(&amp;quot;Fonts&amp;quot;)&lt;br /&gt;
    # Add controls to the font page.&lt;br /&gt;
    chk = dabo.ui.dCheckBox(fontPage, Caption=&amp;quot;Bold?&amp;quot;, &lt;br /&gt;
      DataSource=fontKey, DataField=&amp;quot;bold&amp;quot;)&lt;br /&gt;
    fontPage.Sizer.append(chk)&lt;br /&gt;
    # Add whatever other controls you need...&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
    # Add controls to the changes page.&lt;br /&gt;
    changesPage = self.addCategory(&amp;quot;Change Management&amp;quot;)&lt;br /&gt;
    chc = dabo.ui.dDropdownList(changesPage, Choices=[&amp;quot;Yes&amp;quot;, &amp;quot;No&amp;quot;, &amp;quot;Maybe&amp;quot;],&lt;br /&gt;
      DataSource=checkChangesKey, DataField=&amp;quot;checkForChanges&amp;quot;)&lt;br /&gt;
    changesPage.Sizer.append(chc)&lt;br /&gt;
    # Add whatever other controls you need...&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
class TestForm(dabo.ui.dForm):&lt;br /&gt;
  def afterInit(self):&lt;br /&gt;
    lbl = dabo.ui.dLabel(self, Caption=&amp;quot;Preference Manager Demo\n&amp;quot; +&lt;br /&gt;
      &amp;quot;Select &#039;Preferences&#039; from the menu.&amp;quot;, WordWrap=True)&lt;br /&gt;
    self.Sizer.append(lbl, halign=&amp;quot;center&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
if __name__ == &#039;__main__&#039;:&lt;br /&gt;
  app = dabo.dApp(BasePrefKey = &amp;quot;demo.PrefDialog&amp;quot;)&lt;br /&gt;
  app.MainFormClass = TestForm&lt;br /&gt;
  app.PreferenceDialogClass = CustomPrefDlg&lt;br /&gt;
  app.start()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Defining the Custom Dialog class ==&lt;br /&gt;
The only method we typically have to override is the &amp;lt;code&amp;gt;addPages()&amp;lt;/code&amp;gt; method. As the name suggests, this is where we add the pages we need for our app&#039;s settings. In this example, we only are using two: one for font settings, and one for tracking changes.&lt;br /&gt;
&lt;br /&gt;
== Preference Objects ==&lt;br /&gt;
This is also a good illustration of how to use the &amp;lt;code&amp;gt;PreferenceManager&amp;lt;/code&amp;gt; object. You simply define attributes of that object, and they are automagically added to it. In this example, we use &amp;lt;code&amp;gt;pm&amp;lt;/code&amp;gt; as the name of the app&#039;s &amp;lt;code&amp;gt;PreferenceManager&amp;lt;/code&amp;gt; object, which has a path of &amp;lt;code&amp;gt;demo.PrefDialog&amp;lt;/code&amp;gt;, which is the app&#039;s &amp;lt;code&amp;gt;BasePrefKey&amp;lt;/code&amp;gt;. We then create keys off of it named &amp;lt;code&amp;gt;fonts&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;checkChanges&amp;lt;/code&amp;gt; by simply referencing those keys as attributes of &amp;lt;code&amp;gt;pm&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
One cool thing about preference objects is that they can either persist their value as soon as you set it, or they can cache those changes until you either call their &amp;lt;code&amp;gt;persist()&amp;lt;/code&amp;gt; method (to save) or their &amp;lt;code&amp;gt;cancel()&amp;lt;/code&amp;gt; method to discard the changes. This behavior is controlled by the &amp;lt;code&amp;gt;AutoPersist&amp;lt;/code&amp;gt; property of the preference object, but we don&#039;t have to worry about dealing with that here. Simply add any preference keys whose values you want to manage to the &amp;lt;code&amp;gt;PreferenceDialog&amp;lt;/code&amp;gt;&#039;s &amp;lt;code&amp;gt;preferenceKeys&amp;lt;/code&amp;gt; list, and their persistence settings will be handled for you. If the user cancels out of the dialog, none of the changes they made will be saved.&lt;br /&gt;
&lt;br /&gt;
== Adding the Pages ==&lt;br /&gt;
Now that we have the preference information set, we call the &amp;lt;code&amp;gt;addCategory()&amp;lt;/code&amp;gt; method to create the page for the font settings, passing in the caption &#039;&#039;&#039;&amp;quot;Fonts&amp;quot;&#039;&#039;&#039;. This method adds the page to the dialog&#039;s paged control, and returns a reference to the newly-created page. We then use as the parent for the controls used for the font settings. To keep things simple, we have a single setting, called &amp;lt;code&amp;gt;bold&amp;lt;/code&amp;gt;. In a real app, you&#039;d probably have default font faces, sizes, etc., but this will do for this demo. What&#039;s critical to note are the [[DataSource]] and [[DataField]] properties: [[DataSource]] is set to the &amp;lt;code&amp;gt;fontKey&amp;lt;/code&amp;gt; object we defined, and [[DataField]] is set to &amp;lt;code&amp;gt;bold&amp;lt;/code&amp;gt;. This will automagically add the subkey of &amp;lt;code&amp;gt;bold&amp;lt;/code&amp;gt; to the &amp;lt;code&amp;gt;fontKey&amp;lt;/code&amp;gt; preference object (if it doesn&#039;t already exist), making the full key path for this &amp;lt;code&amp;gt;demo.prefDialog.fonts.bold&amp;lt;/code&amp;gt;. Also, if there already is a setting saved for this key, it will be retrieved, and the control&#039;s &amp;lt;code&amp;gt;Value&amp;lt;/code&amp;gt; will be set accordingly. We repeat this for the change management page, but this time we use a dropdown list to present the user with 3 options. This value will be saved to the preference database when the user clicks &amp;lt;code&amp;gt;OK&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Defining the Form ==&lt;br /&gt;
The form really doesn&#039;t do anything in this demo, so all we do is add a descriptive label.&lt;br /&gt;
&lt;br /&gt;
== Setting Up the Application ==&lt;br /&gt;
There are a few basic properties of the application object that we need to set:&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;BasePrefKey:&#039;&#039;&#039; This is the unique name under which your preferences are saved. For this demo I chose a subkey of prefDialog off of a main demo key.&lt;br /&gt;
* &#039;&#039;&#039;MainFormClass:&#039;&#039;&#039; the class used by the app for its startup form.&lt;br /&gt;
* &#039;&#039;&#039;PreferenceDialogClass:&#039;&#039;&#039; The class to display when the user selects the Preferences menu item. In this example, it is the CustomPrefDlg class we defined.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.getEventData&amp;diff=4163</id>
		<title>Dabo.ui.getEventData</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.getEventData&amp;diff=4163"/>
		<updated>2020-05-15T14:27:17Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.getEventData(wxEvt) &amp;lt;/syntaxhighlight&amp;gt;  == Description: == Extracts as much information from the &amp;lt;code&amp;gt;wx.Event&amp;lt;/code...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.getEventData(wxEvt)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Extracts as much information from the &amp;lt;code&amp;gt;wx.Event&amp;lt;/code&amp;gt; object about the event.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
A dictionary containing the event information&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: red&amp;quot;&amp;gt;&#039;&#039;&#039;NOT USED BY DABO DEVELOPERS&#039;&#039;&#039;&amp;lt;/span&amp;gt;. For framework use only.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.discontinueEvent&amp;diff=4162</id>
		<title>Dabo.ui.discontinueEvent</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.discontinueEvent&amp;diff=4162"/>
		<updated>2020-05-15T14:26:10Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.discontinueEvent(evt) &amp;lt;/syntaxhighlight&amp;gt;  == Description: == Given a wx Event object, tells it to stop searching for...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.discontinueEvent(evt)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Given a wx Event object, tells it to stop searching for an event handler.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
&amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: red&amp;quot;&amp;gt;&#039;&#039;&#039;NOT USED BY DABO DEVELOPERS&#039;&#039;&#039;&amp;lt;/span&amp;gt;. For framework use only.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.continueEvent&amp;diff=4161</id>
		<title>Dabo.ui.continueEvent</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.continueEvent&amp;diff=4161"/>
		<updated>2020-05-15T14:25:19Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.continueEvent(evt) &amp;lt;/syntaxhighlight&amp;gt;  == Description: == Given a wx Event object, tells it to continue searching for...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.continueEvent(evt)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Given a wx Event object, tells it to continue searching for an event handler.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
&amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
&amp;lt;span style=&amp;quot;color: red&amp;quot;&amp;gt;&#039;&#039;&#039;NOT USED BY DABO DEVELOPERS&#039;&#039;&#039;&amp;lt;/span&amp;gt;. For framework use only.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.getMouseObject&amp;diff=4160</id>
		<title>Dabo.ui.getMouseObject</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.getMouseObject&amp;diff=4160"/>
		<updated>2020-05-15T14:21:01Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.getMouseObject() &amp;lt;/syntaxhighlight&amp;gt;  == Description: == Incredibly handy function for interactive debugging. Allows t...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.getMouseObject()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Incredibly handy function for interactive debugging. Allows the developer to quickly grab a reference to any visual object in a live application.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
Returns a reference to the object below the mouse pointer at the moment the command is issued.&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
This function is extremely useful for interactive development when testing a live application. Typically, a [[Command Window]] is opened from the running app, and the mouse is positioned over the object for which you want to get information. Then the following line is executed:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
obj = dabo.ui.getMouseObject()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
After that, you can inspect the state of that object by querying its properties, or you can modify the object by calling its methods or changing its properties.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.getMousePosition&amp;diff=4159</id>
		<title>Dabo.ui.getMousePosition</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.getMousePosition&amp;diff=4159"/>
		<updated>2020-05-15T14:19:21Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.getMousePosition() &amp;lt;/syntaxhighlight&amp;gt;  == Description: == Returns the x,y coordinates of the mouse on the screen.  ==...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.getMousePosition()&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Returns the x,y coordinates of the mouse on the screen.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
A 2-tuple containing the (x, y) values for the mouse position.&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
The coordinates are absolute screen coordinates, not relative to the active form.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.fontMetric&amp;diff=4158</id>
		<title>Dabo.ui.fontMetric</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.fontMetric&amp;diff=4158"/>
		<updated>2020-05-14T16:06:57Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.fontMetric(txt=None, wind=None, face=None, size=None, bold=None, italic=None) &amp;lt;/syntaxhighlight&amp;gt;  == Description: ==...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.fontMetric(txt=None, wind=None, face=None, size=None, bold=None, italic=None)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Calculate the width and height of the given text using the supplied font information. If any font parameters are missing, they are taken from the specified window, or, if no window is specified, the currently active form. If no form is active, the app&#039;s &amp;lt;code&amp;gt;MainForm&amp;lt;/code&amp;gt; is used.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
A 2-tuple containing the (width, height) of the specified text.&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
Sometimes it is necessary to see just how big a given bit of text will be. This method allows you to specify as many aspects about the text&#039;s appearance, and will return the width and height for those specs.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.fontMetricFromDrawObject&amp;diff=4157</id>
		<title>Dabo.ui.fontMetricFromDrawObject</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.fontMetricFromDrawObject&amp;diff=4157"/>
		<updated>2020-05-14T16:05:33Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.fontMetricFromDrawObject(obj) &amp;lt;/syntaxhighlight&amp;gt;  == Description: == Given a drawn text object, returns the width and...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.fontMetricFromDrawObject(obj)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Given a drawn text object, returns the width and height of the text. See the section on [[DrawObjects]] for information on the &amp;lt;code&amp;gt;drawText()&amp;lt;/code&amp;gt; function.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
A 2-tuple containing the (width, height) of the specified drawn object.&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
If you&#039;re using the drawing primitives to create text, this method will take the drawn object and return the size of the text as it will be drawn.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.fontMetricFromFont&amp;diff=4156</id>
		<title>Dabo.ui.fontMetricFromFont</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.fontMetricFromFont&amp;diff=4156"/>
		<updated>2020-05-14T16:04:08Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.fontMetricFromFont(txt, font) &amp;lt;/syntaxhighlight&amp;gt;  == Description: == Much like dabo.ui.fontMetric(), except that...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.fontMetricFromFont(txt, font)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Much like [[dabo.ui.fontMetric]](), except that you pass a single &amp;lt;code&amp;gt;wx.Font&amp;lt;/code&amp;gt; or &amp;lt;code&amp;gt;dabo.ui.dFont&amp;lt;/code&amp;gt; instance instead of seperate font qualities.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
A 2-tuple containing the (width, height) of the text in the specified font.&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
Rarely used by programmers. Mostly used internally by the framework.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.getCommonBitmap&amp;diff=4155</id>
		<title>Dabo.ui.getCommonBitmap</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.getCommonBitmap&amp;diff=4155"/>
		<updated>2020-05-14T15:54:09Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.getCommonBitmap(name) &amp;lt;/syntaxhighlight&amp;gt;  == Description: == &amp;#039;&amp;#039;&amp;#039;wxPython&amp;#039;&amp;#039;&amp;#039; comes with several built-in bitmaps for c...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.getCommonBitmap(name)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
&#039;&#039;&#039;wxPython&#039;&#039;&#039; comes with several built-in bitmaps for common icons. This wraps the procedure for generating these bitmaps. If a name is passed for which there is no icon, an image denoting a missing image is returned.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
wx.Bitmap object.&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
Occasionally used by a programmer; mostly used internally by the framework.&lt;br /&gt;
&lt;br /&gt;
Available Bitmaps:&lt;br /&gt;
&lt;br /&gt;
* tickmark&lt;br /&gt;
* helpbook&lt;br /&gt;
* goup&lt;br /&gt;
* godirup&lt;br /&gt;
* tip&lt;br /&gt;
* frame&lt;br /&gt;
* harddisk&lt;br /&gt;
* gohome&lt;br /&gt;
* filesaveas&lt;br /&gt;
* down&lt;br /&gt;
* newdir&lt;br /&gt;
* findandreplace&lt;br /&gt;
* warning&lt;br /&gt;
* normalfile&lt;br /&gt;
* commondialog&lt;br /&gt;
* delbookmark&lt;br /&gt;
* home&lt;br /&gt;
* crossmark&lt;br /&gt;
* reportview&lt;br /&gt;
* redo&lt;br /&gt;
* find&lt;br /&gt;
* help&lt;br /&gt;
* forward&lt;br /&gt;
* information&lt;br /&gt;
* messagebox&lt;br /&gt;
* cut&lt;br /&gt;
* open&lt;br /&gt;
* menu&lt;br /&gt;
* cmndialog&lt;br /&gt;
* question&lt;br /&gt;
* cross&lt;br /&gt;
* cd&lt;br /&gt;
* goforward&lt;br /&gt;
* gotoparent&lt;br /&gt;
* executablefile&lt;br /&gt;
* hd&lt;br /&gt;
* folderopen&lt;br /&gt;
* save&lt;br /&gt;
* helpbrowser&lt;br /&gt;
* new&lt;br /&gt;
* folder&lt;br /&gt;
* exit&lt;br /&gt;
* configure&lt;br /&gt;
* addbookmark&lt;br /&gt;
* helppage&lt;br /&gt;
* frameicon&lt;br /&gt;
* file&lt;br /&gt;
* missingimage&lt;br /&gt;
* removable&lt;br /&gt;
* parent&lt;br /&gt;
* quit&lt;br /&gt;
* floppy&lt;br /&gt;
* goback&lt;br /&gt;
* dialog&lt;br /&gt;
* helpfolder&lt;br /&gt;
* findreplace&lt;br /&gt;
* undo&lt;br /&gt;
* back&lt;br /&gt;
* print&lt;br /&gt;
* exe&lt;br /&gt;
* cdrom&lt;br /&gt;
* filesave&lt;br /&gt;
* fileopen&lt;br /&gt;
* copy&lt;br /&gt;
* paste&lt;br /&gt;
* saveas&lt;br /&gt;
* toolbar&lt;br /&gt;
* info&lt;br /&gt;
* listview&lt;br /&gt;
* godown&lt;br /&gt;
* directoryup&lt;br /&gt;
* button&lt;br /&gt;
* up&lt;br /&gt;
* exefile&lt;br /&gt;
* helpsettings&lt;br /&gt;
* error&lt;br /&gt;
* helpsidepanel&lt;br /&gt;
* other&lt;br /&gt;
* delete&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.imageFromData&amp;diff=4154</id>
		<title>Dabo.ui.imageFromData</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.imageFromData&amp;diff=4154"/>
		<updated>2020-05-14T15:51:38Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.imageFromData(data) &amp;lt;/syntaxhighlight&amp;gt;  == Description: == Using the &amp;lt;code&amp;gt;img2py.py&amp;lt;/code&amp;gt; script in the &amp;lt;code&amp;gt;wx.to...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.imageFromData(data)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Using the &amp;lt;code&amp;gt;img2py.py&amp;lt;/code&amp;gt; script in the &amp;lt;code&amp;gt;wx.tools&amp;lt;/code&amp;gt; folder, you can convert an image to a text stream that can be included in a Python script. This allows for greater portability, since you don&#039;t need to distribute a separate image file.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
wx.Image object.&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
Rarely used by a programmer; mostly used internally by the framework.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.resizeBmp&amp;diff=4153</id>
		<title>Dabo.ui.resizeBmp</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.resizeBmp&amp;diff=4153"/>
		<updated>2020-05-14T15:50:16Z</updated>

		<summary type="html">&lt;p&gt;Ed: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.resizeBmp(bmp, wd, ht)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Given a bitmap, returns another bitmap resized to the specified sizes.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
Bitmap&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
Rarely needed by the programmer; use [[dabo.ui.strToBmp]]() instead.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.resizeBmp&amp;diff=4152</id>
		<title>Dabo.ui.resizeBmp</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.resizeBmp&amp;diff=4152"/>
		<updated>2020-05-14T15:50:01Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.resizeBmp(bmp, wd, ht) &amp;lt;/syntaxhighlight&amp;gt;  == Description: == Given a bitmap, returns another bitmap resized to the s...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.resizeBmp(bmp, wd, ht)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Given a bitmap, returns another bitmap resized to the specified sizes.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
Bitmap&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
Rarely needed by the programmer; use dabo.ui.strToBmp() instead.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.pathToBmp&amp;diff=4151</id>
		<title>Dabo.ui.pathToBmp</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.pathToBmp&amp;diff=4151"/>
		<updated>2020-05-14T15:49:16Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.pathToBmp(pth) &amp;lt;/syntaxhighlight&amp;gt;  == Description: == Given a file path, returns a bitmap of the image contained in t...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.pathToBmp(pth)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
Given a file path, returns a bitmap of the image contained in the file.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
Bitmap&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
Rarely needed by the programmer; use [[dabo.ui.strToBmp]](pth) instead.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.strToBmp&amp;diff=4150</id>
		<title>Dabo.ui.strToBmp</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.strToBmp&amp;diff=4150"/>
		<updated>2020-05-14T15:47:56Z</updated>

		<summary type="html">&lt;p&gt;Ed: Created page with &amp;quot;== Signature: ==  &amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt; dabo.ui.strToBmp(val, scale=None, width=None, height=None) &amp;lt;/syntaxhighlight&amp;gt;  == Description: == This can be either a path,...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature: ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.strToBmp(val, scale=None, width=None, height=None)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description: ==&lt;br /&gt;
This can be either a path, or the name of a built-in graphic. If an adjusted size is desired, you can either pass a &amp;lt;code&amp;gt;scale&amp;lt;/code&amp;gt; value (where 1.00 is full size, 0.5 scales it to 50% in both &amp;lt;code&amp;gt;Height&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;Width&amp;lt;/code&amp;gt;), or you can pass specific &amp;lt;code&amp;gt;height&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;width&amp;lt;/code&amp;gt; values. The final image will be a bitmap resized to those specs.&lt;br /&gt;
&lt;br /&gt;
== Returns: ==&lt;br /&gt;
A bitmap of the specified image, or &amp;lt;code&amp;gt;None&amp;lt;/code&amp;gt; if an invalid image was specified.&lt;br /&gt;
&lt;br /&gt;
== Comments: ==&lt;br /&gt;
This is the heart of the simplification of image handling. It allows you to simply specify a file path for something like the &amp;lt;code&amp;gt;Picture&amp;lt;/code&amp;gt; property of an [[dImage]] control, rather than having to manually read in the file and convert it from its native format to a display bitmap.&lt;br /&gt;
&lt;br /&gt;
== Parameters: ==&lt;br /&gt;
* &#039;&#039;&#039;val&#039;&#039;&#039; - This is a string representing the image to be displayed. It can be either a file path, or the name of a built-in graphic, or a standard Dabo icon.&lt;br /&gt;
* &#039;&#039;&#039;scale&#039;&#039;&#039; - A value by which the original image will be scaled. A value of 1 returns the image at its original size; a value of 2.5 returns the image enlarged by 2500%; a value of 0.6 returns the image reduced to 60% of its original size.&lt;br /&gt;
* &#039;&#039;&#039;width&#039;&#039;&#039;, &#039;&#039;&#039;height&#039;&#039;&#039; - Rather than pass a percentage to scale the entire image, you can pass an absolute value for either the &amp;lt;code&amp;gt;width&amp;lt;/code&amp;gt; or &amp;lt;code&amp;gt;height&amp;lt;/code&amp;gt; (or both). The returned image will be resized to match the sizes you pass. If you pass, say, just a &amp;lt;code&amp;gt;height&amp;lt;/code&amp;gt; value, the width will remain unchanged, and the height will be modified to the specified value.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
	<entry>
		<id>https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.bitmapFromData&amp;diff=4149</id>
		<title>Dabo.ui.bitmapFromData</title>
		<link rel="alternate" type="text/html" href="https://wiki.dabo.leafe.com/index.php?title=Dabo.ui.bitmapFromData&amp;diff=4149"/>
		<updated>2020-05-14T15:44:02Z</updated>

		<summary type="html">&lt;p&gt;Ed: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Signature ==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
dabo.ui.bitmapFromData(data)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Description ==&lt;br /&gt;
Using the &amp;lt;code&amp;gt;img2py.py&amp;lt;/code&amp;gt; script in the &amp;lt;code&amp;gt;wx.tools&amp;lt;/code&amp;gt; folder, you can convert an image to a text stream that can be included in a Python script. This allows for greater portability, since you don&#039;t need to distribute a separate image file.&lt;br /&gt;
&lt;br /&gt;
== Returns ==&lt;br /&gt;
wx.Bitmap object.&lt;br /&gt;
&lt;br /&gt;
== Comments ==&lt;br /&gt;
Rarely used by a programmer; mostly used internally by the framework.&lt;/div&gt;</summary>
		<author><name>Ed</name></author>
	</entry>
</feed>