Class TextStyle

TextStyle

Die Formatierung von Text.

Lesemethoden in dieser Klasse geben null zurück, wenn das zugehörige TextRange-Objekt mehrere Textläufe umfasst und diese Läufe für die aufgerufene Lesemethode jeweils unterschiedliche Werte haben. Sie können derartige Rückgaben vermeiden, wenn Sie zum Abrufen von Textformatierungen die TextRange-Objekte verwenden, die von der Methode TextRange.getRuns() zurückgegeben werden.

Falls Sie Methoden verwenden, die verändern, wie Text an Formen angepasst wird, werden alle auf die Textformatierungen angewendeten automatischen Anpassungen deaktiviert.

Methoden

MethodeRückgabetypKurzbeschreibung
getBackgroundColor()ColorGibt die Hintergrundfarbe des Texts zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.
getBaselineOffset()TextBaselineOffsetGibt den vertikalen Versatz des Texts relativ zu seiner Normalposition zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.
getFontFamily()StringGibt die Schriftfamilie des Texts zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.
getFontSize()NumberGibt den Schriftgrad des Texts in der Einheit „Punkt“ zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.
getFontWeight()IntegerGibt die Schriftstärke des Texts zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.
getForegroundColor()ColorGibt die Vordergrundfarbe des Texts zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.
getLink()LinkGibt den für den Text definierten Link zurück oder null, wenn kein Link definiert ist, wenn der Link nur für einen Teil des Texts definiert ist oder wenn mehrere Links definiert sind.
hasLink()BooleanGibt true zurück, wenn ein Link für den Text definiert ist, false, wenn nicht, und null, wenn der Link nur für einen Teil des Texts definiert ist oder wenn mehrere Links definiert sind.
isBackgroundTransparent()BooleanGibt true zurück, wenn der Hintergrund des Texts transparent ist, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.
isBold()BooleanGibt true zurück, wenn der Text fett gerendert wird, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.
isItalic()BooleanGibt true zurück, wenn der Text kursiv gerendert wird, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.
isSmallCaps()BooleanGibt true zurück, wenn der Text in Kapitälchen gerendert wird, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.
isStrikethrough()BooleanGibt true zurück, wenn der Text durchgestrichen gerendert wird, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.
isUnderline()BooleanGibt true zurück, wenn der Text unterstrichen gerendert wird, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.
removeLink()TextStyleEntfernt einen Link.
setBackgroundColor(color)TextStyleLegt die Hintergrundfarbe des Texts fest.
setBackgroundColor(red, green, blue)TextStyleLegt die Hintergrundfarbe des Texts auf die angegebenen RGB‑Werte im Bereich von 0 bis 255 fest.
setBackgroundColor(hexColor)TextStyleLegt die Hintergrundfarbe des Texts auf den angegebenen Hex‑Farbcode fest.
setBackgroundColor(color)TextStyleLegt die Hintergrundfarbe des Texts auf den angegebenen ThemeColorType fest.
setBackgroundColorTransparent()TextStyleLegt fest, dass die Hintergrundfarbe des Texts transparent sein soll.
setBaselineOffset(offset)TextStyleLegt den vertikalen Versatz des Texts relativ zu seiner Normalposition fest.
setBold(bold)TextStyleLegt fest, ob der Text fett gerendert werden soll.
setFontFamily(fontFamily)TextStyleLegt die Schriftfamilie des Texts fest.
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleLegt die Schriftfamilie und die Schriftstärke des Texts fest.
setFontSize(fontSize)TextStyleLegt den Schriftgrad des Texts in der Einheit „Punkt“ fest.
setForegroundColor(foregroundColor)TextStyleLegt die Vordergrundfarbe des Texts fest.
setForegroundColor(red, green, blue)TextStyleLegt die Vordergrundfarbe des Texts auf die angegebenen RGB‑Werte im Bereich von 0 bis 255 fest.
setForegroundColor(hexColor)TextStyleLegt die Vordergrundfarbe des Texts auf den angegebenen Hex‑Farbcode fest.
setForegroundColor(color)TextStyleLegt die Vordergrundfarbe des Texts auf den angegebenen ThemeColorType fest.
setItalic(italic)TextStyleLegt fest, ob der Text kursiv gerendert werden soll.
setLinkSlide(slideIndex)TextStyleLegt einen Link auf die angegebene Slide fest unter Verwendung des nullbasierten Folienindex.
setLinkSlide(slide)TextStyleLegt einen Link auf die angegebene Slide fest unter Verwendung der angegebenen Folien‑ID.
setLinkSlide(slidePosition)TextStyleLegt einen Link auf die angegebene Slide fest unter Verwendung der relativen Position der Folie.
setLinkUrl(url)TextStyleLegt einen Link auf den angegebenen nicht leeren URL‑String fest.
setSmallCaps(smallCaps)TextStyleLegt fest, ob der Text in Kapitälchen gerendert werden soll.
setStrikethrough(strikethrough)TextStyleLegt fest, ob der Text durchgestrichen gerendert werden soll.
setUnderline(underline)TextStyleLegt fest, ob der Text unterstrichen gerendert werden soll.

