## Manipuler les cadres de texte

deleteText(...)
  `deleteText(["nom"])`

  Supprime le texte dans le cadre de texte "nom". S'il y a du texte sélectionné, seul ce texte sera supprimé. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getAllText(...)
  `getAllText(["nom"]) -> chaîne`

  Retourne le texte d'un cadre de texte "nom" et de tous les cadres de texte qui sont y liés. Si du texte est sélectionné dans ce cadre, il est retourné. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getColumnGap(...)
  `getColumnGap(["nom"]) -> réel`

  Retourne la taille de la gouttière de colonne dans le cadre de texte "nom", exprimée en points. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getColumns(...)
  `getColumns(["nom"]) -> nombre entier`

  Donne le nombre de colonnes du cadre de texte "nom". Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getFirstLineOffset(...)
  `getFirstLineOffset(["nom"]) -> nombre entier`

  Retourne l'offset de la première ligne de texte à l'intérieur du cadre de texte "nom". Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getFirstLinkedFrame(...)
  `getFirstLinkedFrame(["nom"]) -> chaîne`

  Retourne le premier cadre dans la chaîne de texte. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getFont(...)
  `getFont(["nom"]) -> chaîne`

  Retourne le nom de la police pour le cadre de texte "nom". Si ce cadre contient du texte sélectionné, la valeur assignée au premier caractère de la sélection est retournée. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getFontSize(...)
  `getFontSize(["nom"]) -> réel`

  Retourne la taille, en points, de la police du cadre de texte "nom". Si ce cadre contient du texte sélectionné, la valeur assignée au premier caractère de la sélection est retournée. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getFrameText(...)
  `getFrameText(["nom"]) -> chaîne`

  Retourne le texte visible dans le cadre de texte "nom". Si ce cadre de texte contient du texte sélectionné, celui-ci est retourné. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Cette fonction retourne uniquement le texte visible dans le cadre spécifié. Si vous souhaitez obtenir le texte contenu dans une chaîne de texte, veuillez utiliser getAllText() en lieu et place.

  Comme cette fonction nécessite que la mise en page du texte soit à jour, il est possible que vous ayez besoin d'appeler layoutText() ou layoutTextChain() au préalable afin d'obtenir le résultat attendu.

getLastLinkedFrame(...)
  `getLastLinkedFrame(["name"]) -> chaîne`

  Retourne le dernier cadre dans la chaîne de texte. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getLineSpacing(...)
  `getLineSpacing(["nom"]) -> réel`

  Retourne l'espacement de ligne ("leading") du cadre de texte "nom", exprimé en points. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getNextLinkedFrame(...)
  `getNextLinkedFrame(["nom"]) -> chaîne`

  Retourne le cadre suivant dans la chaîne de texte ou None si le cadre spécifié est le dernier dans la chaîne. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getPrevLinkedFrame(...)
  `getPrevLinkedFrame(["nom"]) -> chaîne`

  Retourne le cadre précédent dans la chaîne de texte ou None si le cadre spécifié est le premier dans la chaîne. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getText(...)
  `getText(["nom"]) -> chaîne`

  Obsolète. Veuillez utiliser getFrameText() en lieu et place.

getTextColor(...)
  `getTextColor(["nom"]) -> chaîne`

  Retourne le nom de la couleur de texte définie pour l'objet "nom". Si ce cadre contient du texte sélectionné, la valeur assignée au premier caractère de la sélection est retournée. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Peut générer WrongFrameTypeError si le cadre cible n'est pas un cadre de texte.

getTextLength(...)
  `getTextLength(["nom"]) -> nombre entier`

  Retourne la longueur du texte dans le cadre de texte "nom". Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

getTextLines(...)
  `getTextLines(["nom"]) -> integer`

  Retourne le nombre de lignes de texte présenté dans le cadre de texte "nom". Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Comme cette fonction nécessite que la mise en page du texte soit à jour, il est possible que vous ayez besoin d'appeler layoutText() ou layoutTextChain() au préalable afin d'obtenir le résultat attendu.

