selection

 

selection - Manipule la sélection X


SYNTAXE

 selection option ?arg arg ...?

DESCRIPTION


cette commande fournit une interface Tcl au mécanisme de sélection X et implémente la fonctionnalité de sélection complète décrite dans le X Inter-Client Communication Conventions Manual (ICCCM).

Notez que pour la gestion de la sélection CLIPBOARD (voir ci-dessous), la commande clipboard peut être également utilisée.

Le premier argument à selection détermine le format du reste des arguments et le comportement de la commande. Les formes suivantes sont actuellement supportées:

selection clear ?-displayof fenêtre? ?-selection sélection? Efface selection partout où elle existe sur l'écran de fenêtre, ainsi aucune fenêtre ne pourra plus la revendiquer. Selection indique la sélection X qui doit être effacée, et doit être un nom d'atome comme PRIMARY ou CLIPBOARD; voir le Inter-Client Communication Conventions Manual pour des détails complets. Selection est par défaut de PRIMARY et fenêtre est par défaut de ``.''. Retourne une chaîne vide.

sélection get ?-displayof fenêtre? ?-sélection sélection? ?-type type? Lit la valeur de selection dans l'écran de fenêtre et la retourne comme résultat. Selection est par défaut de PRIMARY et fenêtre est par défaut de ``.. Type indique la forme sous laquelle la sélection sera retournée (la ``cible désirée pour la conversion, en terminologie ICCCM), et doit être un nom d'atome comme STRING ou FILE_NAME ; voir le Inter-Client Communication Conventions Manual pour des détails complets. Type est par défaut de STRING. Le propriétaire de la sélection devra choisir de retourner la sélection sous une des plusieurs différent formats de représentation, comme STRING, ATOM, INTEGER, etc. (cette forme est différente du type de la sélection ; voir le ICCCM pour les confusing détails). Si la sélection est retournée sous un format non-chaîne, comme INTEGER ou ATOM, la commande selection le convertit en format chaîne comme une collection de champs séparés par des espaces: les atomes sont convertis en leurs noms textuels, et tous le reste est converti en entiers hexadécimaux.

selection handle ?-selection sélection? ?-type type? ?-format format? fenêtre commande Crée un gestionnaire pour les requêtes de sélection, tel que commande sera exécutée chaque fois que sélection est possédée par fenêtre et que quelqu'un tente de la récupérer sous la forme indiquée par type (ex. type est spécifié dans la commande sélection get). Selection est par défaut de PRIMARY, type est par défaut de STRING, et format est par défaut de STRING. Si commande est une chaîne vide alors tout gestionnaire existant pour fenêtre, type, et sélection est enlevé.

Quand sélection est demandée, fenêtre est le propriétaire de la sélection, et type est le type demandé, commande sera exécutée comme une commande Tcl avec deux nombres supplémentaires ajoutés (avec des espaces comme séparateurs). Les deux nombres supplémentaires sont offset et maxChars: offset indique la position du premier caractère de la sélection et maxChars donne le nombre maximum de caractères à lire. La commande doit retourner aune valeur consistant en au plus maxChars de la sélection, commençant à la position offset. Pour les très grandes sélections (plus grandes que maxChars) la sélection sera lue en utilisant plusieurs appels de commande avec des valeurs offset croissantes. Si commande retourne une chaîne dont la longueur est inférieure à maxChars, la valeur de retour est supposée inclure tous le reste de la sélection; si la longueur du resultat de commande est égale à maxChars alors commande sera appelée encore, jusqu'à ce qu'elle retourne éventuellement un resultat plus court que maxChars. La valeur de maxChars sera toujours relativement élevée (des milliers de caractères).

Si commande retourne une erreur alors la lecture de la sélection est rejetée comme si la sélection n'existait plus.

L'argument format indique la représentation qui doit être utilisée pour transmettre la sélection au demandeur (la seconde colonne de la Table 2 de l'ICCCM), et est par défaut de STRING. Si format est STRING, la sélection est transmise comme des caractères 8-bit ASCII (c.a.d. comme sous la forme retournée par commande). Si format est ATOM, alors la valeur de retour de commande est divisée en champs séparés par des espaces; chaque champ est converti en sa valeur atomique, et la valeur 32-bit de l'atome est transmise à la place du nom de l'atome. Pour tout autre format, la valeur de retour de commande est divisées en champs séparés par des espaces et chaque champ est converti en un entier 32-bit; un tableau d'entiers est transmis au demandeur de la sélection.

L'argument format est seulement requis par compatibilité avec les demandeur de sélection qui n'utilisent pas Tk. Si Tk est utilisé pour lire la sélection alors la valeur est convertie en une chaîne à l'extrémité demandeuse, et format est hors sujet.

selection own ?-displayof fenêtre? ?-selection sélection?

selection own ?-commande commande? ?-selection sélection? fenêtre La première forme de sélection own retourne le nom de chemin de la fenêtre de l'application qui possède sélection à l'écran contenant fenêtre, ou une chaîne vide si aucune fenêtre de cette application ne possède la sélection. Selection est par défaut de PRIMARY et fenêtre est par défaut de ``.''.

La seconde forme de selection own donne à fenêtre la propriété de selection sur l'écran de fenêtre's , retournant une chaîne vide comme résultat. Le propriétaire, s'il existe, est notifié qu'il a perdu la sélection. Si commande est spécifiée, c'est un script Tcl à exécuter quand une autre fenêtre réclame la propriété de la sélection. Selection est par défaut de PRIMARY.


VOIR ÉGALEMENT

clipboard


Copyright © 1990 The Regents of the UniverJL


Catégorie Manuel Tcl/Tk