diff options
Diffstat (limited to 'tde-i18n-et/docs/tdewebdev/kommander/extending.docbook')
| -rw-r--r-- | tde-i18n-et/docs/tdewebdev/kommander/extending.docbook | 48 |
1 files changed, 24 insertions, 24 deletions
diff --git a/tde-i18n-et/docs/tdewebdev/kommander/extending.docbook b/tde-i18n-et/docs/tdewebdev/kommander/extending.docbook index bd5e935ee0d..0c35f9194e8 100644 --- a/tde-i18n-et/docs/tdewebdev/kommander/extending.docbook +++ b/tde-i18n-et/docs/tdewebdev/kommander/extending.docbook @@ -31,36 +31,36 @@ class KomLineEdit : public KLineEdit, public KommanderWidget { TQ_OBJECT - TQ_PROPERTY(QString populationText READ populationText WRITE setPopulationText DESIGNABLE false) + TQ_PROPERTY(TQString populationText READ populationText WRITE setPopulationText DESIGNABLE false) TQ_PROPERTY(QStringList associations READ associatedText WRITE setAssociatedText DESIGNABLE false) TQ_PROPERTY(bool KommanderWidget READ isKommanderWidget) public: - KomLineEdit(QWidget *a_parent, const char *a_name); + KomLineEdit(TQWidget *a_parent, const char *a_name); ~KomLineEdit(); - virtual QString widgetText() const; + virtual TQString widgetText() const; virtual bool isKommanderWidget() const; virtual void setAssociatedText(const QStringList&); virtual QStringList associatedText() const; - virtual QString currentState() const; + virtual TQString currentState() const; - virtual QString populationText() const; - virtual void setPopulationText(const QString&); + virtual TQString populationText() const; + virtual void setPopulationText(const TQString&); public slots: - virtual void setWidgetText(const QString &); + virtual void setWidgetText(const TQString &); virtual void populate(); protected: void showEvent( QShowEvent *e ); signals: void widgetOpened(); - void widgetTextChanged(const QString &); + void widgetTextChanged(const TQString &); }; </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) +<screen>KomLineEdit::KomLineEdit(TQWidget *a_parent, const char *a_name) : KLineEdit(a_parent, a_name), KommanderWidget(this) { QStringList states; @@ -70,23 +70,23 @@ signals: } </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 +<screen>TQString KomLineEdit::currentState() const { - return QString("default"); + return TQString("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 +<screen>TQString KomLineEdit::widgetText() const { return KLineEdit::text(); } -void KomLineEdit::setWidgetText(const QString &a_text) +void KomLineEdit::setWidgetText(const TQString &a_text) { KLineEdit::setText(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>Need on kaks kõige tähtsamat meetodit, mis sisaldavat põhiosa funktsionaalsest koodist. Meetod <emphasis>TQString 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 <tdelocale.h> //for i18n @@ -99,16 +99,16 @@ enum Functions { Function2, LastFunction }; -KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) +KomLineEdit::KomLineEdit(TQWidget *a_parent, const char *a_name) : KLineEdit(a_parent, a_name), KommanderWidget(this) { ... //code like described above KommanderPlugin::setDefaultGroup(Group::DCOP); - KommanderPlugin::registerFunction(Function1, "function1(QString widget, QString arg1, int arg2)", i18n("Call function1 with two arguments, second is optional."), 2, 3); - KommanderPlugin::registerFunction(function2, "function2(QString widget)", i18n("Get a QString as a result of function2."), 1); + KommanderPlugin::registerFunction(Function1, "function1(TQString widget, TQString arg1, int arg2)", i18n("Call function1 with two arguments, second is optional."), 2, 3); + KommanderPlugin::registerFunction(function2, "function2(TQString widget)", i18n("Get a TQString 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>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>TQString 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) { @@ -116,7 +116,7 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) } </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& args) +<screen>TQString KomLineEdit::handleDCOP(int function, const QStringList& args) { switch (function) { @@ -132,7 +132,7 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) default: return KommanderWidget::handleDCOP(function, args); } - return QString::null; + return TQString::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> @@ -147,7 +147,7 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) 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& args) +<screen>TQString AboutDialog::handleDCOP(int function, const QStringList& args) { switch (function) { ... @@ -184,7 +184,7 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) { public: MinuKomPlugin(); - virtual QWidget *create( const QString &className, QWidget *parent = 0, const char *name = 0 ); + virtual TQWidget *create( const TQString &className, TQWidget *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> @@ -196,7 +196,7 @@ public: </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 &className, QWidget *parent, const char *name ) +<screen>TQWidget *MinuKomPlugin::create( const TQString &className, TQWidget *parent, const char *name ) { if( className == "KomLineEdit" ) return new KomLineEdit( parent, name ); @@ -251,7 +251,7 @@ void WidgetDatabase::setupDataBase( int id ) <screen>... #include "minuvidin.h" ... -QWidget *WidgetFactory::createWidget( const QString &className, QWidget *parent, const char *name, bool init, +TQWidget *WidgetFactory::createWidget( const TQString &className, TQWidget *parent, const char *name, bool init, const QRect *r, Qt::Orientation orient ) { ... |