Text

Textinhalt

Der allgemeine Textinhalt. Der Text muss in einer kompatiblen Form (z.B. Textfeld oder Rechteck) oder in einer Tabellenzelle auf einer Seite platziert werden.

JSON-Darstellung 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Felder
textElements[]

object (TextElement)

Der Textinhalt ist in seine Komponenten unterteilt, einschließlich Stilinformationen. Diese Property ist schreibgeschützt.

lists

map (key: string, value: object ( List))

Die Aufzählungslisten in diesem Text, codiert nach Listen-ID.

Textelement

Ein TextElement beschreibt den Inhalt einer Reihe von Indexen im Textinhalt einer Form oder TableCell.

JSON-Darstellung 
{
  "startIndex": integer,
  "endIndex": integer,

  // Union field kind can be only one of the following:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of list of possible types for union field kind.
}
Felder
startIndex

integer

Der nullbasierte Startindex dieses Textelements in Unicode-Codeeinheiten.

endIndex

integer

Der nullbasierte Endindex dieses Textelements, ausschließlich in Unicode-Codeeinheiten.

Union-Feld kind. Die Textart, die dieses Element darstellt. kind darf nur einer der folgenden Werte sein:
paragraphMarker

object (ParagraphMarker)

Eine Markierung, die den Anfang eines neuen Absatzes darstellt.

Die startIndex und die endIndex dieses Textelements stellen den Bereich des Absatzes dar. Andere TextElemente mit einem Indexbereich innerhalb des Bereichs dieses Absatzes werden als Teil dieses Absatzes betrachtet. Der Indexbereich zweier Absätze wird sich nicht überschneiden.

textRun

object (TextRun)

Ein TextElement, das eine Textausführung repräsentiert, wobei alle Zeichen in der Ausführung dieselbe TextStyle haben.

startIndex und endIndex von TextRuns sind immer vollständig im Indexbereich eines einzelnen paragraphMarker-Elements vom Typ „TextElement“ enthalten. Mit anderen Worten: Ein TextRun umfasst nicht mehrere Absätze.

autoText

object (AutoText)

Ein TextElement für einen Fleck im Text, der dynamisch durch Inhalte ersetzt wird, die sich im Laufe der Zeit ändern können.

Absatzmarkierung

Eine TextElement-Art, die den Anfang eines neuen Absatzes darstellt.

JSON-Darstellung 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Felder
style

object (ParagraphStyle)

Absatzstil

bullet

object (Bullet)

Der Aufzählungspunkt für diesen Absatz. Ist das nicht der Fall, gehört der Absatz nicht zu einer Liste.

Absatzstil

Stile, die für einen ganzen Absatz gelten.

Wenn dieser Text in einer Form mit einem übergeordneten placeholder-Element enthalten ist, können diese Absatzstile vom übergeordneten Element übernommen werden. Welche übernommenen Absatzstile werden von der Verschachtelungsebene der Listen übernommen:

  • Ein Absatz, der nicht in einer Liste enthalten ist, übernimmt den Absatzstil des Absatzes auf der Verschachtelungsebene der Liste innerhalb des übergeordneten Platzhalters.
  • Ein Absatz in einer Liste übernimmt den Absatzstil des Absatzes auf der entsprechenden Verschachtelungsebene der Liste innerhalb des übergeordneten Platzhalters.

Übernommene Absatzstile werden in dieser Nachricht als nicht festgelegte Felder angezeigt.

JSON-Darstellung 
{
  "lineSpacing": number,
  "alignment": enum (Alignment),
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "direction": enum (TextDirection),
  "spacingMode": enum (SpacingMode)
}
Felder
lineSpacing

number

Der Abstand zwischen den Linien, in Prozent als Normalwert, wobei „Normal“ als 100,0 dargestellt wird. Wird die Richtlinie nicht konfiguriert, wird der Wert vom übergeordneten Element übernommen.

alignment

enum (Alignment)

Die Textausrichtung für diesen Absatz.

indentStart

object (Dimension)

Der Einzug für den Absatz auf der Seite, der dem Anfang des Textes entspricht, basierend auf der aktuellen Textrichtung. Wird die Richtlinie nicht konfiguriert, wird der Wert vom übergeordneten Element übernommen.

