From 542a9e5e840b905c97d21bc5b83bda95a4a71582 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Fri, 25 Jan 2013 00:27:31 -0600 Subject: Rename KCModule, KConfig, KIO, KServer, and KSocket to avoid conflicts with KDE4 --- tde-i18n-sv/docs/tdevelop/kdearch/index.docbook | 122 ++++++++++++------------ 1 file changed, 61 insertions(+), 61 deletions(-) (limited to 'tde-i18n-sv/docs/tdevelop/kdearch') diff --git a/tde-i18n-sv/docs/tdevelop/kdearch/index.docbook b/tde-i18n-sv/docs/tdevelop/kdearch/index.docbook index 4bc911484d9..f26ca9026fd 100644 --- a/tde-i18n-sv/docs/tdevelop/kdearch/index.docbook +++ b/tde-i18n-sv/docs/tdevelop/kdearch/index.docbook @@ -202,8 +202,8 @@ <ulink url="kdeapi:tdecore/KConfig" ->KConfig</ulink +><ulink url="kdeapi:tdecore/TDEConfig" +>TDEConfig</ulink > Ger tillgång till KDE:s konfigurationsdatabas. @@ -2683,7 +2683,7 @@ else 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 << "Kunde inte avgöra typen" << 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; } @@ -2870,18 +2870,18 @@ new KRun(url); I de flesta fall skapas jobb genom att anropa funktioner i KIO-namnrymden. Dessa funktioner har en eller två webbadresser som argument, och möjligen också andra nödvändiga parametrar. När jobbet är avslutat, skickar det signalen result(KIO::Job*)result(TDEIO::Job*). Efter signalen har skickats, tar jobbet bort sig självt. Därför ser ett typiskt användarfall ut så här: 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) KIO::mkdir(const KURL &url, int permission) +>TDEIO::mkdir(const KURL &url, int permission) Skapar en katalog, valfritt med vissa rättigheter. KIO::rmdir(const KURL &url) +>TDEIO::rmdir(const KURL &url) Tar bort en katalog. KIO::chmod(const KURL &url, int permissions) +>TDEIO::chmod(const KURL &url, int permissions) Ändrar rättigheter för en fil. KIO::rename(const KURL &src, const KURL &dest, bool overwrite) +>TDEIO::rename(const KURL &src, const KURL &dest, bool overwrite) Byter namn på en fil. KIO::symlink(const QString &target, const KURL &dest, bool overwrite, bool showProgressInfo) +>TDEIO::symlink(const QString &target, const KURL &dest, bool overwrite, bool showProgressInfo) Skapar en symbolisk länk. KIO::stat(const KURL &url, bool showProgressInfo) +>TDEIO::stat(const KURL &url, bool showProgressInfo) Hittar viss information om filen, som storlek, ändringstid och rättigheter. Informationen kan hämtas från KIO::StatJob::statResult() efter jobbet har avslutats. Hittar viss information om filen, som storlek, ändringstid och rättigheter. Informationen kan hämtas från TDEIO::StatJob::statResult() efter jobbet har avslutats. KIO::get(const KURL &url, bool reload, bool showProgressInfo) +>TDEIO::get(const KURL &url, bool reload, bool showProgressInfo) Överför data från en webbadress. KIO::put(const KURL &url, int permissions, bool overwrite, bool resume, bool showProgressInfo) +>TDEIO::put(const KURL &url, int permissions, bool overwrite, bool resume, bool showProgressInfo) Överför data till en webbadress. KIO::http_post(const KURL &url, const QByteArray &data, bool showProgressInfo) +>TDEIO::http_post(const KURL &url, const QByteArray &data, bool showProgressInfo) Sänder data. Särskild för HTTP. KIO::mimetype(const KURL &url, bool showProgressInfo) +>TDEIO::mimetype(const KURL &url, bool showProgressInfo) Försöker hitta webbadressens Mime-typ. Typen kan hämtas från KIO::MimetypeJob::mimetype() efter jobbet har avslutats. Försöker hitta webbadressens Mime-typ. Typen kan hämtas från TDEIO::MimetypeJob::mimetype() efter jobbet har avslutats. KIO::file_copy(const KURL &src, const KURL &dest, int permissions, bool overwrite, bool resume, bool showProgressInfo) +>TDEIO::file_copy(const KURL &src, const KURL &dest, int permissions, bool overwrite, bool resume, bool showProgressInfo) Kopierar en ensam fil. KIO::file_move(const KURL &src, const KURL &dest, int permissions, bool overwrite, bool resume, bool showProgressInfo) +>TDEIO::file_move(const KURL &src, const KURL &dest, int permissions, bool overwrite, bool resume, bool showProgressInfo) Byter namn på eller flyttar en ensam fil. KIO::file_delete(const KURL &url, bool showProgressInfo) +>TDEIO::file_delete(const KURL &url, bool showProgressInfo) Tar bort en ensam fil KIO::listDir(const KURL &url, bool showProgressInfo) +>TDEIO::listDir(const KURL &url, bool showProgressInfo) Listar innehållet i en katalog. Varje gång några nya poster blir kända, skickas signalen KIO::ListJob::entries(). Listar innehållet i en katalog. Varje gång några nya poster blir kända, skickas signalen TDEIO::ListJob::entries(). KIO::listRecursive(const KURL &url, bool showProgressInfo) +>TDEIO::listRecursive(const KURL &url, bool showProgressInfo) Liknar funktionen listDir(), men den här är rekursiv. KIO::copy(const KURL &src, const KURL &dest, bool showProgressInfo) +>TDEIO::copy(const KURL &src, const KURL &dest, bool showProgressInfo) Kopierar en fil eller katalog. Kataloger kopieras rekursivt. KIO::move(const KURL &src, const KURL &dest, bool showProgressInfo) +>TDEIO::move(const KURL &src, const KURL &dest, bool showProgressInfo) Flyttar eller byter namn på en fil eller katalog. KIO::del(const KURL &src, bool shred, bool showProgressInfo) +>TDEIO::del(const KURL &src, bool shred, bool showProgressInfo) Tar bort en fil eller katalog. Katalogposter Båda jobben KIO::stat() och KIO::listDir() returnerar sina resultat med typerna UDSEntry och UDSEntryList. Den senare är definierad som QValueList<UDSEntry>. Akronymen UDS betyder "Universal directory service" (Allmän katalogtjänst). Principen bakom detta är att katalogposten bara innehåller information som en I/O-slav kan tillhandahålla, inte mer. Till exempel tillhandahåller inte HTTP-slaven någon information om åtkomsträttigheter eller ägare av filer. Istället är en UDSEntry en lista med UDSAtoms. Varje objekt tillhandahåller viss information. Den består av en typ som lagras i m_uds, och antingen ett heltalsvärde i m_long, eller ett strängvärde i m_str, beroende på typen. +>Båda jobben TDEIO::stat() och TDEIO::listDir() returnerar sina resultat med typerna UDSEntry och UDSEntryList. Den senare är definierad som QValueList<UDSEntry>. Akronymen UDS betyder "Universal directory service" (Allmän katalogtjänst). Principen bakom detta är att katalogposten bara innehåller information som en I/O-slav kan tillhandahålla, inte mer. Till exempel tillhandahåller inte HTTP-slaven någon information om åtkomsträttigheter eller ägare av filer. Istället är en UDSEntry en lista med UDSAtoms. Varje objekt tillhandahåller viss information. Den består av en typ som lagras i m_uds, och antingen ett heltalsvärde i m_long, eller ett strängvärde i m_str, beroende på typen. Följande typer är för närvarande definierade: @@ -3163,13 +3163,13 @@ void FooClass::mkdirResult(KIO::Job *job) >Synkron användning Ofta är det KIO:s asynkrona programmeringsgränssnitt för komplext att använda, och därför är inte implementering av fullständig asynkronism prioriterat. I ett program som till exempel bara kan hantera en dokumentfil åt gången, finns det ändå inte mycket som kan göras medan programmet laddar ner en fil. I dessa enkla fall, finns ett mycket enklare programmeringsgränssnitt, i form av ett antal statiska funktioner i KIO::NetAccess. För att till exempel kopiera en fil, använd: +>Ofta är det KIO:s asynkrona programmeringsgränssnitt för komplext att använda, och därför är inte implementering av fullständig asynkronism prioriterat. I ett program som till exempel bara kan hantera en dokumentfil åt gången, finns det ändå inte mycket som kan göras medan programmet laddar ner en fil. I dessa enkla fall, finns ett mycket enklare programmeringsgränssnitt, i form av ett antal statiska funktioner i TDEIO::NetAccess. För att till exempel kopiera en fil, använd: KURL source, target; source = ...; target = ... -KIO::NetAccess::copy(source, target); +TDEIO::NetAccess::copy(source, target); KURL url; url = ...; QString tempFile; -if (KIO::NetAccess::download(url, tempFile) { +if (TDEIO::NetAccess::download(url, tempFile) { // ladda filen med namnet tempFile - KIO::NetAccess::removeTempFile(tempFile); + TDEIO::NetAccess::removeTempFile(tempFile); } @@ -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 << "Senaste ändring: " << modified << endl; } @@ -3269,28 +3269,28 @@ void FooClass::transferResult(KIO::Job *job) 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); En tredje möjlighet är anslutningsorienterat. Till exempel för IMAP-slaven, är det inte vettigt att starta flera processer för samma server. Bara en IMAP-anslutning åt gången får upprätthållas. I detta fall måste programmet uttryckligen hantera slavbegreppet. Det måste tilldela en slav för en viss anslutning och sedan tilldela alla jobb som ska gå genom samma anslutning till samma slav. Det kan återigen enkelt åstadkommas genom att använda KIO::Scheduler: +>. Till exempel för IMAP-slaven, är det inte vettigt att starta flera processer för samma server. Bara en IMAP-anslutning åt gången får upprätthållas. I detta fall måste programmet uttryckligen hantera slavbegreppet. Det måste tilldela en slav för en viss anslutning och sedan tilldela alla jobb som ska gå genom samma anslutning till samma slav. Det kan återigen enkelt åstadkommas genom att använda TDEIO::Scheduler: KURL baseUrl("imap://bernd@albert.physik.hu-berlin.de"); -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); Slavar implementeras som delklasser till KIO::SlaveBaseTDEIO::SlaveBase (FtpSlave i exemplet ovan). På så sätt motsvarar åtgärderna i .protocol vissa virtuella funktioner i KIO::SlaveBaseTDEIO::SlaveBase som implementeringen av slaven måste implementera om. Här är en lista med möjliga åtgärder och motsvarande virtuella funktioner: @@ -3510,9 +3510,9 @@ int kdemain(int argc, char **argv) >. Om ett fel uppstod, ska de anropa error() med en felkod som första argument och en sträng som andra. Möjliga felkoder listats som uppräkningstypen KIO::ErrorTDEIO::Error. Det andra argumentet är oftast webbadressen i fråga. Den används t.ex. i KIO::Job::showErrorDialog()TDEIO::Job::showErrorDialog() för att parametrisera felmeddelandet som är läsbart av användaren. rapporterar information om posterna i en katalog. Anropa listEntries() med en KIO::UDSEntryListTDEIO::UDSEntryList som argument, för detta syfte. På motsvarande sätt som data(), kan du anropa den flera gånger. När du är klar, anropa stat() rapporterar information om en fil, som storlek, Mime-typ, etc. Sådan information paketeras i en KIO::UDSEntryTDEIO::UDSEntry, som beskrivs nedan. Använd statEntry() för att skicka ett sådant objekt till programmet. infoMessage(): Det här är för informativ återmatning, som meddelandet "Hämtar data från <värddator>" från HTTP-slaven, som ofta visas i programmets statusrad. På programsidan, motsvarar metoden signalen KIO::Job::infoMessage()TDEIO::Job::infoMessage(). -- cgit v1.2.1