diff options
Diffstat (limited to 'tde-i18n-et/docs/tdevelop/kdearch/index.docbook')
| -rw-r--r-- | tde-i18n-et/docs/tdevelop/kdearch/index.docbook | 122 |
1 files changed, 61 insertions, 61 deletions
diff --git a/tde-i18n-et/docs/tdevelop/kdearch/index.docbook b/tde-i18n-et/docs/tdevelop/kdearch/index.docbook index f3514e41350..2f770fe11c5 100644 --- a/tde-i18n-et/docs/tdevelop/kdearch/index.docbook +++ b/tde-i18n-et/docs/tdevelop/kdearch/index.docbook @@ -202,8 +202,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KConfig" ->KConfig</ulink +><ulink url="kdeapi:tdecore/TDEConfig" +>TDEConfig</ulink ></title> <para >Pakub ligipääsu KDE konfiguratsiooniandmebaasile. </para> @@ -2683,7 +2683,7 @@ else <programlisting >KURL url("http://developer.kde.org/favicon.ico"); -QString type = KIO::NetAccess::mimetype(url); +QString type = TDEIO::NetAccess::mimetype(url); if (type == KMimeType::defaultMimeType()) cout << "Could not find out type" << endl; else @@ -2704,17 +2704,17 @@ else >void FooClass::findType() { KURL url("http://developer.kde.org/favicon.ico"); - KIO::MimetypeJob *job = KIO::mimetype(url); - connect( job, SIGNAL(result(KIO::Job*)), - this, SLOT(mimeResult(KIO::Job*)) ); + TDEIO::MimetypeJob *job = TDEIO::mimetype(url); + connect( job, SIGNAL(result(TDEIO::Job*)), + this, SLOT(mimeResult(TDEIO::Job*)) ); } -void FooClass::mimeResult(KIO::Job *job) +void FooClass::mimeResult(TDEIO::Job *job) { if (job->error()) job->showErrorDialog(); else - cout << "MIME type: " << ((KIO::MimetypeJob *)job)->mimetype() << endl; + cout << "MIME type: " << ((TDEIO::MimetypeJob *)job)->mimetype() << endl; } </programlisting> @@ -2870,18 +2870,18 @@ new KRun(url); <para >Enamasti luuakse tööd KIO nimeruumis funktsioone välja kutsudes. Need funktsioonid kasutavad argumendina üht või kaht URL-i ja võib-olla vastavalt vajadusele veel mõningaid parameetreid. Kui töö on lõpetatud, väljastatakse signaal <literal ->result(KIO::Job*)</literal +>result(TDEIO::Job*)</literal >. Signaali väljastamise järel kustutab töö iseenda. Toome siin tüüpilise kasutamise näite: </para> <programlisting >void FooClass::makeDirectory() { - SimpleJob *job = KIO::mkdir(KURL("file:/home/bernd/kiodir")); - connect( job, SIGNAL(result(KIO::Job*)), - this, SLOT(mkdirResult(KIO::Job*)) ); + SimpleJob *job = TDEIO::mkdir(KURL("file:/home/bernd/kiodir")); + connect( job, SIGNAL(result(TDEIO::Job*)), + this, SLOT(mkdirResult(TDEIO::Job*)) ); } -void FooClass::mkdirResult(KIO::Job *job) +void FooClass::mkdirResult(TDEIO::Job *job) { if (job->error()) job->showErrorDialog(); @@ -2900,7 +2900,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::mkdir(const KURL &url, int õigused)</term> +>TDEIO::mkdir(const KURL &url, int õigused)</term> <listitem ><para >Loob kataloogi, lisavõimalusena teatud õigustega. </para @@ -2909,7 +2909,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::rmdir(const KURL &url)</term> +>TDEIO::rmdir(const KURL &url)</term> <listitem ><para >Eemaldab kataloogi. </para @@ -2918,7 +2918,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::chmod(const KURL &url, int õigused)</term> +>TDEIO::chmod(const KURL &url, int õigused)</term> <listitem ><para >Muudab faili õigusi. </para @@ -2927,7 +2927,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::rename(const KURL &src, const KURL &dest, bool overwrite)</term> +>TDEIO::rename(const KURL &src, const KURL &dest, bool overwrite)</term> <listitem ><para >Nimetab faili ümber. </para @@ -2936,7 +2936,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::symlink(const QString &target, const KURL &dest, bool overwrite, bool showProgressInfo)</term> +>TDEIO::symlink(const QString &target, const KURL &dest, bool overwrite, bool showProgressInfo)</term> <listitem ><para >Loob nimeviida. </para @@ -2945,16 +2945,16 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::stat(const KURL &url, bool showProgressInfo)</term> +>TDEIO::stat(const KURL &url, bool showProgressInfo)</term> <listitem ><para ->Leiab teatud info faili kohta, näiteks suurus, muutmise aeg ja õigused. Info teeb pärast töö lõpetamist teatavaks KIO::StatJob::statResult(). </para +>Leiab teatud info faili kohta, näiteks suurus, muutmise aeg ja õigused. Info teeb pärast töö lõpetamist teatavaks TDEIO::StatJob::statResult(). </para ></listitem> </varlistentry> <varlistentry ><term ->KIO::get(const KURL &url, bool reload, bool showProgressInfo)</term> +>TDEIO::get(const KURL &url, bool reload, bool showProgressInfo)</term> <listitem ><para >Edastab andmed URL-ilt. </para @@ -2963,7 +2963,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::put(const KURL &url, int õigused, bool overwrite, bool resume, bool showProgressInfo)</term> +>TDEIO::put(const KURL &url, int õigused, bool overwrite, bool resume, bool showProgressInfo)</term> <listitem ><para >Edastab andmed URL-ile. </para @@ -2972,7 +2972,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::http_post(const KURL &url, const QByteArray &data, bool showProgressInfo)</term> +>TDEIO::http_post(const KURL &url, const QByteArray &data, bool showProgressInfo)</term> <listitem ><para >Postitab andmed. Spetsiaalselt HTTP jaoks. </para @@ -2981,16 +2981,16 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::mimetype(const KURL &url, bool showProgressInfo)</term> +>TDEIO::mimetype(const KURL &url, bool showProgressInfo)</term> <listitem ><para ->Püüab leida URL-i MIME tüübi. Tüübi teeb pärast töö lõpetamist teatavaks KIO::MimetypeJob::mimetype(). </para +>Püüab leida URL-i MIME tüübi. Tüübi teeb pärast töö lõpetamist teatavaks TDEIO::MimetypeJob::mimetype(). </para ></listitem> </varlistentry> <varlistentry ><term ->KIO::file_copy(const KURL &src, const KURL &dest, int õigused, bool overwrite, bool resume, bool showProgressInfo)</term> +>TDEIO::file_copy(const KURL &src, const KURL &dest, int õigused, bool overwrite, bool resume, bool showProgressInfo)</term> <listitem ><para >Kopeerib ühe faili. </para @@ -2999,7 +2999,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::file_move(const KURL &src, const KURL &dest, int õigused, bool overwrite, bool resume, bool showProgressInfo)</term> +>TDEIO::file_move(const KURL &src, const KURL &dest, int õigused, bool overwrite, bool resume, bool showProgressInfo)</term> <listitem ><para >Nimetab ümber või liigutab ühe faili. </para @@ -3008,7 +3008,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::file_delete(const KURL &url, bool showProgressInfo)</term> +>TDEIO::file_delete(const KURL &url, bool showProgressInfo)</term> <listitem ><para >Kustutab ühe faili. </para @@ -3017,16 +3017,16 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::listDir(const KURL &url, bool showProgressInfo)</term> +>TDEIO::listDir(const KURL &url, bool showProgressInfo)</term> <listitem ><para ->Loetleb kataloogi sisu. Igal uue kirje tuvastamisel väljastatakse signaal KIO::ListJob::entries(). </para +>Loetleb kataloogi sisu. Igal uue kirje tuvastamisel väljastatakse signaal TDEIO::ListJob::entries(). </para ></listitem> </varlistentry> <varlistentry ><term ->KIO::listRecursive(const KURL &url, bool showProgressInfo)</term> +>TDEIO::listRecursive(const KURL &url, bool showProgressInfo)</term> <listitem ><para >Sarnane funktsiooniga listDir(), kuid rekursiivne. </para @@ -3035,7 +3035,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::copy(const KURL &src, const KURL &dest, bool showProgressInfo)</term> +>TDEIO::copy(const KURL &src, const KURL &dest, bool showProgressInfo)</term> <listitem ><para >Kopeerib faili või kataloogi. Kataloogid kopeeritakse rekursiivselt. </para @@ -3044,7 +3044,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::move(const KURL &src, const KURL &dest, bool showProgressInfo)</term> +>TDEIO::move(const KURL &src, const KURL &dest, bool showProgressInfo)</term> <listitem ><para >Liigutab või nimetab ümber faili või kataloogi. </para @@ -3053,7 +3053,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::del(const KURL &src, bool shred, bool showProgressInfo)</term> +>TDEIO::del(const KURL &src, bool shred, bool showProgressInfo)</term> <listitem ><para >Kustutab faili või kataloogi. </para @@ -3070,7 +3070,7 @@ void FooClass::mkdirResult(KIO::Job *job) >Kataloogikirjed</title> <para ->Nii töö KIO::stat() kui ka töö KIO::listDir() tagastavad oma tulemused vastavalt tüübina UDSEntry ja UDSEntryList. Viimane on defineeritud kui QValueList<UDSEntry>. UDS tähendab "universaalne kataloogiteenus" (inglise keeles "Universal Directory Service"). Selle taga seisab põhimõte, et kataloogikirje sisaldab ainult seda infot, mida IO moodul suudab pakkuda. Näiteks ei paku http moodul infot kasutamisõiguste või faili omaniku kohta. UDSEntry on UDSAtom-ite loend. Iga aatom pakub teatud konkreetse infoühiku. See koosneb tüübist, mille on salvestanud m_uds, ning sõltuvalt tüübist kas täisarvulisest väärtusest (m_long) või stringilisest väärtusest (m_str). </para> +>Nii töö TDEIO::stat() kui ka töö TDEIO::listDir() tagastavad oma tulemused vastavalt tüübina UDSEntry ja UDSEntryList. Viimane on defineeritud kui QValueList<UDSEntry>. UDS tähendab "universaalne kataloogiteenus" (inglise keeles "Universal Directory Service"). Selle taga seisab põhimõte, et kataloogikirje sisaldab ainult seda infot, mida IO moodul suudab pakkuda. Näiteks ei paku http moodul infot kasutamisõiguste või faili omaniku kohta. UDSEntry on UDSAtom-ite loend. Iga aatom pakub teatud konkreetse infoühiku. See koosneb tüübist, mille on salvestanud m_uds, ning sõltuvalt tüübist kas täisarvulisest väärtusest (m_long) või stringilisest väärtusest (m_str). </para> <para >Praegu on defineeritud järgmised tüübid: </para> @@ -3163,13 +3163,13 @@ void FooClass::mkdirResult(KIO::Job *job) >Sünkroonne kasutamine</title> <para ->Sageli on KIO asünkroonne API liiga keerukas kasutada, seepärast ei ole ka täieliku asünkroonsuse teostamine esmatähtis. Näiteks programmi korral, mus suudab korraga käsitleda ainult üht dokumenti, ei ole nagunii midagi teha, kui programm parajasti dokumenti alla laeb. Sellistel lihtsatel juhtudel on olemas märksa lihtsam API staatiliste funktsioonide kogumi näol KIO::NetAccess-is. Näiteks faili kopeerimiseks kasuta: </para> +>Sageli on KIO asünkroonne API liiga keerukas kasutada, seepärast ei ole ka täieliku asünkroonsuse teostamine esmatähtis. Näiteks programmi korral, mus suudab korraga käsitleda ainult üht dokumenti, ei ole nagunii midagi teha, kui programm parajasti dokumenti alla laeb. Sellistel lihtsatel juhtudel on olemas märksa lihtsam API staatiliste funktsioonide kogumi näol TDEIO::NetAccess-is. Näiteks faili kopeerimiseks kasuta: </para> <programlisting >KURL source, target; source = ...; target = ... -KIO::NetAccess::copy(source, target); +TDEIO::NetAccess::copy(source, target); </programlisting> <para @@ -3190,9 +3190,9 @@ KIO::NetAccess::copy(source, target); >KURL url; url = ...; QString tempFile; -if (KIO::NetAccess::download(url, tempFile) { +if (TDEIO::NetAccess::download(url, tempFile) { // load the file with the name tempFile - KIO::NetAccess::removeTempFile(tempFile); + TDEIO::NetAccess::removeTempFile(tempFile); } </programlisting> @@ -3210,7 +3210,7 @@ if (KIO::NetAccess::download(url, tempFile) { >void FooClass::reloadPage() { KURL url("http://www.tdevelop.org/index.html"); - KIO::TransferJob *job = KIO::get(url, true, false); + TDEIO::TransferJob *job = TDEIO::get(url, true, false); job->addMetaData("cache", "reload"); ... } @@ -3227,18 +3227,18 @@ if (KIO::NetAccess::download(url, tempFile) { >void FooClass::printModifiedDate() { KURL url("http://developer.kde.org/documentation/kde2arch/index.html"); - KIO::TransferJob *job = KIO::get(url, true, false); - connect( job, SIGNAL(result(KIO::Job*)), - this, SLOT(transferResult(KIO::Job*)) ); + TDEIO::TransferJob *job = TDEIO::get(url, true, false); + connect( job, SIGNAL(result(TDEIO::Job*)), + this, SLOT(transferResult(TDEIO::Job*)) ); } -void FooClass::transferResult(KIO::Job *job) +void FooClass::transferResult(TDEIO::Job *job) { QString mimetype; if (job->error()) job->showErrorDialog(); else { - KIO::TransferJob *transferJob = (KIO::TransferJob*) job; + TDEIO::TransferJob *transferJob = (TDEIO::TransferJob*) job; QString modified = transferJob->queryMetaData("modified"); cout << "Last modified: " << modified << endl; } @@ -3269,28 +3269,28 @@ void FooClass::transferResult(KIO::Job *job) <programlisting >KURL url("http://developer.kde.org/documentation/kde2arch/index.html"); -KIO::TransferJob *job = KIO::get(url, true, false); -KIO::Scheduler::scheduleJob(job); +TDEIO::TransferJob *job = TDEIO::get(url, true, false); +TDEIO::Scheduler::scheduleJob(job); </programlisting> <para >Kolmas võimalus on <emphasis >ühendusepõhine</emphasis ->. Näiteks IMAP mooduli korral ei ole erilist mõtet käivitada ühe ja sama serveri puhul mitu protsessi. Nii või teisiti saab korraga toimida ainult üks IMAP ühendus. Sellisel juhul peab rakendus otseselt suhtlema mooduliga, kõrvaldades mooduli teatud ühenduselt ja seejärel omistama kõik tööd, mis käivad üle ühe ühenduse, samale moodulile. Ka selleks sobib suurepäraselt KIO::Scheduler: </para> +>. Näiteks IMAP mooduli korral ei ole erilist mõtet käivitada ühe ja sama serveri puhul mitu protsessi. Nii või teisiti saab korraga toimida ainult üks IMAP ühendus. Sellisel juhul peab rakendus otseselt suhtlema mooduliga, kõrvaldades mooduli teatud ühenduselt ja seejärel omistama kõik tööd, mis käivad üle ühe ühenduse, samale moodulile. Ka selleks sobib suurepäraselt TDEIO::Scheduler: </para> <programlisting >KURL baseUrl("imap://[email protected]"); -KIO::Slave *slave = KIO::Scheduler::getConnectedSlave(baseUrl); +TDEIO::Slave *slave = TDEIO::Scheduler::getConnectedSlave(baseUrl); -KIO::TransferJob *job1 = KIO::get(KURL(baseUrl, "/INBOX;UID=79374")); -KIO::Scheduler::assignJobToSlave(slave, job1); +TDEIO::TransferJob *job1 = TDEIO::get(KURL(baseUrl, "/INBOX;UID=79374")); +TDEIO::Scheduler::assignJobToSlave(slave, job1); -KIO::TransferJob *job2 = KIO::get(KURL(baseUrl, "/INBOX;UID=86793")); -KIO::Scheduler::assignJobToSlave(slave, job2); +TDEIO::TransferJob *job2 = TDEIO::get(KURL(baseUrl, "/INBOX;UID=86793")); +TDEIO::Scheduler::assignJobToSlave(slave, job2); ... -KIO::Scheduler::disconnectSlave(slave); +TDEIO::Scheduler::disconnectSlave(slave); </programlisting> <para @@ -3385,11 +3385,11 @@ int kdemain(int argc, char **argv) <para >Moodulid teostatakse <classname ->KIO::SlaveBase</classname +>TDEIO::SlaveBase</classname > alamklassidena (ülaltoodud näites FtpSlave). Nii vastavad <literal >.protocol</literal >-failis loetletud toimingud teatud <classname ->KIO::SlaveBase</classname +>TDEIO::SlaveBase</classname > teatud virtuaalsetele funktsioonidele, mida mooduli teostus peab taasteostama. Toome siin ära võimalike toimingute ja neile vastavate virtuaalsete funktsioonide loendi: </para> <variablelist> @@ -3510,9 +3510,9 @@ int kdemain(int argc, char **argv) >, kui aga tekkis viga, siis tuleb välja kutsuda <literal >error()</literal > koos veakoodiga esimese ja stringiga teise argumendina. Võimalike veakoodide loendi annab <type ->KIO::Error</type +>TDEIO::Error</type >. Teine argument on tavaliselt asjakohane URL. Seda kasutab näiteks <function ->KIO::Job::showErrorDialog()</function +>TDEIO::Job::showErrorDialog()</function > inimestele mõistetava veateate loomisel. </para> <para @@ -3558,7 +3558,7 @@ int kdemain(int argc, char **argv) > edastab kataloogikirjete info. Selleks kutsu <function >listEntries()</function > välja argumendiga <classname ->KIO::UDSEntryList</classname +>TDEIO::UDSEntryList</classname >. Nagu <function >data()</function > puhul, võib ka seda mitu korda välja kutsuda. Kui oled lõpetanud, kutsu välja <function @@ -3573,7 +3573,7 @@ int kdemain(int argc, char **argv) ><function >stat()</function > edastab failiinfot, näiteks suuruse, MIME tüübi jne. Sellist infot sisaldab <classname ->KIO::UDSEntry</classname +>TDEIO::UDSEntry</classname >, millest tuleb veel juttu. Selliste andmete saatmiseks rakendustele kasuta <function >statEntry()</function >. </para @@ -3629,7 +3629,7 @@ int kdemain(int argc, char **argv) ><function >infoMessage()</function > - informatsiooniline tagasiside, näiteks HTTP mooduli sõnum "Andmete tõmbamine aadressilt <masin>", mida sageli näidatakse rakenduse olekuribal. Rakenduse poolelt vastab sellele meetodile signaal <function ->KIO::Job::infoMessage()</function +>TDEIO::Job::infoMessage()</function >. </para ></listitem> |