## Python : module scribus

# Module d'interface Python de Scribus

Ce module est l'interface Python de Scribus. Il intègre des fonctions pour contrôler Scribus et manipuler les objets sur le canevas. Chaque fonction est décrite séparément ci-dessous. Il existe quelques éléments qu'on retrouve dans la plupart des zones de l'interface. La majorité des fonctions opèrent sur des cadres. Ces cadres sont identifiés par leur nom (une chaîne) - ils ne sont pas de vrais objets Python. Beaucoup de fonctions acceptent un paramètre optionnel (autre qu'un mot clé), c'est-à-dire un nom de cadre. La plupart des fonctions prévoient aussi de nombreuses exceptions. Celles-ci ne sont pas documentées, pour le moment, dans le docstring de chacune des fonctions.

- Beaucoup de fonctions génèrent une erreur NoDocOpenError si vous essayez de les utiliser sans un document à traiter.
- Si vous ne passez pas un nom de cadre à une fonction qui en réclame un, cette fonction utilisera le cadre sélectionné, s'il y en a un, ou générera une erreur NoValidObjectError si elle ne trouve aucun élément à traiter.
- Beaucoup de fonctions généreront une erreur WrongFrameTypeError si vous essayez de les utiliser dans un type de cadre qu'elles ne peuvent interpréter. Par exemple, l'application d'une couleur de texte dans un cadre de graphiques produira cette exception.
- Les erreurs résultant d'appels aux librairies sous-jacentes de l'API de Python seront passées sans subir de modifications. Ainsi, la liste des exceptions générées par les fonctions qui est fournie ici et dans leur docstring est incomplète.

La documentation des fonctions détaille chaque exception pouvant être générée en cours d'utilisation.

### Modules

#### Classes

- exceptions.Exception
  - ScribusException
  - NameExistsError
  - NoDocOpenError
  - NoValidObjectError
  - NotFoundError
  - WrongFrameTypeError

class NameExistsError(ScribusException)
Ordre de résolution des méthodes : NameExistsError ScribusException exceptions.Exception
Méthodes héritées de exceptions.Exception: __getitem__(...) __init__(...) __str__(...)

class NoDocOpenError(ScribusException)
Ordre de résolution des méthodes : NoDocOpenError ScribusException exceptions.Exception
Méthodes héritées de exceptions.Exception : __getitem__(...) __init__(...) __str__(...)

class NoValidObjectError(ScribusException)
Ordre de résolution des méthodes : NoValidObjectError ScribusException exceptions.Exception
Méthodes héritées de exceptions.Exception : __getitem__(...) __init__(...) __str__(...)

class NotFoundError(ScribusException)
Ordre de résolution des méthodes : NotFoundError ScribusException exceptions.Exception
Méthodes héritées de exceptions.Exception : __getitem__(...) __init__(...) __str__(...)

class ScribusException(exceptions.Exception)
Méthodes héritées de exceptions.Exception : __getitem__(...) __init__(...) __str__(...)

class WrongFrameTypeError(ScribusException)
Ordre de résolution des méthodes : WrongFrameTypeError ScribusException exceptions.Exception
Méthodes héritées de exceptions.Exception : __getitem__(...) __init__(...) __str__(...)

### Fonctions

changeColor(...)
  `changeColor("nom", c, m, j, n)
  Change la couleur "nom" pour la valeur CMJN spécifiée. La valeur de la couleur est définie par quatre composants c = Cyan, m = Magenta, j = Jaune et n = Noir. Ces composants de couleur doivent se situer entre 0 et 255.
  Peut générer NotFoundError si la couleur nommée n'est pas trouvée.
  Peut générer ValueError si le nom de couleur spécifié n'est pas valide.`
closeDoc(...)
  `closeDoc()
  Ferme le document courant sans invite de sauvegarde.
  Peut générer NoDocOpenError s'il n'y a pas de document à fermer`
createBezierLine(...)
  `createBezierLine(liste, ["nom"]) -> chaîne
  Crée une nouvelle courbe de Bézier et retourne son nom. Les points de la courbe de Bézier sont conservés dans la liste ("list") dans l'ordre suivant :
  [x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn]
  Dans la liste de points, x et y sont les coordonnées x et y du point et kx et ky représentent le point de contrôle de la courbe. Les coordonnées s'affichent dans les unités de mesure du document (voir les constantes UNIT). Le nom ("name") doit être un identifiant unique pour l'objet, car vous en aurez besoin accéder plus tard à cet objet. Si le nom "name" n'est pas fourni, Scribus en créera un pour vous.
  Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.
  Peut générer ValueError si le nombre de points précisé est insuffisant ou si le nombre de valeurs passées ne forme pas un groupe de points entier, sans reste.`
createEllipse(...)
  <`createEllipse(x, y, largeur, hauteur, ["nom"]) -> chaîne
  Crée une nouvelle ellipse dans la page courante et retourne son nom. Les coordonnées sont affichées dans les unités de mesure du document (voir les constantes UNIT). Le "name" doit être un identifiant unique parce que vous en aurez besoin pour des références futures à l'objet désigné. Si le "name" n'est pas fourni, Scribus en créera un pour vous.
  Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.`
createImage(...)
  `createImage(x, y, largeur, hauteur, ["nom"]) -> chaîne
  Crée un nouveau cadre d'image dans la page courante et retourne son nom. Les coordonnées sont affichées dans les unités de mesure du document. La valeur de "name" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à l'objet désigné. Si le "name" n'est pas fourni, Scribus en créera un pour vous.
  Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.`
createLayer(...)
  `createLayer("nom")
  Crée un nouveau calque portant le nom précisé.
  Peut générer ValueError si le nom du calque n'est pas admis.`
createLine(...)
  `createLine(x1, y1, x2, y2, ["nom"]) -> chaîne
  Crée une nouvelle ligne à partir du point(x1, y1) et du point(x2, y2) et retourne son nom. Les coordonnées sont affichées dans les unités de mesure du document (voir les constantes UNIT). La valeur de "name" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à l'objet désigné. Si le "name" n'est pas fourni, Scribus en créera un pour vous.
  Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.`
