summaryrefslogtreecommitdiffstats
path: root/tde-i18n-et/docs/tdewebdev/kommander/extending.docbook
diff options
context:
space:
mode:
authorDarrell Anderson <darrella@hushmail.com>2014-01-21 22:06:48 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2014-01-21 22:06:48 -0600
commit0b8ca6637be94f7814cafa7d01ad4699672ff336 (patch)
treed2b55b28893be8b047b4e60514f4a7f0713e0d70 /tde-i18n-et/docs/tdewebdev/kommander/extending.docbook
parenta1670b07bc16b0decb3e85ee17ae64109cb182c1 (diff)
downloadtde-i18n-0b8ca6637be94f7814cafa7d01ad4699672ff336.tar.gz
tde-i18n-0b8ca6637be94f7814cafa7d01ad4699672ff336.zip
Beautify docbook files
Diffstat (limited to 'tde-i18n-et/docs/tdewebdev/kommander/extending.docbook')
-rw-r--r--tde-i18n-et/docs/tdewebdev/kommander/extending.docbook304
1 files changed, 67 insertions, 237 deletions
diff --git a/tde-i18n-et/docs/tdewebdev/kommander/extending.docbook b/tde-i18n-et/docs/tdewebdev/kommander/extending.docbook
index e2499eaa3ad..80f7f8eb80a 100644
--- a/tde-i18n-et/docs/tdewebdev/kommander/extending.docbook
+++ b/tde-i18n-et/docs/tdewebdev/kommander/extending.docbook
@@ -3,78 +3,28 @@
<chapter id="extending">
<chapterinfo>
<authorgroup>
-<author
-><firstname
->Andras</firstname
-> <surname
->Mantia</surname
-> <affiliation
-><address
-><email
->amantia@kde.org</email
-></address
-></affiliation>
+<author><firstname>Andras</firstname> <surname>Mantia</surname> <affiliation><address><email>amantia@kde.org</email></address></affiliation>
</author>
-<author
-><firstname
->Michal</firstname
-> <surname
->Rudolf</surname
-> <affiliation
-><address
-><email
->mrudolf@kdewebdev.org</email
-></address
-></affiliation>
+<author><firstname>Michal</firstname> <surname>Rudolf</surname> <affiliation><address><email>mrudolf@kdewebdev.org</email></address></affiliation>
</author>
-<othercredit role="translator"
-><firstname
->Marek</firstname
-> <surname
->Laane</surname
-> <affiliation
-><address
-><email
->bald@smail.ee</email
-></address
-> </affiliation
-><contrib
->Tõlge eesti keelde</contrib
-></othercredit
->
+<othercredit role="translator"><firstname>Marek</firstname> <surname>Laane</surname> <affiliation><address><email>bald@smail.ee</email></address> </affiliation><contrib>Tõlge eesti keelde</contrib></othercredit>
</authorgroup>
</chapterinfo>
-<title
->&kommander;i laiendamine</title>
+<title>&kommander;i laiendamine</title>
<sect1 id="create-widgets">
-<title
->&kommander;i vidinate loomine</title>
-<para
->&kommander;iga saab päris lihtsalt luua uusi vidinaid ka &kommander;i-väliste vidinate põhjal. </para>
-<para
->&kommander;ile saab uusi vidinaid luua kahel viisil: luues pluginaid või lisades neid otseselt &kommander;i lähtekoodi. </para>
+<title>&kommander;i vidinate loomine</title>
+<para>&kommander;iga saab päris lihtsalt luua uusi vidinaid ka &kommander;i-väliste vidinate põhjal. </para>
+<para>&kommander;ile saab uusi vidinaid luua kahel viisil: luues pluginaid või lisades neid otseselt &kommander;i lähtekoodi. </para>
<sect2 id="create-class">
-<title
->Vidinaklassi loomine</title>
-<para
->Esimeseks sammuks on vidinaklassi loomine. Selleks tuleb tuletada oma uus &kommander;i vidina klass &Qt;/&kde; vidinast, mida soovid &kommander;iga põimida, ning seejärel ka klassist KommanderWidget. Selle klassi alistamismeetodid annavadki &kommander;i vidinale vajalikud funktsioonid. </para>
-<para
->Enamik &kommander;i vidina koodist on lihtsalt mallkood. Seepärast saab enamiku &kommander;i vidina koodi genereerimiseks ära kasutada KDevelopi &kommander;i plugina malli. Selleks käivita KDevelop (soovitavalt vähemalt versioon 3.5), vali <guimenu
->Projekt->Uus projekt</guimenu
->, märgi ära kastike <guilabel
->Kõigi projektimallide näitamine</guilabel
-> ja vali <guilabel
->C++/&kommander;/KommanderPlugin</guilabel
-> mall. Anna oma pluginale nimi ja järgi nõustaja juhiseid. </para>
-<para
->Sul tuleb vaid täita vidinale olulised komponendid, näiteks olekuteave, vidina tekst jms. </para>
-<para
->Oletame, et soovid luua &kommander;ile uue tekstikasti, võttes selle aluseks &kde; vidina KLineEdit. &kommander;i vidina genereerimise dialoogi kasutades võtab päisefail umbes sellise kuju: </para>
-<screen
->#include &lt;kommanderwidget.h&gt;
+<title>Vidinaklassi loomine</title>
+<para>Esimeseks sammuks on vidinaklassi loomine. Selleks tuleb tuletada oma uus &kommander;i vidina klass &Qt;/&kde; vidinast, mida soovid &kommander;iga põimida, ning seejärel ka klassist KommanderWidget. Selle klassi alistamismeetodid annavadki &kommander;i vidinale vajalikud funktsioonid. </para>
+<para>Enamik &kommander;i vidina koodist on lihtsalt mallkood. Seepärast saab enamiku &kommander;i vidina koodi genereerimiseks ära kasutada KDevelopi &kommander;i plugina malli. Selleks käivita KDevelop (soovitavalt vähemalt versioon 3.5), vali <guimenu>Projekt->Uus projekt</guimenu>, märgi ära kastike <guilabel>Kõigi projektimallide näitamine</guilabel> ja vali <guilabel>C++/&kommander;/KommanderPlugin</guilabel> mall. Anna oma pluginale nimi ja järgi nõustaja juhiseid. </para>
+<para>Sul tuleb vaid täita vidinale olulised komponendid, näiteks olekuteave, vidina tekst jms. </para>
+<para>Oletame, et soovid luua &kommander;ile uue tekstikasti, võttes selle aluseks &kde; vidina KLineEdit. &kommander;i vidina genereerimise dialoogi kasutades võtab päisefail umbes sellise kuju: </para>
+<screen>#include &lt;kommanderwidget.h&gt;
class QShowEvent;
class KomLineEdit : public KLineEdit, public KommanderWidget
@@ -108,12 +58,9 @@ signals:
void widgetTextChanged(const QString &amp;);
};
</screen>
-<para
->Peamiselt on tegemist mallkoodiga, mille üle ei tasu pead murda. Tähele tuleb panna vaid kaht asja: fail kommanderwidget.h peab olema kaasatud kohe alguses ning klass peab olema esmalt tuletatud vidinast, mida me soovime lõimida &kommander;iga ja teiseks KommanderWidget'ist. </para>
-<para
->cpp-failis on teatud osad, mida tuleb iga konkreetse vidina puhul tähele panna. </para>
-<screen
->KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name)
+<para>Peamiselt on tegemist mallkoodiga, mille üle ei tasu pead murda. Tähele tuleb panna vaid kaht asja: fail kommanderwidget.h peab olema kaasatud kohe alguses ning klass peab olema esmalt tuletatud vidinast, mida me soovime lõimida &kommander;iga ja teiseks KommanderWidget'ist. </para>
+<para>cpp-failis on teatud osad, mida tuleb iga konkreetse vidina puhul tähele panna. </para>
+<screen>KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name)
: KLineEdit(a_parent, a_name), KommanderWidget(this)
{
QStringList states;
@@ -122,27 +69,13 @@ signals:
setDisplayStates(states);
}
</screen>
-<para
->Konstruktoris saab määrata vidina võimalikud olekud. Meie tekstikastil ei ole mingeid olekuid, sestap anname talle ainult ühe, vaikimisi oleku <emphasis
->default</emphasis
->. Kui lood vidina, millel võib olla mitu olekut, näiteks märkekasti, siis saab siin määrata kolm olekut: märkimata (<emphasis
->unchecked</emphasis
->), poolmärgitud (<emphasis
->semichecked</emphasis
->) ja märgitud<emphasis
->checked</emphasis
->. </para>
-<screen
->QString KomLineEdit::currentState() const
+<para>Konstruktoris saab määrata vidina võimalikud olekud. Meie tekstikastil ei ole mingeid olekuid, sestap anname talle ainult ühe, vaikimisi oleku <emphasis>default</emphasis>. Kui lood vidina, millel võib olla mitu olekut, näiteks märkekasti, siis saab siin määrata kolm olekut: märkimata (<emphasis>unchecked</emphasis>), poolmärgitud (<emphasis>semichecked</emphasis>) ja märgitud<emphasis>checked</emphasis>. </para>
+<screen>QString KomLineEdit::currentState() const
{
return QString("default");
}</screen>
-<para
->Eespool määrasime konstruktoris olekud ning see tagastab lihtsalt vidina aktiivse oleku. Meie vidina puhul on see alati <emphasis
->default</emphasis
->, aga muidu tuleb siia kirjutada kood, mis kontrollib, millises olekus vidin parasjagu on, ning tagastab vajaliku teate. </para>
-<screen
->QString KomLineEdit::widgetText() const
+<para>Eespool määrasime konstruktoris olekud ning see tagastab lihtsalt vidina aktiivse oleku. Meie vidina puhul on see alati <emphasis>default</emphasis>, aga muidu tuleb siia kirjutada kood, mis kontrollib, millises olekus vidin parasjagu on, ning tagastab vajaliku teate. </para>
+<screen>QString KomLineEdit::widgetText() const
{
return KLineEdit::text();
}
@@ -153,18 +86,9 @@ void KomLineEdit::setWidgetText(const QString &amp;a_text)
emit widgetTextChanged(a_text);
}
</screen>
-<para
->Need on kaks kõige tähtsamat meetodit, mis sisaldavat põhiosa funktsionaalsest koodist. Meetod <emphasis
->QString KomLineEdit::widgetText() const</emphasis
-> tagastab vidina teksti (teksti, milleks tekstiseoses laiendatakse eri <emphasis
->@widgetText</emphasis
->. Meie vidina puhul on tekst see, mida kirjutatakse tekstikasti, nii et see tagastataksegi. Vidina teksti määramisel tuleb meil määrata tekstikasti kirjutatav tekst. Me saadame pärast vidina teksti määramist signaali <emphasis
->widgetTextChanged()</emphasis
->, et teised vidinat teaksid, et seda vidinat on uuendatud. </para>
-<para
->Vidinale funktsionaalsuse lisamiseks tuleb registreerida vastavad funktsioonid ja lisada neile vajalik kood. Registreerimiseks mõeldud kood tuleb asetada cpp-faili algusse konstruktori ette: </para>
-<screen
->#include &lt;tdelocale.h&gt; //for i18n
+<para>Need on kaks kõige tähtsamat meetodit, mis sisaldavat põhiosa funktsionaalsest koodist. Meetod <emphasis>QString KomLineEdit::widgetText() const</emphasis> tagastab vidina teksti (teksti, milleks tekstiseoses laiendatakse eri <emphasis>@widgetText</emphasis>. Meie vidina puhul on tekst see, mida kirjutatakse tekstikasti, nii et see tagastataksegi. Vidina teksti määramisel tuleb meil määrata tekstikasti kirjutatav tekst. Me saadame pärast vidina teksti määramist signaali <emphasis>widgetTextChanged()</emphasis>, et teised vidinat teaksid, et seda vidinat on uuendatud. </para>
+<para>Vidinale funktsionaalsuse lisamiseks tuleb registreerida vastavad funktsioonid ja lisada neile vajalik kood. Registreerimiseks mõeldud kood tuleb asetada cpp-faili algusse konstruktori ette: </para>
+<screen>#include &lt;tdelocale.h&gt; //for i18n
#include "kommanderplugin.h"
#include "specials.h"
@@ -184,37 +108,15 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name)
KommanderPlugin::registerFunction(function2, "function2(QString widget)", i18n("Get a QString as a result of function2."), 1);
}
</screen>
-<para
->See registreerib kaks funktsiooni: <emphasis
->function1 ja function2</emphasis
->. Funktsioonile omistatav number (siin <emphasis
->1160</emphasis
-> ja <emphasis
->1161</emphasis
->) peab olema unikaalne, seda ei tohi kasutada üheski muus pluginas ega &kommander;is endas. Funktsioonile <emphasis
->function1</emphasis
-> võib anda kaks argumenti, millest üks pole kohustuslik; funktsioonil <emphasis
->function2</emphasis
-> ei saa anda ühtegi argumenti ja see tagastab stringi. Argument <emphasis
->QString widget</emphasis
-> näitab, et funktsioonid tegutsevad vidinas, näiteks: <emphasis
->KomLineEdit.function1("foo", 1)</emphasis
->. </para>
-<para
->Et ka &kommander; teaks ,et vidin neid funktsioone toetab, lisa selline meetod: </para>
-<screen
->bool KomLineEdit::isFunctionSupported(int f)
+<para>See registreerib kaks funktsiooni: <emphasis>function1 ja function2</emphasis>. Funktsioonile omistatav number (siin <emphasis>1160</emphasis> ja <emphasis>1161</emphasis>) peab olema unikaalne, seda ei tohi kasutada üheski muus pluginas ega &kommander;is endas. Funktsioonile <emphasis>function1</emphasis> võib anda kaks argumenti, millest üks pole kohustuslik; funktsioonil <emphasis>function2</emphasis> ei saa anda ühtegi argumenti ja see tagastab stringi. Argument <emphasis>QString widget</emphasis> näitab, et funktsioonid tegutsevad vidinas, näiteks: <emphasis>KomLineEdit.function1("foo", 1)</emphasis>. </para>
+<para>Et ka &kommander; teaks ,et vidin neid funktsioone toetab, lisa selline meetod: </para>
+<screen>bool KomLineEdit::isFunctionSupported(int f)
{
- return (f
-> FirstFunction &amp;&amp; f &lt; LastFunction) || f == DCOP::text;
+ return (f > FirstFunction &amp;&amp; f &lt; LastFunction) || f == DCOP::text;
}
</screen>
-<para
->See tähendab, et KomLineEdit toetab ülaltoodud funktsioone ja standardset funktsiooni <emphasis
->text</emphasis
->. Funktsiooni koodi saab käsitleda meetodi handleDCOP raames: </para>
-<screen
->QString KomLineEdit::handleDCOP(int function, const QStringList&amp; args)
+<para>See tähendab, et KomLineEdit toetab ülaltoodud funktsioone ja standardset funktsiooni <emphasis>text</emphasis>. Funktsiooni koodi saab käsitleda meetodi handleDCOP raames: </para>
+<screen>QString KomLineEdit::handleDCOP(int function, const QStringList&amp; args)
{
switch (function)
{
@@ -233,10 +135,8 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name)
return QString::null;
}
</screen>
-<para
->Tegemist on juhtudega, kus vidin võib olla redaktoris ja executoris erinev, näiteks skriptiobjektide, infodialoogi vms. puhul. Tavaliselt näidatakse vidina asemel QLabel'it. Selleks peab vidin tulenema QLabel'ist, milleks konstruktoris peab seisma järgmine kood: </para>
-<screen
->if (KommanderWidget::inEditor)
+<para>Tegemist on juhtudega, kus vidin võib olla redaktoris ja executoris erinev, näiteks skriptiobjektide, infodialoogi vms. puhul. Tavaliselt näidatakse vidina asemel QLabel'it. Selleks peab vidin tulenema QLabel'ist, milleks konstruktoris peab seisma järgmine kood: </para>
+<screen>if (KommanderWidget::inEditor)
{
setPixmap(TDEGlobal::iconLoader()->loadIcon("iconname", TDEIcon::NoGroup, TDEIcon::SizeMedium));
setFrameStyle(QFrame::Box | QFrame::Plain);
@@ -246,12 +146,8 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name)
else
setHidden(true);
</screen>
-<para
->Ka vidina enda (kui sul läheb üldse vidinat tarvis - vahest pakub sinu "vidin" kõigest võimalust kasutada andmebaasi vms.) võib luua mõnes funktsioonis, näiteks funktsioonis <emphasis
->execute</emphasis
->. Toome näite infodialoogi põhjal: </para>
-<screen
->QString AboutDialog::handleDCOP(int function, const QStringList&amp; args)
+<para>Ka vidina enda (kui sul läheb üldse vidinat tarvis - vahest pakub sinu "vidin" kõigest võimalust kasutada andmebaasi vms.) võib luua mõnes funktsioonis, näiteks funktsioonis <emphasis>execute</emphasis>. Toome näite infodialoogi põhjal: </para>
+<screen>QString AboutDialog::handleDCOP(int function, const QStringList&amp; args)
{
switch (function) {
...
@@ -267,62 +163,40 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name)
...
}
</screen>
-<para
->Nüüd ongi &kommander;i vidin valmis. Jääb üle vaid muuta see &kommander;ile kättesaadavaks pluginate abil. </para>
+<para>Nüüd ongi &kommander;i vidin valmis. Jääb üle vaid muuta see &kommander;ile kättesaadavaks pluginate abil. </para>
</sect2>
<sect2 id="create-plugin">
-<title
->&kommander;i plugina loomine</title>
-<para
->Kõiki &kommander;i vidinaid pakuvad pluginad. Standardvidinad laaditakse vidinapluginatena, kuid &kommander;i redaktor on samuti lingitud selle teegiga, sest teatud mehhanismid redaktoris on seotud spetsiaalselt standardvidinatega. </para>
-<para
->&kommander;i plugin on lihtsalt ühisteek sümboliga 'kommander_plugin'. See sümbol on funktsioon, mis tagastab viida klassi KommanderPlugin isendile. </para>
-<para
->&kommander; võimaldab väga lihtsalt luua vidinatele pluginat, nii et kirjeldatud süvateadmiste pärast ei tasu muret tunda. Põhiline on tuletada oma vidinate uus pluginaklass baasklassist KommanderPlugin ja teostada mõned konkreetsed üksikasjad. Mallkoodi saab genereeriga ülalmainitud KDevelopi projektimallist. </para>
-<para
->Järgnev kood jätkab meie näidet, milles me lõime Kommanderi tekstikasti. </para>
-<screen
->#include &lt;kommanderplugin.h>
+<title>&kommander;i plugina loomine</title>
+<para>Kõiki &kommander;i vidinaid pakuvad pluginad. Standardvidinad laaditakse vidinapluginatena, kuid &kommander;i redaktor on samuti lingitud selle teegiga, sest teatud mehhanismid redaktoris on seotud spetsiaalselt standardvidinatega. </para>
+<para>&kommander;i plugin on lihtsalt ühisteek sümboliga 'kommander_plugin'. See sümbol on funktsioon, mis tagastab viida klassi KommanderPlugin isendile. </para>
+<para>&kommander; võimaldab väga lihtsalt luua vidinatele pluginat, nii et kirjeldatud süvateadmiste pärast ei tasu muret tunda. Põhiline on tuletada oma vidinate uus pluginaklass baasklassist KommanderPlugin ja teostada mõned konkreetsed üksikasjad. Mallkoodi saab genereeriga ülalmainitud KDevelopi projektimallist. </para>
+<para>Järgnev kood jätkab meie näidet, milles me lõime Kommanderi tekstikasti. </para>
+<screen>#include &lt;kommanderplugin.h>
/* WIDGET INCLUDES */
#include "komlineedit.h"
</screen>
-<para
->Kõigepealt tuleb kaasata kommanderplugin.h. See sisaldab klassi KommanderPlugin definitsiooni. Samuti tuleb kaasata kõigi vidinate päisefailid, mida antud plugin pakub - praegusel juhul on selleks ainult komlineedit.h. </para>
-<screen
->class MinuKomPlugin : public KommanderPlugin
+<para>Kõigepealt tuleb kaasata kommanderplugin.h. See sisaldab klassi KommanderPlugin definitsiooni. Samuti tuleb kaasata kõigi vidinate päisefailid, mida antud plugin pakub - praegusel juhul on selleks ainult komlineedit.h. </para>
+<screen>class MinuKomPlugin : public KommanderPlugin
{
public:
MinuKomPlugin();
virtual QWidget *create( const QString &amp;className, QWidget *parent = 0, const char *name = 0 );
};
</screen>
-<para
->Seejärel loome KommanderPlugin'i alamklassi <emphasis
->MyKomPlugin</emphasis
->. See sisaldab lihtsalt konstruktorit ja tühistavat loomismeetodit. </para>
-<screen
->MinuKomPlugin::MinuKomPlugin()
+<para>Seejärel loome KommanderPlugin'i alamklassi <emphasis>MyKomPlugin</emphasis>. See sisaldab lihtsalt konstruktorit ja tühistavat loomismeetodit. </para>
+<screen>MinuKomPlugin::MinuKomPlugin()
{
addWidget( "KomLineEdit", "My Widget Group", i18n("A Kommander line edit widget") new QIconSet(TDEGlobal::iconLoader()->loadIcon("ikooninimi", TDEIcon::NoGroup, TDEIcon::SizeMedium)));
//add my other widgets here
}
</screen>
-<para
->Plugina konstruktoris kutsume <emphasis
->addWidget()</emphasis
-> välja iga vidina puhul, mida plugin meie soovide kohaselt peab pakkuda. <emphasis
->addWidget()</emphasis
-> võib kasutada kuut argumenti, aga vajalikud on ainult esimesed neli. Argumendid on järgmises järjekorras: vidina klassi nimi, grupp, kohtspikker, redaktori tööriistaribal kasutatava ikooni ikoonirühm, 'Mis see on?' teave ning tõeväärtus, mis osutab, kas vidin on teiste vidinate konteiner või mitte. Seda teavet kasutab redaktor vidinate rühmitamisel menüüs, abiinfo pakkumisel jne. </para>
-<para
->Mis puutub ikooni, siis toodud näide laadib keskmise suurusega ikooni <emphasis
->ikooninimi</emphasis
-> &kde; ikoonide standardsest asukohast. </para>
-<screen
->QWidget *MinuKomPlugin::create( const QString &amp;className, QWidget *parent, const char *name )
+<para>Plugina konstruktoris kutsume <emphasis>addWidget()</emphasis> välja iga vidina puhul, mida plugin meie soovide kohaselt peab pakkuda. <emphasis>addWidget()</emphasis> võib kasutada kuut argumenti, aga vajalikud on ainult esimesed neli. Argumendid on järgmises järjekorras: vidina klassi nimi, grupp, kohtspikker, redaktori tööriistaribal kasutatava ikooni ikoonirühm, 'Mis see on?' teave ning tõeväärtus, mis osutab, kas vidin on teiste vidinate konteiner või mitte. Seda teavet kasutab redaktor vidinate rühmitamisel menüüs, abiinfo pakkumisel jne. </para>
+<para>Mis puutub ikooni, siis toodud näide laadib keskmise suurusega ikooni <emphasis>ikooninimi</emphasis> &kde; ikoonide standardsest asukohast. </para>
+<screen>QWidget *MinuKomPlugin::create( const QString &amp;className, QWidget *parent, const char *name )
{
if( className == "KomLineEdit" )
return new KomLineEdit( parent, name );
@@ -330,23 +204,12 @@ public:
return 0;
}
</screen>
-<para
->Just <emphasis
->create()</emphasis
-> loob tegelikult meie vidinate isendid. Kui &kommander; soovib mõne meie plugina pakutava klassi isendit, kutsub ta välja <emphasis
->create()</emphasis
-> soovitud klassi nimega, samuti selle eellase nime ja nimega, mida hakatakse kasutama. Kui <emphasis
->className</emphasis
-> vastab mõnele teadaolevale vidinale, tagastatakse selle uus isend, vastasel juhul 0. </para>
-<para
->Lõpuks tuleb plugin eksportida. See on meie plugina kättesaamiskoht, mille järel &kommander; oskab teda üles leida. Ilma selleta ei pea &kommander; meie teeki &kommander;i pluginaks. </para>
-<screen
->KOMMANDER_EXPORT_PLUGIN(MinuKomPlugin)
+<para>Just <emphasis>create()</emphasis> loob tegelikult meie vidinate isendid. Kui &kommander; soovib mõne meie plugina pakutava klassi isendit, kutsub ta välja <emphasis>create()</emphasis> soovitud klassi nimega, samuti selle eellase nime ja nimega, mida hakatakse kasutama. Kui <emphasis>className</emphasis> vastab mõnele teadaolevale vidinale, tagastatakse selle uus isend, vastasel juhul 0. </para>
+<para>Lõpuks tuleb plugin eksportida. See on meie plugina kättesaamiskoht, mille järel &kommander; oskab teda üles leida. Ilma selleta ei pea &kommander; meie teeki &kommander;i pluginaks. </para>
+<screen>KOMMANDER_EXPORT_PLUGIN(MinuKomPlugin)
</screen>
-<para
->Uue &kommander;i laiendi kompileerimiseks tuleb kompileerida kõik failid ühisteegina, linkides nad kommanderplugini, kommanderwidgeti ja kõigi vajalike KDE teekidega. Tekstikasti puhul, kus meil on komlineedit.h, komlineedit.cpp ja minukomplugin.cpp, peaks plugina kompileerimine ja paigaldamine käima umbes selliste käskudega: </para>
-<screen
->libtool --mode=compile g++ -$TDEDIR/include -IQTDIR/include \
+<para>Uue &kommander;i laiendi kompileerimiseks tuleb kompileerida kõik failid ühisteegina, linkides nad kommanderplugini, kommanderwidgeti ja kõigi vajalike KDE teekidega. Tekstikasti puhul, kus meil on komlineedit.h, komlineedit.cpp ja minukomplugin.cpp, peaks plugina kompileerimine ja paigaldamine käima umbes selliste käskudega: </para>
+<screen>libtool --mode=compile g++ -$TDEDIR/include -IQTDIR/include \
-I. -fPIC -c komlineedit.cpp
libtool --mode=compile g++ -$TDEDIR/include -IQTDIR/include \
-I. -fPIC -c minukomplugin.cpp
@@ -355,45 +218,21 @@ libtool --mode=link g++ -shared -L$TDEDIR/lib -ltdeui -lkommanderwidget \
-lkommanderplugin komlineedit.cppkomlineedit.o minukomplugin.o
-o libmykomplugin.so
</screen>
-<para
->Kui soovid paigaldada uue plugina süsteemsena, kasuta järgmist käsku: </para>
-<screen
->su -c "cp libminukomplugin.so $TDEDIR/lib"
+<para>Kui soovid paigaldada uue plugina süsteemsena, kasuta järgmist käsku: </para>
+<screen>su -c "cp libminukomplugin.so $TDEDIR/lib"
</screen>
-<note
-><para
->Kui tarvitad KDevelopi projektigeneraatorit, ei ole ülaltoodut vaja, vaid tuleb kohandada Makefile.am-i, linkides selle täiendavate teekidega. Vaikimisi lingitakse &Qt; ja &kde; teekidega ning genereeritakse kõik vajalikud objektfailid. Anna ehitamiseks lihtsalt käsk <command
->make</command
-> ja paigaldamiseks <command
->su -c make install</command
->.</para
-></note>
+<note><para>Kui tarvitad KDevelopi projektigeneraatorit, ei ole ülaltoodut vaja, vaid tuleb kohandada Makefile.am-i, linkides selle täiendavate teekidega. Vaikimisi lingitakse &Qt; ja &kde; teekidega ning genereeritakse kõik vajalikud objektfailid. Anna ehitamiseks lihtsalt käsk <command>make</command> ja paigaldamiseks <command>su -c make install</command>.</para></note>
</sect2>
<sect2 id="config-plugin">
-<title
->Paigaldatud plugina seadistamine</title>
-<para
->Kui plugin on paigaldatud, käivita programm <command
->kmdr-plugins</command
-> või vali redaktoris menüükäsk <guimenu
->Seadistused->Pluginate seadistamine</guimenu
->. Programmi nimekirjas on parajasti &kommander;is laaditud pluginad. Lisa uus plugin, klõpsates tööriistaribal nupule <guilabel
->Lisa</guilabel
-> ja valides oma plugina. Programmi sulgemisel salvestatakse muudatused. </para>
-<para
->Kui nüüd &kommander;i redaktor uuesti käivitada, on uue plugina pakutavad vidinad kättesaadavad menüüdes ja tööriistaribadel. Nüüd saab ka uusi vidinaid kasutada &kommander;i dialoogides. </para>
+<title>Paigaldatud plugina seadistamine</title>
+<para>Kui plugin on paigaldatud, käivita programm <command>kmdr-plugins</command> või vali redaktoris menüükäsk <guimenu>Seadistused->Pluginate seadistamine</guimenu>. Programmi nimekirjas on parajasti &kommander;is laaditud pluginad. Lisa uus plugin, klõpsates tööriistaribal nupule <guilabel>Lisa</guilabel> ja valides oma plugina. Programmi sulgemisel salvestatakse muudatused. </para>
+<para>Kui nüüd &kommander;i redaktor uuesti käivitada, on uue plugina pakutavad vidinad kättesaadavad menüüdes ja tööriistaribadel. Nüüd saab ka uusi vidinaid kasutada &kommander;i dialoogides. </para>
</sect2>
<sect2 id="add-widget">
-<title
->Vidina lisamine otse &kommander;ile</title>
-<para
->See osa on mõeldud &kommander;i arendajatele ja kirjeldab, kuidas lisada uus vidin otse &kommander;ile.</para>
-<para
->Mõneti irooniliselt on see omajagu keerulisem, eriti siis, kui vidin vajab täiendavaid redigeerimismeetodeid. Kõigepealt tuleb luua vidin, nagu eespool kirjeldatud. Seejärel tuleb vidin registreerida redaktoris ja executoris. Redaktoris registreerimiseks tuleb järgnev lisada faili <emphasis
->editor/widgetdatabase.cpp</emphasis
->: </para>
-<screen
->...
+<title>Vidina lisamine otse &kommander;ile</title>
+<para>See osa on mõeldud &kommander;i arendajatele ja kirjeldab, kuidas lisada uus vidin otse &kommander;ile.</para>
+<para>Mõneti irooniliselt on see omajagu keerulisem, eriti siis, kui vidin vajab täiendavaid redigeerimismeetodeid. Kõigepealt tuleb luua vidin, nagu eespool kirjeldatud. Seejärel tuleb vidin registreerida redaktoris ja executoris. Redaktoris registreerimiseks tuleb järgnev lisada faili <emphasis>editor/widgetdatabase.cpp</emphasis>: </para>
+<screen>...
#include "minuvidin.h"
...
void WidgetDatabase::setupDataBase( int id )
@@ -408,12 +247,8 @@ void WidgetDatabase::setupDataBase( int id )
...
}
</screen>
-<para
->Lisada tuleb ka faili <emphasis
->editor/widgetfactory.cpp</emphasis
->: </para>
-<screen
->...
+<para>Lisada tuleb ka faili <emphasis>editor/widgetfactory.cpp</emphasis>: </para>
+<screen>...
#include "minuvidin.h"
...
QWidget *WidgetFactory::createWidget( const QString &amp;className, QWidget *parent, const char *name, bool init,
@@ -425,20 +260,15 @@ QWidget *WidgetFactory::createWidget( const QString &amp;className, QWidget *par
...
}
</screen>
-<para
->Registreerimiseks executoris (sisuliselt pluginasüsteemis) tuleb järgnev lisada failile <emphasis
->widgets/plugin.cpp</emphasis
->: </para>
-<screen
->KomStdPlugin::KomStdPlugin()
+<para>Registreerimiseks executoris (sisuliselt pluginasüsteemis) tuleb järgnev lisada failile <emphasis>widgets/plugin.cpp</emphasis>: </para>
+<screen>KomStdPlugin::KomStdPlugin()
{
...
addWidget("MyWidgetName", group, "", new QIconSet(TDEGlobal::iconLoader()->loadIcon("iconname", TDEIcon::NoGroup, TDEIcon::SizeMedium)));
...
}
</screen>
-<para
->See sarnaneb sellele, kuidas vidin registreeriti pluginasüsteemis esimesel juhul. </para>
+<para>See sarnaneb sellele, kuidas vidin registreeriti pluginasüsteemis esimesel juhul. </para>
</sect2>
</sect1>