
Groupe de commandes "CLIP": Presse-papiers
==========================================

RK offre une série de commandes qui manipule le contenu du presse-papiers.


/CLIP.CALC [mod] ......: Calcule le contenu du presse-papiers (s'il est 
                         en "liste" = colonne), <mod>=1: calcule la 
------------------------ moyenne, <mod>=2: calcule en heures

Quand une liste de chiffres est sous forme de colonne dans le presse-
papiers, cette commande peut calculer le résultat, que cela soit une 
addition, soustraction, multiplication (*), division (/) et pourcent 
(% : doit se trouver à la fin).
Si aucun opérateur n'est donné, c'est l'addition qui sera effectuée.
Depuis la version 7.7.61, "ClipCalc" est un programme unique qui se trouve 
dans le sous-dossier "App". Si le paramètre "1" est ajouté, le résultat de 
l'addition sera également donné sous forme de moyenne (quand c'est 
possible). Si le paramètre "2" est ajouté, le résultat sera calculé en 
heures et minutes.

Exemple: bouton "=" du profil "Calculatrice du scénario"
Exemple pour mode 1: bouton "Ø" du profil "Calculatrice du scénario"
Exemple pour mode 2: bouton droit "=" du profil "Calculatrice du scénario"

Exemple de scénario:
1. Créez un bouton avec le scénario suivant:

{/BTCH.EXPLICIT}
{/CLIP.CALC}
{/CLIP.TXT.VIEW}

2. Maintenant copiez le bloque suivant dans le presse-papiers

44.50
17.33
112.05

3. Cliquez sur le bouton nouvellement créé.

--> Conseil
Cela fonctionne aussi si une colonne dans Excel est copiée dans le presse-
papiers.

--> Note
Le résultat est automatiquement stocké dans la variable VAR actuelle 
("Définition VAR") pour des calculations additionelles. (voir le bouton 
"VAR" du profil "Calculatrice du scénario")

--> Note
Le profil "Calculatrice du scénario" est basé sur ce principe, ainsi c'est 
possible de coder une calculatrice complète avec des scénarios.


/CLIP.CLEAR ...........: Efface le presse-papiers
------------------------

Exemple: bouton "eff. pr-pa" du profil "Stock"


/CLIP.COPYPATH ........: Copie un chemin dans le presse-papiers en 
                         utilisant l'utilitaire "FileDuplicate", option 
------------------------ "Copy a Path..."

Depuis "l'Explorateur", glissez un fichier et déplacez-le sur l'image.
Le texte s'affiche dans le champ "Clipboard" suivant l'une des 3 options 
choisies : "Chemin et Nom de fichier", "Chemin seulement" ou "Nom de 
fichier seulement" et est copié dans le presse-papiers.

Exemple: {/CLIP.COPYPATH}


/CLIP.IMG.LOAD file....: Copie les fichiers images dans le presse-papiers
------------------------
Avec cette commande on peut envoyer une image (bmp, jpg, gif) dans le 
presse-papiers, puis immédiatement après la coller dans une application.

Exemple: {/CLIP.IMG.LOAD c:\mes documents\mes images\lion.jpg}


/CLIP.IMG.MEM no ......: Charge une image <no> (1-10) de la boîte 
------------------------ "Mémoire des images" dans le presse-papiers

La boîte "Mémoire des images" (s.v.p. lisez le fichier-texte) peut 
contenir 10 images. Cette commande permet d'envoyer une des 10 images 
dans le presse-papiers.

Exemple: bouton "image" du profil "Stock"


/CLIP.IMG.VIEW ........: Affiche l'image, chargée dans le presse-papiers 
                         avec "/CLIP.IMG.LOAD file", dans l'Aperçu 
------------------------ interne d'image

Exemple: {/CLIP.IMG.VIEW}


/CLIP.TXT.APPEND file .: Ajoute au fichier-texte <file> le texte contenu 
------------------------ dans le presse-papiers

Exemple de scénario: 

1. Créez un fichier-texte nommé "essai" dans C:\Mes Documents, puis tapez 
   quelques mots et fermez-le.
2. Créez un bouton avec la commande : 
   {/CLIP.TXT.APPEND c:\mes documents\essai.txt}
3. Copiez un texte dans le presse-papiers, puis cliquez sur le bouton.
4. Ouvrez "essai" : le texte a été collé.