createPathText(...)
  `createPathText(x, y, "boiteTexte", "courbeBezier", ["nom"]) -> chaîne
  Crée un nouveau pathText en combinant les deux objets "boîte de texte" et "courbe de Bézier", puis retourne son nom. Les coordonnées sont affichées dans les unités de mesure du document (voir les constantes UNIT). La valeur de "name" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à l'objet désigné. Si le "name" n'est pas fourni, Scribus en créera un pour vous.
  Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.
  Peut générer NotFoundError si l'un des objets de base (ou les deux) n'existent pas.`
createPolyLine(...)
  `createPolyLine(liste, ["nom"]) -> chaîne
  Crée un nouveau polyline et retourne son nom. Les points de l'élément polyline sont conservés dans la "liste", dans l'ordre suivant : [x1, y1, x2, y2...xn. yn]. Les coordonnées s'affichent dans les unités de mesure du document (voir les constantes UNIT). Le nom ("name") doit être un identifiant unique pour l'objet, car vous en aurez besoin accéder plus tard à cet objet. Si le nom "name" n'est pas fourni, Scribus en créera un pour vous.
  Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.
  Peut générer ValueError si le nombre de points précisé est insuffisant ou si le nombre de valeurs passées ne forme pas un groupe de points entier, sans reste.`
createPolygon(...)
  `createPolygon(liste, ["nom"]) -> chaîne
  Crée un nouveau polygone et retourne son nom. Les points du polygone sont conservés dans la "liste", dans l'ordre suivant: [x1, y1, x2, y2...xn. yn]. Au moins trois points sont requis. Il n'est pas nécessaire de répéter le premier point pour fermer le polygone. Le polygone se ferme automatiquement avec la connexion du premier et du dernier point. Les coordonnées sont données dans les unités de mesure du document (voir les constantes UNIT). La valeur de "name" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à l'objet désigné. Si le "name" n'est pas fourni, Scribus en créera un pour vous.
  Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.
  Peut générer ValueError si le nombre de points est insuffisant ou si
  le nombre de valeurs passées ne forme pas un groupe de points sans reste.`
createRect(...)
  `createRect(x, y, largeur, hauteur, ["nom"]) -> chaîne
  Crée un nouveau rectangle dans la page courante et retourne son nom. Les coordonnées sont données dans les unités de mesure du document (voir les constantes UNIT). Le "name" doit être un identifiant unique parce que vous en aurez besoin pour des références futures à l'objet désigné. Si le nom "name" n'est pas fourni, Scribus en créera un pour vous.
  Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.`
createText(...)
  `createText(x, y, largeur, hauteur, ["nom"]) -> chaîne
  Crée un nouveau cadre de texte dans la page courante et retourne son nom. Les coordonnées sont données dans les unités de mesure du document (voir les constantes UNIT). La valeur de "name" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à l'objet désigné. Si le "name" n'est pas fourni, Scribus en créera un pour vous.
  Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.`
currentPage(...)
  `currentPage() -> nombre entier
  Retourne le numéro de la page de travail courante. Les numéros de page sont incrémentés à partir de 1, peu importe quel est le premier numéro de page affiché dans votre document.`
defineColor(...)
  `defineColor("nom", c, m, j, n)
  Définit une nouvelle couleur "nom". La valeur de la couleur est définie par quatre composants :
  c = Cyan, m = Magenta, j = Jaune et n = Noir. Les composants de la couleur doivent se situer entre 0 et 255.
  Peut générer ValueError si le nom de couleur spécifié n'est pas valide.`
deleteColor(...)
  `deleteColor("nom", "remplacement")
  Supprime la couleur "nom". Chaque occurrence de cette couleur est remplacée par la couleur dite de "remplacement". Si elle n'est pas spécifiée, "remplacement" prendra par défaut la valeur "none" - transparente.
  deleteColor s'applique au document par défaut s'il n'y a pas de document ouvert. Dans ce cas, le "remplacement", si spécifié, n'a pas d'effet.
  Peut générer NotFoundError si la couleur nommée n'est pas trouvée.
  Peut générer ValueError si le nom de couleur spécifié n'est pas valide.`
deleteLayer(...)
  `deleteLayer("calque")
  Supprime le calque portant le nom "calque". Sans effet si le calque n'existe pas ou s'il n'y a qu'un seul calque dans le document.
  Peut générer NotFoundError si le calque est introuvable.
  Peut générer ValueError si le nom du calque n'est pas admis.`
deleteObject(...)
  `deleteObject(["nom"])
  Supprime l'élément portant le nom "nom". Si le "nom" n'est pas fourni, l'élément courant est supprimé.`
deletePage(...)
  `deletePage(nr)
  Supprime la page donnée. Sans effet si le document contient seulement une page. Les numéros de page sont incrémentés à partir de 1, peu importe le premier numéro de page affiché dans votre document.
  Peut générer IndexError si le numéro de page est hors limites`
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 le "nom" n'est pas fourni, l'élément sélectionné courant est utilisé.`
deselectAll(...)
  `deselectAll()
  Désélectionne tous les objets du document au complet.`
docChanged(...)
  `docChanged(bool)
  Active/désactive l'icône enregistrer dans la barre d'icônes de Scribus et dans l'élément de menu Enregistrer. Il est utile d'appeler cette procédure lorsque vous changez de document, parce que Scribus ne remarquera pas automatiquement un changement de document en utilisant un script.`
fileDialog(...)
  `fileDialog("titre", ["filtre", "nomDefaut" ,possedeApercu, estEnregistrer]) -> chaîne associée au nom du fichier
  Affiche une boîte de dialogue Ouvrir un fichier portant le titre "titre". Les fichiers sont filtrés par la chaîne "filtre". Vous pouvez aussi donner un nom de fichier ou un chemin par défaut, mais laissez cette chaîne vide lorsque vous ne voulez pas l'utiliser. Une valeur True pour possedeApercu déclenche l'affichage d'une vue réduire dans la boîte FileSelect. Quand le paramètre estEnregistrer est mis à True, le dialogue se comporte comme un dialogue "Enregistrer sous", sinon il se comporte comme un dialogue "Ouvrir". La valeur par défaut de ces deux paramètres optionnels est False.
  Le filtre, si spécifié, prend la forme 'commentaire (*.type *.type2 ...)'.
  Par exemple 'Images (*.png *.xpm *.jpg)'.
  Reportez-vous à la documentation de QFileDialog dans Qt pour plus de détails sur les filtres.
  Exemple : fileDialog('Ouvrir', 'CSV files (*.csv)')
  Exemple : fileDialog('Enregistrer le rapport', nomdefaut='report.txt', estenregistrer=True)`
getActiveLayer(...)
  c`getActiveLayer() -> chaîne
  Retourne le nom du calque actif courant.`
getAllObjects(...)
  `getAllObjects() -> liste
  Retourne une liste contenant les noms de tous les objets de la page courante.`
getAllStyles(...)
  `getAllStyles() -> liste
  Retourne une liste des noms de tous les styles de paragraphe du document courant.`
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é.`
getColor(...)
  `getColor("nom") -> vecteur
  Retourne un vecteur (C, M, J, N) contenant les quatre composants de la couleur "nom" du document courant. Si aucun document n'est ouvert, retourne la valeur de la couleur nommée à partir des couleur du document par défaut.
  Peut générer NotFoundError si la couleur nommée est introuvable.
  Peut générer ValueError si le nom de couleur spécifié n'est pas valide.`