indentEnd

object (Dimension)

Der Einzug für den Absatz auf der Seite, der dem Ende des Textes entspricht, basierend auf der aktuellen Textrichtung. Wird die Richtlinie nicht konfiguriert, wird der Wert vom übergeordneten Element übernommen.

spaceAbove

object (Dimension)

Der überschüssige Abstand über dem Absatz. Wird die Richtlinie nicht konfiguriert, wird der Wert vom übergeordneten Element übernommen.

spaceBelow

object (Dimension)

Der überschüssige Abstand unter dem Absatz. Wird die Richtlinie nicht konfiguriert, wird der Wert vom übergeordneten Element übernommen.

indentFirstLine

object (Dimension)

Der Einzug für den Anfang der ersten Zeile des Absatzes. Wird die Richtlinie nicht konfiguriert, wird der Wert vom übergeordneten Element übernommen.

direction

enum (TextDirection)

Die Textrichtung dieses Absatzes. Wenn der Wert nicht festgelegt ist, wird standardmäßig LEFT_TO_RIGHT verwendet, da die Textrichtung nicht übernommen wird.

spacingMode

enum (SpacingMode)

Der Abstandsmodus für den Absatz.

Ausrichtung

Die Arten der Textausrichtung für einen Absatz.

Enums
ALIGNMENT_UNSPECIFIED Die Absatzausrichtung wird vom übergeordneten Element übernommen.
START Der Absatz wird am Anfang der Zeile ausgerichtet. Linksbündig für LTR-Text, ansonsten rechtsbündig.
CENTER Der Absatz ist zentriert.
END Der Absatz ist am Ende der Zeile ausgerichtet. Rechts ausgerichtet für LTR-Text, ansonsten linksbündig.
JUSTIFIED Der Absatz wird gerechtfertigt.

Textrichtung

Der Routentext kann eingeblendet werden.

Enums
TEXT_DIRECTION_UNSPECIFIED Die Textrichtung wird vom übergeordneten Element übernommen.
LEFT_TO_RIGHT Der Text ist von links nach rechts zu sehen.
RIGHT_TO_LEFT Der Text reicht von rechts nach links.

Abstandsmodus

Die verschiedenen Modi für den Absatzabstand.

Enums
SPACING_MODE_UNSPECIFIED Der Abstandsmodus wird vom übergeordneten Element übernommen.
NEVER_COLLAPSE Absatzabstände werden immer gerendert.
COLLAPSE_LISTS Der Abstand zwischen Absätzen wird zwischen Listenelementen übersprungen.

Bullet-Diagramm

Beschreibt das Aufzählungszeichen eines Absatzes.

JSON-Darstellung 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Felder
listId

string

Die ID der Liste, zu der dieser Absatz gehört.

nestingLevel

integer

Die Verschachtelungsebene dieses Absatzes in der Liste.

glyph

string

Das gerenderte Gliederungszeichen für diesen Absatz.

bulletStyle

object (TextStyle)

Der Absatzspezifische Textstil, der auf diesen Aufzählungspunkt angewendet wird.

Textstil

Das Styling, das auf einen TextRun angewendet werden kann.

Wenn dieser Text in einer Form mit einem übergeordneten placeholder-Element enthalten ist, können diese Textstile vom übergeordneten Element übernommen werden. Welche Textstile übernommen werden, hängt von der Verschachtelungsebene der Listen ab:

  • Ein Text, der in einem Absatz ausgeführt wird, der nicht in einer Liste steht, übernimmt den Textstil des Zeilenumbruchs im Absatz auf der Verschachtelungsebene der Liste innerhalb des übergeordneten Platzhalters.
  • Text, der in einem Absatz in einer Liste ausgeführt wird, übernimmt den Textstil des Zeilenumbruchs im Absatz auf der entsprechenden Verschachtelungsebene der Liste innerhalb des übergeordneten Platzhalters.