/CLIP.TXT.ASK .........: Ajoute un texte dans le presse-papiers, écrit par 
------------------------ l'utilisateur pendant le processus du scénario

Exemple: bouton "Ex - Clip" du profil "Démo scénarios Go-Exit" 
         bouton "Go - Clip" du profil "Démo scénarios Go-Exit"

--> Conseil
L'exécution du scénario peut être interrompue à l'aide de la commande 
"BTCH.EXITIF.CANCEL" si la boîte est fermée avec le bouton "Ferme".


/CLIP.TXT.BEFOR txt....: Ajoute un texte <txt> au début du presse-papiers
/CLIP.TXT.BEHND txt....: Ajoute un texte <txt> à la fin du presse-papiers
------------------------

Avec ces commandes on peut par exemple copié un texte dans le presse-
papiers après l'avoir vidé.

Exemple: {/CLIP.CLEAR}{/CLIP.TXT.BEFOR Bonjour tout le monde}

Dans cet exemple il ne reste que le texte "Bonjour tout le monde" dans le 
presse-papiers. 

Autres exemples: boutons "avant" et "après" du profil "Stock"


/CLIP.TXT.BEHND.ASC no : Ajoute un code ASCII <no> à la fin du presse-p.
/CLIP.TXT.BEHND.ASK ...: Ajoute un texte à la fin du presse-p., défini par 
                         l'utilisateur pendant le processus du scénario
/CLIP.TXT.BEHND.CR ....: Ajoute un "retour à la ligne" à la fin du presse-p.
/CLIP.TXT.BEHND.MEM ...: Ajoute la mémoire du presse-papiers de RK à la fin 
                         du presse-papiers
/CLIP.TXT.BEHND.STR [n]: Ajoute la variable-série STR <n> à la fin du 
                         presse-papiers
/CLIP.TXT.BEHND.VAR ...: Ajoute la variable VAR actuelle à la fin du 
------------------------ presse-papiers

Exemple ..BEHND.ASK: bouton "Com." du profil "Calculatrice du scénario"

Exemple ..BEHND.CR: bouton "Vers le pres.-p." du profil "Exemples de base 
                    de données"

--> Conseil
Pour la commande BEHND.ASK, l'exécution du scénario peut être interrompue 
à l'aide de la commande "BTCH.EXITIF.CANCEL" si la boîte est fermée avec 
le bouton "Ferme".


/CLIP.TXT.BLOCK.BEGIN .: Marque le début d'un bloc de texte du scénario 
                         qui sera copié dans le presse-papiers
/CLIP.TXT.BLOCK.END ...: Marque la fin du bloc de texte pour ..BLOCK.BEGIN 
------------------------ (facultative : si = non, le scénario prend fin)

Ces commandes permettent de copier un bloc de texte du scénario dans le 
presse-papiers.
La commande BLOCK.END n'est pas obligatoire. Si elle manque, le scénario 
prendra automatiquement fin à ce point.

Exemple: bouton "Note" du profil "Stock"

Exemple de scénario:

{/CLIP.TXT.BLOCK.BEGIN}
Ligne 1
Ligne 2

Exemple de scénario:

{/CLIP.TXT.BLOCK.BEGIN}
Ligne 1 et
Ligne 2 viennent du presse-papiers...{/CLIP.TXT.BLOCK.END}
{/BTCH.EXPLICIT}
{HOLD.CONTROL}v
{KEY.ENTER}
Ligne 3 est envoyée directement.

--> Remarque !
La commande BTCH.EXPLICIT assure un bon résultat, car elle supprime du 
scénario les retours à la ligne indésirés.

--> Conseil
La combinaison de ces commandes permet également de marquer un bloc à 
l'intérieur du scénario, qui ne doit pas être envoyé.

Exemple de scénario:

Cette ligne est envoyée.
{/CLIP.TXT.BLOCK.BEGIN}
Cette ligne n'est pas envoyée.
{/CLIP.TXT.BLOCK.END}{/BTCH.EXPLICIT}
Cette ligne est également envoyée.


/CLIP.TXT.CONV [mod] ..: Convertit dans le presse-papiers les valeurs en 
                         caractères, <mod>=0: déc>hex, <mod>=1: hex>déc 
------------------------ (défaut=0)

Exemple: bouton "dé>H" du profil "Calculatrice du scénario"

Si le chiffre "234" se trouve dans le presse-papiers, il devient "EA" 
après l'exécution de cette commande.


