Text

Tekst

Treści tekstowe. Tekst musi mieć zgodny kształt (np. pole tekstowe lub prostokąt) albo komórka tabeli.

Zapis JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Pola
textElements[]

object (TextElement)

Zawartość tekstu podzielona na poszczególne elementy, w tym informacje o stylu. Ta usługa jest tylko do odczytu.

lists

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

Listy punktowane w tym tekście, do których odwołuje się identyfikator listy.

Element tekstowy

Element TextElement opisuje zawartość szeregu indeksów w treści tekstowej kształtu lub komórki tabeli.

Zapis JSON 
{
  "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.
}
Pola
startIndex

integer

Indeks początkowy zero tego elementu w jednostkach kodu Unicode.

endIndex

integer

Indeks końcowy tego elementu tekstowego (zero) na poziomie 0 w jednostkach Unicode.

Pole sumy: kind. Rodzaj tekstu, który reprezentuje ten element. kind może być tylko jedną z tych wartości:
paragraphMarker

object (ParagraphMarker)

Znacznik na początku nowego akapitu.

startIndex i endIndex tego elementu tekstowego stanowią zakres akapitu. Inne fragmenty TextText o zakresie indeksu zawartym w tym akapicie są uznawane za część tego akapitu. Zakres indeksów z dwoma akapitami nigdy się nie pokrywa.

textRun

object (TextRun)

Element TextElement reprezentujący bieg tekstu, w którym wszystkie znaki w biegu mają ten sam TextStyle.

startIndex i endIndex TextTexts zawsze będą w pełni zawarte w indeksie pojedynczego paragraphMarkerTextElement. Oznacza to, że funkcja TextRun nigdy nie będzie obejmować wielu akapitów.

autoText

object (AutoText)

Element tekstowy Element w tekście, który dynamicznie zastępuje treść z czasem, która może się zmieniać.

Znacznik akapitu

Rodzaj TextElement, który reprezentuje początek nowego akapitu.

Zapis JSON 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Pola
style

object (ParagraphStyle)

Styl akapitu

bullet

object (Bullet)

Punktor w tym akapicie. Jeśli go nie ma, akapit nie należy do listy.

Styl akapitu

Style stosowane do całego akapitu.

Jeśli tekst zawiera kształt o nazwie placeholder, te style akapitu mogą być dziedziczone z elementu nadrzędnego. To, które style akapitu są dziedziczone, zależy od poziomu zagnieżdżenia list:

  • Akapit nieznajdujący się na liście, odziedziczy jego styl z akapitu na poziomie zagnieżdżenia listy na stronie nadrzędnej.
  • Akapit z listy odziedziczy jego styl z akapitu na odpowiednim poziomie zagnieżdżenia listy w obiekcie nadrzędnym.

Dziedziczone style akapitu są reprezentowane w tym polu w postaci nieskonfigurowanych pól.

Zapis JSON 
{
  "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)
}
Pola
lineSpacing

number

Wielkość odstępu między wierszami wyrażona jako procent normalnej wartości, w której normalny czas wynosi 100, 0. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

alignment

enum (Alignment)

Wyrównanie tekstu w tym akapicie.

indentStart

object (Dimension)

Wcięcie akapitu z boku odpowiadającego początkowi tekstu zgodne z bieżącym kierunkiem tekstu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

indentEnd

object (Dimension)

Wcięcie akapitu z boku odpowiadającego koniec tekstu na podstawie bieżącego kierunku tekstu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

spaceAbove

object (Dimension)

Ilość dodatkowego miejsca nad akapitem. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

spaceBelow

object (Dimension)

Ilość dodatkowego miejsca pod akapitem. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

indentFirstLine

object (Dimension)

Wcięcie na początku pierwszego wiersza akapitu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

direction

enum (TextDirection)

Kierunek tekstu w tym akapicie. Jeśli zasada jest nieskonfigurowana, wartość domyślna to LEFT_TO_RIGHT, ponieważ kierunek tekstu nie jest dziedziczony.

spacingMode

enum (SpacingMode)

Tryb odstępów dla akapitu.

Wyrównanie

Rodzaje wyrównania tekstu dla akapitu.

Wartości w polu enum
ALIGNMENT_UNSPECIFIED Wyrównanie akapitów jest dziedziczone z elementu nadrzędnego.
START Akapit rozpoczyna się od początku wiersza. Wyrównano do lewej w przypadku tekstu LTR i do prawej.
CENTER Akapit wyśrodkowano.
END Akapit wyrówna się do końca wiersza. Wyrównanie do prawej w tekście LTR i wyrównanie do lewej.
JUSTIFIED Akapit zawiera uzasadnienie.

Kierunek tekstu