Detaillierte Dokumentation

getBackgroundColor()

Gibt die Hintergrundfarbe des Texts zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.

Rückgabe

Color

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getBaselineOffset()

Gibt den vertikalen Versatz des Texts relativ zu seiner Normalposition zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.

Rückgabe

TextBaselineOffset

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getFontFamily()

Gibt die Schriftfamilie des Texts zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.

Rückgabe

String

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getFontSize()

Gibt den Schriftgrad des Texts in der Einheit „Punkt“ zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.

Rückgabe

Number

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getFontWeight()

Gibt die Schriftstärke des Texts zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.

Die Schriftstärke ist ein Vielfaches von 100 aus dem Wertebereich von 100 bis 900 (100 und 900 jeweils eingeschlossen). Dieser Bereich entspricht den numerischen Werten in der Spezifikation CSS 2.1, Abschnitt 15.6. Die dort genannten nicht numerischen Werte sind jedoch unzulässig. Schriftstärken größer oder gleich 700 gelten als fett. In diesem Fall gibt isBold() den Wert true zurück. Der Standardwert ist 400 („normal“).

Rückgabe

Integer

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getForegroundColor()

Gibt die Vordergrundfarbe des Texts zurück oder null, wenn mehrere Formatierungen für den Text definiert sind.

Rückgabe

Color

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Gibt den für den Text definierten Link zurück oder null, wenn kein Link definiert ist, wenn der Link nur für einen Teil des Texts definiert ist oder wenn mehrere Links definiert sind. Rufen Sie hasLink() auf, um zu ermitteln, ob kein Link für den Text definiert ist. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const textLink = shape.getText().getTextStyle().getLink();
if (textLink != null) {
  Logger.log(`Shape text has a link of type: ${textLink.getLinkType()}`);
}

Rückgabe

Link

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Gibt true zurück, wenn ein Link für den Text definiert ist, false, wenn nicht, und null, wenn der Link nur für einen Teil des Texts definiert ist oder wenn mehrere Links definiert sind.

Auf Neue-Zeile-Zeichen (Zeilenvorschubzeichen) können keine Links angewendet werden. Wenn TextRange ein Neue-Zeile-Zeichen enthält, gibt diese Methode also immer entweder null oder false zurück.

Rückgabe

Boolean

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isBackgroundTransparent()

Gibt true zurück, wenn der Hintergrund des Texts transparent ist, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.

Rückgabe

Boolean

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isBold()

Gibt true zurück, wenn der Text fett gerendert wird, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.

Rückgabe

Boolean

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isItalic()

Gibt true zurück, wenn der Text kursiv gerendert wird, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.

Rückgabe

Boolean

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isSmallCaps()

Gibt true zurück, wenn der Text in Kapitälchen gerendert wird, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.

Rückgabe

Boolean

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isStrikethrough()

Gibt true zurück, wenn der Text durchgestrichen gerendert wird, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.