Übernommene Textstile werden in dieser Nachricht als nicht festgelegte Felder angezeigt. Wenn Text in einer Form ohne übergeordneten Platzhalter enthalten ist, wird durch das Zurücksetzen dieser Felder der Stil auf einen Wert zurückgesetzt, der den Standardeinstellungen im Präsentationen-Editor entspricht.

JSON-Darstellung 
{
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "bold": boolean,
  "italic": boolean,
  "fontFamily": string,
  "fontSize": {
    object (Dimension)
  },
  "link": {
    object (Link)
  },
  "baselineOffset": enum (BaselineOffset),
  "smallCaps": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "weightedFontFamily": {
    object (WeightedFontFamily)
  }
}
Felder
backgroundColor

object (OptionalColor)

Hintergrundfarbe des Texts Wenn sie festgelegt wird, ist die Farbe entweder undurchsichtig oder transparent, je nachdem, ob das Feld opaqueColor darin festgelegt ist.

foregroundColor

object (OptionalColor)

Die Farbe des Textes selbst. Wenn sie festgelegt wird, ist die Farbe entweder undurchsichtig oder transparent, je nachdem, ob das Feld opaqueColor darin festgelegt ist.

bold

boolean

Gibt an, ob der Text fett formatiert ist.

italic

boolean

Gibt an, ob der Text kursiv dargestellt wird.

fontFamily

string

Die Schriftfamilie des Textes

Die Schriftfamilie kann aus einer beliebigen Schriftart im Menü „Schriftarten“ in Google Präsentationen oder aus Google Fonts bestehen. Wenn der Name der Schriftart nicht erkannt wird, wird der Text in Arial gerendert.

Einige Schriftarten können die Stärke des Texts beeinflussen. Wenn in einer Aktualisierungsanfrage Werte für fontFamily und bold angegeben werden, wird der explizit festgelegte Wert bold verwendet.

fontSize

object (Dimension)

Die Größe der Schriftart des Texts. Beim Lesen wird der fontSize in Punkten angegeben.

baselineOffset

enum (BaselineOffset)

Der vertikale Versatz des Textes von seiner normalen Position aus.

Text mit SUPERSCRIPT- oder SUBSCRIPT-Baseline-Offsets wird automatisch in einer kleineren Schriftgröße gerendert, die auf der Grundlage des Felds fontSize berechnet wird. Der fontSize selbst ist von Änderungen in diesem Feld nicht betroffen.

smallCaps

boolean

Gibt an, ob der Text in Großbuchstaben geschrieben ist.

strikethrough

boolean

Gibt an, ob der Text durchgestrichen wird.

underline

boolean

Gibt an, ob der Text unterstrichen ist.

weightedFontFamily

object (WeightedFontFamily)

Die Schriftfamilie und die gerenderte Gewichtung des Textes.

Dieses Feld ist eine Erweiterung von fontFamily, die explizite Schriftstärken unterstützen soll, ohne die Abwärtskompatibilität zu beeinträchtigen. Beim Lesen des Stils eines Textbereichs ist der Wert von weightedFontFamily#fontFamily immer gleich dem von fontFamily. Wenn beim Schreiben jedoch beide Felder (entweder explizit oder über den Platzhalter "*") in die Feldmaske eingeschlossen sind, werden ihre Werte so abgeglichen:

  • Wenn fontFamily festgelegt ist und weightedFontFamily nicht, wird der Wert von fontFamily mit der Gewichtung 400 („normal“) angewendet.
  • Wenn beide Felder festgelegt sind, muss der Wert von fontFamily mit dem von weightedFontFamily#fontFamily übereinstimmen. Ist das der Fall, werden die Schriftfamilie und -stärke von weightedFontFamily angewendet. Andernfalls wird der Fehler 400 zurückgegeben.
  • Wenn weightedFontFamily festgelegt ist, fontFamily aber nicht, werden die Schriftfamilie und -stärke von weightedFontFamily angewendet.
  • Wenn keines der beiden Felder festgelegt ist, werden die Schriftfamilie und die Schriftstärke des Textes vom übergeordneten Element übernommen. Diese Eigenschaften können nicht separat übernommen werden.

Wenn in einer Aktualisierungsanfrage Werte sowohl für weightedFontFamily als auch für bold angegeben werden, wird zuerst weightedFontFamily und dann bold angewendet.

