Class WordArt

WordArt

Élément PageElement représentant le texte Word Art.

Méthodes

MéthodeType renvoyéBrève description
alignOnPage(alignmentPosition)WordArtAligne l'élément selon la position d'alignement spécifiée sur la page.
bringForward()WordArtAffiche l'élément de page d'un élément vers l'avant sur la page.
bringToFront()WordArtPlace l'élément de page au début de la page.
duplicate()PageElementDuplique l'élément de page.
getConnectionSites()ConnectionSite[]Renvoie la liste des ConnectionSite sur l'élément de page ou une liste vide si l'élément de page ne comporte aucun site de connexion.
getDescription()StringRenvoie la description du texte alternatif de l'élément de page.
getHeight()NumberRécupère la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsqu'il n'a pas de rotation.
getInherentHeight()NumberRenvoie la hauteur inhérente à l'élément en points.
getInherentWidth()NumberRenvoie la largeur inhérente à l'élément en points.
getLeft()NumberRenvoie la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'a pas de rotation.
getLink()LinkRenvoie la valeur Link ou null en l'absence de lien.
getObjectId()StringRenvoie l'identifiant unique de cet objet.
getPageElementType()PageElementTypeRenvoie le type de l'élément de page, représenté par une énumération PageElementType.
getParentGroup()GroupRenvoie le groupe auquel appartient cet élément de page ou null si l'élément ne fait pas partie d'un groupe.
getParentPage()PageAffiche la page sur laquelle se trouve cet élément de page.
getRenderedText()StringRécupère le texte affiché au format Word Art.
getRotation()NumberRenvoie l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés, où zéro degré signifie qu'il n'y a pas de rotation.
getTitle()StringRenvoie le titre du texte alternatif de l'élément de page.
getTop()NumberRécupère la position verticale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'a pas de rotation.
getTransform()AffineTransformRenvoie la transformation de l'élément de page.
getWidth()NumberRenvoie la largeur de l'élément en points, qui correspond à la largeur du cadre de délimitation de l'élément lorsque celui-ci n'a pas de rotation.
preconcatenateTransform(transform)WordArtPréconcatène la transformation fournie avec la transformation existante de l'élément de page.
remove()voidSupprime l'élément de page.
removeLink()voidSupprime un Link.
scaleHeight(ratio)WordArtMet à l'échelle la hauteur de l'élément selon le ratio spécifié.
scaleWidth(ratio)WordArtMet à l'échelle la largeur de l'élément selon le ratio spécifié.
select()voidSélectionne uniquement l'élément PageElement dans la présentation active et supprime toute sélection précédente.
select(replace)voidSélectionne PageElement dans la présentation active.
sendBackward()WordArtRenvoie l'élément de page vers l'arrière sur la page d'un élément.
sendToBack()WordArtEnvoie l'élément de page au dos de la page.
setDescription(description)WordArtDéfinit la description du texte alternatif de l'élément de page.
setHeight(height)WordArtDéfinit la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsqu'il n'a pas de rotation.
setLeft(left)WordArtDéfinit la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'a pas de rotation.
setLinkSlide(slideIndex)LinkDéfinit un Link sur le Slide donné à l'aide de l'index basé sur zéro de la diapositive.
setLinkSlide(slide)LinkDéfinit un Link sur le Slide donné, le lien est défini par l'ID de diapositive indiqué.
setLinkSlide(slidePosition)LinkDéfinit un Link sur le Slide donné en utilisant la position relative de la diapositive.
setLinkUrl(url)LinkDéfinit un Link sur la chaîne d'URL non vide donnée.
setRotation(angle)WordArtDéfinit l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés.
setTitle(title)WordArtDéfinit le titre du texte alternatif de l'élément de page.
setTop(top)WordArtDéfinit la position verticale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'a pas de rotation.
setTransform(transform)WordArtDéfinit la transformation de l'élément de page avec la transformation fournie.
setWidth(width)WordArtDéfinit la largeur de l'élément en points, qui correspond à la largeur du cadre de délimitation de l'élément lorsqu'il n'a pas de rotation.

Documentation détaillée

alignOnPage(alignmentPosition)

Aligne l'élément selon la position d'alignement spécifiée sur la page.

Paramètres

NomTypeDescription
alignmentPositionAlignmentPositionPosition à laquelle aligner cet élément de page sur la page.

Renvois

WordArt : cet élément de page, pour le chaînage.


bringForward()

Affiche l'élément de page d'un élément vers l'avant sur la page.

L'élément de page ne doit pas appartenir à un groupe.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

bringToFront()

Place l'élément de page au début de la page.

L'élément de page ne doit pas appartenir à un groupe.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

duplicate()

Duplique l'élément de page.

L'élément de page en double est placé sur la même page, à la même position que l'élément d'origine.

Renvois

PageElement : nouveau doublon de cet élément de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getConnectionSites()

Renvoie la liste des ConnectionSite sur l'élément de page ou une liste vide si l'élément de page ne comporte aucun site de connexion.