Rückgabe

Boolean

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isUnderline()

Gibt true zurück, wenn der Text unterstrichen gerendert wird, false, wenn nicht, und null, wenn mehrere Formatierungen für den Text definiert sind.

Rückgabe

Boolean

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Entfernt einen Link.

Wenn ein Link entfernt wird, werden damit für den betreffenden Text auch die derzeitigen Link-Formatierungen entfernt (Hyperlink-Vordergrundfarbe und Rendern des Hyperlinks als unterstrichen). Diese Formatierungen werden dann nach Möglichkeit an die Formatierungen des Texts angeglichen, der dem Link vorausgeht. 

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().removeLink();

Rückgabe

TextStyle

setBackgroundColor(color)

Legt die Hintergrundfarbe des Texts fest.

Parameter

NameTypBeschreibung
colorColor

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setBackgroundColor(red, green, blue)

Legt die Hintergrundfarbe des Texts auf die angegebenen RGB‑Werte im Bereich von 0 bis 255 fest.

Parameter

NameTypBeschreibung
redInteger
greenInteger
blueInteger

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setBackgroundColor(hexColor)

Legt die Hintergrundfarbe des Texts auf den angegebenen Hex‑Farbcode fest.

Der Hex‑Farbcode muss ein String im Format #RRGGBB sein. Für die Farbe Rosa würden Sie beispielsweise #FFC0CB angeben.

Parameter

NameTypBeschreibung
hexColorString

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setBackgroundColor(color)

Legt die Hintergrundfarbe des Texts auf den angegebenen ThemeColorType fest.

Parameter

NameTypBeschreibung
colorThemeColorType

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setBackgroundColorTransparent()

Legt fest, dass die Hintergrundfarbe des Texts transparent sein soll.

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setBaselineOffset(offset)

Legt den vertikalen Versatz des Texts relativ zu seiner Normalposition fest.

Parameter

NameTypBeschreibung
offsetTextBaselineOffset

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setBold(bold)

Legt fest, ob der Text fett gerendert werden soll.

Wenn Sie diese Textformatierung ändern, wird die Schriftstärke aktualisiert, in der der Text gerendert wird.

Parameter

NameTypBeschreibung
boldBoolean

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setFontFamily(fontFamily)

Legt die Schriftfamilie des Texts fest.

Parameter

NameTypBeschreibung
fontFamilyString

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setFontFamilyAndWeight(fontFamily, fontWeight)

Legt die Schriftfamilie und die Schriftstärke des Texts fest.

Die Schriftstärke ist ein Vielfaches von 100 aus dem Wertebereich von 100 bis 900 (100 und 900 jeweils eingeschlossen). Dieser Bereich entspricht den numerischen Werten in der Spezifikation CSS 2.1, Abschnitt 15.6. Die dort genannten nicht numerischen Werte sind jedoch unzulässig. Schriftstärken größer oder gleich 700 gelten als fett. In diesem Fall gibt isBold() den Wert true zurück. Der Standardwert ist 400 („normal“).

Parameter

NameTypBeschreibung
fontFamilyString
fontWeightInteger

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setFontSize(fontSize)

Legt den Schriftgrad des Texts in der Einheit „Punkt“ fest.

Parameter

NameTypBeschreibung
fontSizeNumber

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setForegroundColor(foregroundColor)

Legt die Vordergrundfarbe des Texts fest.

Parameter

NameTypBeschreibung
foregroundColorColor

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setForegroundColor(red, green, blue)

Legt die Vordergrundfarbe des Texts auf die angegebenen RGB‑Werte im Bereich von 0 bis 255 fest.

Parameter

NameTypBeschreibung
redInteger
greenInteger
blueInteger

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setForegroundColor(hexColor)

Legt die Vordergrundfarbe des Texts auf den angegebenen Hex‑Farbcode fest.

Der Hex‑Farbcode muss ein String im Format #RRGGBB sein. Für die Farbe Rosa würden Sie beispielsweise #FFC0CB angeben.