getColorAsRGB(...)
  `getColorAsRGB("nom") -> vecteur`

  Retourne un vecteur (R,V,B) contenant les trois composantes de la couleur "nom" du document courant, converties à l'espace de couleur RVB. Si aucun document n'est ouvert, retourne la valeur de la couleur nommée à partir des couleur du document par défaut.

  Peut générer NotFoundError si la couleur nommée est introuvable. Peut générer ValueError si le nom de couleur spécifié n'est pas valide.

getColorNames(...)
  `getColorNames() -> liste
  Retourne une liste contenant les noms de toutes les couleurs définies dans le document. Si aucun document n'est ouvert, retourne une liste des couleurs du document par défaut.`
getColumnGap(...)
  `getColumnGap(["nom"]) -> réel
  Retourne la taille de la gouttière de colonne dans le cadre de texte "nom", exprimé 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é.`
getCornerRadius(...)
  `getCornerRadius(["nom"]) -> nombre entier
  Retourne le rayon du coin de l'objet "nom". Le rayon est exprimé en points. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getFillColor(...)
  `getFillColor(["nom"]) -> chaîne
  Retourne le nom de la couleur d'accompagnement de l'objet "nom". Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getFillShade(...)
  `getFillShade(["nom"]) -> entier
  Retourne la valeur de la teinte de la couleur d'accompagnement de l'objet "nom". Si "nom" n'est pas fourni, l'élément sélectionné courant est utilisé.`
getFont(...)
  `getFont(["nom"]) -> chaîne
  Retourne le nom la police pour le cadre de texte "nom". Si le cadre contient du texte sélectionné, la valeur assignée au premier caractère de la sélection est retourné. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getFontNames(...)
  `getFontNames() -> liste
  Retourne une liste contenant les noms de toutes les polices disponibles.`
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 le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getGuiLanguage(...)
  `getGuiLanguage() -> chaîne
  Retourne une contenant la valeur de -lang.`
getHGuides(...)
  `getHGuides() -> liste
  Retourne une liste contenant les positions des guides horizontaux. Les valeurs sont affichées dans les unités courantes du document - voir les constantes UNIT_<type>.`
getImageFile(...)
  `getImageName(["nom"]) -> chaîne
  Retourne le nom de fichier de l'image du cadre d'image. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getImageScale(...)
  `getImageScale(["nom"]) -> (x,y)
  Retourne un vecteur (x, y) contenant les valeurs de redimensionnement du cadre d'image "nom". Si "nom" n'est pas fourni, l'élément sélectionné courant est utilisé.`
getLayers(...)
  `getLayers() -> liste
  Retourne une liste contenant les noms de tous les calques définis.`
getLineCap(...)
  `getLineEnd(["nom"]) -> nombre entier (voir les constantes)
  Retourne le style de bout de ligne de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé. Les styles de bout de ligne sont :
  CAP_FLAT, CAP_ROUND, CAP_SQUARE`
getLineColor(...)
  `getLineColor(["nom"]) -> chaîne
  Retourne le nom de la couleur de filet de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getLineJoin(...)
  `getLineJoin(["nom"]) -> nombre entier (voir les constantes)
  Retourne le style de jointure de filet de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé. Les types de jointure sont :
  JOIN_BEVEL, JOIN_MITTER, JOIN_ROUND`
getLineShade(...)
  `getLineShade(["nom"]) -> entier
  Retourne la valeur de la teinte de la couleur de filet de l'objet "nom". Si le "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 le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getLineStyle(...)
  `getLineStyle(["nom"]) -> nombre entier (voir les constantes)
  Retourne le style de filet de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé. Les constantes de style de filet sont :
  LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID`
getLineWidth(...)
  `getLineWidth(["nom"]) -> nombre entier
  Retourne la largeur de filet de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getPageItems(...)
  `getPageItems() -> liste
  Retourne une liste de vecteurs contenant les éléments de la page courante. Le vecteur est :
  (nom, typeObjet, ordre), par exemple [('Texte1', 4, 0), ('Image1', 2, 1)]
  signifie que l'objet nommé 'Texte1' est un cadre de texte (type 4) et est le premier dans
  la page...`
getPageMargins(...)
  `getPageMargins()
  Retourne les marges de la page sous la forme d'un vecteur (gauche, droite, haut, bas) dans les unités courantes. Voir les constantes UNIT_<type> et getPageSize().`
getPageSize(...)
  `getPageSize() -> vecteur
  Retourne un vecteur contenant les dimensions de la page exprimées dans les unités courantes du document.
  Voir les constantes UNIT_<type> et getPageMargins()`
getPosition(...)
  `getPosition(["nom"]) -> (x,y)
  Retourne un vecteur (x, y) indiquant la position de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionnéest utilisé. La position est exprimée dans les unités de mesure courantes du document - voir UNIT_<type> pour référence.`
getRotation(...)
  `getRotation(["nom"]) -> nombre entier
  Retourne la rotation de l'objet "nom". La valeur est exprimée en degrés, et le sens des aiguilles d'une montre correspond au sens positif. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getSelectedObject(...)
  `getSelectedObject([nr]) -> chaîne
  Retourne le nom de l'objet sélectionné. "nr", s'il est fourni, indique le numéro de l'objet sélectionné, par exemple 0 signifie le premier objet sélectionné, 1, le second objet sélectionné et ainsi de suite.`
