diff options
Diffstat (limited to 'tde-i18n-et/docs/tdevelop/kdearch/index.docbook')
| -rw-r--r-- | tde-i18n-et/docs/tdevelop/kdearch/index.docbook | 196 |
1 files changed, 98 insertions, 98 deletions
diff --git a/tde-i18n-et/docs/tdevelop/kdearch/index.docbook b/tde-i18n-et/docs/tdevelop/kdearch/index.docbook index 2f770fe11c5..f1721605326 100644 --- a/tde-i18n-et/docs/tdevelop/kdearch/index.docbook +++ b/tde-i18n-et/docs/tdevelop/kdearch/index.docbook @@ -25,7 +25,7 @@ > <affiliation ><address ><email ->bernd@tdevelop.org</email +>bernd@kdevelop.org</email ></address ></affiliation> </author> @@ -97,13 +97,13 @@ <varlistentry> <term -><ulink url="kdeapi:kio/index.html" ->kio</ulink +><ulink url="kdeapi:tdeio/index.html" +>tdeio</ulink ></term> <listitem ><para >Teek <literal ->kio</literal +>tdeio</literal > sisaldab vahendeid asünkroonseks ja võrguläbipaistvusega sisend-väljundoperatsioonideks ning ligipääsu MIME tüüpide käsitlemisele. Samuti pakub see KDE failidialoogi ja selle abiklasse. </para ></listitem> </varlistentry> @@ -123,14 +123,14 @@ <varlistentry> <term -><ulink url="kdeapi:khtml/index.html" ->khtml</ulink +><ulink url="kdeapi:tdehtml/index.html" +>tdehtml</ulink ></term> <listitem ><para >Teek <literal ->khtml</literal -> sisaldab KHTML komponenti, HTML lehitsemise vidinat, DOM API-t ja parsijat, sealhulgas Java ja JavaScripti liidest. </para +>tdehtml</literal +> sisaldab TDEHTML komponenti, HTML lehitsemise vidinat, DOM API-t ja parsijat, sealhulgas Java ja JavaScripti liidest. </para ></listitem> </varlistentry> @@ -401,8 +401,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KZoneAllocator" ->KZoneAllocator</ulink +><ulink url="kdeapi:tdecore/TDEZoneAllocator" +>TDEZoneAllocator</ulink ></title> <para >Tõhus mälueraldaja väikeste objektide suurtele gruppidele. </para> @@ -430,8 +430,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KAccel" ->KAccel</ulink +><ulink url="kdeapi:tdecore/TDEAccel" +>TDEAccel</ulink ></title> <para >Valik kiirklahve. </para> @@ -441,8 +441,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KStdAccel" ->KStdAccel</ulink +><ulink url="kdeapi:tdecore/TDEStdAccel" +>TDEStdAccel</ulink ></title> <para >Hõlpus ligipääs tavalistele kiirklahvidele. </para> @@ -470,8 +470,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KIconLoader" ->KIconLoader</ulink +><ulink url="kdeapi:tdecore/TDEIconLoader" +>TDEIconLoader</ulink ></title> <para >Laeb ikoonid teemaga ühilduvalt. </para> @@ -481,11 +481,11 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KIconTheme" ->KIconTheme</ulink +><ulink url="kdeapi:tdecore/TDEIconTheme" +>TDEIconTheme</ulink ></title> <para ->KIconLoaderi abiklassid. </para> +>TDEIconLoaderi abiklassid. </para> </formalpara ></listitem> @@ -576,8 +576,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KCompletion" ->KCompletion</ulink +><ulink url="kdeapi:tdecore/TDECompletion" +>TDECompletion</ulink ></title> <para >Üldine stringide automaatne lõpetamine. </para> @@ -587,7 +587,7 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KURLCompletion" +><ulink url="kdeapi:tdeio/KURLCompletion" >KURLCompletion</ulink ></title> <para @@ -598,7 +598,7 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KShellCompletion" +><ulink url="kdeapi:tdeio/KShellCompletion" >KShellCompletion</ulink ></title> <para @@ -616,8 +616,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KListView" ->KListView</ulink +><ulink url="kdeapi:tdeui/TDEListView" +>TDEListView</ulink ></title> <para >Klassi <classname @@ -629,8 +629,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KListView" ->KListBox</ulink +><ulink url="kdeapi:tdeui/TDEListView" +>TDEListBox</ulink ></title> <para >Klassi <classname @@ -642,8 +642,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KListView" ->KIconView</ulink +><ulink url="kdeapi:tdeui/TDEListView" +>TDEIconView</ulink ></title> <para >Klassi <classname @@ -655,7 +655,7 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KListView" +><ulink url="kdeapi:tdeui/TDEListView" >KLineEdit</ulink ></title> <para @@ -681,8 +681,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KFontCombo" ->KFontCombo</ulink +><ulink url="kdeapi:tdeui/TDEFontCombo" +>TDEFontCombo</ulink ></title> <para >Liitkast fontide valimiseks. </para> @@ -725,7 +725,7 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:kfile/KURLRequester" +><ulink url="kdeapi:tdefile/KURLRequester" >KURLRequester</ulink ></title> <para @@ -788,7 +788,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kfile/KFileDialog" +><ulink url="kdeapi:tdefile/KFileDialog" >KFileDialog</ulink ></title> <para @@ -810,8 +810,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KFontDialog" ->KFontDialog</ulink +><ulink url="kdeapi:tdeui/TDEFontDialog" +>TDEFontDialog</ulink ></title> <para >Fondi valimise dialoog. </para> @@ -821,8 +821,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kfile/KIconDialog" ->KIconDialog</ulink +><ulink url="kdeapi:tdefile/TDEIconDialog" +>TDEIconDialog</ulink ></title> <para >Ikooni valimise dialoog. </para> @@ -865,8 +865,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KAboutDialog" ->KAboutDialog</ulink +><ulink url="kdeapi:tdeui/TDEAboutDialog" +>TDEAboutDialog</ulink ></title> <para >Infodialoog. </para> @@ -887,7 +887,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kfile/KURLRequesterDlg" +><ulink url="kdeapi:tdefile/KURLRequesterDlg" >KURLRequesterDlg</ulink ></title> <para @@ -927,8 +927,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KAction" ->KAction</ulink +><ulink url="kdeapi:tdeui/TDEAction" +>TDEAction</ulink ></title> <para >Toimingu abstraktsioon, mida võib lisada menüü- ja tööriistaribale. </para> @@ -938,8 +938,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KActionCollection" ->KActionCollection</ulink +><ulink url="kdeapi:tdeui/TDEActionCollection" +>TDEActionCollection</ulink ></title> <para >Valik toiminguid. </para> @@ -960,7 +960,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kparts/KPartManager" +><ulink url="kdeapi:tdeparts/KPartManager" >KPartManager</ulink ></title> <para @@ -1011,7 +1011,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KServiceType" +><ulink url="kdeapi:tdeio/KServiceType" >KServiceType</ulink ></title> <para @@ -1022,7 +1022,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KService" +><ulink url="kdeapi:tdeio/KService" >KService</ulink ></title> <para @@ -1033,7 +1033,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KMimeType" +><ulink url="kdeapi:tdeio/KMimeType" >KMimeType</ulink ></title> <para @@ -1044,7 +1044,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KServiceTypeProfile" +><ulink url="kdeapi:tdeio/KServiceTypeProfile" >KServiceTypeProfile</ulink ></title> <para @@ -1055,8 +1055,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KServiceTypeProfile" ->KTrader</ulink +><ulink url="kdeapi:tdeio/KServiceTypeProfile" +>TDETrader</ulink ></title> <para >Teenuste päring. </para> @@ -1698,8 +1698,8 @@ url="kdeapi:tdeui/KAnimWidget" >) esinevad just seal, kus stiilijuhised ette näevad. XMLGUI on eriti oluline moodulprogrammides, kus menüüriba elemendid võivad pärineda erinevatelt pluginatelt või komponentidelt. </para> <para ->KDE tipptaseme akna klassi <ulink url="kdeapi:tdeui/KMainWindow.html" ->KMainWindow</ulink +>KDE tipptaseme akna klassi <ulink url="kdeapi:tdeui/TDEMainWindow.html" +>TDEMainWindow</ulink > eellane on <ulink url="kdeapi:tdeui/KXMLGUIClient.html" >KXMLGUIClient</ulink >, mistõttu see toetab automaatselt XMLGUI-d. Kõigi selles loodud toimingute eellane peab olema kliendi <literal @@ -1763,19 +1763,19 @@ rc_DATA = kviewui.rc >KStdAction::zoomIn ( this, SLOT(slotZoomIn()), actionCollection() ); KStdAction::zoomOut ( this, SLOT(slotZoomOut()), actionCollection() ); KStdAction::zoom ( this, SLOT(slotZoom()), actionCollection() ); - new KAction ( i18n("&Half size"), ALT+Key_0, + new TDEAction ( i18n("&Half size"), ALT+Key_0, this, SLOT(slotHalfSize()), actionCollection(), "zoom50" ); - new KAction ( i18n("&Normal size"), ALT+Key_1, + new TDEAction ( i18n("&Normal size"), ALT+Key_1, this, SLOT(slotDoubleSize()), actionCollection(), "zoom100" ); - new KAction ( i18n("&Double size"), ALT+Key_2, + new TDEAction ( i18n("&Double size"), ALT+Key_2, this, SLOT(slotDoubleSize()), actionCollection(), "zoom200" ); - new KAction ( i18n("&Fill Screen"), ALT+Key_3, + new TDEAction ( i18n("&Fill Screen"), ALT+Key_3, this, SLOT(slotFillScreen()), actionCollection(), "zoomMaxpect" ); - new KAction ( i18n("Fullscreen &Mode"), CTRL+SHIFT+Key_F, + new TDEAction ( i18n("Fullscreen &Mode"), CTRL+SHIFT+Key_F, this, SLOT(slotFullScreen()), actionCollection(), "fullscreen" ); </programlisting> @@ -1975,7 +1975,7 @@ rc_DATA = kviewui.rc unplugActionList("openwith"); openWithActions.clear(); for ( /* iterate over the relevant services */ ) { - KAction *action = new KAction( ...); + TDEAction *action = new TDEAction( ...); openWithActions.append(action); } plugActionList("openwith", openWithActions); @@ -2098,12 +2098,12 @@ rc_DATA = kviewui.rc <para >Kui menüü- ja tööriistaribad luua <ulink url="actionpattern.html" >toimingumustreid</ulink -> kasutades, võetakse kohtspikrina kasutatav string konstruktori <ulink url="kdeapi:tdeui/KAction.html" ->KAction</ulink +> kasutades, võetakse kohtspikrina kasutatav string konstruktori <ulink url="kdeapi:tdeui/TDEAction.html" +>TDEAction</ulink > esimesest argumendist: </para> <programlisting ->action = new KAction(i18n("&Delete"), "editdelete", +>action = new TDEAction(i18n("&Delete"), "editdelete", SHIFT+Key_Delete, actionCollection(), "del") </programlisting> @@ -2334,9 +2334,9 @@ X-KDevelop-Scope=Project >KDevFactory</classname > (mille eellane on <classname >KLibFactory</classname ->). Levinum näide on <ulink url="kdeapi:kparts/KParts::Factory" +>). Levinum näide on <ulink url="kdeapi:tdeparts/KParts::Factory" >KParts::Factory</ulink ->, mis peaks pakkuma <ulink url="kdeapi:kparts/KParts::ReadOnlyPart" +>, mis peaks pakkuma <ulink url="kdeapi:tdeparts/KParts::ReadOnlyPart" >KParts::ReadOnlyPart</ulink > või enamikul juhtudel üldisem <ulink url="kdeapi:tdecore/KLibFactory" >KLibFactory</ulink @@ -2350,11 +2350,11 @@ X-KDevelop-Scope=Project >Jagatud teekide teenuste kasutamine</title> <para ->Jagatud teegi teenuse kasutamiseks rakenduses tuleb hankida seda esindav <ulink url="kdeapi:kio/KService.html" +>Jagatud teegi teenuse kasutamiseks rakenduses tuleb hankida seda esindav <ulink url="kdeapi:tdeio/KService.html" >KService</ulink > objekt. Sellest räägitakse pikemalt <ulink url="mime.html" >MIME tüüpe tutvustavas osas</ulink -> (samuti ikka veel kirjutamata osas KTraderi kohta). </para> +> (samuti ikka veel kirjutamata osas TDETraderi kohta). </para> <para ><classname @@ -2399,8 +2399,8 @@ if (!factory) { <para >DCOP-teenus on tavaliselt teostatud programmina, mis käivitub vajaduse korral. Sellisel juhul loob ta silmuse ja jälgib DCOP-ühendusi. Programm võib olla interaktiivne, kuid see võib ka täielikult või osaliselt tegutseda taustal deemonina, ilma et kasutaja seda otseselt märkaks. Sellise deemoni näide on <literal ->kio_uiserver</literal ->, mis teostab kasutaja suhtlust, näiteks KIO teegi edenemisdialoogi. Antud kontekstis on tsentraliseeritud deemoni eeliseks näiteks see, et mitme erineva faili tõmbamise edenemist saab näidata ühes aknas isegi juhul, kui tõmbamine käivitati erinevatest rakendustest. </para> +>tdeio_uiserver</literal +>, mis teostab kasutaja suhtlust, näiteks TDEIO teegi edenemisdialoogi. Antud kontekstis on tsentraliseeritud deemoni eeliseks näiteks see, et mitme erineva faili tõmbamise edenemist saab näidata ühes aknas isegi juhul, kui tõmbamine käivitati erinevatest rakendustest. </para> <para >DCOP-teenus defineeritakse teisiti kui jagatud teegi teenus. Loomulikult ei määra see teeki, vaid käivitatava faili. Samuti ei määra DCOP-teenused rida ServiceType, sest tavaliselt käivitatakse nad nimepidi. Lisaomadustena on selles kaks rida: </para> @@ -2432,14 +2432,14 @@ if (!factory) { <para >Selline on <literal ->kio_uiserver</literal +>tdeio_uiserver</literal > definitsioon: </para> <programlisting >[Desktop Entry] Type=Service -Name=kio_uiserver -Exec=kio_uiserver +Name=tdeio_uiserver +Exec=tdeio_uiserver X-DCOP-ServiceType=Unique X-TDE-StartupNotify=false </programlisting> @@ -2457,9 +2457,9 @@ X-TDE-StartupNotify=false <programlisting >DCOPClient *client = kapp->dcopClient(); client->attach(); -if (!client->isApplicationRegistered("kio_uiserver")) { +if (!client->isApplicationRegistered("tdeio_uiserver")) { QString error; - if (TDEApplication::startServiceByName("kio_uiserver", QStringList(), &error)) + if (TDEApplication::startServiceByName("tdeio_uiserver", QStringList(), &error)) cout << "Starting kioserver failed with message " << error << endl; } ... @@ -2467,9 +2467,9 @@ QByteArray data, replyData; QCString replyType; QDataStream arg(data, IO_WriteOnly); arg << true; -if (!client->call("kio_uiserver", "UIServer", "setListMode(bool)", +if (!client->call("tdeio_uiserver", "UIServer", "setListMode(bool)", data, replyType, replyData)) - cout << "Call to kio_uiserver failed" << endl; + cout << "Call to tdeio_uiserver failed" << endl; ... </programlisting> @@ -2484,7 +2484,7 @@ if (!client->call("kio_uiserver", "UIServer", "setListMode(bool)", >. Teine võimalus on kasutada funktsiooni <function >TDEApplication::startServiceByDesktopName()</function >, mis võtab argumendiks töölauafaili failinime, s.t. antud juhul <literal ->"kio_uiserver.desktop"</literal +>"tdeio_uiserver.desktop"</literal >. </para> <para @@ -2602,7 +2602,7 @@ Comment[et]=Foo andmefail >is. </para> <para ->KDE teekides on selline tüübidefinitsioon seotud <ulink url="kdeapi:kio/KMimeType.html" +>KDE teekides on selline tüübidefinitsioon seotud <ulink url="kdeapi:tdeio/KMimeType.html" >KMimeType</ulink > eksemplariga. Kasuta seda umbes nii, nagu alljärgnevas näites: </para> @@ -2651,7 +2651,7 @@ else >(sellel meetodil on veel mõningaid argumente, kuid need on dokumenteerimata, mistõttu võib nad antud juhul kõrvale jätta) </para> <para ->Sellisel juhul võib olla mõttekam tuvastada MIME tüüp faili sisu, mitte aga faili nime järgi. See on usaldusväärsem, kuid ka aeglasem meetod, sest selleks tuleb lugeda vähemalt osa failist. Seda teeb klass <ulink url="kdeapi:kio/KMimeMagic.html" +>Sellisel juhul võib olla mõttekam tuvastada MIME tüüp faili sisu, mitte aga faili nime järgi. See on usaldusväärsem, kuid ka aeglasem meetod, sest selleks tuleb lugeda vähemalt osa failist. Seda teeb klass <ulink url="kdeapi:tdeio/KMimeMagic.html" >KMimeMagic</ulink >, mille veakäsitlus on veidi teistsugune: </para> @@ -2691,14 +2691,14 @@ else </programlisting> <para ->See käivitab KIO töö, laadides alla osa failist ja uurides seda. Arvesta, et see funktsioon on tõenäoliselt päris aeglane ja blokeerib programmi töö. Tavaliselt on seda mõtet kasutada ainult siis, kui <function +>See käivitab TDEIO töö, laadides alla osa failist ja uurides seda. Arvesta, et see funktsioon on tõenäoliselt päris aeglane ja blokeerib programmi töö. Tavaliselt on seda mõtet kasutada ainult siis, kui <function >KMimeType::findByURL()</function > tagastab <literal >"application/octet-stream"</literal >. </para> <para ->Kui sa aga ei soovi rakenduse tööd blokeerida, võib ka vahetult käivitada KIO töö ja luua ühenduse selle mõningate signaalidega: </para> +>Kui sa aga ei soovi rakenduse tööd blokeerida, võib ka vahetult käivitada TDEIO töö ja luua ühenduse selle mõningate signaalidega: </para> <programlisting >void FooClass::findType() @@ -2765,7 +2765,7 @@ for (it = offers.begin(); it != offers.end(); ++it) { >"Application"</literal > võib anda ka <literal >"KParts::ReadOnlyPart"</literal ->. Sellisel juhul tagastatakse põimitavate komponentide nimekiri, mis suudavad HTML-i esitada, näiteks KHTML. </para> +>. Sellisel juhul tagastatakse põimitavate komponentide nimekiri, mis suudavad HTML-i esitada, näiteks TDEHTML. </para> <para >Enamasti puudub vajadus saada teada kõiki MIME tüübi ja teenuse tüübi kombinatsiooni käsitleda suutvaid teenuseid. Siis sobib kasutada mugavat funktsiooni, mis tagastab ainult kõige eelistatuma teenuse: </para> @@ -2779,12 +2779,12 @@ else </programlisting> <para ->Keerulisemate päringute jaoks on mõeldud võimas CORBA taoline <ulink url="kdeapi:kio/KTrader.html" +>Keerulisemate päringute jaoks on mõeldud võimas CORBA taoline <ulink url="kdeapi:tdeio/TDETrader.html" >maakler</ulink >. </para> <para ->Rakenduse teenuse käivitamiseks mõne URL-iga on kasutatav <ulink url="kdeapi:kio/KRun.html" +>Rakenduse teenuse käivitamiseks mõne URL-iga on kasutatav <ulink url="kdeapi:tdeio/KRun.html" >KRun</ulink >: </para> @@ -2845,7 +2845,7 @@ new KRun(url); >: kui ootad, et veebilehitseja laeks alla mingi saidi, ei pea see blokeerima kasutajaliidest. Samuti ei peaks veebilehekülje renderdamine algama alles siis, kui kätte on saadud kogu lehekülg, vaid käima regulaarselt vastavalt uute andmete saabumisele. </para> <para ->KDE teekides teostab võrguläbipaistvuse KIO API. Selle arhitektuuri keskne mõiste on IO <emphasis +>KDE teekides teostab võrguläbipaistvuse TDEIO API. Selle arhitektuuri keskne mõiste on IO <emphasis >töö</emphasis >. Töö võib faile kopeerida, kustutada vms. Töö käivitamisel tegutseb see taustal ega blokeeri rakendust. Kogu töö tagasiside rakendusele, näiteks andmete edastamine või edenemisinfo, käib läbi integreeritud Qt sündmusesilmuse. </para> @@ -2866,10 +2866,10 @@ new KRun(url); <simplesect id="nettransparency-usingkio"> <title ->KIO kasutamine</title> +>TDEIO kasutamine</title> <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 +>Enamasti luuakse tööd TDEIO 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(TDEIO::Job*)</literal >. Signaali väljastamise järel kustutab töö iseenda. Toome siin tüüpilise kasutamise näite: </para> @@ -3163,7 +3163,7 @@ void FooClass::mkdirResult(TDEIO::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 TDEIO::NetAccess-is. Näiteks faili kopeerimiseks kasuta: </para> +>Sageli on TDEIO 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; @@ -3209,7 +3209,7 @@ if (TDEIO::NetAccess::download(url, tempFile) { <programlisting >void FooClass::reloadPage() { - KURL url("http://www.tdevelop.org/index.html"); + KURL url("http://www.kdevelop.org/index.html"); TDEIO::TransferJob *job = TDEIO::get(url, true, false); job->addMetaData("cache", "reload"); ... @@ -3252,13 +3252,13 @@ void FooClass::transferResult(TDEIO::Job *job) >Ajastamine</title> <para ->KIO API kasutamisel ei ole tavaliselt vajalik pead vaevata IO moodulite käivitamise ja nendega suhtlemise üksikasjade pärast. Kõige tavalisem on käivitada töö teatud parameetritega ja tegelda töö väljastatud signaalidega. </para> +>TDEIO API kasutamisel ei ole tavaliselt vajalik pead vaevata IO moodulite käivitamise ja nendega suhtlemise üksikasjade pärast. Kõige tavalisem on käivitada töö teatud parameetritega ja tegelda töö väljastatud signaalidega. </para> <para ->Tagaplaanil on aga kõik palju keerukam. Tööd luues seatakse see järjekorda. Kui rakendus läheb tagasi sündmusesilmusesse, eraldab KIO mooduliprotsessid järjekorras olevatele töödele. Esimese töö korral on kõik lihtne: käivitatakse vajaliku protokolli IO moodul. Kuid pärast töö lõpetamist (näiteks allalaadimist HTTP-serverilt) ei tapeta tööd otsekohe, vaid see lükatakse jõude moodulite puhvrisse ja tapetakse pärast seda, kui see on olnud mingi aja mitteaktiivne (praegu on väärtuseks 3 minutit). Kui saabub uus soov samale protokollile ja masinale, võetakse moodul uuesti kasutusele. Selle ilmne eelis on tõik, et nii saab tunduvalt kärpida sama masina puhul sarnaseid töid ette võttes muidu uute protsesside loomisele ja võib-olla ka autentimisele kuluvaid ressursse ja aega. </para> +>Tagaplaanil on aga kõik palju keerukam. Tööd luues seatakse see järjekorda. Kui rakendus läheb tagasi sündmusesilmusesse, eraldab TDEIO mooduliprotsessid järjekorras olevatele töödele. Esimese töö korral on kõik lihtne: käivitatakse vajaliku protokolli IO moodul. Kuid pärast töö lõpetamist (näiteks allalaadimist HTTP-serverilt) ei tapeta tööd otsekohe, vaid see lükatakse jõude moodulite puhvrisse ja tapetakse pärast seda, kui see on olnud mingi aja mitteaktiivne (praegu on väärtuseks 3 minutit). Kui saabub uus soov samale protokollile ja masinale, võetakse moodul uuesti kasutusele. Selle ilmne eelis on tõik, et nii saab tunduvalt kärpida sama masina puhul sarnaseid töid ette võttes muidu uute protsesside loomisele ja võib-olla ka autentimisele kuluvaid ressursse ja aega. </para> <para ->Mõistagi on taaskasutamne võimalik ainult siis, kui olemasolev moodul on oma varasema töö juba lõpetanud. Kui uus soov saabub ajal, mil mooduliprotsess veel käib, tuleb käivitada uus protsess. Ülaltoodud API näiteks ei olnud piiratud uute mooduliprotsesside loomine: kui käivitad järjest 20 erineva faili allalaadimise, käivitab KIO 20 mooduliprotsessi. Sellist moodulite omistamist töödele nimetatakse <emphasis +>Mõistagi on taaskasutamne võimalik ainult siis, kui olemasolev moodul on oma varasema töö juba lõpetanud. Kui uus soov saabub ajal, mil mooduliprotsess veel käib, tuleb käivitada uus protsess. Ülaltoodud API näiteks ei olnud piiratud uute mooduliprotsesside loomine: kui käivitad järjest 20 erineva faili allalaadimise, käivitab TDEIO 20 mooduliprotsessi. Sellist moodulite omistamist töödele nimetatakse <emphasis >vahetuks</emphasis > omistamiseks. See ei ole aga mitte alati eelistatav viis, sest võib nõuda hulganisti mälu ja koormata tugevasti nii kliendi kui serveri masinat. </para> @@ -3317,7 +3317,7 @@ EXTRA_DIST = $(mime_DATA) <programlisting >[Protocol] -exec=kio_ftp +exec=tdeio_ftp protocol=ftp input=none output=filesystem @@ -3344,7 +3344,7 @@ Icon=ftp <para >Ülejäänud <literal >.protocol</literal ->-faili read määravad ära mooduli omadused. Üldiselt on võimalused, mida moodul peab teostama, palju lihtsamad kui võimalused, mida KIO API rakendustele pakub. Selle põhjuseks on keerukate tööde jagamine mitmeks alamtööks. Näiteks kataloogi sisu näitamiseks rekursiivselt käivitatakse üks töö tippkataloogis. Seejärel käivitatakse iga alamkataloogi sisu leidmiseks uued alamtööd. KIO ajastaja tagab, et korraga ei oleks aktiivsed liiga palju töid. Ka võib KIO näiteks faili kopeerimiseks protokolli korral, mis ei toeta vahetult kopeerimist (näiteks <literal +>-faili read määravad ära mooduli omadused. Üldiselt on võimalused, mida moodul peab teostama, palju lihtsamad kui võimalused, mida TDEIO API rakendustele pakub. Selle põhjuseks on keerukate tööde jagamine mitmeks alamtööks. Näiteks kataloogi sisu näitamiseks rekursiivselt käivitatakse üks töö tippkataloogis. Seejärel käivitatakse iga alamkataloogi sisu leidmiseks uued alamtööd. TDEIO ajastaja tagab, et korraga ei oleks aktiivsed liiga palju töid. Ka võib TDEIO näiteks faili kopeerimiseks protokolli korral, mis ei toeta vahetult kopeerimist (näiteks <literal >ftp:</literal >), lugeda lähtefaili ja seejärel kirjutada andmed sihtfaili. Selleks peab <literal >.protocol</literal @@ -3360,12 +3360,12 @@ Icon=ftp int kdemain(int argc, char **argv) { - KLocale::setMainCatalogue("tdelibs"); - TDEInstance instance("kio_ftp"); + TDELocale::setMainCatalogue("tdelibs"); + TDEInstance instance("tdeio_ftp"); (void) TDEGlobal::locale(); if (argc != 4) { - fprintf(stderr, "Usage: kio_ftp protocol " + fprintf(stderr, "Usage: tdeio_ftp protocol " "domain-socket1 domain-socket2\n"); exit(-1); } @@ -3453,7 +3453,7 @@ int kdemain(int argc, char **argv) <para >Lisaks on taasteostatavaid funktsioone, mida ei ole ära toodud <literal >.protocol</literal ->-failis. Nende tegevuste puhul määrab KIO automaatselt, kas need on toetatud või mitte (s.t vaiketeostus tagastab vea). </para> +>-failis. Nende tegevuste puhul määrab TDEIO automaatselt, kas need on toetatud või mitte (s.t vaiketeostus tagastab vea). </para> <variablelist> |