getTextShade(...)
  `getTextShade(["nom"]) -> nombre entier`

  Retourne la valeur de la teinte de couleur définie pour le texte de l'objet "nom". Si ce cadre contient du texte sélectionné, la valeur assignée au premier caractère de la sélection est retournée. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Peut générer WrongFrameTypeError si le cadre cible n'est pas un cadre de texte.

getTextVerticalAlignment(...)
  `getTextVerticalAlignment(["nom"]) -> nombre entier`

  Retourne l'alignement vertical utilisé pour le texte à l'intérieur de l'objet "nom". Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

insertText(...)
  `insertText("texte", pos, ["nom"])`

  Insère le "texte" à la position "pos" dans le cadre de texte. Le texte doit être encodé en UTF (voir setText() comme référence). Le premier caractère a un index de 0. Insérer du texte à la position -1 l'ajoute à la fin du cadre. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Pour des raisons de performance, cette fonction ne réalise aucune mise à jour de la mise en page du texte. En conséquence il est possible que vous deviez appeler layoutText() or layoutTextChain() après avoir appelé cette fonction et lorsque vous le jugez nécessaire préalablement à l'appel de fonctions telles que getFrameText() ou getTextLines().

  Peut générer IndexError dans le cas d'une insertion hors limites.

layoutText(...)
  `layoutText(["nom"])`

  Actualise la mise en page du texte dans le cadre de texte "nom". Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

layoutTextChain(...)
  `layoutTextChain(["nom"])`

  Actualise la mise en page du texte pour l'intégralité de la chaîne de texte à laquelle le cadre de texte "nom" appartient. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

linkTextFrames(...)
  `linkTextFrames("nomDepart", "nomArrivee")`

  Établit un lien entre deux cadres de texte. Le cadre nommé "nomDepart" est lié au cadre "nomArrivee". Le cadre source ne doit pas déja porter un lien vers un cadre de texte suivant. Le cadre cible ne doit pas porter de lien provenant d'autres cadres.

  Peut générer ScribusException en cas d'infraction des règles de liens.

selectFrameText(...)
  `selectFrameText(depart, compte, ["nom"])`

  Sélectionne le nombre ("compte") de caractères de texte dans le cadre de texte "nom" en partant du caractère "départ". Le décompte des caractères commence à 0. Si "compte" est égal à zéro, tout le texte sera effacé. Si "compte" est égal à -1, la sélection s'étendra jusqu'au dernier charactère du cadre. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Cette fonction agit uniquement sur le texte visible dans le cadre spécifié. Si vous avez besoin de travailler sur le texte contenu dans une chaîne de texte, veuillez utiliser selectText() à la place.

  Comme cette fonction nécessite que la mise en page du texte soit à jour, il est possible que vous ayez besoin d'appeler layoutText() ou layoutTextChain() au préalable afin d'obtenir le résultat attendu.

  Peut générer IndexError si la sélection dépasse les limites du texte.

selectText(...)
  `selectText(depart, compte, ["nom"])`

  Sélectionne le nombre ("compte") de caractères de texte dans le cadre de texte "nom" en partant du caractère "départ". Le décompte des caractères commence à 0. Si "compte" est égal à zéro, tout le texte sera effacé. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Peut générer IndexError si la sélection dépasse les limites du texte.

setColumns(...)
  `setColumns(nr, ["nom"])`

  Définit le nombre de colonnes du cadre de texte "nom" à la valeur entière "nr". Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Peut générer ValueError si le nombre de colonnes n'est pas au moins égal à un.

setColumnGap(...)
  `setColumnGap(taille, ["nom"])`

  Définit la gouttière de colonne du cadre de texte "nom" à la valeur "taille". Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Peut générer ValueError si la gouttière de colonne est hors limites (elle doit être positive).