getSize(...)
  `getSize(["nom"]) -> (largeur,hauteur)
  Retourne un vecteur (largeur, hauteur) décrivant la taille de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionnéest utilisé. La taille est exprimée dans les unités de mesure courantes du document - voir UNIT_<type> pour référence.`
getText(...)
  `getText(["nom"]) -> chaîne
  Retourne le texte du cadre de texte "nom". Si ce cadre de texte contient du texte sélectionné, celui-ci est retourné. Tout le texte présent dans le cadre, et non seulement le texte visible, est retourné. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getTextColor(...)
  `getLineColor(["nom"]) -> chaîne
  Retourne le nom de la couleur de filet de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getTextLength(...)
  `getTextLength(["nom"]) -> nombre entier
  Retourne la longueur du texte dans le cadre de texte "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getTextShade(...)
  `getLineShade(["nom"]) -> nombre entier
  Retourne la valeur de la teinte de la couleur de filet de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
getUnit(...)
  `getUnit() -> nombre entier (constante d'unité de Scribus)
  Retourne les unités de mesure du document. La valeur retournée sera une des constantes UNIT_* constants :
  UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.`
getVGuides(...)
  `getVGuides()
  Voir getHGuides.`
getXFontNames(...)
  `getXFontNames() -> liste de vecteurs
  Retourne une information détaillée sur la police. Il s'agit d'une liste de vecteurs :
  [ (nom Scribus, Famille, Nom réel, sous-ensemble (1|0), PS inclus PS (1|0), fichier de police), (...), ... ]`
getval(...)
  `Interne à Scribus.`
gotoPage(...)
  `gotoPage(nr)
  Déplace à la page "nr" (la page courante devient "nr"). Notez que gotoPage ne modifie pas (actuellement) la page affichée dans la vue de l'utilisateur; ce paramètre établit simplement la page sur laquelle les commandes du script opéreront.
  Peut générer IndexError si le numéro de page est hors limites.`
groupObjects(...)
  `groupObjects(liste)
  Groupe les objets énumérés dans "liste". La "liste" doit contenir les noms des objets à grouper. Si la "liste" n'est pas fournie, les éléments sélectionnés sont utilisés.`
haveDoc(...)
  `haveDoc() -> booléen
  Retourne la valeur "true" s'il y a un document ouvert.`
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. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.
  Peut générer IndexError dans le cas d'une insertion hors limites.`
isLayerPrintable(...)
  `isLayerPrintable("calque") -> booléen
  Indique si le "calque" est imprimable ou non; une valeur True signifie que le "calque" peut être imprimé et une valeur False, que l'impression est désactivée.
  Peut générer NotFoundError si le calque est introuvable.
  Peut générer ValueError si le nom du calque n'est pas valide.`
isLayerVisible(...)
  `isLayerPrintable("calque") -> booléen
  Indique si le "calque" est visible ou non; une valeur True signifie que le "calque" est visible, une valeur False signifie que le "calque" est invisible.
  Peut générer NotFoundError si le calque est introuvable.
  Peut générer ValueError si le nom du calque n'est pas valide.`
isLocked(...)
  `isLocked(["nom"]) -> booléen
  Retourne la valeur True si l'objet "nom" est vérouillé. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
isPDFBookmark(...)
  `isPDFBookmark(["nom"]) -> booléen`

  Retourne la valeur True si le cadre de texte "nom" est un signet PDF. Si le "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.

linkTextFrames(...)
  `linkTextFrames("nomDepart", "nomArrivee")
  Établit un lien entre deux cadres de texte. Le cadre nommé "nomDepart" est lié au cadre "nomArrivee". Le cadre cible doit être un cadre de texte vide et ne doit pas pointer vers d'autres cadres ni porter un lien provenant d'autres cadres.
  Peut générer ScribusException en cas d'infraction des règles de liens.`
loadImage(...)
  `loadImage("nomFichier" [, "nom"])
  Charge l'image "nomFichier" dans le cadre d'image "nom". 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 d'image`
loadStylesFromFile(...)
  `loadStylesFromFile("nomFichier")
  Charge des styles de paragraphe à partir du document Scribus "nomFichier" dans le document courant.`
lockObject(...)
  `lockObject(["nom"]) -> booléen
  Verrouille l'objet "nom" s'il est déverrouillé, ou le déverrouille s'il y a lieu. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé. Retourne la valeur True si verrouillé.`
messageBox(...)
  `messageBox("titre", "message", icone=ICON_NONE, bouton1=BUTTON_OK|BUTTONOPT_DEFAULT, bouton2=BUTTON_NONE, bouton3=BUTTON_NONE) -> nombre entier
  Affiche une boîte de message contenant le "titre", le message "message", une icône "icone" et jusqu'à 3 boutons. Par défaut, aucune icône n'est utilisée et un seul bouton, OK, est affiché. Seuls les arguments titre et message sont requis, mais on recommande de définir une icône et un ou plusieurs boutons appropriés. Le message texte peut contenir des marqueurs de type HTML simples.
  Retourne le numéro du bouton que l'utilisateur a enfoncé. Les numéros de boutons commencent à 1.
  Pour les paramètres d'icône et de bouton, certaines constantes prédéfinies sont disponibles et portent les mêmes noms que dans la documentation Qt. Ce sont les constantes BUTTON_* et ICON_* définies dans ce module. Il y a également deux constantes supplémentaires qui peuvent être combinées par un OU aux constantes de bouton :
  BUTTONOPT_DEFAULT Appuyer sur Entrée enfonce ce bouton.
  BUTTONOPT_ESCAPE Appuyer sur Esc enrfonce ce bouton.
  Exemples d'utilisation :
  result = messageBox('Le script a échoué',
  'Ce script fonctionne seulement lorsqu'un cadre de texte est sélectionné.',
  ICON_ERROR)
  result = messageBox('Singes!'Qu'est-ce qui fait ook?<i>C'est le singe?</i>',
  ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
  BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
  Constantes de bouton et d'icône définies :
  BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
  BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
  ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.`
