Retourne l’offset(la position) relatif d’une face du curseur d’insertion texte.

caret-to-offset face offset

face - La face qui contient le texte. (type: object!)

offset - L’offset dans le texte. (type: any-string!)

Cette fonction sert à convertir depuis une chaîne de caractère l’indice de la position pour une valeur offset X-Y à l’intérieur du texte de la face. C’est utilisé de façon primaire pour l’édition de texte ou pour les opérations de traçages telles que la création de texte colorié ou d’hyperlien.

    out: layout [
        bx: box 10x15 red
        tx: body 100x100
    ]
    tx/text: {This is an example character string.}
    xy: caret-to-offset tx at tx/text 14
    bx/offset: tx/offset + xy
    view out

Notez que pour l’offset résultant (xy) était ajouté à la position de la face (tx/offset) pour trouver la position correcte pour localiser la boîte (bx).

Dans l’example ci-dessus, la fonction caret-to-offset était utilisée sur une face qui n’avait pas déjà été affichée. mais il peut aussi être utilisé après qu’une face ait été affichée.

Souvenez vous que lorsqu’on fait un changement dans le contenu d’une chaîne de caractère qui est plus longue que 200 caractères, vous devez initialiser le texte de la face line-list à NONE pour forcer le recalcul de toutes les fins de lignes.

Voir la fonction offset-to-caret pour la conversion inverse.

Cette fonction peut aussi fonctionner sur des faces qui n’ont jamais été affichées. Ceci fait un processus de préaffichage pour la coloration du texte et la création d’hyperliens est possible en l’utilisant en conjonction avec SIZE-TEXT.

offset-to-caret - Positionne le curseur de saisie de texte dans une zone de texte à partir d’une position offset (xy).

http://www.rebol.com/docs/words/wcaret-to-offset.html