diff options
Diffstat (limited to 'tde-i18n-it/docs/tdevelop/kdearch/index.docbook')
| -rw-r--r-- | tde-i18n-it/docs/tdevelop/kdearch/index.docbook | 124 |
1 files changed, 62 insertions, 62 deletions
diff --git a/tde-i18n-it/docs/tdevelop/kdearch/index.docbook b/tde-i18n-it/docs/tdevelop/kdearch/index.docbook index 8d7a296cb80..b1dfa2c7f05 100644 --- a/tde-i18n-it/docs/tdevelop/kdearch/index.docbook +++ b/tde-i18n-it/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 >Fornisce accesso al database di configurazione di KDE. </para> @@ -2681,7 +2681,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 @@ -2702,17 +2702,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> @@ -2867,19 +2867,19 @@ new KRun(url); >Usare KIO</title> <para ->I job in molti casi sono creati chiamando le funzioni contenute nel namespace KIO. Esse ricevono uno o due URL come argomenti ed eventualmente altri parametri. Quando un job è concluso, emette il segnale <literal ->result(KIO::Job*)</literal +>I job in molti casi sono creati chiamando le funzioni contenute nel namespace TDEIO. Esse ricevono uno o due URL come argomenti ed eventualmente altri parametri. Quando un job è concluso, emette il segnale <literal +>result(TDEIO::Job*)</literal >. Dopo che questo segnale è stato emesso, il job si cancella. Quindi un caso d'uso tipico sarà simile a questo: </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(); @@ -2898,7 +2898,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::mkdir(const KURL &url, int permission)</term> +>TDEIO::mkdir(const KURL &url, int permission)</term> <listitem ><para >Crea una directory, eventualmente con alcuni permessi. </para @@ -2907,7 +2907,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::rmdir(const KURL &url)</term> +>TDEIO::rmdir(const KURL &url)</term> <listitem ><para >Rimuove una directory </para @@ -2916,7 +2916,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::chmod(const KURL &url, int permissions)</term> +>TDEIO::chmod(const KURL &url, int permissions)</term> <listitem ><para >Cambia i permessi di un file. </para @@ -2925,7 +2925,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 >Rinomina un file. </para @@ -2934,7 +2934,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 >Crea un collegamento simbolico. </para @@ -2943,16 +2943,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 ->Cerca alcune informazioni sul file, come dimensione, data di modifica e permessi. L'informazione può essere ottenuta da KIO::StatJob::statResult() dopo che il job è concluso. </para +>Cerca alcune informazioni sul file, come dimensione, data di modifica e permessi. L'informazione può essere ottenuta da TDEIO::StatJob::statResult() dopo che il job è concluso. </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 >Trasferisce i dati da un URL. </para @@ -2961,7 +2961,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::put(const KURL &url, int permissions, bool overwrite, bool resume, bool showProgressInfo)</term> +>TDEIO::put(const KURL &url, int permissions, bool overwrite, bool resume, bool showProgressInfo)</term> <listitem ><para >Trasferisce i dati ad un URL </para @@ -2970,7 +2970,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 >Invia dati. Comando speciale per HTTP. </para @@ -2979,16 +2979,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 ->Tenta di trovare il tipo MIME dell'URL. Il tipo può essere ottenuto con KIO::MimetypeJob::mimetype() al termine del job. </para +>Tenta di trovare il tipo MIME dell'URL. Il tipo può essere ottenuto con TDEIO::MimetypeJob::mimetype() al termine del job. </para ></listitem> </varlistentry> <varlistentry ><term ->KIO::file_copy(const KURL &src, const KURL &dest, int permissions, bool overwrite, bool resume, bool showProgressInfo)</term> +>TDEIO::file_copy(const KURL &src, const KURL &dest, int permissions, bool overwrite, bool resume, bool showProgressInfo)</term> <listitem ><para >Copia un singolo file. </para @@ -2997,7 +2997,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::file_move(const KURL &src, const KURL &dest, int permissions, bool overwrite, bool resume, bool showProgressInfo)</term> +>TDEIO::file_move(const KURL &src, const KURL &dest, int permissions, bool overwrite, bool resume, bool showProgressInfo)</term> <listitem ><para >Rinomina o muove un singolo file. </para @@ -3006,7 +3006,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 >Cancella un singolo file. </para @@ -3015,16 +3015,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 ->Elenca i contenuti di una directory. Ogni volta che vengono scoperti nuovi elementi viene emesso il segnale KIO::ListJob::entries(). </para +>Elenca i contenuti di una directory. Ogni volta che vengono scoperti nuovi elementi viene emesso il segnale 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 >Simile alla funzione listDir(), ma questa è ricorsiva. </para @@ -3033,7 +3033,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 >Copia un file o una directory. Queste ultime vengono copiate ricorsivamente. </para @@ -3042,7 +3042,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 >Muove o rinomina un file o una directory. </para @@ -3051,7 +3051,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 >Cancella un file o una directory. </para @@ -3068,7 +3068,7 @@ void FooClass::mkdirResult(KIO::Job *job) >Elementi di una directory</title> <para ->I job di KIO::stat() e di KIO::listDir() restituiscono i loro risultati rispettivamente come tipi UDSEntry e USDEntryList. Quest'ultimo è definito come QValueList<UDSEntry>. L'acronimo UDS significa "Universal Directory Service". Il principio di base è che una voce della directory contiene le informazioni che possono essere fornite da uno slave, e nient'altro. Per esempio, lo slave http non fornisce nessuna informazione sui permessi di accesso o sui proprietari del file. Invece un UDSEntry è un elenco di UDSAtoms. Ogni atom fornisce una porzione specifica di informazione e consiste di un tipo memorizzato in m_uds e di un valore intero m_long o di una stringa m_str a seconda del tipo. </para> +>I job di TDEIO::stat() e di TDEIO::listDir() restituiscono i loro risultati rispettivamente come tipi UDSEntry e USDEntryList. Quest'ultimo è definito come QValueList<UDSEntry>. L'acronimo UDS significa "Universal Directory Service". Il principio di base è che una voce della directory contiene le informazioni che possono essere fornite da uno slave, e nient'altro. Per esempio, lo slave http non fornisce nessuna informazione sui permessi di accesso o sui proprietari del file. Invece un UDSEntry è un elenco di UDSAtoms. Ogni atom fornisce una porzione specifica di informazione e consiste di un tipo memorizzato in m_uds e di un valore intero m_long o di una stringa m_str a seconda del tipo. </para> <para >Attualmente sono definiti i seguenti tipi: </para> @@ -3161,13 +3161,13 @@ void FooClass::mkdirResult(KIO::Job *job) >Uso sincrono</title> <para ->Spesso l'API asincrona di KIO è troppo complessa da usare e quindi l'implementazione asincrona non costituisce una priorità. Per esempio, in un programma che può gestire un solo documento alla volta c'è poco da fare quando un programma sta scaricando un file. Per questi semplici casi, esiste un'API molto più facile costituita da un insieme di funzioni statiche in KIO::NetAccess. Per esempio, per copiare un file si può usare </para> +>Spesso l'API asincrona di KIO è troppo complessa da usare e quindi l'implementazione asincrona non costituisce una priorità. Per esempio, in un programma che può gestire un solo documento alla volta c'è poco da fare quando un programma sta scaricando un file. Per questi semplici casi, esiste un'API molto più facile costituita da un insieme di funzioni statiche in TDEIO::NetAccess. Per esempio, per copiare un file si può usare </para> <programlisting >KURL source, target; source = ...; target = ... -KIO::NetAccess::copy(source, target); +TDEIO::NetAccess::copy(source, target); </programlisting> <para @@ -3188,9 +3188,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> @@ -3208,7 +3208,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"); ... } @@ -3225,18 +3225,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; } @@ -3267,28 +3267,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 >Una terza possibilità è quella <emphasis >orientata alla connessione</emphasis ->. Per esempio, per lo slave IMAP non ha senso avviare processi multipli per lo stesso server. Dovrebbe essere rinforzata solo una connessione IMAP alla volta. In questo caso l'applicazione deve occuparsi direttamente con la nozione di slave. Deve deallocare uno slave per alcune connessioni e in seguito assegnare tutti i job che dovrebbero utilizzare la stessa connessione allo stesso slave. Questo può essere fatto semplicemente usando KIO::Scheduler: </para> +>. Per esempio, per lo slave IMAP non ha senso avviare processi multipli per lo stesso server. Dovrebbe essere rinforzata solo una connessione IMAP alla volta. In questo caso l'applicazione deve occuparsi direttamente con la nozione di slave. Deve deallocare uno slave per alcune connessioni e in seguito assegnare tutti i job che dovrebbero utilizzare la stessa connessione allo stesso slave. Questo può essere fatto semplicemente usando TDEIO::Scheduler: </para> <programlisting >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); </programlisting> <para @@ -3383,11 +3383,11 @@ int kdemain(int argc, char **argv) <para >Gli slave sono implementati come sottoclassi di <classname ->KIO::SlaveBase</classname +>TDEIO::SlaveBase</classname > (nell'esempio sopra FtpSlave). Quindi le azioni elencate nel file <literal >.protocol</literal > corrispondono ad alcune funzioni virtuali di <classname ->KIO::SlaveBase</classname +>TDEIO::SlaveBase</classname > che devono essere reimplementate dall'implementazione dello slave. Ecco una lista di azioni possibili e le funzioni virtuali corrispondenti: </para> <variablelist> @@ -3508,9 +3508,9 @@ int kdemain(int argc, char **argv) >. Se accade un errore, dovrebbe essere chiamata la funzione <literal >error()</literal > con un codice di errore come primo argomento e una stringa come secondo. I codici di errore possibili sono elencati come enumerazioni di <type ->KIO::Error</type +>TDEIO::Error</type >. Il secondo argomento è normalmente l'URL in questione. È usato ad esempio nella funzione <function ->KIO::Job::showErrorDialog()</function +>TDEIO::Job::showErrorDialog()</function > per parametrizzare il messaggio di errore in forma leggibile. </para> <para @@ -3556,7 +3556,7 @@ int kdemain(int argc, char **argv) > riporta le informazioni sugli elementi di una directory. Per questo scopo chiama <function >listEntries()</function > con un argomento di tipo <classname ->KIO::UDSEntryList</classname +>TDEIO::UDSEntryList</classname >. Analogamente alla funzione <function >data()</function > può essere chiamata diverse volte. Quando termina, chiamare <function @@ -3571,7 +3571,7 @@ int kdemain(int argc, char **argv) ><function >stat()</function > riferisce le informazioni su un file come la dimensione, il tipo MIME, ecc. Tali informazioni sono impacchettate in un <classname ->KIO::UDSEntry</classname +>TDEIO::UDSEntry</classname > che sarà discusso più avanti. Usare <function >statEntry()</function > per inviare un tale oggetto all'applicazione. </para @@ -3627,7 +3627,7 @@ int kdemain(int argc, char **argv) ><function >infoMessage()</function > - usato per avere un feedback, come ad esempio per un messaggio del tipo "Scaricamento dati dall'<host>" dallo slave http, che viene visualizzato spesso nella barra di stato dei programmi. Dalla parte dell'applicazione questo metodo corrisponde al segnale <function ->KIO::Job::infoMessage()</function +>TDEIO::Job::infoMessage()</function >. </para ></listitem> |