messagebarText(...)
  `messagebarText("chaîne")
  Écrit "chaîne" dans la barre de message de Scribus (ligne d'état). Le texte
  doit être encodé en une chaîne UTF8 ou en une chaîne 'unicode' (recommandé).`

moveObject(...)
  `moveObject(dx, dy [, "nom"])
  Déplace l'objet "nom" de dx et dy par rapport à sa position courante. Les
  distances sont exprimées dans les unités de mesure courantes du document (voir
  les constantes UNIT). Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.
  Si l'objet "nom" appartient à un groupe, tout le groupe est déplacé.`
moveObjectAbs(...)
  `moveObjectAbs(x, y [, "nom"])
  Déplace l'objet "nom" à une nouvelle position. Les coordonnées sont exprimées dans
  les unités de mesure courantes du document (voir les constantes UNIT). Si "nom"
  n'est pas fourni, l'élément sélectionné courant est utilisé. Si l'objet "nom"
  appartient à un groupe, tout le groupe est déplacé.`
newDoc(...)
  `newDoc(taille, marges, orientation, numeroPremierePage,
  unite, pagesRegard, premierePageGauche) -> booléen
  Crée un nouveau document et retourne la valeur True si l'opération réussit. Les paramètres ont la
  signification suivante :
  taille = un vecteur (largeur, hauteur) décrivant la taille du document. Vous pouvez
  utiliser des constantes prédéfinies nommées PAPER_<paper_type> c'est-à-dire PAPER_A4 etc.
  marges = un vecteur (gauche, droite, haut, bas) décrivant les marges du
  document
  orientation = l'orientation de la page - constantes PORTRAIT, LANDSCAPE
  numeroPremierePage = est le numéro de la première page dans le document utilisé
  pour pagenumbering. Même si habituellement vous choisirez la valeur 1, il est utile d'avoir
  de plus grands nombres si vous créez un document en plusieurs parties.
  unité = cette valeurs définit les unités de mesure utilisées par le document. Utilisez une
  constante prédéfinie pour cela, parmi les suivantes : UNIT_INCHES, UNIT_MILLIMETERS,
  UNIT_PICAS, UNIT_POINTS.
  pagesRegard = FACINGPAGES, NOFACINGPAGES
  premierPageGauche = FIRSTPAGELEFT, FIRSTPAGERIGHT
  Les valeurs établies pour la largeur, la hauteur et les marges sont exprimées dans les unités choisies
  pour le document. Les constantes PAPER_* sont exprimées en points. Si votre document
  n'est pas défini en points, assurez-vous d'en tenir compte.
  exemple : newDoc(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 1, UNIT_POINTS,
  FACINGPAGES, FIRSTPAGERIGHT)`
newDocDialog(...)
  `newDocDialog() -> booléen
  Affiche la boîte dialogue "Nouveau document". Crée un nouveau document si l'utilisateur accepte les paramètres. Ne crée pas de document si l'utilisateur appuie sur Annuler. Retourne la valeur True si un nouveau document a été créé.`
newPage(...)
  `newPage(lieu [,"modèle"])
  Crée une nouvelle page. Si "lieu" est à -1, la nouvelle page est ajoutée à la fin du document, sinon la nouvelle page est insérée avant "lieu". Les numéros de page sont incrémentés à partir de 1, peu importe le premier numéro de page affiché dans votre document. Le paramètre optionnel "modèle" spécifie le nom du gabarit pour la nouvelle page.
  Peut générer IndexError si le numéro de page est hors limites`
objectExists(...)
  `objectExists(["nom"]) -> booléen
  Teste si un objet avec le nom spécifié existe réellement dans le document. Le paramètre optionnel est le nom de l'objet. Lorsqu'aucun nom d'objet n'est donné, retourne la valeur True si un élément est sélectionné.`
openDoc(...)
  `openDoc("nom")
  Ouvre le document "nom".
  Peut générer ScribusError si le document ne peut pas être ouvert.`
pageCount(...)
  `pageCount() -> entier
  Retourne le nombre de pages dans le document.`
pageDimension(...)
  `getPageSize() -> vecteur
  Retourne un vecteur précisant les dimensions de la page mesurées dans les unités courantes du document.
  Voir les constantes UNIT_<type> et getPageMargins()`
progressReset(...)
  `progressReset()
  Élimine les réglages précédents de la barre de progression de Scribus. La fonction est appelée avant l'utilisation de la nouvelle barre de progression. Voir progressSet.`
progressSet(...)
  `progressSet(nr)
  Établit la position de la barre de progression à "nr", , c'est-à-dire une valeur relative à la valeur précédente de progressTotal. La barre de progression utilise le concept d'étapes; il suffit d'indiquer le nombre total d'étapes et le nombre d'étapes déjà effectuées, puis la fonction affichera le pourcentage d'avancement. Vous pouvez spécifier le nombre total d'étapes avec progressTotal(). Le nombre courant d'étapes est indiqué avec progressSet(). La barre de progression peut être remise à zéro avec progressReset(). [compte tenu de l'information provenant de la documentation QT de Trolltech]`
progressTotal(...)
  `progressTotal(max)
  Établit le nombre maximal d'étapes de la barre de progression au nombre spécifié. Voir progressSet.`
redrawAll(...)
  `redrawAll()
  Redessine toutes les pages.`
renderFont(...)
  `renderFont("nom", "nomFichier", "example", taille, format="PPM") -> booléen`

  Crée un aperçu image de la police "nom" avec le texte "exemple" et la taille "taille". L'image est enregistrée dans "nomFichier". Retourne la valeur True si l'opération réussit. L'argument optionnel "format" spécifie le format de l'image à générer et supporte tout format admis par QPixmap.save(). Les formats courants sont PPM, JPEG, PNG et XPM.

  Peut générer NotFoundError si la police spécifiée n'est pas trouvée. Peut générer ValueError si un "example" ou un "nomFichier" vide est passé.

replaceColor(...)
  `replaceColor("nom", "remplacement")
  Chaque occurrence de la couleur "nom" est remplacée par la couleur "remplacement".
  Peut générer NotFoundError si une couleur nommée n'est pas trouvée.
  Peut générer ValueError si un nom de couleur invalide est spécifié.`
retval(...)
  `Interne à Scribus.`
