Tester presse papiers

version 6.0

Tester presse papiers (typeDonnées) Numérique

Tester presse papiers vous permet de savoir s'il y a des données du type typeDonnées dans le Presse-papiers.

ATTENTION : La valeur passée dans typeDonnées établit la distinction majuscules/minuscules, par exemple "abcd" n'est pas égal à "ABCD."

Si le Presse-papiers est vide ou ne contient pas de données du type spécifié, la fonction retourne une erreur -102 (référez-vous ci-dessous à la table des constantes). Si le Presse-papiers contient des données du type spécifié, la fonction retourne la taille des données exprimée en octets.

Après avoir vérifié que le Presse-papiers contient bien des données du type que vous voulez, vous pouvez les récupérer à l'aide d'une des commandes suivantes :

• Si le Presse-papiers contient du texte, vous pouvez l'extraire à l'aide de la commande Lire texte dans presse papiers, qui retourne une valeur texte. Sinon, vous pouvez utiliser la commande LIRE PRESSE PAPIERS, qui retourne le texte dans un BLOB.

• Si le Presse-papiers contient une image, vous pouvez l'extraire à l'aide de la commande LIRE IMAGE DANS PRESSE PAPIERS, qui retourne l'image dans un champ ou une variable. Sinon, vous pouvez utiliser la commande LIRE PRESSE PAPIERS, qui retourne l'image dans un BLOB.

• Pour tout type de données, vous pouvez utiliser la commande LIRE PRESSE PAPIERS, qui retourne les données dans un BLOB.

4e Dimension fournit les constantes suivantes :

(1) L'exemple suivant teste si le Presse-papiers contient une image et, si oui, la copie dans une variable 4D :

   Si (Tester presse papiers (Données image) > 0)  ` Y a-t-il une image dans le Presse-papiers ?
      LIRE IMAGE DANS PRESSE PAPIERS ($vPicVariable)  ` Si oui, extraire l'image du Presse-papiers
   Sinon
      ALERTE("Il n'y a pas d'image dans le Presse-papiers.")
   Fin de si

(2) Généralement, après un couper ou un copier, les applications placent des données de type Texte ou Image dans le Presse-papiers, ces deux types de données standard sont reconnus par la plupart des applications. Cependant, une application peut placer dans le Presse-papiers plusieurs copies des mêmes données sous des formats différents. Par exemple, chaque fois que vous copiez ou coupez un tableau, l'application tableur peut placer les données dans un format propriétaire — par exemple, 'SPSH' — ou dans les formats SYLK et TEXT. La copie 'SPSH' contient les données structurées dans le format interne de l'application. La copie SYLK contient les mêmes données, mais dans le format SYLK, reconnu par la plupart des tableurs. Enfin, la copie TEXT contient les mêmes données, mais sans les informations de formatage supplémentaires présentes dans les formats SYLK ou 'SPSH'. Donc, lorsque vous écrivez des routines de Couper/Copier/Coller entre 4e Dimension et une application tableur, en prenant l'hypothèse que vous connaissez la description du format 'SPSH' et que vous pouvez analyser les données SYLK, vous pouvez écrire le code suivant :

   Au cas ou
         ` D'abord, vérifier si le Presse-papiers contient les données venant du tableur 
      : (Tester presse papiers ('SPSH') > 0)
         ` ...
         ` Ensuite, vérifier si le Presse-papiers contient des données au format SYLK
      : (Tester presse papiers ('SYLK') > 0)
         ` ...
         ` Enfin, vérifier si le Presse-papiers contient des données au format TEXT
      : (Tester presse papiers ('TEXT') > 0)
         ` ...
   Fin de cas

Autrement dit, vous essayez d'extraire du Presse-papiers la copie des données la plus riche en informations originales.

(3) Référez-vous à l'exemple de la commande AJOUTER A PRESSE PAPIERS.

LIRE IMAGE DANS PRESSE PAPIERS, LIRE PRESSE PAPIERS, Lire texte dans presse papiers.