From 241e0082f7b9ccadaeed0ef43a1c9ebb9b4fe840 Mon Sep 17 00:00:00 2001 From: Michele Calgaro Date: Fri, 13 Oct 2023 18:02:18 +0900 Subject: Replace QObject, QWidget, QImage, QPair, QRgb, QColor, QChar, QString, QIODevice with TQ* version Signed-off-by: Michele Calgaro --- tde-i18n-et/docs/tdewebdev/kommander/dcop.docbook | 20 ++++----- .../docs/tdewebdev/kommander/extending.docbook | 48 +++++++++++----------- .../docs/tdewebdev/kommander/parser.docbook | 4 +- .../docs/tdewebdev/kommander/tutorials.docbook | 2 +- 4 files changed, 37 insertions(+), 37 deletions(-) (limited to 'tde-i18n-et/docs/tdewebdev/kommander') diff --git a/tde-i18n-et/docs/tdewebdev/kommander/dcop.docbook b/tde-i18n-et/docs/tdewebdev/kommander/dcop.docbook index fbcb98c2349..86af50e41a1 100644 --- a/tde-i18n-et/docs/tdewebdev/kommander/dcop.docbook +++ b/tde-i18n-et/docs/tdewebdev/kommander/dcop.docbook @@ -18,7 +18,7 @@ dcop `dcop | grep kmdr` KommanderIf See eeldab, et oled &kommander;i failis ja sul on ligipääs spetsiaalsele @pid-ile, mis sisaldab protsessi ID-d. Tegelikult on lihtsam asendada kmdr-executor-@pid @dcopid-ga. Aga igal juhul on võimalik seda süntaksit kasutada (küll ilma erideta) käsurealt või mis tahes välisest skriptist, et muuta &kommander;i akent. &kommander; on võtnud kasutusele palju kiirema sisemise &DCOP;-funktsiooni. Selle kasutamine mõne muu rakenduse aknast (konsooli &DCOP; on ikka päris aeglane) tekitab mõningaid raskusi, sest sa pead andma hulganisti infot, sealhulgas väljakutse prototüübi. Eeltoodud käsk võtab siis kuju (pane tähele, et @dcopid on dialoogis tegelikult sisene, aga sa võid selle asendada mis tahes korrektse protsessi ID-ga): -@dcop(@dcopid, KommanderIf, enableWidget(QString, tõeväärtus), Vidin, true) +@dcop(@dcopid, KommanderIf, enableWidget(TQString, tõeväärtus), Vidin, true) Varasemas &kommander;is tähendas &DCOP;-väljakutsete pesastamine skriptikeele struktuuridesse (näiteks bash) seda, et väljakutsed tuli esitada konsoolilt. Kui kasutad sisest &DCOP;-i, käivitatakse esmalt kõik &kommander;i erid ja seejärel skript. Palun loe eelmist lauset veel kord, sest muidu ei ole nutul ja halal piiri, kui bash satub &kommander;i eridega lõpmatusse silmusesse. On ka uus ja lihtsam viis kasutada &DCOP;-i &kommander;is endas, mida võimaldab objektsüntaks. Oletame, et soovid muuta teksti vidinas nimega @LineEdit1. See käib järgmiselt. @@ -30,15 +30,15 @@ dcop `dcop | grep kmdr` KommanderIf &DCOP; globaalsete muutujatele -global(QString muutujaNimi) +global(TQString muutujaNimi) Tagastab määratud globaalse muutuja väärtuse. Kui skript käivitatakse &kommander;i aknast, lakkavad kõik skriptiga määratud (mitteglobaalsed) muutujad eksisteerimast pärast skripti töö lõpetamist ega ole seepärast enam kasutatavad muudes skriptides või ka sama väljakutse kordamisel. Globaalne skoop tähendab seda, et muutuja eksisteerib akna iga protsessi jaoks seni, kuni aken suletakse. Neid muutujaid võib igal ajal muuta funktsiooni @setGlobal uue väljakutsega. -setGlobal(QString muugujaNimi, QString väärtus) +setGlobal(TQString muugujaNimi, TQString väärtus) -Loob muutuja, mis on akna protsessile globaalne ja omistab sellele väärtuse, Väärtuse saab hankida global(QString muutujaNimi) abil või ka uuesti määrata. +Loob muutuja, mis on akna protsessile globaalne ja omistab sellele väärtuse, Väärtuse saab hankida global(TQString muutujaNimi) abil või ka uuesti määrata. @@ -50,7 +50,7 @@ dcop `dcop | grep kmdr` KommanderIf Järgnev nimekiri on vananenud ja siin ära toodud rohkem ajaloo huvides. Kõigi vidinafunktsioonide ajakohastatud täielikku nimekirja pakub funktsioonibrauser, mille saab avada suvalisest &kommander;i tekstiredaktori aknast alumisele vasakpoolsele nupule vajutades. Need on nüüd vidinafunktsioonid, mitte enam &DCOP;-funktsioonid, aga &DCOP;-funktsioonid avaldatakse KommanderIf &DCOP;-liideses, mida kirjeldati eespool. Selle funktsionaalsuse väljakutsete loomise dialoogid on saadaval meie veebileheküljel. -setText(QString tekst) +setText(TQString tekst) See eemaldab see vidinas näidatava teksti ja asendab selle antava tekstiga. @@ -68,7 +68,7 @@ dcop `dcop | grep kmdr` KommanderIf -setAssociatedText(QString tekst) +setAssociatedText(TQString tekst) See määrab &kommander;i vaiketekstistringi. Tavaliselt määratakse selleks @widgetText, et näidata vidinasse sisestatut. Vaevalt sul seda eriti vaja läheb, aga igatahes on see olemas. Saab kasutada kõigi andmeid sisaldavate vidinate korral. @@ -80,7 +80,7 @@ dcop `dcop | grep kmdr` KommanderIf &DCOP; loendikasti ja liitkasti vidinale -addListItem(QString element, int index) +addListItem(TQString element, int index) Lisab elemendi loendikasti vidinasse määratud indeksiga. Loendi indeks algab nullist. Loendi lõppu lisamiseks anna -1. @@ -92,7 +92,7 @@ dcop `dcop | grep kmdr` KommanderIf -addUniqueItem(QString element) +addUniqueItem(TQString element) addUniqueItem lisab elemendi loendi lõppu ainult siis, kui see on unikaalne. @@ -128,7 +128,7 @@ dcop `dcop | grep kmdr` KommanderIf &DCOP; märkekasti ja raadionupu vidinale -setChecked(QString elemendiNimi, tõeväärtus checked) +setChecked(TQString elemendiNimi, tõeväärtus checked) Märgib või eemaldab märke märkekasti või raadionupu elemendilt. @@ -140,7 +140,7 @@ dcop `dcop | grep kmdr` KommanderIf &DCOP; kaardividinale -setCurrentTab(QString elemendiNimi, int index) +setCurrentTab(TQString elemendiNimi, int index) Valib kaardi indeksi järgi kaardividinalde. Indeks algab nulliga. 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 &); }; 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. cpp-failis on teatud osad, mida tuleb iga konkreetse vidina puhul tähele panna. -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) { QStringList states; @@ -70,23 +70,23 @@ signals: } Konstruktoris saab määrata vidina võimalikud olekud. Meie tekstikastil ei ole mingeid olekuid, sestap anname talle ainult ühe, vaikimisi oleku default. Kui lood vidina, millel võib olla mitu olekut, näiteks märkekasti, siis saab siin määrata kolm olekut: märkimata (unchecked), poolmärgitud (semichecked) ja märgitudchecked. -QString KomLineEdit::currentState() const +TQString KomLineEdit::currentState() const { - return QString("default"); + return TQString("default"); } Eespool määrasime konstruktoris olekud ning see tagastab lihtsalt vidina aktiivse oleku. Meie vidina puhul on see alati default, aga muidu tuleb siia kirjutada kood, mis kontrollib, millises olekus vidin parasjagu on, ning tagastab vajaliku teate. -QString KomLineEdit::widgetText() const +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); } -Need on kaks kõige tähtsamat meetodit, mis sisaldavat põhiosa funktsionaalsest koodist. Meetod QString KomLineEdit::widgetText() const tagastab vidina teksti (teksti, milleks tekstiseoses laiendatakse eri @widgetText. 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 widgetTextChanged(), et teised vidinat teaksid, et seda vidinat on uuendatud. +Need on kaks kõige tähtsamat meetodit, mis sisaldavat põhiosa funktsionaalsest koodist. Meetod TQString KomLineEdit::widgetText() const tagastab vidina teksti (teksti, milleks tekstiseoses laiendatakse eri @widgetText. 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 widgetTextChanged(), et teised vidinat teaksid, et seda vidinat on uuendatud. Vidinale funktsionaalsuse lisamiseks tuleb registreerida vastavad funktsioonid ja lisada neile vajalik kood. Registreerimiseks mõeldud kood tuleb asetada cpp-faili algusse konstruktori ette: #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); } -See registreerib kaks funktsiooni: function1 ja function2. Funktsioonile omistatav number (siin 1160 ja 1161) peab olema unikaalne, seda ei tohi kasutada üheski muus pluginas ega &kommander;is endas. Funktsioonile function1 võib anda kaks argumenti, millest üks pole kohustuslik; funktsioonil function2 ei saa anda ühtegi argumenti ja see tagastab stringi. Argument QString widget näitab, et funktsioonid tegutsevad vidinas, näiteks: KomLineEdit.function1("foo", 1). +See registreerib kaks funktsiooni: function1 ja function2. Funktsioonile omistatav number (siin 1160 ja 1161) peab olema unikaalne, seda ei tohi kasutada üheski muus pluginas ega &kommander;is endas. Funktsioonile function1 võib anda kaks argumenti, millest üks pole kohustuslik; funktsioonil function2 ei saa anda ühtegi argumenti ja see tagastab stringi. Argument TQString widget näitab, et funktsioonid tegutsevad vidinas, näiteks: KomLineEdit.function1("foo", 1). Et ka &kommander; teaks ,et vidin neid funktsioone toetab, lisa selline meetod: bool KomLineEdit::isFunctionSupported(int f) { @@ -116,7 +116,7 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) } See tähendab, et KomLineEdit toetab ülaltoodud funktsioone ja standardset funktsiooni text. Funktsiooni koodi saab käsitleda meetodi handleDCOP raames: -QString KomLineEdit::handleDCOP(int function, const QStringList& args) +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; } 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: @@ -147,7 +147,7 @@ KomLineEdit::KomLineEdit(QWidget *a_parent, const char *a_name) setHidden(true); 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 execute. Toome näite infodialoogi põhjal: -QString AboutDialog::handleDCOP(int function, const QStringList& args) +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 ); }; Seejärel loome KommanderPlugin'i alamklassi MyKomPlugin. See sisaldab lihtsalt konstruktorit ja tühistavat loomismeetodit. @@ -196,7 +196,7 @@ public: Plugina konstruktoris kutsume addWidget() välja iga vidina puhul, mida plugin meie soovide kohaselt peab pakkuda. addWidget() 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. Mis puutub ikooni, siis toodud näide laadib keskmise suurusega ikooni ikooninimi &kde; ikoonide standardsest asukohast. -QWidget *MinuKomPlugin::create( const QString &className, QWidget *parent, const char *name ) +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 ) ... #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 ) { ... diff --git a/tde-i18n-et/docs/tdewebdev/kommander/parser.docbook b/tde-i18n-et/docs/tdewebdev/kommander/parser.docbook index 2b26b6fbed0..ec077e20459 100644 --- a/tde-i18n-et/docs/tdewebdev/kommander/parser.docbook +++ b/tde-i18n-et/docs/tdewebdev/kommander/parser.docbook @@ -176,7 +176,7 @@ debug(result) Skriptis leiad midagi sellist: var = str_upper(Se return(var) Nüüd tagastatakse teatelogis Stderr HELLO WORLD. Skripti pesaga ühendatud signaali vastuvõtmine käib samamoodi. Self.Item(0) on esimene parameeter jne. Edastatud argumentide arvu hankimiseks on mõeldud ScriptObject.count. Käserea parameetrid lubavad nii nimega kui ka nimeta argumente. Nimeta argument näeb välja selline: kmdr-executor myprog.kmdr 100 red kus _ARG1 = 100 ja _ARG2 = red. Tühikutega stringide edastamisel argumendina tuleb nad panna jutumärkidesse. Dialoogikäsu kasutamine muudab asjad keerulisemaks, sest kogu argumendistring tuleb edastada tervikuna, mis tähendab selle asetamist jutumärkidesse. dialog("mydialog.kmdr", 100+" \"Hello World\"") See tagastab _ARG1 = 100 ja _ARG2 = Hello World. Ilma jutumärkideta saaksid _ARG2 = Hello ja _ARG3 = World. Nimega parameetrite kasutamine on kenam ja mitte nii segadusseajav. dialog("mydialog.kmdr", "xcount=100 xquote=Hello world") Nüüd saad neid kasutada globaalsete muutujatega _xcount ja _xquote. -DCOP võib olla päris keeruline, mistõttu me soovitame kasutada meie tööriistu DCOP-i lubamiseks &kommander;i võrgudialoogides näiteks funktsioonisirvijaga. Toome näite DCOP-i väljakutse kohta dialoogist, mis on avatud &kommander;i eellasaknast. Kuna ta teab oma eellast, võib ta saata teabe tagasi ajal, mil ta on avatud, ning vabalt kasutada kõiki oma eellase funktsioone, välja arvatud pesad. Loomulikult saab seda teha ka seesmiselt skriptiga, mis kutstutakse välja väliselt, nii et praktikas ei ole sisuliselt mingeid piire. dcop("kmdr-executor-"+parentPid, "KommanderIf", "setText(QString,QString)", "StatusBar8", "Hello") Vaatame seda osade kaupa. Kõigepealt lisame parentPid "kmdr-ececutor-"-ile, sest me ei saa eeldada, et väljakutsuja on &kommander;i aken. Seda võib kasutada Quanta või KSpreadi või millega tahes. Seejärel adresseerime KommanderIf'i, mis on kena ja puhastatud liides lõppkasutajale. Me loodame, et kui KDE lõpuks KDE4 ajal vahetab DCOP-i välja D-Busi vastu, võtab aina enam rakendusi omaks selle kena lõimimist soodustava liidese. Järgmine parameeter "setText(QString,QString)" on oluline, sest see muudab lubatud parameetrid prototüübiks. Vastasel juhul ei suudaks &kommander; väljakutset valideerida. Niisiis ilma DCOP-väljakutse definitsioonita on tulemuseks viga. Ülejäänud on mõistagi edastatavad parameetrid. Me soovitame uurida rakendusi, mis kasutavad kdcop'i, kui soovid näha, kuidas see töötab, ning harjutada DCOP-väljakutsetega shellis, kuni omandad õige süntaksi. +DCOP võib olla päris keeruline, mistõttu me soovitame kasutada meie tööriistu DCOP-i lubamiseks &kommander;i võrgudialoogides näiteks funktsioonisirvijaga. Toome näite DCOP-i väljakutse kohta dialoogist, mis on avatud &kommander;i eellasaknast. Kuna ta teab oma eellast, võib ta saata teabe tagasi ajal, mil ta on avatud, ning vabalt kasutada kõiki oma eellase funktsioone, välja arvatud pesad. Loomulikult saab seda teha ka seesmiselt skriptiga, mis kutstutakse välja väliselt, nii et praktikas ei ole sisuliselt mingeid piire. dcop("kmdr-executor-"+parentPid, "KommanderIf", "setText(TQString,TQString)", "StatusBar8", "Hello") Vaatame seda osade kaupa. Kõigepealt lisame parentPid "kmdr-ececutor-"-ile, sest me ei saa eeldada, et väljakutsuja on &kommander;i aken. Seda võib kasutada Quanta või KSpreadi või millega tahes. Seejärel adresseerime KommanderIf'i, mis on kena ja puhastatud liides lõppkasutajale. Me loodame, et kui KDE lõpuks KDE4 ajal vahetab DCOP-i välja D-Busi vastu, võtab aina enam rakendusi omaks selle kena lõimimist soodustava liidese. Järgmine parameeter "setText(TQString,TQString)" on oluline, sest see muudab lubatud parameetrid prototüübiks. Vastasel juhul ei suudaks &kommander; väljakutset valideerida. Niisiis ilma DCOP-väljakutse definitsioonita on tulemuseks viga. Ülejäänud on mõistagi edastatavad parameetrid. Me soovitame uurida rakendusi, mis kasutavad kdcop'i, kui soovid näha, kuidas see töötab, ning harjutada DCOP-väljakutsetega shellis, kuni omandad õige süntaksi.