diff options
Diffstat (limited to 'tde-i18n-fr/docs/tdevelop/kdearch')
| -rw-r--r-- | tde-i18n-fr/docs/tdevelop/kdearch/index.docbook | 122 |
1 files changed, 61 insertions, 61 deletions
diff --git a/tde-i18n-fr/docs/tdevelop/kdearch/index.docbook b/tde-i18n-fr/docs/tdevelop/kdearch/index.docbook index ca1a3199879..7d42ced259c 100644 --- a/tde-i18n-fr/docs/tdevelop/kdearch/index.docbook +++ b/tde-i18n-fr/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 >Fournit l'accès à la base de données de configuration de KDE. </para> @@ -2701,7 +2701,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 << "Impossible de découvrir le type" << endl; else @@ -2722,17 +2722,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> @@ -2890,18 +2890,18 @@ new KRun(url); <para >Dans la majorité des cas, les tâches sont créées en appelant des fonctions dans l'espace de noms KIO. Celles-ci prennent une ou deux URL comme arguments, voire d'autres paramètres nécessaires. Lorsque la tâche est terminée, elle émet le signal <literal ->result(KIO::Job*)</literal +>result(TDEIO::Job*)</literal >. Une fois ce signal émis, la tâche se supprime. Ainsi, voici à quoi ressemble un cas classique d'utilisation : </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(); @@ -2920,7 +2920,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 >Crée un dossier, optionnellement avec certaines permissions. </para @@ -2929,7 +2929,7 @@ void FooClass::mkdirResult(KIO::Job *job) <varlistentry ><term ->KIO::rmdir(const KURL &url)</term> +>TDEIO::rmdir(const KURL &url)</term> <listitem ><para >Supprime un dossier. </para @@ -2938,7 +2938,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 >Change les permissions d'un fichier. </para @@ -2947,7 +2947,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 >Renomme un fichier. </para @@ -2956,7 +2956,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 >Crée un lien symbolique. </para @@ -2965,16 +2965,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 ->Découvre certaines informations sur le fichier, comme sa taille, l'heure de sa modification et ses permissions. Les informations peuvent être obtenues à partir de KIO::StatJob::statResult() lorsque la tâche est terminée. </para +>Découvre certaines informations sur le fichier, comme sa taille, l'heure de sa modification et ses permissions. Les informations peuvent être obtenues à partir de TDEIO::StatJob::statResult() lorsque la tâche est terminée. </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 >Transfère des données depuis une URL. </para @@ -2983,7 +2983,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 >Transfère des données vers une URL. </para @@ -2992,7 +2992,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 >Poste des données. Spécial pour HTTP. </para @@ -3001,16 +3001,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 ->Essaie de trouver le type MIME de l'URL. Le type peut être obtenu depuis KIO::MimetypeJob::mimetype() lorsque la tâche est terminée. </para +>Essaie de trouver le type MIME de l'URL. Le type peut être obtenu depuis TDEIO::MimetypeJob::mimetype() lorsque la tâche est terminée. </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 >Copie un seul fichier. </para @@ -3019,7 +3019,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 >Renomme ou déplace un seul fichier. </para @@ -3028,7 +3028,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 >Supprime un seul fichier. </para @@ -3037,16 +3037,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 ->Répertorie le contenu d'un dossier. Chaque fois que de nouveaux éléments sont connus, le signal KIO::ListJob::entries() est émis. </para +>Répertorie le contenu d'un dossier. Chaque fois que de nouveaux éléments sont connus, le signal TDEIO::ListJob::entries() est émis. </para ></listitem> </varlistentry> <varlistentry ><term ->KIO::listRecursive(const KURL &url, bool showProgressInfo)</term> +>TDEIO::listRecursive(const KURL &url, bool showProgressInfo)</term> <listitem ><para >Similaire à la fonction listDir(), mais celle-ci est récursive. </para @@ -3055,7 +3055,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 >Copie un fichier ou un dossier. Les dossiers sont copiés récursivement. </para @@ -3064,7 +3064,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 >Déplace ou renomme un fichier ou un dossier. </para @@ -3073,7 +3073,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 >Supprime un fichier ou un dossier. </para @@ -3090,7 +3090,7 @@ void FooClass::mkdirResult(KIO::Job *job) >Éléments des dossiers</title> <para ->Les tâches KIO::stat() et KIO::listDir() retournent toutes deux leur résultat sous la forme d'un type UDSEntry, UDSEntryList, respectivement. Cette dernière est définie en tant que QValueList<UDSEntry>. L'acronyme UDS signifie « Universal Directory Service » (service universel de dossiers). Le principe sous-jacent est que l'élément du dossier ne transporte que les informations qu'un ioslave peut fournir, sans plus. Par exemple, l'esclave http ne fournit aucune information sur les droits d'accès ou sur les propriétaires des fichiers. En revanche, un UDSEntry est une liste de UDSAtoms. Chaque atome fournit une partie spécifique d'information. Il se compose d'un type enregistré dans m_uds et soit d'une valeur entière dans m_long, soit d'une valeur chaîne dans m_str, en fonction du type. </para> +>Les tâches TDEIO::stat() et TDEIO::listDir() retournent toutes deux leur résultat sous la forme d'un type UDSEntry, UDSEntryList, respectivement. Cette dernière est définie en tant que QValueList<UDSEntry>. L'acronyme UDS signifie « Universal Directory Service » (service universel de dossiers). Le principe sous-jacent est que l'élément du dossier ne transporte que les informations qu'un ioslave peut fournir, sans plus. Par exemple, l'esclave http ne fournit aucune information sur les droits d'accès ou sur les propriétaires des fichiers. En revanche, un UDSEntry est une liste de UDSAtoms. Chaque atome fournit une partie spécifique d'information. Il se compose d'un type enregistré dans m_uds et soit d'une valeur entière dans m_long, soit d'une valeur chaîne dans m_str, en fonction du type. </para> <para >Les types suivants sont actuellement définis : </para> @@ -3183,13 +3183,13 @@ void FooClass::mkdirResult(KIO::Job *job) >Utilisation synchrone</title> <para ->Souvent, l'API asynchrone de KIO est trop complexe à employer et donc, la mise en œuvre de l'asynchronicité complète n'est pas une priorité. Par exemple, dans un programme qui ne peut gérer qu'un fichier document à la fois, il y a de toute façon très peu de choses à faire pendant que le programme télécharge un fichier. Pour ces cas peu complexes, il y a une API beaucoup plus simple, sous la forme d'un ensemble de fonctions statiques dans KIO::NetAccess. Par exemple, pour copier un fichier, utilisez </para> +>Souvent, l'API asynchrone de KIO est trop complexe à employer et donc, la mise en œuvre de l'asynchronicité complète n'est pas une priorité. Par exemple, dans un programme qui ne peut gérer qu'un fichier document à la fois, il y a de toute façon très peu de choses à faire pendant que le programme télécharge un fichier. Pour ces cas peu complexes, il y a une API beaucoup plus simple, sous la forme d'un ensemble de fonctions statiques dans TDEIO::NetAccess. Par exemple, pour copier un fichier, utilisez </para> <programlisting >KURL source, target; source = ...; target = ... -KIO::NetAccess::copy(source, target); +TDEIO::NetAccess::copy(source, target); </programlisting> <para @@ -3210,9 +3210,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> @@ -3232,7 +3232,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"); ... } @@ -3249,18 +3249,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 << "Dernière modification : " << modified << endl; } @@ -3291,28 +3291,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 >Une troisième possibilité est <emphasis >orientée connexion</emphasis ->. Par exemple, pour l'esclave IMAP, il n'est pas judicieux de démarrer de multiples processus pour le même serveur. Une seule connexion IMAP à la fois devra être imposée. Dans ce cas, l'application doit accepter explicitement la notion d'esclave. Il faut qu'elle désalloue un esclave pour une certaine connexion puis qu'elle affecte toutes les tâches qui obtiendront la même connexion au même esclave. Cette opération peut à nouveau être réalisée à l'aide du KIO::Scheduler : </para> +>. Par exemple, pour l'esclave IMAP, il n'est pas judicieux de démarrer de multiples processus pour le même serveur. Une seule connexion IMAP à la fois devra être imposée. Dans ce cas, l'application doit accepter explicitement la notion d'esclave. Il faut qu'elle désalloue un esclave pour une certaine connexion puis qu'elle affecte toutes les tâches qui obtiendront la même connexion au même esclave. Cette opération peut à nouveau être réalisée à l'aide du 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 @@ -3409,11 +3409,11 @@ int kdemain(int argc, char **argv) <para >Les esclaves sont implémentés en tant que sous-classes de <classname ->KIO::SlaveBase</classname +>TDEIO::SlaveBase</classname > (FtpSlave dans l'exemple ci-dessus). Ainsi, les actions répertoriées dans le <literal >.protocol</literal > correspondent à certaines fonctions virtuelles dans <classname ->KIO::SlaveBase</classname +>TDEIO::SlaveBase</classname > que l'implémentation de l'esclave doit réimplémenter. Voici une liste des actions possibles et des fonctions virtuelles correspondantes : </para> <variablelist> @@ -3534,9 +3534,9 @@ int kdemain(int argc, char **argv) >. Si une erreur s'est produite, <literal >error()</literal > devra être appelée avec un code d'erreur comme premier argument et une chaîne dans le second. Les codes d'erreur possibles sont répertoriés sous forme d'énumération <type ->KIO::Error</type +>TDEIO::Error</type >. Le second argument est habituellement l'URL en question. Elle est utilisée &pex; dans <function ->KIO::Job::showErrorDialog()</function +>TDEIO::Job::showErrorDialog()</function > afin de paramétrer le message d'erreur humainement lisible. </para> <para @@ -3582,7 +3582,7 @@ int kdemain(int argc, char **argv) > signale des informations sur les éléments d'un dossier. À cette fin, appelez <function >listEntries()</function > avec une <classname ->KIO::UDSEntryList</classname +>TDEIO::UDSEntryList</classname > comme argument. De manière analogue à <function >data()</function >, vous pouvez l'appeler plusieurs fois. Quand vous avez fini, appelez <function @@ -3597,7 +3597,7 @@ int kdemain(int argc, char **argv) ><function >stat()</function > signale des informations sur un fichier, comme sa taille, son type MIME, &etc; Ce genre d'informations est conditionné dans une <classname ->KIO::UDSEntry</classname +>TDEIO::UDSEntry</classname >, que nous aborderons ci-après. Utilisez <function >statEntry()</function > pour envoyer un tel élément à l'application. </para @@ -3653,7 +3653,7 @@ int kdemain(int argc, char **argv) ><function >infoMessage()</function > — il s'agit d'un message de retour d'informations, comme un message « Retrieving data from <host> » depuis l'esclave http, qui est souvent affiché dans la barre d'état du programme. Côté application, cette méthode correspond au signal <function ->KIO::Job::infoMessage()</function +>TDEIO::Job::infoMessage()</function >. </para ></listitem> |