diff options
Diffstat (limited to 'tde-i18n-es/docs/tdevelop/kdearch')
| -rw-r--r-- | tde-i18n-es/docs/tdevelop/kdearch/index.docbook | 122 |
1 files changed, 61 insertions, 61 deletions
diff --git a/tde-i18n-es/docs/tdevelop/kdearch/index.docbook b/tde-i18n-es/docs/tdevelop/kdearch/index.docbook index 283f0ccf455..c4b1116a9f7 100644 --- a/tde-i18n-es/docs/tdevelop/kdearch/index.docbook +++ b/tde-i18n-es/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 >Proporciona acceso a la base de datos de configuración de KDE. </para> @@ -2687,7 +2687,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 << "No se puede encontrar el tipo" << endl; else @@ -2708,17 +2708,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 << "Tipo MIME: " << ((KIO::MimetypeJob *)job)->mimetype() << endl; + cout << "Tipo MIME: " << ((TDEIO::MimetypeJob *)job)->mimetype() << endl; } </programlisting> @@ -2874,18 +2874,18 @@ new KRun(url); <para >En muchos casos, las tareas se crean llamando a funciones del nombre de espacios KIO. Estas funciones tienen una o dos URL como argumento, además de otros parámetros posiblemente necesarios. Cuando la tarea termina, emite la señal <literal ->result(KIO::Job*)</literal +>result(TDEIO::Job*)</literal >. Tras emitir esta señal, la tarea se borra a sí misma. De este modo, un caso de uso típico podría ser: </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(); @@ -2904,7 +2904,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 un directorio, opcionalmente con ciertos permisos. </para @@ -2913,7 +2913,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::rmdir(const KURL &url)</term> +>TDEIO::rmdir(const KURL &url)</term> <listitem ><para >Elimina un directorio. </para @@ -2922,7 +2922,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 los permisos de un archivo. </para @@ -2931,7 +2931,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 >Renombra un archivo. </para @@ -2940,7 +2940,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 enlace simbólico. </para @@ -2949,16 +2949,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 ->Obtiene cierta información sobre el archivo, como su tamaño, hora de modificación y permisos. La información puede obtenerse de KIO::StatJob::statResult() una vez que el trabajo haya finalizado. </para +>Obtiene cierta información sobre el archivo, como su tamaño, hora de modificación y permisos. La información puede obtenerse de TDEIO::StatJob::statResult() una vez que el trabajo haya finalizado. </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 >Transfiere datos desde un URL. </para @@ -2967,7 +2967,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 >Transfiere datos a un URL. </para @@ -2976,7 +2976,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 >Envía datos. Específica de HTTP. </para @@ -2985,16 +2985,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 ->Intenta encontrar el tipo MIME de un URL. El tipo se puede obtener de KIO::MimetypeJob::mimetype() una vez que el trabajo haya finalizado. </para +>Intenta encontrar el tipo MIME de un URL. El tipo se puede obtener de TDEIO::MimetypeJob::mimetype() una vez que el trabajo haya finalizado. </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 único archivo. </para @@ -3003,7 +3003,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 >Renombra o mueve un único archivo. </para @@ -3012,7 +3012,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 >Elimina un único archivo. </para @@ -3021,16 +3021,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 ->Lista el contenido de un directorio. Cada vez que se conozcan nuevas entradas será emitida la señal KIO::ListJob::entries(). </para +>Lista el contenido de un directorio. Cada vez que se conozcan nuevas entradas será emitida la señal 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 >Similar a la función listDir(), aunque esta es recursiva. </para @@ -3039,7 +3039,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 archivo o un directorio. Los directorios se copian recursivamente. </para @@ -3048,7 +3048,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 >Mueve o renombra un archivo o un directorio. </para @@ -3057,7 +3057,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 >Elimina un archivo o un directorio. </para @@ -3074,7 +3074,7 @@ void FooClass::mkdirResult(KIO::Job *job) >Entradas de directorio</title> <para ->La tarea KIO::stat() y la tarea KIO::listDir() devuelven un resultado de tipo UDSEntry y UDSEntryList, respectivamente. Esta última está definida como QValueList<UDSEntry>. El acrónimo de UDS significa «servicio de directorio universal», en inglés. El principio subyacente consiste en que una entrada de directorio solo contiene la información que puede proporcionar un «ioslave», pero no más. Por ejemplo, el esclavo http no proporciona ninguna información sobre permisos de acceso o propietarios del archivo. En lugar de ello, una USDEntry consiste en una lista de UDSAtoms, cada uno de los cuales proporciona una pieza de información específica (que consiste en un tipo almacenado en «m_uds», y en un valor entero en «m_long» o en una cadena de texto en «m_str», dependiendo del tipo). </para> +>La tarea TDEIO::stat() y la tarea TDEIO::listDir() devuelven un resultado de tipo UDSEntry y UDSEntryList, respectivamente. Esta última está definida como QValueList<UDSEntry>. El acrónimo de UDS significa «servicio de directorio universal», en inglés. El principio subyacente consiste en que una entrada de directorio solo contiene la información que puede proporcionar un «ioslave», pero no más. Por ejemplo, el esclavo http no proporciona ninguna información sobre permisos de acceso o propietarios del archivo. En lugar de ello, una USDEntry consiste en una lista de UDSAtoms, cada uno de los cuales proporciona una pieza de información específica (que consiste en un tipo almacenado en «m_uds», y en un valor entero en «m_long» o en una cadena de texto en «m_str», dependiendo del tipo). </para> <para >Actualmente están definidos los siguientes tipos: </para> @@ -3167,13 +3167,13 @@ void FooClass::mkdirResult(KIO::Job *job) >Utilización síncrona</title> <para ->A menudo, la API asíncrona de KIO resulta demasiado compleja de usar, por lo que la implementación de asincronismo total no es una prioridad. Por ejemplo, en un programa que solo puede manejar un archivo de documento a la vez, realmente hay pocas cosas que se puedan hacer mientras el programa descarga el archivo. Para estos casos simples, existe una API mucho más simple bajo la forma de funciones estáticas en KIO::NetAccess. Por ejemplo, para copiar un archivo, utilice </para> +>A menudo, la API asíncrona de KIO resulta demasiado compleja de usar, por lo que la implementación de asincronismo total no es una prioridad. Por ejemplo, en un programa que solo puede manejar un archivo de documento a la vez, realmente hay pocas cosas que se puedan hacer mientras el programa descarga el archivo. Para estos casos simples, existe una API mucho más simple bajo la forma de funciones estáticas en TDEIO::NetAccess. Por ejemplo, para copiar un archivo, utilice </para> <programlisting >KURL origen, destino; origen = ...; destino = ... -KIO::NetAccess::copy(origen, destino); +TDEIO::NetAccess::copy(origen, destino); </programlisting> <para @@ -3194,9 +3194,9 @@ KIO::NetAccess::copy(origen, destino); >KURL url; url = ...; QString tempFile; -if (KIO::NetAccess::download(url, tempFile) { +if (TDEIO::NetAccess::download(url, tempFile) { // cargar el archivo de nombre tempFile - KIO::NetAccess::removeTempFile(tempFile); + TDEIO::NetAccess::removeTempFile(tempFile); } </programlisting> @@ -3214,7 +3214,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"); ... } @@ -3231,18 +3231,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 << "Última modificación: " << modified << endl; } @@ -3273,28 +3273,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 >Existe una tercera posibilidad <emphasis >orientada a conexiones</emphasis ->. Por ejemplo, para el esclavo IMAP, no tiene sentido iniciar múltiples procesos para el mismo servidor: solo se debe forzar una conexión IMAP a la vez. En este caso, la aplicación debe tratar explícitamente con la noción de esclavo. Debe desasignar un esclavo de cierta conexión y luego asignar todas las tareas que pueda realizar la misma conexión con el mismo esclavo. De nuevo, esto se puede conseguir fácilmente usando KIO::Scheduler: </para> +>. Por ejemplo, para el esclavo IMAP, no tiene sentido iniciar múltiples procesos para el mismo servidor: solo se debe forzar una conexión IMAP a la vez. En este caso, la aplicación debe tratar explícitamente con la noción de esclavo. Debe desasignar un esclavo de cierta conexión y luego asignar todas las tareas que pueda realizar la misma conexión con el mismo esclavo. De nuevo, esto se puede conseguir fácilmente 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 @@ -3389,11 +3389,11 @@ int kdemain(int argc, char **argv) <para >Los esclavos se implementan como subclases de <classname ->KIO::SlaveBase</classname +>TDEIO::SlaveBase</classname > (FtpSlave en el ejemplo anterior). De este modo, las acciones que se listan en el archivo <literal >.protocol</literal > corresponden a ciertas funciones virtuales de <classname ->KIO::SlaveBase</classname +>TDEIO::SlaveBase</classname > que la implementación del esclavo debe reimplementar. Estas son algunas de las posibles acciones y sus correspondientes funciones virtuales: </para> <variablelist> @@ -3514,9 +3514,9 @@ int kdemain(int argc, char **argv) >; si ocurrió un error, <literal >error()</literal > debería ser llamada con un código de error como primer argumento y una cadena de texto como segundo. Los códigos de error posibles se listan como enumeraciones de tipo <type ->KIO::Error</type +>TDEIO::Error</type >. El segundo argumento suele ser la URL en cuestión. Se usa, por ejemplo, en la función <function ->KIO::Kob::showErrorDialgog()</function +>TDEIO::Kob::showErrorDialgog()</function > para parametizar el mensaje de error legible por el usuario. </para> <para @@ -3562,7 +3562,7 @@ int kdemain(int argc, char **argv) > devuelve información sobre las entradas de un directorio. Para este propósito, llame a <function >listEntries()</function > con una <classname ->KIO::UDSEntryList</classname +>TDEIO::UDSEntryList</classname > como argumento. Del mismo modo que ocurría con <function >data()</function >, puede llamar a esta función varias veces. Cuando haya terminado, llame a <function @@ -3577,7 +3577,7 @@ int kdemain(int argc, char **argv) ><function >stat()</function > devuelve información sobre el archivo, como su tamaño, tipo MIME, etc. Esta información está empaquetada en una <classname ->KIO::UDSEntry</classname +>TDEIO::UDSEntry</classname >, que se describirá más adelante. Use <function >statEntry()</function > para enviar este tipo de elementos a la aplicación. </para @@ -3633,7 +3633,7 @@ int kdemain(int argc, char **argv) ><function >infoMessage()</function > - Se usa para propósitos informativos, tales como el mensaje «Obteniendo datos de <host>» del esclavo http, que se muestra a menudo en la barra de estado del programa. En el lado de la aplicación, este método se corresponde a la señal <function ->KIO::Job::infoMessage()</function +>TDEIO::Job::infoMessage()</function >. </para ></listitem> |