Parameter

NameTypBeschreibung
hexColorString

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setForegroundColor(color)

Legt die Vordergrundfarbe des Texts auf den angegebenen ThemeColorType fest.

Parameter

NameTypBeschreibung
colorThemeColorType

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setItalic(italic)

Legt fest, ob der Text kursiv gerendert werden soll.

Parameter

NameTypBeschreibung
italicBoolean

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setLinkSlide(slideIndex)

Legt einen Link auf die angegebene Slide fest unter Verwendung des nullbasierten Folienindex.

Wenn Sie einen Link für einen Text festlegen, geben Sie damit auch vor, dass der Text unterstrichen und in der in ThemeColorType.HYPERLINK definierten Vordergrundfarbe gerendert werden soll. Diese Formatierungen lassen sich mit setForegroundColor(hexColor) und setUnderline(underline) ändern.

Da auf Neue-Zeile-Zeichen (Zeilenvorschubzeichen) keine Links angewendet werden können, werden alle Neue-Zeile-Zeichen in TextRange ignoriert. 

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(0);

Parameter

NameTypBeschreibung
slideIndexIntegerNullbasierter Index der Folie

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setLinkSlide(slide)

Legt einen Link auf die angegebene Slide fest unter Verwendung der angegebenen Folien‑ID.

Wenn Sie einen Link für einen Text festlegen, geben Sie damit auch vor, dass der Text unterstrichen und in der in ThemeColorType.HYPERLINK definierten Vordergrundfarbe gerendert werden soll. Diese Formatierungen lassen sich mit setForegroundColor(hexColor) und setUnderline(underline) ändern.

Da auf Neue-Zeile-Zeichen (Zeilenvorschubzeichen) keine Links angewendet werden können, werden alle Neue-Zeile-Zeichen in TextRange ignoriert. 

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(slide);

Parameter

NameTypBeschreibung
slideSlideSlide, auf die der Link verweisen soll

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setLinkSlide(slidePosition)

Legt einen Link auf die angegebene Slide fest unter Verwendung der relativen Position der Folie.

Wenn Sie einen Link für einen Text festlegen, geben Sie damit auch vor, dass der Text unterstrichen und in der in ThemeColorType.HYPERLINK definierten Vordergrundfarbe gerendert werden soll. Diese Formatierungen lassen sich mit setForegroundColor(hexColor) und setUnderline(underline) ändern.

Da auf Neue-Zeile-Zeichen (Zeilenvorschubzeichen) keine Links angewendet werden können, werden alle Neue-Zeile-Zeichen in TextRange ignoriert. 

// Set a link to the first slide of the presentation.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Parameter

NameTypBeschreibung
slidePositionSlidePositionRelative SlidePosition

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setLinkUrl(url)

Legt einen Link auf den angegebenen nicht leeren URL‑String fest.

Wenn Sie einen Link für einen Text festlegen, geben Sie damit auch vor, dass der Text unterstrichen und in der in ThemeColorType.HYPERLINK definierten Vordergrundfarbe gerendert werden soll. Diese Formatierungen lassen sich mit setForegroundColor(hexColor) und setUnderline(underline) ändern.

Da auf Neue-Zeile-Zeichen (Zeilenvorschubzeichen) keine Links angewendet werden können, werden alle Neue-Zeile-Zeichen in TextRange ignoriert. 

// Set a link to the URL.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkUrl('https://slides.google.com');

Parameter

NameTypBeschreibung
urlStringURL‑String

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setSmallCaps(smallCaps)

Legt fest, ob der Text in Kapitälchen gerendert werden soll.

Parameter

NameTypBeschreibung
smallCapsBoolean

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setStrikethrough(strikethrough)

Legt fest, ob der Text durchgestrichen gerendert werden soll.

Parameter

NameTypBeschreibung
strikethroughBoolean

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setUnderline(underline)

Legt fest, ob der Text unterstrichen gerendert werden soll.

Parameter

NameTypBeschreibung
underlineBoolean

Rückgabe

TextStyle

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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