setFirstLineOffset(...)
  `setFirstLineOffset(offset, ["nom"])`

  Définit l'offset de la première ligne de texte du cadre de texte "nom" à la valeur spécifiée. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé. La valeur "offset" doit être une des constantes FLOP_* définies dans ce module - voir dir(scribus).

  Peut générer ValueError si la constante d'offset n'est pas valide.

setFont(...)
  `setFont("police", ["nom"])`

  Assigne la police du cadre de texte "nom" à la "police". S'il y a du texte sélectionné, seul ce texte sera modifié. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Peut générer ValueError si la police est introuvable.

setFontSize(...)
  `setFontSize(taille, ["nom"])`

  Définit la taille de police du cadre de texte "nom" à la valeur "taille". La "taille" est traitée comme une valeur en points. S'il y a du texte sélectionné, seul ce texte sera modifié. La "taille" doit être réglée entre 1 et 512. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Peut générer ValueError pour une taille de police qui est hors limites.

setLineSpacing(...)
  `setLineSpacing(taille, ["nom"])`

  Définit l'interlignage ("leading") du cadre de texte "nom" à la valeur "taille". La "taille" est une valeur en points. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

  Peut générer ValueError si l'interlignage est hors limites.

setText(...)
  `setText("texte", ["nom"])`

  Définit le contenu du cadre de texte "nom" à la chaîne "texte". Le texte doit être encodé en UTF8 - utilisez par exemple unicode(texte, 'iso-8859-2'). Voir les FAQ pour plus de détails. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

setTextAlignment(...)
  `setTextAlignment(alignement, ["nom"])`

  Définit l'alignement du contenu du cadre de texte "nom" à la valeur spécifiée. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé. La valeur "alignement" doit être une des constantes ALIGN_ définies dans ce module - voir dir(scribus).

  Peut générer ValueError si la constante d'alignement n'est pas valide.

setTextColor(...)
  `setTextColor("couleur", ["nom"])`

  Définit la "couleur" du contenu du cadre de texte "nom". S'il y a du texte sélectionné, seul ce texte sera modifié. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

setTextShade(...)
  `setTextShade(teinte, ["nom"])`

  Définit la valeur "teinte" de la couleur du texte de l'objet "nom". S'il y a du texte sélectionné, seul ce texte sera modifié. La valeur "teinte" doit être un nombre entier compris entre 0 (pâle) et 100 (intensité maximale). Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

setTextStroke(...)
  `setTextStroke("couleur", ["nom"])`

  Définit la "couleur" du contour des caractères. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

setTextVerticalAlignment(...)
  `setTextVerticalAlignment(alignement, ["nom"])`

  Définit l'alignement vertical du contenu du cadre de texte "nom" à la valeur spécifiée. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé. La valeur "alignement" doit être une des constantes ALIGNV_ définies dans ce module - voir dir(scribus).

  Peut générer ValueError si la constante d'alignement n'est pas valide.

textOverflows(...)
  `textOverflows(["nom", sansLiens]) -> nombre entier`

  Retourne 1 en cas de présence de caractères en surplus dans le cadre de texte "nom", 0 sinon. Si sansLiens est une valeur non nulle, il prend seulement un cadre - il n'utilise pas les liens de cadre. Sans ce paramètre, il cherche toute les chaînes liées.

  Peut générer WrongFrameTypeError si le cadre cible n'est pas un cadre de texte.

unlinkTextFrames(...)
  `unlinkTextFrames("nom")`

  Retire l'objet désigné de la séquence de liens du cadre de texte. Si le cadre se trouvait au milieu d'une chaîne de liens, les cadres précédent et suivant seront connectés, par exemple 'a->b->c' devient 'a->c' lorsque vous déconnectez unlinkTextFrames(b)'

  Peut générer ScribusException en cas d'infraction des règles de liens.