rotateObject(...)
  `rotateObject(rot [, "nom"])
  Fait pivoter l'objet "nom" de la valeur "rot" en degrés relatifs. La rotation est activée par le sommet sélectionné comme point de rotation - par défaut, le sommet en haut à gauche est le point de zéro rotation. Les valeurs positives signifient une rotation dans le sens des aiguilles d'une montre, lorsque le point de rotation par défaut est utilisé. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
rotateObjectAbs(...)
  `rotateObjectAbs(rot [, "nom"])
  Établit la rotation de l'objet "nom" à "rot". Des valeurs positives signifient une rotation dans le sens des aiguilles d'une montre. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
saveDoc(...)
  `saveDoc()
  Enregistre le document ouvert sous son nom courant, et retourne la valeur True si l'opération réussit. Si le document n'a pas déjà été enregistré, le système peut afficher le dialogue interactif Enregistrer sous.
  Si l'enregistrement échoue, il n'y a actuellement aucun moyen de le savoir.`
saveDocAs(...)
  `saveDocAs("nom")
  Enregistre le document courant sous le nouveau "nom" (qui peut être un chemin complet ou relatif).
  Peut générer ScribusError si l'enregistrement échoue.`
savePageAsEPS(...)
  `savePageAsEPS("nom")
  Enregistre la page courante comme EPS dans le fichier "nom".
  Peut générer ScribusError si l'enregistrement échoue.`
scaleGroup(...)
  `scaleGroup(facteur [,"nom"])
  Redimensionne le groupe auquel l'objet "nom" appartient. Les valeurs supérieures à 1 agrandissent le groupe, les valeurs inférieures à 1 rendent le groupe plus petit, par exemple une valeur de 0.5 redimensionne le groupe à 50 % de sa taille originale, tandis qu'une valeur de 1.5 redimensionne le groupe à 150 % de sa taille originale. La valeur de "facteur" doit être supérieure à 0. Si le "nom" n'est pas fourni, l'élément sélectionné courant est utilisé.
  Peut générer ValueError si le facteur de redimensionnement n'est pas valide.`
scaleImage(...)
  `scaleImage(x, y [, "nom"])
  Définit les facteurs de redimensionnement de l'image dans le cadre d'image "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé. Un nombre de 1 signifie 100 %.
  Peut générer WrongFrameTypeError si le cadre cible n'est pas un cadre d'image.`
selectObject(...)
  `selectObject("nom")
  Sélectionne l'objet avec le nom "nom".`
selectText(...)
  `selectText(depart, compte, ["nom"])
  Sélectionne le nombre ("compte") de caractères de texte dand le cadre de texte "nom" en partant du caractère "départ". Le comptage des caractères commence à 0. Si "compte" est à zéro, tout le texte sera effacé. Si le "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.`
selectionCount(...)
  `selectionCount() -> entier
  Retourne le nombre d'objets sélectionnés.`
sentToLayer(...)
  `sentToLayer("calque" [, "nom"])
  Envoie l'objet "nom" au calque "calque". Le calque doit exister. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.
  Peut générer NotFoundError si le calque est introuvable.
  Peut générer ValueError si le nom du calque n'est pas valide.`
setActiveLayer(...)
  `setActiveLayer("nom")
  Rend actif le calque nommé "nom".
  Peut générer NotFoundError si le calque est introuvable.
  Peut générer ValueError si le nom du calque n'est pas valide.`
setColumnGap(...)
  `setColumnGap(taille, ["nom"])
  Établit la gouttière de colonne du cadre de texte "nom" à la valeur "taille". Si le "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).`
setColumns(...)
  `setColumns(nr, ["nom"])
  Établit le nombre de colonnes du cadre de texte "nom" à la valeur entière "nr". Si le "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.`
setCornerRadius(...)
  `setCornerRadius(rayon, ["nom"])
  Établit le rayon de coin de l'objet "nom". Le rayon est exprimé en points. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.
  Peut générer ValueError si le rayon de coin est négatif.`
setCursor(...)
  `setCursor()
  [NON SUPPORTÉ !] Cette fonction peut créer des dommages, donc évitez de l'utiliser.`
setDocType(...)
  `setDocType(pagesRegard, premierePageGauche)
  Assigne le type de document. Pour obtenir des pages en regard, mettez le premier paramètre à FACINGPAGES; pour désactiver facingPages, utilisez NOFACINGPAGES à la place. Si vous voulez que la première page soit à gauche, mettez le deuxième paramètre à FIRSTPAGELEFT; pour une première page à droite, utilisez FIRSTPAGERIGHT.`
setFillColor(...)
  `setFillColor("couleur", ["nom"])
  Établit la couleur de fond de l'objet "nom" à la couleur "couleur". La "couleur" est le nom d'une des couleurs définies. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
setFillShade(...)
  `setFillShade(teinte, ["nom"])
  Établit la teinte de la couleur de fond de l'objet "nom" à "teinte". La "teinte" doit être une valeur entière entre 0 (le plus pâle) et 100 (toute l'intensité couleur). Si "nom" n'est pas fourni, l'élément sélectionné est utilisé. Peut générer ValueError si la couleur de fond est hors limites.`
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 le "nom" n'est pas fourni, l'élément sélectionné est utilisé.
  Peut générer ValueError si la police est introuvable.`
setFontSize(...)
  `setFontSize(police, ["nom"])
  Établit 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 le "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.`
setGradientFill(...)
  `setGradientFill(type, "couleur1", teinte1, "couleur2", teinte2, ["nom"])
  Établit le dégradé de fond de l'objet "nom" à "type". Les descriptions des couleurs sont identiques à celles de setFillColor() et desetFillShade(). Voir les constantes pour les types disponibles (FILL_<type>).`
setHGuides(...)
  `setHGuides(liste)
  Établit les guides horizontaux. Le paramètre en entrée doit être une liste de positions de guide exprimées dans les unités courantes du document - voir les constantes UNIT_<type>.
  Exemple : setHGuides(getHGuides() + [200.0, 210.0] # ajoute de nouveaux guides sans en perdre aucun
  setHGuides([90,250]) # remplace la totalité des guides courants`
setInfo(...)
  `saveDocAs("auteur", "info", "description") -> booléen
  Établit l'information relative au document. "Auteur", "Info", "Description" sont des chaînes.`