Renvois

ConnectionSite[] : liste des sites de connexion, qui peut être vide si cet élément ne comporte aucun site de connexion.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getDescription()

Renvoie la description du texte alternatif de l'élément de page. La description est combinée au titre pour afficher et lire le texte alternatif.

Renvois

String : description du texte alternatif de l'élément de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getHeight()

Récupère la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsqu'il n'a pas de rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de taille et de positionnement.

Renvois

Number : hauteur inhérente à l'élément de page en points, ou null si l'élément de page n'a pas de hauteur.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getInherentHeight()

Renvoie la hauteur inhérente à l'élément en points.

La transformation de l'élément de page dépend de sa taille inhérente. Utilisez la taille inhérente associée à la transformation de l'élément pour déterminer son apparence visuelle finale.

Renvois

Number : hauteur inhérente à l'élément de page en points, ou null si l'élément de page n'a pas de hauteur.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getInherentWidth()

Renvoie la largeur inhérente à l'élément en points.

La transformation de l'élément de page dépend de sa taille inhérente. Utilisez la taille inhérente associée à la transformation de l'élément pour déterminer son apparence visuelle finale.

Renvois

Number : largeur inhérente à l'élément de page en points, ou null si l'élément de page n'a pas de largeur.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLeft()

Renvoie la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'a pas de rotation.

Renvois

Number : position horizontale de cet élément en points, à partir de l'angle supérieur gauche de la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Renvoie la valeur Link ou null en l'absence de lien.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Renvois

Link

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getObjectId()

Renvoie l'identifiant unique de cet objet. Les ID d'objet utilisés par les pages et les éléments de page partagent le même espace de noms.

Renvois

String : identifiant unique de cet objet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElementType()

Renvoie le type de l'élément de page, représenté par une énumération PageElementType.

Renvois

PageElementType : type de l'élément de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParentGroup()

Renvoie le groupe auquel appartient cet élément de page ou null si l'élément ne fait pas partie d'un groupe.

Renvois

Group : groupe auquel appartient cet élément de page, ou null.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParentPage()

Affiche la page sur laquelle se trouve cet élément de page.

Renvois

Page : page sur laquelle se trouve cet élément.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getRenderedText()

Récupère le texte affiché au format Word Art.

Renvois

String : texte affiché sous forme de texte Word Art.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getRotation()

Renvoie l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés, où zéro degré signifie qu'il n'y a pas de rotation.

Renvois

Number : angle de rotation en degrés compris entre 0 (inclus) et 360 (exclus).

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTitle()

Renvoie le titre du texte alternatif de l'élément de page. Le titre est combiné à la description pour afficher et lire le texte alternatif.

Renvois

String : titre du texte alternatif de l'élément de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTop()

Récupère la position verticale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'a pas de rotation.

Renvois

Number : position verticale de cet élément en points, à partir de l'angle supérieur gauche de la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTransform()

Renvoie la transformation de l'élément de page.

L'apparence visuelle de l'élément de page est déterminée par sa transformation absolue. Pour calculer la transformation absolue, préconcaténez la transformation d'un élément de page avec les transformations de tous ses groupes parents. Si l'élément de page ne se trouve pas dans un groupe, sa transformation absolue est identique à la valeur de ce champ.

Renvois

AffineTransform : transformation de l'élément de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getWidth()

Renvoie la largeur de l'élément en points, qui correspond à la largeur du cadre de délimitation de l'élément lorsque celui-ci n'a pas de rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de taille et de positionnement.

Renvois

Number : largeur inhérente à l'élément de page en points, ou null si l'élément de page n'a pas de largeur.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

preconcatenateTransform(transform)

Préconcatène la transformation fournie avec la transformation existante de l'élément de page.

newTransform = argument * existingTransform

Par exemple, pour déplacer les éléments d'une page de 36 points vers la gauche:

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

Vous pouvez également remplacer la transformation de l'élément de page par setTransform(transform).

Paramètres

NomTypeDescription
transformAffineTransformTransformation à préconcaténer dans la transformation de cet élément de page.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

remove()

Supprime l'élément de page.

Si, après une opération de suppression, une Group ne contient qu'un seul élément de page ou aucun, le groupe lui-même est également supprimé.

Si un espace réservé PageElement est supprimé d'une page maître ou d'une mise en page, tous les espaces réservés vides hérités sont également supprimés.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Supprime un Link.

shape.removeLink();

scaleHeight(ratio)

Met à l'échelle la hauteur de l'élément selon le ratio spécifié. La hauteur de l'élément correspond à la hauteur de son cadre de délimitation lorsqu'il n'est pas soumis à une rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de taille et de positionnement.

Paramètres

NomTypeDescription
ratioNumberRatio de mise à l'échelle de la hauteur de cet élément de page.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

scaleWidth(ratio)

Met à l'échelle la largeur de l'élément selon le ratio spécifié. La largeur de l'élément correspond à la largeur de son cadre de délimitation lorsqu'il n'a pas de rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de taille et de positionnement.

