summaryrefslogtreecommitdiffstats
path: root/doc/kommander/tutorials.docbook
diff options
context:
space:
mode:
authorSlávek Banko <[email protected]>2013-09-03 20:03:18 +0200
committerSlávek Banko <[email protected]>2013-09-03 21:03:38 +0200
commitd17de25b7fe2200ed60b15ec6801e3458b2c1046 (patch)
treef8d177d2e951eab368c0491c24837836ef41470b /doc/kommander/tutorials.docbook
parent9b520883661b34a40beb46cedb80355fbe6587ad (diff)
downloadtdewebdev-d17de25b7fe2200ed60b15ec6801e3458b2c1046.tar.gz
tdewebdev-d17de25b7fe2200ed60b15ec6801e3458b2c1046.zip
Additional k => tde renaming and fixes
Diffstat (limited to 'doc/kommander/tutorials.docbook')
-rw-r--r--doc/kommander/tutorials.docbook6
1 files changed, 3 insertions, 3 deletions
diff --git a/doc/kommander/tutorials.docbook b/doc/kommander/tutorials.docbook
index ba051e78..6071c60c 100644
--- a/doc/kommander/tutorials.docbook
+++ b/doc/kommander/tutorials.docbook
@@ -8,7 +8,7 @@
<firstname>Eric</firstname>
<surname>Laffoon</surname>
<affiliation><address>
-<email>[email protected]</email>
+<email>[email protected]</email>
</address></affiliation>
</author>
@@ -316,7 +316,7 @@ Shows how to use Table widget
These examples reflect the most recent development state of &kommander;. In its current state &kommander; has few limitations for developing small to medium applications. It certainly is not suitable for building a KWord clone, but for a simple editor, database frontend, GUI for commandline programs or any application in the spirit of Unix/Linux small applications it is a good choice. The examples presented here are intended to show the potential as well as how to work around limitations. There are some useful tricks included in these if you want to do a more capable small application with &kommander;. Remember &kommander; is not intended to do everything, but to do most things. For this concession you should be able to build something in &kommander; faster than other alternatives ad add GUI to scripting languages not otherwise supported in KDE.
</para>
<note><para>
-The examples are installed to <command>$TDEDIR/share/apps/kmdr-editor/editor</command>. In case you do not have them there, get from <ulink url="http://kommander.tdewebdev.org">our home page</ulink>, by downloading the latest release.
+The examples are installed to <command>$TDEDIR/share/apps/kmdr-editor/editor</command>. In case you do not have them there, get from <ulink url="http://kommander.kdewebdev.org">our home page</ulink>, by downloading the latest release.
</para>
</note>
@@ -334,7 +334,7 @@ There is a quick help dialog this editor launches that discusses in depth what i
<sect2 id="example-key-value">
<title>kevaluecombo.kmdr</title>
<para>
-&kommander; can be used with databases and has an optional <ulink url="http://kommander.tdewebdev.org/releases.php#plugins">database plugin</ulink>. One shortcoming is not being able to store key/value pairs in the ComboBox. An ingenious trick was realized for this. It requires only that the content of the ComboBox not be changed unless it is done using the arrays that go with it. As this is commonly used with SQL in small data sets it's quite fast even to reload the whole Combobox. The inherent problem is that &kommander; does not have internally indexed arrays by default. This is compounded by the fact that to accommodate shell commands that return lines separated by newlines &kommander;'s array functions will load what is effectively an array of keys. Such an array can only be accessed with a foreach loop. This is the reason new indexed array functions were added. It is important to remember that these arrays are not self maintaining, but their insert and delete functions will help you.
+&kommander; can be used with databases and has an optional <ulink url="http://kommander.kdewebdev.org/releases.php#plugins">database plugin</ulink>. One shortcoming is not being able to store key/value pairs in the ComboBox. An ingenious trick was realized for this. It requires only that the content of the ComboBox not be changed unless it is done using the arrays that go with it. As this is commonly used with SQL in small data sets it's quite fast even to reload the whole Combobox. The inherent problem is that &kommander; does not have internally indexed arrays by default. This is compounded by the fact that to accommodate shell commands that return lines separated by newlines &kommander;'s array functions will load what is effectively an array of keys. Such an array can only be accessed with a foreach loop. This is the reason new indexed array functions were added. It is important to remember that these arrays are not self maintaining, but their insert and delete functions will help you.
</para>
<para>
Getting back to the ComboBox, it will return selected text, but it also will return the current index. It does rigidly maintain a contiguous zero based array. That's the key. We loop through a data set with a zero based index counter and create two arrays, as &kommander; also cannot create arrays of arrays. It can however use an array value to represent a key just like any value could. .If you look at the included dialog the code actually managing this is in <quote>ScriptObject36</quote>. We will extract the key code here.