/CLIP.TXT.COUNT .......: Compte les caractères contenus dans le 
------------------------ presse-papiers

Dans beaucoup de formulaires Internet la requête est limitée à un nombre 
défini de caractères. Quand des textes sont rédigés pour des formulaires 
différents c'est très utile de trouver rapidement le nombre de caractères 
de ceux-ci : simplement en les copiant dans le presse-papiers puis en 
utilisant cette commande.

Exemple: bouton "Compte" du profil "Stock"


/CLIP.TXT.CUT.LEFT qu .: Supprime dans le presse-papiers la quantité <qu> 
                         de caractères depuis la gauche
/CLIP.TXT.CUT.RGHT qu .: Supprime dans le presse-papiers la quantité <qu> 
                         de caractères depuis la droite
/CLIP.TXT.CUT.FROM pos : Supprime dans le presse-p. la droite du texte 
                         depuis le caractère n° <pos> (y compris celui-ci)
/CLIP.TXT.CUT.REVERSE .: Commute entre le résultat du presse-papiers et la 
------------------------ partie coupée de la dernière commande .CUT

Exemple de scénario:

{/BTCH.EXPLICIT}
{/STR.SET 1,1234567890}
{/STR.CLIP.SET 1}
{/CLIP.TXT.CUT.LEFT 3}
{/CLIP.TXT.CUT.FROM 5}
{/STR.CLIP.GET 1}
{/STR.VIEW}

L'aperçu affiche le contenu "4567" pour la série STR 1.

Depuis la version 8.0, le paramètre "qu" négatif est possible. Dans ce 
cas "qu" se calcule avec la différence entre la longueur totale du presse-
papiers et lui-même.
Cela signifie: si 10 chiffres se trouvent dans le presse-papiers et que 
le paramètre -3 est donné, alors 7 chiffres seront supprimés.

De même depuis la version 8.0, la commande REVERSE commute entre la partie 
coupée et le résultat obtenu dans le presse-papiers.
Exemple: 
Dans le presse-papiers se trouve "1234567890". Avec la commande CUT.LEFT 
les 4 premiers chiffres sont effacés. Dans le presse-papiers il y a 
maintenant "567890". Si la commande REVERSE est exécutée, le contenu du 
presse-papiers se change en "1234".


