diff options
Diffstat (limited to 'tde-i18n-fr/docs/tdevelop/kdearch/index.docbook')
| -rw-r--r-- | tde-i18n-fr/docs/tdevelop/kdearch/index.docbook | 196 |
1 files changed, 98 insertions, 98 deletions
diff --git a/tde-i18n-fr/docs/tdevelop/kdearch/index.docbook b/tde-i18n-fr/docs/tdevelop/kdearch/index.docbook index 7d42ced259c..4d04397a7e7 100644 --- a/tde-i18n-fr/docs/tdevelop/kdearch/index.docbook +++ b/tde-i18n-fr/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 >La bibliothèque <literal ->kio</literal +>tdeio</literal > contient des ressources pour les entrées / sorties asynchrones, transparentes vis-à-vis du réseau et un accès à la gestion des types mime. Elle fournit aussi les boîtes de dialogue des fichiers KDE et ses classes d'aide. </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 >La bibliothèque <literal ->khtml</literal -> contient la partie KHTML, un widget de navigation HTML, l'API et l'analyseur DOM, y compris les interfaces à Java et JavaScript. </para +>tdehtml</literal +> contient la partie TDEHTML, un widget de navigation HTML, l'API et l'analyseur DOM, y compris les interfaces à Java et JavaScript. </para ></listitem> </varlistentry> @@ -403,8 +403,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KZoneAllocator" ->KZoneAllocator</ulink +><ulink url="kdeapi:tdecore/TDEZoneAllocator" +>TDEZoneAllocator</ulink ></title> <para >Allocateur de mémoire efficace pour de grands groupes de petits objets. </para> @@ -432,8 +432,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KAccel" ->KAccel</ulink +><ulink url="kdeapi:tdecore/TDEAccel" +>TDEAccel</ulink ></title> <para >Collection de raccourcis clavier. </para> @@ -443,8 +443,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KStdAccel" ->KStdAccel</ulink +><ulink url="kdeapi:tdecore/TDEStdAccel" +>TDEStdAccel</ulink ></title> <para >Accès aisé aux touches courantes de raccourcis clavier. </para> @@ -472,8 +472,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KIconLoader" ->KIconLoader</ulink +><ulink url="kdeapi:tdecore/TDEIconLoader" +>TDEIconLoader</ulink ></title> <para >Charge des icônes d'une manière se conformant à un thème. </para> @@ -483,11 +483,11 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KIconTheme" ->KIconTheme</ulink +><ulink url="kdeapi:tdecore/TDEIconTheme" +>TDEIconTheme</ulink ></title> <para ->Classes d'aide pour KIconLoader. </para> +>Classes d'aide pour TDEIconLoader. </para> </formalpara ></listitem> @@ -578,8 +578,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdecore/KCompletion" ->KCompletion</ulink +><ulink url="kdeapi:tdecore/TDECompletion" +>TDECompletion</ulink ></title> <para >Complétement automatique générique des chaînes. </para> @@ -589,7 +589,7 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KURLCompletion" +><ulink url="kdeapi:tdeio/KURLCompletion" >KURLCompletion</ulink ></title> <para @@ -600,7 +600,7 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KShellCompletion" +><ulink url="kdeapi:tdeio/KShellCompletion" >KShellCompletion</ulink ></title> <para @@ -618,8 +618,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KListView" ->KListView</ulink +><ulink url="kdeapi:tdeui/TDEListView" +>TDEListView</ulink ></title> <para >Une variante de <classname @@ -631,8 +631,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KListView" ->KListBox</ulink +><ulink url="kdeapi:tdeui/TDEListView" +>TDEListBox</ulink ></title> <para >Une variante de <classname @@ -644,8 +644,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KListView" ->KIconView</ulink +><ulink url="kdeapi:tdeui/TDEListView" +>TDEIconView</ulink ></title> <para >Une variante de <classname @@ -657,7 +657,7 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KListView" +><ulink url="kdeapi:tdeui/TDEListView" >KLineEdit</ulink ></title> <para @@ -683,8 +683,8 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KFontCombo" ->KFontCombo</ulink +><ulink url="kdeapi:tdeui/TDEFontCombo" +>TDEFontCombo</ulink ></title> <para >Une zone de liste modifiable pour sélectionner les polices. </para> @@ -727,7 +727,7 @@ <listitem ><formalpara ><title -><ulink url="kdeapi:kfile/KURLRequester" +><ulink url="kdeapi:tdefile/KURLRequester" >KURLRequester</ulink ></title> <para @@ -790,7 +790,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kfile/KFileDialog" +><ulink url="kdeapi:tdefile/KFileDialog" >KFileDialog</ulink ></title> <para @@ -812,8 +812,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KFontDialog" ->KFontDialog</ulink +><ulink url="kdeapi:tdeui/TDEFontDialog" +>TDEFontDialog</ulink ></title> <para >Une boîte de dialogue pour la sélection des polices. </para> @@ -823,8 +823,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kfile/KIconDialog" ->KIconDialog</ulink +><ulink url="kdeapi:tdefile/TDEIconDialog" +>TDEIconDialog</ulink ></title> <para >Une boîte de dialogue pour la sélection des icônes. </para> @@ -867,8 +867,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KAboutDialog" ->KAboutDialog</ulink +><ulink url="kdeapi:tdeui/TDEAboutDialog" +>TDEAboutDialog</ulink ></title> <para >Une boîte de dialogue « À propos ». </para> @@ -889,7 +889,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kfile/KURLRequesterDlg" +><ulink url="kdeapi:tdefile/KURLRequesterDlg" >KURLRequesterDlg</ulink ></title> <para @@ -929,8 +929,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KAction" ->KAction</ulink +><ulink url="kdeapi:tdeui/TDEAction" +>TDEAction</ulink ></title> <para >Abstraction pour une action qui peut être intégrée dans les barres de menus et les barres d'outils. </para> @@ -940,8 +940,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:tdeui/KActionCollection" ->KActionCollection</ulink +><ulink url="kdeapi:tdeui/TDEActionCollection" +>TDEActionCollection</ulink ></title> <para >Un ensemble d'actions. </para> @@ -962,7 +962,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kparts/KPartManager" +><ulink url="kdeapi:tdeparts/KPartManager" >KPartManager</ulink ></title> <para @@ -1015,7 +1015,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KServiceType" +><ulink url="kdeapi:tdeio/KServiceType" >KServiceType</ulink ></title> <para @@ -1026,7 +1026,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KService" +><ulink url="kdeapi:tdeio/KService" >KService</ulink ></title> <para @@ -1037,7 +1037,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KMimeType" +><ulink url="kdeapi:tdeio/KMimeType" >KMimeType</ulink ></title> <para @@ -1048,7 +1048,7 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KServiceTypeProfile" +><ulink url="kdeapi:tdeio/KServiceTypeProfile" >KServiceTypeProfile</ulink ></title> <para @@ -1059,8 +1059,8 @@ url="kdeapi:tdeui/KAnimWidget" <listitem ><formalpara ><title -><ulink url="kdeapi:kio/KServiceTypeProfile" ->KTrader</ulink +><ulink url="kdeapi:tdeio/KServiceTypeProfile" +>TDETrader</ulink ></title> <para >Requêtes de services. </para> @@ -1708,8 +1708,8 @@ url="kdeapi:tdeui/KAnimWidget" >) ou parties différents. </para> <para ->La classe de KDE pour les fenêtres de premier niveau, <ulink url="kdeapi:tdeui/KMainWindow.html" ->KMainWindow</ulink +>La classe de KDE pour les fenêtres de premier niveau, <ulink url="kdeapi:tdeui/TDEMainWindow.html" +>TDEMainWindow</ulink >, hérite de <ulink url="kdeapi:tdeui/KXMLGUIClient.html" >KXMLGUIClient</ulink > et gère donc XMLGUI en dehors de l'ordinateur. Toutes les actions créées en son sein doivent avoir la <literal @@ -1773,19 +1773,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> @@ -1985,7 +1985,7 @@ rc_DATA = kviewui.rc unplugActionList("openwith"); openWithActions.clear(); for ( /* itérer sur les services pertinents */ ) { - KAction *action = new KAction( ...); + TDEAction *action = new TDEAction( ...); openWithActions.append(action); } plugActionList("openwith", openWithActions); @@ -2108,12 +2108,12 @@ rc_DATA = kviewui.rc <para >Si les barres de menus et les barres d'outils sont créées à l'aide du <ulink url="actionpattern.html" >motif d'actions</ulink ->, la chaîne employée comme bulle d'aide est dérivée du premier argument du constructeur <ulink url="kdeapi:tdeui/KAction.html" ->KAction</ulink +>, la chaîne employée comme bulle d'aide est dérivée du premier argument du constructeur <ulink url="kdeapi:tdeui/TDEAction.html" +>TDEAction</ulink > : </para> <programlisting ->action = new KAction(i18n("&Delete"), "editdelete", +>action = new TDEAction(i18n("&Delete"), "editdelete", SHIFT+Key_Delete, actionCollection(), "del") </programlisting> @@ -2348,9 +2348,9 @@ X-KDevelop-Scope=Project >KDevFactory</classname > (qui hérite de <classname >KLibFactory</classname ->). <ulink url="kdeapi:kparts/KParts::Factory" +>). <ulink url="kdeapi:tdeparts/KParts::Factory" >KParts::Factory</ulink -> est un autre exemple courant supposé produire des objets <ulink url="kdeapi:kparts/KParts::ReadOnlyPart" +> est un autre exemple courant supposé produire des objets <ulink url="kdeapi:tdeparts/KParts::ReadOnlyPart" >KParts::ReadOnlyPart</ulink > ou dans la plupart des cas, la <ulink url="kdeapi:tdecore/KLibFactory" >KLibFactory</ulink @@ -2364,7 +2364,7 @@ X-KDevelop-Scope=Project >Utilisation des services de bibliothèques partagées</title> <para ->Pour employer un service de bibliothèque partagée dans une application, vous devez obtenir un objet <ulink url="kdeapi:kio/KService.html" +>Pour employer un service de bibliothèque partagée dans une application, vous devez obtenir un objet <ulink url="kdeapi:tdeio/KService.html" >KService</ulink > qui le représente. Ce point est étudié dans la <ulink url="mime.html" >section sur les types MIME</ulink @@ -2413,8 +2413,8 @@ if (!factory) { <para >Un service DCOP est habituellement mis en œuvre comme un programme qui est démarré lorsqu'il est nécessaire. Il entre ensuite dans une boucle et écoute les connexions DCOP. Il peut s'agir d'un programme interactif, mais il se peut aussi qu'il s'exécute complètement ou pour une partie de sa durée de vie comme un démon en arrière-plan, sans que l'utilisateur le remarque. Un exemple de ce type de démon est <literal ->kio_uiserver</literal ->, qui met en œuvre une interaction utilisateur comme boîte de dialogue de progression pour la bibliothèque KIO. L'avantage d'un tel démon centralisé dans ce contexte est que &pex; la progression du téléchargement de différents fichiers peut s'afficher dans une seule fenêtre, même si ces téléchargements ont été lancés à partir de différentes applications. </para> +>tdeio_uiserver</literal +>, qui met en œuvre une interaction utilisateur comme boîte de dialogue de progression pour la bibliothèque TDEIO. L'avantage d'un tel démon centralisé dans ce contexte est que &pex; la progression du téléchargement de différents fichiers peut s'afficher dans une seule fenêtre, même si ces téléchargements ont été lancés à partir de différentes applications. </para> <para >Un service DCOP est défini différemment depuis un service de bibliothèque partagée. Bien sûr, il ne spécifie pas une bibliothèque, mais plutôt un exécutable. En outre, les services DCOP ne spécifient pas de ligne ServiceType parce qu'ils sont habituellement démarrés par leur nom. À titre de propriétés additionnelles, il contient deux lignes : </para> @@ -2448,14 +2448,14 @@ if (!factory) { <para >Voici la définition de <literal ->kio_uiserver</literal +>tdeio_uiserver</literal > : </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> @@ -2473,9 +2473,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 << "Le démarrage de kioserver a échoué avec le message " << error << endl; } ... @@ -2483,9 +2483,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 << "L'appel à kio_uiserver a échoué" << endl; + cout << "L'appel à tdeio_uiserver a échoué" << endl; ... </programlisting> @@ -2500,7 +2500,7 @@ if (!client->call("kio_uiserver", "UIServer", "setListMode(bool)", > du fichier desktop. Une alternative consiste à utiliser <function >TDEApplication::startServiceByDesktopName()</function >, qui prend le nom de fichier de son fichier desktop comme argument, &cad; dans ce cas, <literal ->"kio_uiserver.desktop"</literal +>"tdeio_uiserver.desktop"</literal >. </para> <para @@ -2620,7 +2620,7 @@ Comment[en]=Foo Data File >. </para> <para ->Dans les bibliothèques KDE, un tel type de définition est mis en correspondance vers une instance de la classe <ulink url="kdeapi:kio/KMimeType.html" +>Dans les bibliothèques KDE, un tel type de définition est mis en correspondance vers une instance de la classe <ulink url="kdeapi:tdeio/KMimeType.html" >KMimeType</ulink >. Utilisez-la, comme dans l'exemple suivant : </para> @@ -2669,7 +2669,7 @@ else >(cette méthode a quelques arguments supplémentaires, mais comme ils ne sont pas documentés, ignorons-les.) </para> <para ->Vous pouvez être amené à trouver un type MIME à partir du contenu du fichier au lieu du nom du fichier. Ce procédé est plus fiable mais aussi plus lent, puisqu'il exige la lecture d'une partie du fichier. Pour ce faire, faites appel à la classe <ulink url="kdeapi:kio/KMimeMagic.html" +>Vous pouvez être amené à trouver un type MIME à partir du contenu du fichier au lieu du nom du fichier. Ce procédé est plus fiable mais aussi plus lent, puisqu'il exige la lecture d'une partie du fichier. Pour ce faire, faites appel à la classe <ulink url="kdeapi:tdeio/KMimeMagic.html" >KMimeMagic</ulink > qui gère différemment les erreurs : </para> @@ -2709,14 +2709,14 @@ else </programlisting> <para ->Cette fonction démarre une tâche KIO pour télécharger une partie du fichier et le vérifie. Notez qu'elle peut être très lente et bloque le programme. Normalement, vous ne l'utiliserez que si <function +>Cette fonction démarre une tâche TDEIO pour télécharger une partie du fichier et le vérifie. Notez qu'elle peut être très lente et bloque le programme. Normalement, vous ne l'utiliserez que si <function >KMimeType::findByURL()</function > a retourné <literal >"application/octet-stream"</literal >. </para> <para ->Par ailleurs, si vous ne voulez pas bloquer votre application, vous pouvez également démarrer explicitement la tâche KIO et vous connecter à quelques-uns de ses signaux : </para> +>Par ailleurs, si vous ne voulez pas bloquer votre application, vous pouvez également démarrer explicitement la tâche TDEIO et vous connecter à quelques-uns de ses signaux : </para> <programlisting >void FooClass::findType() @@ -2783,7 +2783,7 @@ for (it = offers.begin(); it != offers.end(); ++it) { >"Application"</literal > par <literal >"KParts::ReadOnlyPart"</literal ->. Dans ce cas, vous obtenez une liste des composants intégrables pour présenter du contenu HTML, &pex;, KHTML. </para> +>. Dans ce cas, vous obtenez une liste des composants intégrables pour présenter du contenu HTML, &pex;, TDEHTML. </para> <para >La plupart du temps, la liste de toutes les offres de services n'a aucun intérêt pour une combinaison type MIME et type de service. Il y a une fonction de confort qui vous donne uniquement l'offre de service ayant la plus grande préférence : </para> @@ -2797,12 +2797,12 @@ else </programlisting> <para ->Pour des requêtes encore plus complexes, il y a un <ulink url="kdeapi:kio/KTrader.html" +>Pour des requêtes encore plus complexes, il y a un <ulink url="kdeapi:tdeio/TDETrader.html" >courtier</ulink > à part entière dans le style de CORBA. </para> <para ->Pour exécuter un service d'application avec quelques URL, utilisez <ulink url="kdeapi:kio/KRun.html" +>Pour exécuter un service d'application avec quelques URL, utilisez <ulink url="kdeapi:tdeio/KRun.html" >KRun</ulink > : </para> @@ -2863,7 +2863,7 @@ new KRun(url); > est importante. Pendant que vous attendez que votre navigateur web télécharge une page, l'interface utilisateur ne devra pas se bloquer. De plus, le rendu de la page ne devrait pas commencer quand la page est complètement disponible, mais devrait être régulièrement actualisé au fur et à mesure que les données arrivent. </para> <para ->Dans les bibliothèques KDE, la transparence réseau est mise en œuvre dans l'API KIO. Le concept central de cette architecture est une <emphasis +>Dans les bibliothèques KDE, la transparence réseau est mise en œuvre dans l'API TDEIO. Le concept central de cette architecture est une <emphasis >tâche</emphasis > d'E/S. Une tâche peut copier ou supprimer des fichiers, ou toute autre chose similaire. Dès lors qu'une tâche est démarrée, elle s'exécute en arrière-plan et ne bloque pas l'application. Toute communication depuis la tâche à nouveau vers l'application — comme la remise des données ou les informations de progression — s'effectue alors qu'elle est intégrée à la boucle d'événement Qt. </para> @@ -2886,10 +2886,10 @@ new KRun(url); <simplesect id="nettransparency-usingkio"> <title ->Utilisation de KIO</title> +>Utilisation de TDEIO</title> <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 +>Dans la majorité des cas, les tâches sont créées en appelant des fonctions dans l'espace de noms TDEIO. 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(TDEIO::Job*)</literal >. Une fois ce signal émis, la tâche se supprime. Ainsi, voici à quoi ressemble un cas classique d'utilisation : </para> @@ -3183,7 +3183,7 @@ void FooClass::mkdirResult(TDEIO::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 TDEIO::NetAccess. Par exemple, pour copier un fichier, utilisez </para> +>Souvent, l'API asynchrone de TDEIO 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; @@ -3231,7 +3231,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"); ... @@ -3274,13 +3274,13 @@ void FooClass::transferResult(TDEIO::Job *job) >Planification</title> <para ->Lorsque vous employez l'API KIO, vous n'avez d'ordinaire pas à vous préoccuper des détails du démarrage des IOslaves et de la communication avec ces derniers. Le cas normal d'utilisation est de démarrer une tâche et avec certains paramètres, ainsi que de gérer les signaux que la tâche émet. </para> +>Lorsque vous employez l'API TDEIO, vous n'avez d'ordinaire pas à vous préoccuper des détails du démarrage des IOslaves et de la communication avec ces derniers. Le cas normal d'utilisation est de démarrer une tâche et avec certains paramètres, ainsi que de gérer les signaux que la tâche émet. </para> <para ->En coulisses, le scénario est beaucoup plus compliqué. Dès que vous créez une tâche, elle est mise en file d'attente. Quand l'application revient vers la boucle d'événement, KIO alloue les processus esclaves pour les tâches contenues dans la file d'attente. Pour la première tâche démarrée, c'est trivial : un IOslave est démarré pour le protocole approprié. Toutefois, une fois que la tâche (comme un téléchargement depuis un serveur http) est terminée, elle n'est pas tuée immédiatement. Elle est au contraire placée dans un groupe d'esclaves inactifs et tuée après un certain temps d'inactivité (le plus souvent, 3 minutes). Si une nouvelle requête pour le même protocole et le même hôte arrive, l'esclave est réutilisé. L'avantage évident est que, pour une série de tâches concernant le même hôte, le coût nécessaire à la création de nouveaux processus et éventuellement à l'obtention d'une procédure d'authentification est économisé. </para> +>En coulisses, le scénario est beaucoup plus compliqué. Dès que vous créez une tâche, elle est mise en file d'attente. Quand l'application revient vers la boucle d'événement, TDEIO alloue les processus esclaves pour les tâches contenues dans la file d'attente. Pour la première tâche démarrée, c'est trivial : un IOslave est démarré pour le protocole approprié. Toutefois, une fois que la tâche (comme un téléchargement depuis un serveur http) est terminée, elle n'est pas tuée immédiatement. Elle est au contraire placée dans un groupe d'esclaves inactifs et tuée après un certain temps d'inactivité (le plus souvent, 3 minutes). Si une nouvelle requête pour le même protocole et le même hôte arrive, l'esclave est réutilisé. L'avantage évident est que, pour une série de tâches concernant le même hôte, le coût nécessaire à la création de nouveaux processus et éventuellement à l'obtention d'une procédure d'authentification est économisé. </para> <para ->Naturellement, la réutilisation n'est possible que si l'esclave existant a déjà terminé sa tâche précédente. Quand une nouvelle requête arrive alors qu'un processus esclave existant s'exécute encore, un nouveau processus doit être démarré et utilisé. Lors de l'usage de l'API dans les exemples précédents, il n'y a aucune limite à la création de nouveaux processus esclaves : si vous démarrez une série consécutive de téléchargements pour 20 fichiers différents, alors KIO démarre 20 processus esclaves. Ce dispositif visant à affecter des esclaves aux tâches est appelé <emphasis +>Naturellement, la réutilisation n'est possible que si l'esclave existant a déjà terminé sa tâche précédente. Quand une nouvelle requête arrive alors qu'un processus esclave existant s'exécute encore, un nouveau processus doit être démarré et utilisé. Lors de l'usage de l'API dans les exemples précédents, il n'y a aucune limite à la création de nouveaux processus esclaves : si vous démarrez une série consécutive de téléchargements pour 20 fichiers différents, alors TDEIO démarre 20 processus esclaves. Ce dispositif visant à affecter des esclaves aux tâches est appelé <emphasis >direct</emphasis >. Ce n'est pas toujours celui qui est le plus approprié, car il peut exiger beaucoup de mémoire et placer une charge élevée à la fois sur les machines clientes et serveurs. </para> @@ -3339,7 +3339,7 @@ EXTRA_DIST = $(mime_DATA) <programlisting >[Protocol] -exec=kio_ftp +exec=tdeio_ftp protocol=ftp input=none output=filesystem @@ -3366,9 +3366,9 @@ Icon=ftp <para >Dans le fichier <literal >.protocol</literal ->, les lignes restantes définissent les capacités qu'a l'esclave. En général, les fonctionnalités qu'un esclave doit implémenter sont beaucoup plus simples que celles que l'API KIO fournit pour l'application. La raison à cela est que les tâches complexes sont planifiées pour quelques sous-tâches. Par exemple, pour répertorier un dossier récursivement, une tâche sera démarrée pour le dossier de premier niveau. Puis, pour chaque sous-dossier faisant l'objet d'un rapport, de nouvelles sous-tâches sont démarrées. Dans KIO, un planificateur veille à ce qu'il n'y ait pas trop de tâches actives au même moment. De la même manière, pour copier un fichier au sein d'un protocole qui ne prend pas en charge la copie directement (comme le protocole <literal +>, les lignes restantes définissent les capacités qu'a l'esclave. En général, les fonctionnalités qu'un esclave doit implémenter sont beaucoup plus simples que celles que l'API TDEIO fournit pour l'application. La raison à cela est que les tâches complexes sont planifiées pour quelques sous-tâches. Par exemple, pour répertorier un dossier récursivement, une tâche sera démarrée pour le dossier de premier niveau. Puis, pour chaque sous-dossier faisant l'objet d'un rapport, de nouvelles sous-tâches sont démarrées. Dans TDEIO, un planificateur veille à ce qu'il n'y ait pas trop de tâches actives au même moment. De la même manière, pour copier un fichier au sein d'un protocole qui ne prend pas en charge la copie directement (comme le protocole <literal >ftp:</literal ->), KIO peut lire le fichier source puis écrire les données sur le fichier de destination. Pour que cela fonctionne, le <literal +>), TDEIO peut lire le fichier source puis écrire les données sur le fichier de destination. Pour que cela fonctionne, le <literal >.protocol</literal > doit annoncer les actions que son esclave prend en charge. </para> @@ -3384,12 +3384,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); } @@ -3477,7 +3477,7 @@ int kdemain(int argc, char **argv) <para >En outre, il y a des fonctions réimplémentables non répertoriées dans le fichier <literal >.protocol</literal ->. Pour ces opérations, KIO détermine automatiquement si elles sont prises en charge ou non (&cad; que l'implémentation par défaut retourne une erreur). </para> +>. Pour ces opérations, TDEIO détermine automatiquement si elles sont prises en charge ou non (&cad; que l'implémentation par défaut retourne une erreur). </para> <variablelist> |