User Tools

Site Tools


koda:en:documentation:appendice_control_templates

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

koda:en:documentation:appendice_control_templates [2014/07/10 10:47] (current)
Line 1: Line 1:
 +====== Control templates ======
  
 +The default appearance of controls can be modified. For example:
 +  * The default width of Button controls can be changed
 +  * As installed, Koda defaults to naming Button controls //​Button1//,​ //Button2// ... A control template can change the default names to //Btn1//, //Btn2//, etc.
 +
 +To change the default properties of one or more controls, a file **control_templates.xml** must be created in the Koda directory. The properties of //object types// defined in it will override Koda's defaults.
 +
 +**Extras\Control Templates\control_templates.xml** is an example. It is listed below.
 +
 +<code xml>
 +<​control_templates>​
 +  <object type="​TAForm">​
 +  <​properties>​
 +    <​property name="​Width"​ vt="​Int8">​600</​property>​
 +  </​properties>​
 +  <​components/>​
 +  </​object>​
 +  <object type="​TAButton"​ name="​Btn%INSTANCE%">​
 +  <​properties>​
 +    <​property name="​Width"​ vt="​Int8">​100</​property>​
 +    <​property name="​Height"​ vt="​Int8">​30</​property>​
 +    <​property name="​CtrlStyle"​ vt="​Int32">​1342291968</​property>​
 +  </​properties>​
 +  <​components/>​
 +  </​object>​
 +</​control_templates>​
 +</​code>​
 +
 +It overrides Koda's installation defaults. It changes:
 +  * the default Width of forms, <color red>​TAForm</​color>,​ to 600 pixels
 +  * the default size of buttons, <color red>​TAButton</​color>,​ to 100 x 30 pixels
 +  * the default style of buttons from <color blue>​BS_PUSHBUTTON</​color>​ (to <color blue> BitOr(BS_PUSHBUTTON,​ BS_FLAT)</​color>​
 +
 +All other default properties remain as installed.
 +
 +//The value of <color red>​CtrlStyle</​color>​ (and of <color red>​Style</​color>​) is a 32-bit signed-integer combination of Windows styles.//
 +
 +Note <color red>​Btn%INSTANCE%</​color>​. %INSTANCE% is essential. Without it, Koda will try to create buttons //Btn//, //Btn//, etc. - and will fail!
 +
 +The format of the file is critically important. The safest way of creating your own control_templates.xml is to copy appropriate chunks from one of your form (.kxf) files.
 +
 +Creating control_templates.xml in the Koda directory safeguards against making unintended changes that you cannot easily correct. =)
koda/en/documentation/appendice_control_templates.txt ยท Last modified: 2014/07/10 10:47 (external edit)