/CLIP.TXT.ENCRYPT .....: Code le texte du presse-papiers
/CLIP.TXT.DECRYPT .....: Décode le texte du presse-papiers
------------------------
La fonction "Code" se trouve dans la boîte de l'Editeur des boutons. Donc 
comme ce module existe, ce n'était pas un luxe de l'ajouter au presse-
papiers pour coder et décoder des textes.
Si on désire coder un texte-ASCII (.txt) : on le copie dans le presse-
papiers, on le code avec un mot de passe (une boîte pour entrer le mot 
de passe s'ouvre automatiquement), et on le colle dans l'application.
Ainsi on peut oublier le texte et l'enlever de sa mémoire.

Si on désire le rendre lisible à nouveau, on le copie une nouvelle fois 
dans le presse-papiers, on le décode avec le même mot de passe et on le 
colle dans une application-texte.

-->Attention ! 
Si le mot de passe est perdu, c'est pratiquement impossible de rendre le 
texte lisible !

Exemple: {/CLIP.TXT.ENCRYPT}


/CLIP.TXT.EDITOR ......: Ouvre le contenu du presse-papiers dans 
------------------------ l'éditeur (editor.txt du sous-dossier "PicMem")

Exemple: bouton "Edit." du profil "Calculatrice du scénario"


/CLIP.TXT.END>FRONT [s]: Inverse dans le presse-p. les mots espacés de la 
                         fin au début, facultatif avec un séparateur <s>
/CLIP.TXT.FRONT>END [s]: Inverse dans le presse-p. les mots espacés du 
------------------------ début à la fin, facultatif avec un séparateur <s>

Ces commandes sont utiles pour inverser des listes de noms dans le presse-
papiers.

Exemple:

Liza Minelli
Johann Sebastian Bach

donne:

Minelli, Liza
Bach, Johann Sebastian

et sur demande comme à l'origine.

Les scénarios se présentent ainsi:

{/BTCH.EXPLICIT}
{/CLIP.TXT.END>FRONT ,}
{/CLIP.TXT.BEHND.CR}
{/CLIP.TXT.SEND}

et

{/BTCH.EXPLICIT}
{/CLIP.TXT.REMOVE.TXT ,}
{/CLIP.TXT.FRONT>END}
{/CLIP.TXT.BEHND.CR}
{/CLIP.TXT.SEND}

--> Remarque !
Encore une fois pour être clair :
C'est valable aussi bien pour une liste complète de noms que pour des noms 
uniques.

--> Conseil !
Si l'on place avant la commande {/CLIP.TXT.TAB>SPC 1}, on peut alors 
également inverser la place de listes dans Excel.


/CLIP.TXT.FORMAT.DO ...: Formate la liste de calculs dans le presse-papiers
/CLIP.TXT.FORMAT.SET [n] Définit dans le presse-p. le mode du format <n> 
                         (-1,0,1,2,3...) : -1 = sans colonne, 0 = colonne, 
                         1 = 0.0, etc...
/CLIP.TXT.FORMAT.SYM txt Ajoute des symboles de monnaie, <txt> pour $ etc, 
------------------------ off=sans, del=supprime les symboles actuels

Ces commandes ont été développées pour formater la sortie du profil 
"Calculatrice du scénario". Si l'on veut obtenir de bons résultats dans 
CMM (l'Aperçu), on doit naturellement utiliser ces commandes.

Exemple: bouton "F.on" du profil "Calculatrice du scénario"

Exemple de scénario:

{/BTCH.EXPLICIT}
{/APP.ACTIVATION.OFF}
{/CLIP.TXT.FORMAT.SYM del}
{/CLIP.TXT.FORMAT.SET 2}
{/CLIP.TXT.FORMAT.DO}
{/CLIP.TXT.FORMAT.SYM EUR}
{/CLIP.TXT.FORMAT.DO}


/CLIP.TXT.INITIAL [str]: Convertit le 1er caractère après un espace, TAB 
                         et retour à la ligne en majuscule, facultatif: 
------------------------ série de caractères <str>

Exemple: {/CLIP.TXT.INITIAL}

La phrase "abc def, ghi" deviendra "Abc Def, Ghi".

Depuis la version 8.2, on peut ajouter un paramètre facultatif de série de 
signes, qui concerne d'autres signes autres que "espace", "TAB" et "Retour 
à la ligne".
Sans le paramètre la commande va donner avec "jean-pierre" : "Jean-pierre", 
car le "trait d'union" ne rentre pas en ligne de compte.
Pour obtenir "Jean-Pierre" la commande doit être : {/CLIP.TXT.INITIAL -}.
On peut ajouter beaucoup de caractères arbitraires, comme par exemple 
{/CLIP.TXT.INITIAL -.,}.


/CLIP.TXT.LOAD file....: Charge un fichier-texte <file> dans le presse-
------------------------ papiers

Avec cette commande on peut lire un texte-ASCII (.txt) dans le presse-
papiers (dans la liste alphabétique c'est le plus agréable), puis le 
coller ensuite dans une autre application-texte avec la commande 
/CLIP.TXT.SEND (voir plus bas).

Exemple: bouton "c. txt" du profil "Stock"


/CLIP.TXT.LOWCASE .....: Change le texte du presse-papiers en minuscules
/CLIP.TXT.UPCASE ......: Change le texte du presse-papiers en majuscules
------------------------

Exemples: boutons "minusc." et "majusc." du profil "Stock"


/CLIP.TXT.MEM.COPY ....: Copie le texte du presse-papiers dans la mémoire 
                         du presse-papiers de RK
/CLIP.TXT.MEM.SWAP ....: Permute entre le texte du presse-papiers et la 
------------------------ mémoire du presse-papiers de RK

RK possède une mémoire pour le presse-papiers, appelée "ClipMemory". Avec 
la commande COPY, le contenu actuel du presse-papiers sera stocké dedans, 
et la commande SWAP permutera entre le contenu du presse-papiers et de la 
mémoire.

Exemple: {/CLIP.TXT.MEM.SWAP}

--> Attention !
Après le 1er appel le contenu du presse-papiers est naturellement vide.

Aussi suivez la démarche suivante :
1. Sélectionnez le 1er texte et copiez-le dans le presse-papiers
2. Envoyez la commande /CLIP.TXT.MEM.COPY
3. Sélectionnez le 2ème texte et copiez-le dans le presse-papiers 

Maintenant vous pouvez permuter entre les 2 textes à l'aide de la 
commande /CLIP.TXT.MEM.SWAP.


/CLIP.TXT.REMOVE.ASC ..: Supprime le code-ASCII <no> du presse-papiers
/CLIP.TXT.REPLACE.ASC .: Remplace le 1er code-ASCII par le 2ème
------------------------ <no>,<no> dans le presse-papiers

Exemple: {/CLIP.TXT.REMOVE.ASC 34}

Dans cet exemple toutes les apostrophes (") seront supprimées.

Exemple: {/CLIP.TXT.REPLACE.ASC 45,61}

Dans cet exemple tous les traits d'union (-) seront remplacés par des 
signes d'égalité (=).

Dans le sous-dossier "App" de RK il y a un utilitaire nommé "CheckASC", 
grâce auquel on peut trouver les codes ASCII des caractères.


/CLIP.TXT.REMOVE.ASK ..: Supprime dans le presse-papiers un caractère ou 
                         un texte à définir
/CLIP.TXT.REPLACE.ASK .: Remplace dans le presse-papiers un caractète ou 
------------------------ un texte à définir

Ces 2 commandes ouvrent une boîte, dans laquelle on pourra effectuer le 
changement désiré.
D'autres informations se trouvent dans le texte "Historique du presse-
papiers".

Exemple: {/CLIP.TXT.REMOVE.ASK}
Exemple: {/CLIP.TXT.REPLACE.ASK}


/CLIP.TXT.REMOVE.TXT ..: Supprime le texte <txt> du presse-papiers
/CLIP.TXT.REPLACE.TXT .: Remplace dans le presse-papiers le 1er texte 
------------------------ par le 2ème <txt>,<txt>

Exemple: {/CLIP.TXT.REMOVE.TXT abrév.: }

Dans ce scénario le texte "abrév. " sera supprimé du presse-papiers, et 
également par exemple "Abrév. ".

Exemple: {/CLIP.TXT.REPLACE.TXT example,Exemple}

Ce scénario remplace tous les mots "Example" par "Exemple".


/CLIP.TXT.SAVE file ...: Sauvegarde le texte contenu dans le presse-
------------------------ papiers dans un fichier-texte <file>

Exemple de scénario : 

1. Créez un bouton avec la commande : 
   {/CLIP.TXT.SAVE c:\mes documents\essai2.txt}
2. Copiez un texte dans le presse-papiers, puis cliquez sur le bouton.
3. Le fichier-texte "essai2" est créé dans C:\Mes documents avec le 
   contenu du presse-papiers.

On peut aussi utiliser cette commande en effaçant d'abord le contenu 
du presse-papiers avec /CLIP.CLEAR, puis en ajoutant du texte avec 
/CLIP.TXT.APPEND.


/CLIP.TXT.SEND ........: Colle le texte-ASCII (.txt) du presse-papiers
------------------------ dans une application-texte

Cette commande fonctionne comme le "coller" [Ctrl]+[v], même si celle-ci 
ne fonctionne pas. Elle peut être utilisée bien sûr en complément de la 
commande /CLIP.TXT.LOAD file (voir plus haut).

Exemple: bouton droit "Val2Wrd" du profil "Stock"


/CLIP.TXT.SET txt .....: Copie un texte <txt> dans le presse-papiers
------------------------

Exemple: {/CLIP.TXT.SET http://www.freewarehits.de}


/CLIP.TXT.TAB>SPC no ..: Convertit dans le presse-papiers les tabulations 
------------------------ en nb. <no> d'espaces

Exemple: {/CLIP.TXT.TAB>SPC 8}


/CLIP.TXT.TRIM ........: Enlève les Espaces et les Tabulations au début 
------------------------ et à la fin du texte dans le presse-papiers

Cette commande peut être très utile lorsqu'un texte mal formaté est copié
dans le presse-papiers, comme c'est souvent le cas avec des pages Web.

Exemple: bouton "es/re/ta." du profil "Stock"

--> Conseil
Pour corriger des pages Web mal formatées allez au site freewarehits.de 
pour télécharger le logiciel gratuit "Copy & Trim" qui fait partie d'un 
paquet de plus de 30 utilitaires appelé "ToolPackage".


/CLIP.TXT.VIEW ........: Affiche le contenu du presse-papiers (texte 
------------------------ seulement) dans l'Aperçu interne de texte

Exemple: bouton "aperçu" du profil "Stock"