Tekst wskazówek dojazdu może napływać.

Wartości w polu enum
TEXT_DIRECTION_UNSPECIFIED Kierunek tekstu jest dziedziczony z elementu nadrzędnego.
LEFT_TO_RIGHT Tekst przechodzi od lewej do prawej.
RIGHT_TO_LEFT Tekst przechodzi od prawej do lewej.

Tryb spacji

Różne tryby odstępów między akapitami.

Wartości w polu enum
SPACING_MODE_UNSPECIFIED Tryb odstępów jest dziedziczony z elementu nadrzędnego.
NEVER_COLLAPSE Odstępy w akapicie są zawsze renderowane.
COLLAPSE_LISTS Odstępy między akapitami są pomijane.

Pociskowy

Opisuje akapit.

Zapis JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Pola
listId

string

Identyfikator listy, do której należy ten akapit.

nestingLevel

integer

Poziom zagnieżdżenia tego akapitu na liście.

glyph

string

Renderowany glif do akapitu.

bulletStyle

object (TextStyle)

Wybrany styl akapitu akapitu.

Styl tekstu

Odzwierciedla styl, który można zastosować do TextRun.

Jeśli tekst zawiera kształt o nazwie placeholder, te style mogą być dziedziczone z elementu nadrzędnego. Odziedziczone style tekstu zależą od poziomu zagnieżdżenia list:

  • Tekst ułożony w akapicie, którego nie ma na liście, będzie dziedziczyć jego styl ze znaku nowego wiersza w akapicie na poziomie zagnieżdżenia listy w nadrzędnej zmiennej.
  • Tekst ułożony w akapicie, który znajduje się na liście, będzie dziedziczyć styl tekstu z nowego znaku w akapicie na odpowiednim poziomie zagnieżdżenia listy w nadrzędnej zmiennej.

Dziedziczone style tekstu są wyświetlane w tej wiadomości jako pola nieskonfigurowane. Jeśli tekst zawiera kształt bez zmiennej nadrzędnej, cofnięcie ustawienia spowoduje przywrócenie stylu do wartości domyślnej w edytorze Prezentacji.

Zapis JSON 
{
  "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)
  }
}
Pola
backgroundColor

object (OptionalColor)

Kolor tła tekstu. Gdy jest ustawiony, kolor jest przezroczysty lub przezroczysty w zależności od tego, czy pole opaqueColor jest w nim ustawione.

foregroundColor

object (OptionalColor)

Kolor tekstu. Gdy jest ustawiony, kolor jest przezroczysty lub przezroczysty w zależności od tego, czy pole opaqueColor jest w nim ustawione.

bold

boolean

Określa, czy tekst ma być pogrubiony.

italic

boolean

Określa, czy tekst jest zapisany kursywą.

fontFamily

string

Rodzina czcionek tekstu.

Rodzina czcionek może być dowolna z menu czcionek w Prezentacjach lub z Google Fonts. Jeśli nazwa czcionki nie zostanie rozpoznana, tekst zostanie wyrenderowany w języku Arial.

Niektóre czcionki mogą mieć wpływ na grubość tekstu. Jeśli żądanie aktualizacji zawiera wartości zarówno dla fontFamily, jak i bold, używana jest jawnie ustawiona wartość bold.

fontSize

object (Dimension)

Rozmiar czcionki tekstu. Wartość fontSize będzie podana w punktach.

baselineOffset

enum (BaselineOffset)

Przesunięcie w pionie względem normalnego położenia.

Tekst z przesunięciami podstawowymi SUPERSCRIPT lub SUBSCRIPT jest automatycznie renderowany przy mniejszym rozmiarze czcionki, obliczanym na podstawie pola fontSize. Zmiany w tym polu nie mają wpływu na sam fontSize.

smallCaps

boolean

Określa, czy tekst jest zapisany małymi literami.

strikethrough

boolean

Czy przekreślenie jest włączone.

underline

boolean

Czy tekst jest podkreślony.

weightedFontFamily

object (WeightedFontFamily)

Rodzina czcionek i wyrenderowana waga tekstu.