Wenn weightedFontFamily#weight nicht festgelegt ist, wird standardmäßig 400 verwendet.

Wenn weightedFontFamily festgelegt ist, muss auch weightedFontFamily#fontFamily mit einem nicht leeren Wert festgelegt werden. Andernfalls wird der Fehler 400 zurückgegeben.

Optionale Farbe

Eine Farbe, die entweder undurchsichtig oder vollständig transparent ist.

JSON-Darstellung 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Felder
opaqueColor

object (OpaqueColor)

Wenn die Richtlinie festgelegt ist, wird sie als undurchsichtige Farbe verwendet. Ist die Richtlinie nicht konfiguriert, wird eine transparente Farbe verwendet.

BaselineOffset

Die Art und Weise, wie Text vertikal ausgerichtet werden kann.

Enums
BASELINE_OFFSET_UNSPECIFIED Der Referenzversatz des Textes wird vom übergeordneten Element übernommen.
NONE Der Text ist nicht vertikal versetzt.
SUPERSCRIPT Der Text ist vertikal nach oben verschoben (hochgestellt).
SUBSCRIPT Der Text ist vertikal nach unten verschoben (Tiefzahl).

Schriftfamilie

Stellt eine Schriftfamilie und -stärke dar, die zum Gestalten eines TextRun verwendet werden.

JSON-Darstellung 
{
  "fontFamily": string,
  "weight": integer
}
Felder
fontFamily

string

Die Schriftfamilie des Textes

Die Schriftfamilie kann aus einer beliebigen Schriftart im Menü „Schriftarten“ in Google Präsentationen oder aus Google Fonts bestehen. Wenn der Name der Schriftart nicht erkannt wird, wird der Text in Arial gerendert.

weight

integer

Die gerenderte Gewichtung des Texts. Dieses Feld kann einen beliebigen Wert haben, der ein Vielfaches von 100 zwischen 100 und 900 ist. Dieser Bereich entspricht den in der CSS 2.1-Spezifikation beschriebenen numerischen Werten (Abschnitt 15.6), wobei nicht numerische Werte zulässig sind. Gewichtungen über oder gleich 700 werden fett formatiert, Gewichtungen unter 700 nicht fett. Der Standardwert ist 400 („normal“).

Textlauf

Eine TextElement-Art, die für einen Textlauf steht, der alle denselben Stil hat.

JSON-Darstellung 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Felder
content

string

Der Text dieser Ausführung.

style

object (TextStyle)

Der auf diese Ausführung angewendete Stil.

AutoText

Eine TextElement-Art, die automatischen Text darstellt.

JSON-Darstellung 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Felder
type

enum (Type)

Der Typ dieses automatischen Texts.

content

string

Der gerenderte Inhalt dieses automatischen Texts, falls verfügbar.

style

object (TextStyle)

Der Stil für diesen automatischen Text

Typ

Arten von automatischem Text

Enums
TYPE_UNSPECIFIED Ein nicht angegebener Autotexttyp.
SLIDE_NUMBER Typ für Autotext zur Darstellung der aktuellen Foliennummer.

Liste

In einer Liste wird das Erscheinungsbild von Aufzählungspunkten in Absätzen beschrieben, die mit einer Liste verknüpft sind. Ein Absatz, der Teil einer Liste ist, verweist implizit auf die ID dieser Liste.

JSON-Darstellung 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Felder
listId

string

Die ID der Liste.

nestingLevel

map (key: integer, value: object ( NestingLevel))

Eine Zuordnung von Verschachtelungsebenen zu den Eigenschaften von Aufzählungspunkten auf der zugehörigen Ebene. Eine Liste hat maximal neun Verschachtelungsebenen. Daher sind die möglichen Werte für die Schlüssel dieser Karte von 0 bis einschließlich 8.

Niststand

Enthält Eigenschaften, die das Erscheinungsbild eines Listenpunkts bei einer bestimmten Verschachtelungsebene beschreiben.

JSON-Darstellung 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Felder
bulletStyle

object (TextStyle)

Der Stil eines Aufzählungszeichens auf dieser Verschachtelungsebene.