setLayerPrintable(...)
  `setLayerPrintable("calque", imprimable)
  Autorise ou non l'impression du "calque". Si la valeur "imprimable" est à False, le calque ne sera pas imprimé.
  Peut générer NotFoundError si le calque est introuvable.
  Peut générer ValueError si le nom du calque n'est pas valide.`
setLayerVisible(...)
  `setLayerVisible("calque", visible)
  Affiche ou masque le "calque". Si "visible" prend la valeur False, le calque est invisible.
  Peut générer NotFoundError si le calque est introuvable.
  Peut générer ValueError si le nom du calque n'est pas valide.`
setLineCap(...)
  `setLineEnd(typeFin, ["nom"])
  Établit la valeur de style "typeFin" pour le bout de ligne de l'objet "nom".
  Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé. Il y a des constantes prédéfinies pour "typeFin" - CAP_<type>.`
setLineColor(...)
  `setLineColor("couleur", ["nom"])
  Établit la valeur "couleur" pour le filet de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
setLineJoin(...)
  `setLineJoin(jonction, ["nom"])
  Établit la valeur du style "jonction# pour le filet de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé. Il y a des constantes prédéfinies pour "jonction" - JOIN_<type>.`
setLineShade(...)
  `setLineShade(teinte, ["nom"])
  Établit la valeur "teinte" pour la couleur de filet de l'objet "nom". La valeur de "teinte" doit être un nombre entier entre 0 (pâle) et 100 (intensité maximale). Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.
  Peut générer ValueError si la teinte du filet est hors limites.`
setLineSpacing(...)
  `setLineSpacing(taille, ["nom"])
  Établit la valeur "taille" pour l'interlignage ("leading") du cadre de texte "nom". La "taille" est une valeur en points. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.
  Peut générer ValueError si l'interlignage est hors limites.`
setLineStyle(...)
  `setLineStyle(style, ["nom"])
  Établit la valeur "style" pour le filet de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé. Il y a des constantes prédéfinies pour "style" - LINE_<style>.`
setLineWidth(...)
  `setLineWidth(épaisseur, ["nom"])
  Établit la valeur "épaisseur" pour le filet de l'objet "nom". La valeur "épaisseur" doit être entre 0.0 et 12.0 inclusivement, exprimée en points. Si "nom" n'est pas fourni, l'élément sélectionné courant est utilisé.
  Peut générer ValueError si l'épaisseur de filet est hors limites.`
setMargins(...)
  `setMargins(gr, dr, hr, br)
  Établit les marges du document, les marges gauche(gr), droite(dr), haut(hr) et bas(br) sont indiquées dans les unités de mesure du document - voir les constantesUNIT_<type>.`
setMultiLine(...)
  `setMultiLine("styleNomme", ["nom"])
  Établit la valeur "styleNomme" pour le style de filet de l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.
  Peut générer NotFoundError si le style de filet n'existe pas.`
setPDFBookmark(...)
  `setPDFBookmark("toggle", ["nom"])`

  Définit si le cadre de texte "nom" est un signet (toggle = 1) ou non. Si le "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.

setRedraw(...)
  `setRedraw(bool)
  Désactive le rafraîchissement d'écran quand bool = False, sinon le rafraîchissement est activé. Comme ce changement garde son effet après la fin du script, vous devez appeler setRedraw(True) dans une clause finally: au début de votre script.`
setScaleImageToFrame(...)
  `setScaleImageToFrame(redimAuCadre, proportionnel=None, nom=<selection>)`

  Établit le mode de redimensionnement par rapport au cadre d'image sélectionné, ou spécifié dans 'redimAuCadre'. Si 'proportionnel' est spécifié, établit le redimensionnement en maintenant des proportions fixes. 'redimAuCadre' et 'proportionnel' sont booléens.

  Peut générer WrongFrameTypeError.

setStyle(...)
  `setStyle("style" [, "nom"])
  Établit le "style" désigné à l'objet "nom". Si aucun objet n'est fourni, le style est appliqué à l'objet sélectionné.`
setText(...)
  `setText("texte", ["nom"])
  Établit la chaîne "texte" pour contenu du cadre de texte "nom". Le texte doit être encodé en UTF8 - utilisez par exemple Unicode(texte, 'iso-8859-2'). Voir les FAQ pour plus de détails. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
setTextAlignment(...)
  `setTextAlignment(alignement, ["nom"])
  Établit la valeur spécifiée pour l'alignement du contenu du cadre de texte "nom". Si le "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"])
  Établit la "couleur" du contenu du cadre de texte "nom". S'il y a du texte sélectionné, seul ce texte sera modifié. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
setTextShade(...)
  `setTextShade(teinte, ["nom"])
  Établit la valeur "teinte" pour la couleur du texte de l'objet "nom". S'il y a du texte sélectionné, seul cetexte sera modifié. La valeur "teinte" doit être un nombre entier compris entre 0 (pâle) et 100 (intensité maximale). Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
setTextStroke(...)
  `setTextStroke("couleur", ["nom"])
  Établit la "couleur" au contour des caractères. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
setUnit(...)
  `setUnit(unite)
  Change l'unité de mesure du document. Les valeurs possibles de l'"unité" sont définies par les constantes UNIT_<type>.
  Peut générer ValueError si l'unité passée n'est pas valide.`
setVGuides(...)
  `setVGuides()
  Voir setHGuides.`
sizeObject(...)
  `sizeObject(largeur, hauteur [, "nom"])
  Redimensionne l'objet "nom" à la largeur et à la hauteur données. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
statusMessage(...)
  `messagebarText("chaîne")
  Écrit "chaîne" dans la barre de message de Scribus (ligne d'état). Le texte doit être encodé en UTF8 ou en une chaîne 'unicode' (recommandé).`
textFlowsAroundFrame(...)
  `textFlowsAroundFrame("nom" [, état])
  Active ou désactive l'"habillage" (le texte défile autour de l'objet) pour l'objet "nom". Appelé avec les paramètres chaîne "nom" et le booléen optionnel "état". Si "état" n'est pas passé, cette fonctionnalité change de valeur (activée si inactive ou désactivée si active).`
traceText(...)
  `traceText(["nom"])
  Convertit le cadre de texte "nom" en contours. Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
unGroupObject(...)
  `unGroupObjects("nom")
  Détruit le groupe auquel appartient l'objet "nom". Si le "nom" n'est pas fourni, l'élément sélectionné est utilisé.`
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.`
valueDialog(...)
  `valueDialog(titre, message [,valeurDefaut]) -> chaîne
  Affiche la boîte de dialogue "Demande d'une chaîne" et retourne la valeur recherchée sous la forme d'une chaîne
  Paramètres : titre de la fenêtre, texte dans la fenêtre et une valeur par 'défaut' optionnelle.
  Exemple : valueDialog('titre', 'texte dans la fenêtre', 'optionnel')`

### Données

ALIGN_BLOCK = 4
ALIGN_CENTERED = 1
ALIGN_FORCED = 4
ALIGN_LEFT = 0
ALIGN_RIGHT = 2
Abort = 5
BUTTON_ABORT = 5
BUTTON_CANCEL = 2
BUTTON_IGNORE = 7
BUTTON_NO = 4
BUTTON_NONE = 0
BUTTON_OK = 1
BUTTON_RETRY = 6
BUTTON_YES = 3
BevelJoin = 64
CAP_FLAT = 0
CAP_ROUND = 32
CAP_SQUARE = 16
Cancel = 2
Centered = 1
Critical = 3
CrossDiagonalGradient = 4
DashDotDotLine = 5
DashDotLine = 4
DashLine = 2
DiagonalGradient = 3
DotLine = 3
FACINGPAGES = 1
FILL_CROSSDIAGONALG = 4
FILL_DIAGONALG = 3
FILL_HORIZONTALG = 1
FILL_NOG = 0
FILL_RADIALG = 5
FILL_VERTICALG = 2
FIRSTPAGELEFT = 1
FIRSTPAGERIGHT = 0
FacingPages = 1
FirstPageLeft = 1
FirstPageRight = 0
FlatCap = 0
Forced = 4
HorizontalGradient = 1
ICON_CRITICAL = 3
ICON_INFORMATION = 1
ICON_NONE = 0
ICON_WARNING = 2
Ignore = 7
Inches = 2
Information = 1
JOIN_BEVEL = 64
JOIN_MITTER = 0
JOIN_ROUND = 128
LANDSCAPE = 1
LINE_DASH = 2
LINE_DASHDOT = 4
LINE_DASHDOTDOT = 5
LINE_DOT = 3
LINE_SOLID = 1
Landscape = 1
LeftAlign = 0
Millimeters = 1
MiterJoin = 0
NOFACINGPAGES = 0
No = 4
NoButton = 0
NoFacingPages = 0
NoGradient = 0
NoIcon = 0
Ok = 1
PAPER_A0 = (2380.0, 3368.0)
PAPER_A1 = (1684.0, 2380.0)
PAPER_A2 = (1190.0, 1684.0)
PAPER_A3 = (842.0, 1190.0)
PAPER_A4 = (595.0, 842.0)
PAPER_A5 = (421.0, 595.0)
PAPER_A6 = (297.0, 421.0)
PAPER_A7 = (210.0, 297.0)
PAPER_A8 = (148.0, 210.0)
PAPER_A9 = (105.0, 148.0)
PAPER_B0 = (2836.0, 4008.0)
PAPER_B1 = (2004.0, 2836.0)
PAPER_B10 = (89.0, 125.0)
PAPER_B2 = (1418.0, 2004.0)
PAPER_B3 = (1002.0, 1418.0)
PAPER_B4 = (709.0, 1002.0)
PAPER_B5 = (501.0, 709.0)
PAPER_B6 = (355.0, 501.0)
PAPER_B7 = (250.0, 355.0)
PAPER_B8 = (178.0, 250.0)
PAPER_B9 = (125.0, 178.0)
PAPER_C5E = (462.0, 649.0)
PAPER_COMM10E = (298.0, 683.0)
PAPER_DLE = (312.0, 624.0)
PAPER_EXECUTIVE = (542.0, 720.0)
PAPER_FOLIO = (595.0, 935.0)
PAPER_LEDGER = (1224.0, 792.0)
PAPER_LEGAL = (612.0, 1008.0)
PAPER_LETTER = (612.0, 792.0)
PAPER_TABLOID = (792.0, 1224.0)
PORTRAIT = 0
Paper_A0 = (2380.0, 3368.0)
Paper_A1 = (1684.0, 2380.0)
Paper_A2 = (1190.0, 1684.0)
Paper_A3 = (842.0, 1190.0)
Paper_A4 = (595.0, 842.0)
Paper_A5 = (421.0, 595.0)
Paper_A6 = (297.0, 421.0)
Paper_A7 = (210.0, 297.0)
Paper_A8 = (148.0, 210.0)
Paper_A9 = (105.0, 148.0)
Paper_B0 = (2836.0, 4008.0)
Paper_B1 = (2004.0, 2836.0)
Paper_B10 = (89.0, 125.0)
Paper_B2 = (1418.0, 2004.0)
Paper_B3 = (1002.0, 1418.0)
Paper_B4 = (709.0, 1002.0)
Paper_B5 = (501.0, 709.0)
Paper_B6 = (355.0, 501.0)
Paper_B7 = (250.0, 355.0)
Paper_B8 = (178.0, 250.0)
Paper_B9 = (125.0, 178.0)
Paper_C5E = (462.0, 649.0)
Paper_Comm10E = (298.0, 683.0)
Paper_DLE = (312.0, 624.0)
Paper_Executive = (542.0, 720.0)
Paper_Folio = (595.0, 935.0)
Paper_Ledger = (1224.0, 792.0)
Paper_Legal = (612.0, 1008.0)
Paper_Letter = (612.0, 792.0)
Paper_Tabloid = (792.0, 1224.0)
Picas = 3
Points = 0
Portrait = 0
RadialGradient = 5
Retry = 6
RightAlign = 2
RoundCap = 32
RoundJoin = 128
SolidLine = 1
SquareCap = 16
UNIT_INCHES = 2
UNIT_MILLIMETERS = 1
UNIT_PICAS = 3
UNIT_POINTS = 0
VerticalGradient = 2
Warning = 2
Yes = 3
scribus_version = '1.2.2'
scribus_version_info = (1, 2, 2, '', 0)
y