Paramètres

NomTypeDescription
ratioNumberRatio de mise à l'échelle de la largeur de cet élément de page.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

select()

Sélectionne uniquement l'élément PageElement dans la présentation active et supprime toute sélection précédente. Cela revient à appeler select(replace) avec true.

Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement s'il est lié à la présentation.

Cela définit le Page parent de PageElement comme current page selection.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

select(replace)

Sélectionne PageElement dans la présentation active.

Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement s'il est lié à la présentation.

Transmettez true à cette méthode pour ne sélectionner que PageElement et supprimer toute sélection précédente. Cela définit également le Page parent de PageElement comme current page selection.

Transmettez false pour sélectionner plusieurs objets PageElement. Les objets PageElement doivent se trouver dans le même Page.

Lorsque vous sélectionnez un élément de page à l'aide d'un paramètre false, les conditions suivantes doivent être remplies:

  1. La Page parente de l'objet PageElement doit être la current page selection.
  2. Vous ne devez pas sélectionner plusieurs objets Page.

Pour vous en assurer, l'approche privilégiée consiste à sélectionner d'abord le Page parent à l'aide de Page.selectAsCurrentPage(), puis à sélectionner les éléments de cette page.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Paramètres

NomTypeDescription
replaceBooleanSi la valeur est true, la sélection remplace toute sélection précédente. Sinon, elle est ajoutée à toute sélection précédente.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

sendBackward()

Renvoie l'élément de page vers l'arrière sur la page d'un élément.

L'élément de page ne doit pas appartenir à un groupe.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

sendToBack()

Envoie l'élément de page au dos de la page.

L'élément de page ne doit pas appartenir à un groupe.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setDescription(description)

Définit la description du texte alternatif de l'élément de page.

Cette méthode n'est pas compatible avec les éléments Group.

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Paramètres

NomTypeDescription
descriptionStringChaîne sur laquelle définir la description du texte alternatif.

Renvois

WordArt : cet élément de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setHeight(height)

Définit la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsqu'il n'a pas de rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de taille et de positionnement.

Paramètres

NomTypeDescription
heightNumberNouvelle hauteur à définir pour cet élément de page, en points.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLeft(left)

Définit la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'a pas de rotation.

Paramètres

NomTypeDescription
leftNumberNouvelle position horizontale à définir, en points.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slideIndex)

Définit un Link sur le Slide donné à l'aide de l'index basé sur zéro de la diapositive.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Paramètres

NomTypeDescription
slideIndexIntegerIndice basé sur zéro de la diapositive.

Renvois

Link : Link défini

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slide)

Définit un Link sur le Slide donné, le lien est défini par l'ID de diapositive indiqué.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Paramètres

NomTypeDescription
slideSlideLe Slide à associer.

Renvois

Link : Link défini

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slidePosition)

Définit un Link sur le Slide donné en utilisant la position relative de la diapositive.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Paramètres

NomTypeDescription
slidePositionSlidePositionLa valeur SlidePosition relative.

Renvois

Link : Link défini

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkUrl(url)

Définit un Link sur la chaîne d'URL non vide donnée.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Paramètres

NomTypeDescription
urlStringChaîne d'URL.

Renvois

Link : Link défini

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setRotation(angle)

Définit l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de taille et de positionnement.

Paramètres

NomTypeDescription
angleNumberNouvel angle de rotation dans le sens des aiguilles d'une montre à définir, en degrés.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTitle(title)

Définit le titre du texte alternatif de l'élément de page.

Cette méthode n'est pas compatible avec les éléments Group.

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Paramètres

NomTypeDescription
titleStringChaîne sur laquelle définir le titre du texte alternatif.

Renvois

WordArt : cet élément de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTop(top)

Définit la position verticale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'a pas de rotation.

Paramètres

NomTypeDescription
topNumberNouvelle position verticale à définir, en points.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTransform(transform)

Définit la transformation de l'élément de page avec la transformation fournie.

La mise à jour de la transformation d'un groupe modifie la transformation absolue des éléments de page de ce groupe, ce qui peut modifier leur apparence visuelle.

La mise à jour de la transformation d'un élément de page faisant partie d'un groupe ne modifie que la transformation de cet élément de page. Elle n'a aucune incidence sur les transformations du groupe ni sur les autres éléments de page du groupe.

Pour en savoir plus sur l'impact des transformations sur l'apparence visuelle des éléments de la page, consultez getTransform().

Paramètres

NomTypeDescription
transformAffineTransformTransformation définie pour cet élément de page.

Renvois

WordArt : cet élément, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setWidth(width)

Définit la largeur de l'élément en points, qui correspond à la largeur du cadre de délimitation de l'élément lorsqu'il n'a pas de rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de taille et de positionnement.

Paramètres

NomTypeDescription
widthNumberNouvelle largeur à définir de cet élément de page, en points.

Renvois

WordArt : cet élément de page, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations