## Manipuler les objets

combinePolygons()
  `combinePolygons()`

  Combine deux polygones ou plus.

  Peut générer l'exception WrongFrameTypeError.

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

  Effectue une copie de l'objet sélectionné vers le presse-papiers ou du premier objet dans la sélection si "nom" n'est pas spécifié.

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

copyObjects(...)
  `copyObjects(noms)`

  Effectue une copie des objets spécifiés vers le presse-papiers ou de la sélection courante si aucun nom d'objet n'est spécifié.

  Le nom des objets à copier peut être spécifié sous forme d'une chaîne de caractères afin de copier un seul objet ou d'une liste de chaînes afin de copier plusieurs objets à la fois.

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

  Crée une copie de l'objet spécifié ou du premier objet dans la sélection si "nom" n'est pas spécifié.

  Retourne le nom de l'objet nouvellement créé.

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

duplicateObjects(...)
  `duplicateObjects(noms) -> list`

  Crée une copie des objets spécifiés ou de la sélection courante si aucun nom d'objet n'est spécifié.

  Le nom des objets à dupliquer peut être spécifié sous forme d'une chaîne de caractères afin de dupliquer un seul objet ou d'une liste de chaînes afin de dupliquer plusieurs objets à la fois.

  Retourne une liste des noms des objets nouvellement créés.

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

  Retourne le nom du style de caractère appliqué à l'objet "nom". Si aucun nom d'objet n'est fourni, l'élément sélectionné est utilisé.

  Si l'objet courant possède une sélection de texte, le nom retourné est celui du style appliqué au début de la sélection. Sinon le nom retourné est celui du style de caractère appliqué par défaut.

  Peut générer l'exception WrongFrameTypeError.

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

  Retourne le nom du style de paragraphe appliqué à l'objet "nom". Si aucun nom d'objet n'est fourni, l'élément sélectionné est utilisé.

  Si l'objet courant possède une sélection de texte, le nom retourné est celui du style appliqué au début de la sélection. Sinon le nom retourné est celui du style appliqué par défaut.

  Peut générer l'exception WrongFrameTypeError.

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

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

getTextFlowMode(...)
  `getTextFlowMode(["nom"]) -> entier`

  Return le mode d'habillage du texte appliqué à l'objet "nom" sous forme d'un entier. Si aucun nom d'objet n'est fourni, l'élément sélectionné est utilisé.

  La fonction retournera une des valeurs suivantes:

  - 0 : l'habillage du texte est désactivé
  - 1 : l'habillage du texte suit la forme du cadre
  - 2 : l'habillage du texte suit la bounding box du cadre
  - 3 : l'habillage du texte suit la ligne de contour du cadre
  - 4 : l'habillage du texte suit le tracé de découpage de l'image
groupObjects(...)
  `groupObjects(liste) -> chaîne`

  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. Retourne le nom du groupe créé pour utilisation ultérieure.

isLocked(...)
  `isLocked(["nom"]) -> booléen`

  Retourne la valeur True si l'objet "nom" est verrouillé. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

lockObject(...)
  `lockObject(["nom"]) -> booléen`

  Verrouille l'objet "nom" s'il est déverrouillé, ou le déverrouille s'il y a lieu. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé. Retourne la valeur True si verrouillé.

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 du document (voir les constantes UNIT). Si "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 du document (voir les constantes UNIT). Si "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é.

pasteObject(...)
  `pasteObject() -> chaîne`

  Colle un objet depuis le presse-papier. Cette fonction doit être utilisée uniquement suivant un appel à la fonction copyObject(...), sans quoi le presse-papier ne contiendra probablement aucune donnée susceptible d'être collée.

  Retourne les noms des objets nouvellement créés sous forme d'une chaîne séparés par des virgules.

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

pasteObjects(...)
  `pasteObjects() -> list`

  Colle des objets depuis le presse-papier. Cette fonction doit être utilisée uniquement suivant un appel à la fonction copyObjects(...), sans quoi le presse-papier ne contiendra probablement aucune donnée susceptible d'être collée.

  Retourne le nom des objets nouvellement créés sous forme d'une liste.

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 rotation zéro. 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 "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 "nom" n'est pas fourni, l'élément sélectionné est utilisé.

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.

setCharacterStyle(...)
  `setCharacterStyle("style" [, "nom"])`

  Applique le "style" de caractère spécifié à l'objet "nom".

  Si le nom d'objet "nom" n'est pas spécifié, le style est appliqué à la sélection d'objets courante.

  Si de multiples objets sont sélectionnés ou si l'objet sélectionné ne comporte aucune sélection de texte, le style est appliqué aux objets sélectionnés. Dans le cas contraire, le style est appliqué à la sélection de texte courante.

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

  Peut générer l'exception NotFoundError si le nom de style spécifié n'appartient pas au document courant.

setParagraphStyle(...)
  `setParagraphStyle("style" [, "nom"])`

  Applique le "style" de paragraphe spécifié à l'objet "nom".

  Si le nom d'objet "nom" n'est pas spécifié, le style est appliqué à la sélection d'objets courante.

  Si de multiples objets sont sélectionnés ou si l'objet sélectionné ne comporte aucune sélection de texte, le style est appliqué aux objets sélectionnés. Dans le cas contraire, le style est appliqué à la sélection de texte courante.

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

  Peut générer l'exception NotFoundError si le nom de style spécifié n'appartient pas au document courant.

setScaleFrameToImage(...)
  `setScaleFrameToImage([nom])`

  Redimensionne l'objet "nom" aux dimensions de l'image. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé

  Peut générer l'exception WrongFrameTypeError.

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 l'exception WrongFrameTypeError.

setStyle(...)
  `setStyle("style" [, "nom"])`

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

setTextFlowMode(...)
  `setTextFlowMode("nom" [, etat])`

  Active ou désactive l'habillage du texte pour l'objet "nom".

  Appelé avec les paramètres chaîne "nom" et l'entier optionnel "état" (0 <= "état" <= 3). Paramétrer "état" à la valeur 0 désactivera l'habillage du texte. Paramétrer "état" à la valeur 1 habillera le texte selon le cadre de l'objet. Paramétrer "état" à la valeur 2 habillera le texte selon la bounding box de l'objet. Paramétrer "état" à la valeur 3 habillera le texte selon la ligne de contourde l'objet. Si l'argument"état" n'est pas passé, cette fonctionnalité change de valeur (activée si inactive ou désactivée si active).

sizeObject(...)
  `sizeObject(largeur, hauteur [, "nom"])`

  Redimensionne l'objet "nom" à la largeur et à la hauteur données. Si "nom" n'est pas fourni, l'élément sélectionné est utilisé.

unGroupObjects(...)
  `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é.

textFlowMode(...)
  `textFlowMode("nom" [, etat])`

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