To pole jest rozszerzeniem fontFamily, które obsługuje określoną wagę czcionek bez naruszania zgodności wstecznej. W efekcie podczas odczytywania stylu zakresu tekstu wartość weightedFontFamily#fontFamily zawsze będzie równa wartości fontFamily. Jeśli jednak podczas zapisu występują oba pola w masce pól (jednoznacznie lub przez symbol wieloznaczny "*"), ich wartości są uzgadniane w ten sposób:

  • Jeśli ustawiona jest wartość fontFamily, a właściwość weightedFontFamily nie jest ustawiona, wartość fontFamily jest stosowana do wagi 400 ("normal").
  • Jeśli ustawisz oba pola, wartość fontFamily musi być zgodna z wartością weightedFontFamily#fontFamily. Jeśli tak, zostanie zastosowana rodzina czcionek i waga weightedFontFamily. W przeciwnym razie zwracany jest błąd 400.
  • Jeśli ustawiona jest weightedFontFamily, a fontFamily nie jest skonfigurowana, stosowana jest rodzina czcionek i waga weightedFontFamily.
  • Jeśli nie ustawisz żadnego z tych pól, rodzina i grubość czcionki będą dziedziczyć z elementu nadrzędnego. Pamiętaj, że te usługi nie mogą dziedziczyć się nawzajem.

Jeśli w żądaniu aktualizacji określono zarówno wartości weightedFontFamily, jak i bold, najpierw stosowana jest wartość weightedFontFamily, a potem bold.

Jeśli zasada weightedFontFamily#weight nie jest skonfigurowana, wartość domyślna to 400.

Jeśli skonfigurowana jest zasada weightedFontFamily, wartość weightedFontFamily#fontFamily nie może być pusta. W przeciwnym razie zwracany jest błąd 400.

Kolor opcjonalny

Kolor, który może być w pełni nieprzezroczysty lub w pełni przezroczysty.

Zapis JSON 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Pola
opaqueColor

object (OpaqueColor)

Po ustawieniu zostanie on ustawiony jako nieprzezroczysty. Jeśli zasada jest nieskonfigurowana, reprezentuje on przezroczysty kolor.

Odsunięcie Baseline

Sposoby przesunięcia tekstu w pozycji pionowej.

Wartości w polu enum
BASELINE_OFFSET_UNSPECIFIED Przesunięcie bazowe tekstu jest dziedziczone z elementu nadrzędnego.
NONE Tekst nie jest odsunięty w pionie.
SUPERSCRIPT Tekst jest odsunięty w górę (górny indeks).
SUBSCRIPT Tekst jest odsunięty w dół (dolny indeks).

Rodzina czcionek

Reprezentuje rodzinę czcionek i wagę używaną do określania stylu tekstu biegu.

Zapis JSON 
{
  "fontFamily": string,
  "weight": integer
}
Pola
fontFamily

string

Rodzina czcionek tekstu.

Rodzina czcionek może być dowolna z menu czcionek w Prezentacjach lub z Google Fonts. Jeśli nazwa czcionki nie zostanie rozpoznana, tekst zostanie wyrenderowany w języku Arial.

weight

integer

Waga wyrenderowanego tekstu. To pole może zawierać dowolną wartość będącą wielokrotnością wartości 100 od 100 do 900 (włącznie). Ten zakres odpowiada wartościom liczbowym opisanym w specyfikacji CSS 2.1 (sekcja 15.6), gdzie wartości nienumeryczne są niedozwolone. W przypadku wag większych niż 700 uważamy je za pogrubione, a wagi mniejsze niż 700 – nie. Wartością domyślną jest 400 („normalne”).

Uruchomienie tekstu

Rodzaj TextElement reprezentujący serię tekstu o identycznym stylu.

Zapis JSON 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Pola
content

string

Tekst tego uruchomienia.

style

object (TextStyle)

Styl zastosowany do tego uruchomienia.

Autotekst

Rodzaj TextElement, który reprezentuje tekst automatyczny.

Zapis JSON 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Pola
type

enum (Type)

Typ tego tekstu automatycznego.

content

string

Renderowana treść tego tekstu automatycznego (jeśli jest dostępna).

style

object (TextStyle)

Styl zastosowany do tego tekstu automatycznego.

Typ

Rodzaje tekstu automatycznego

Wartości w polu enum
TYPE_UNSPECIFIED Nieokreślony typ autotekstu.
SLIDE_NUMBER Wpisz tekst automatyczny reprezentujący bieżący numer slajdu.

Lista

Lista opisuje wygląd punktorów powiązanych z akapitami powiązanymi z listą. Akapit z listy zawiera bezpośrednie odwołanie do identyfikatora tej listy.

Zapis JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Pola
listId

string

Identyfikator listy.

nestingLevel

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

Mapa zagnieżdżania poziomów do właściwości punktorów na powiązanym poziomie. Lista zawiera maksymalnie 9 poziomów zagnieżdżania, więc możliwe wartości kluczy na tej mapie to od 0 do 8 włącznie.

Poziom Nest

Zawiera właściwości opisujące wygląd i charakter listy punktowanej na danym poziomie zagnieżdżania.

Zapis JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Pola
bulletStyle

object (TextStyle)

Styl punktu po zagnieżdżeniu.