Text

Contenuto del testo

Il contenuto generale del testo. Il testo deve trovarsi in una forma compatibile (ad esempio casella di testo o rettangolo) o in una cella di tabella di una pagina.

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

object (TextElement)

Il contenuto del testo suddiviso nelle sue componenti, comprese le informazioni sullo stile. Questa proprietà è di sola lettura.

lists

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

Gli elenchi puntati contenuti in questo testo, criptati da ID elenco.

Elemento di testo

Un elemento TextElement descrive i contenuti di un intervallo di indici nei contenuti testuali di una forma o di una tabella.

Rappresentazione 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.
}
Campi
startIndex

integer

L'indice iniziale di zero di questo elemento di testo, espresso in unità di codice Unicode.

endIndex

integer

L'indice finale a base zero di questo elemento di testo, esclusivo, nelle unità di codice Unicode.

Campo Union kind. Il tipo di testo rappresentato da questo elemento. kind può essere solo uno dei seguenti:
paragraphMarker

object (ParagraphMarker)

Un indicatore che rappresenta l'inizio di un nuovo paragrafo.

startIndex e endIndex di questo elemento di testo rappresentano l'intervallo di paragrafo. Gli altri elementi di testo con un intervallo di indice contenuto nell'intervallo di questo paragrafo sono considerati parte di questo paragrafo. L'intervallo di indici di due paragrafi separati non si sovrapporrà mai.

textRun

object (TextRun)

Un elemento di testo che rappresenta un'esecuzione di testo in cui tutti i caratteri dell'esecuzione hanno lo stesso valore TextStyle.

startIndex e endIndex di TextRuns saranno sempre inclusi nell'intervallo di indice di un singolo paragraphMarker TextElement. In altre parole, un TextRun non si estende mai su più paragrafi.

autoText

object (AutoText)

Un elemento di testo che rappresenta uno spot nel testo che viene sostituito dinamicamente con contenuti che possono cambiare nel tempo.

Paragrafo

Un tipo di TextElement che rappresenta l'inizio di un nuovo paragrafo.

Rappresentazione JSON 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Campi
style

object (ParagraphStyle)

Stile del paragrafo

bullet

object (Bullet)

Il punto elenco di questo paragrafo. In caso contrario, il paragrafo non appartiene a un elenco.

Stile paragrafo

Stili che si applicano a un intero paragrafo.

Se questo testo è contenuto in una forma con un elemento placeholder principale, gli stili paragrafo possono essere ereditati dall'elemento principale. Gli stili dei paragrafi ereditati dipendono dal livello di nidificazione degli elenchi:

  • Un paragrafo non incluso in un elenco eredita il relativo stile dal paragrafo a 0 anni all'interno dell'elenco all'interno del segnaposto principale.
  • Un paragrafo di un elenco eredita lo stile del paragrafo dal relativo livello di nidificazione dell'elenco all'interno del segnaposto principale.

Gli stili dei paragrafi ereditati sono rappresentati come campi non impostati in questo messaggio.

Rappresentazione 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)
}
Campi
lineSpacing

number

La quantità di spazio tra le linee, come percentuale del normale, dove normale è rappresentato come 100,0. Se non viene configurato, il valore viene ereditato dall'elemento principale.

alignment

enum (Alignment)

L'allineamento del testo per questo paragrafo.

indentStart

object (Dimension)

Il rientro per il paragrafo sul lato che corrisponde all'inizio del testo in base alla direzione del testo corrente. Se non viene configurato, il valore viene ereditato dall'elemento principale.

indentEnd

object (Dimension)

Il rientro del paragrafo sul lato che corrisponde alla fine del testo, in base alla direzione del testo corrente. Se non viene configurato, il valore viene ereditato dall'elemento principale.

spaceAbove

object (Dimension)

La quantità di spazio supplementare sopra il paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento principale.

spaceBelow

object (Dimension)

La quantità di spazio supplementare sotto il paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento principale.

indentFirstLine

object (Dimension)

Il valore di rientro per l'inizio della prima riga del paragrafo. Se non viene configurato, il valore viene ereditato dall'elemento principale.

direction

enum (TextDirection)

La direzione del testo di questo paragrafo. Se non viene configurato, il valore predefinito è LEFT_TO_RIGHT, poiché la direzione del testo non viene ereditata.

spacingMode

enum (SpacingMode)

La modalità di spaziatura del paragrafo.

Allineamento

I tipi di allineamento del testo per un paragrafo.

Enum
ALIGNMENT_UNSPECIFIED L'allineamento del paragrafo viene ereditato dalla risorsa principale.
START Il paragrafo è allineato all'inizio della riga. Allineato a sinistra per il testo LTR, altrimenti allineato a destra.
CENTER Il paragrafo è centrato.
END Il paragrafo è allineato alla fine della riga. Allineato a destra per testo LTR, altrimenti allineato a sinistra.
JUSTIFIED Il paragrafo è giustificato.

Direzione testo

Il testo delle indicazioni stradali può scorrere.

Enum
TEXT_DIRECTION_UNSPECIFIED La direzione del testo viene ereditata dall'elemento principale.
LEFT_TO_RIGHT Il testo va da sinistra a destra.
RIGHT_TO_LEFT Il testo va da destra a sinistra.

Modalità spaziatura

Le diverse modalità di spaziatura dei paragrafi.

Enum
SPACING_MODE_UNSPECIFIED La modalità di spaziatura viene ereditata dall'elemento principale.
NEVER_COLLAPSE La spaziatura del paragrafo è sempre visualizzata.
COLLAPSE_LISTS La spaziatura del paragrafo viene ignorata tra gli elementi dell'elenco.

Bullet

Descrive il punto elenco di un paragrafo.

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

string

L'ID dell'elenco a cui appartiene questo paragrafo.

nestingLevel

integer

Il livello di nidificazione di questo paragrafo nell'elenco.

glyph

string

Il glifo puntato visualizzato per questo paragrafo.

bulletStyle

object (TextStyle)

Lo stile del testo specifico del paragrafo applicato al punto elenco.

Stile testo

Rappresenta lo stile che può essere applicato a un TextRun.

Se questo testo è contenuto in una forma con un elemento placeholder principale, gli stili di testo potrebbero essere ereditati dall'elemento principale. Gli stili di testo ereditati dipendono dal livello di nidificazione degli elenchi:

  • Un testo eseguito in un paragrafo che non è in un elenco eredita lo stile del testo dal carattere della nuova riga del paragrafo al livello di nidificazione dell'elenco all'interno del segnaposto principale.
  • Un testo eseguito in un paragrafo all'interno di un elenco eredita il suo stile dal carattere di nuova riga nel paragrafo al relativo livello di nidificazione all'interno del segnaposto principale.

Gli stili di testo ereditati sono rappresentati come campi non impostati in questo messaggio. Se il testo è contenuto in una forma senza segnaposto principale, se annulli l'impostazione di questi campi verrà ripristinato lo stile del valore predefinito impostato nell'editor di Presentazioni.

Rappresentazione 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)
  }
}
Campi
backgroundColor

object (OptionalColor)

Il colore di sfondo del testo. Se impostato, il colore è opaco o trasparente, a seconda che sia impostato o meno il campo opaqueColor.

foregroundColor

object (OptionalColor)

Il colore del testo stesso. Se impostato, il colore è opaco o trasparente, a seconda che sia impostato o meno il campo opaqueColor.

bold

boolean

Indica se il testo viene visualizzato in grassetto o meno.

italic

boolean

Indica se il testo è in corsivo o meno.

fontFamily

string

La famiglia di caratteri del testo.

La famiglia di caratteri può essere qualsiasi carattere dal menu Carattere di Presentazioni o da Google Fonts. Se il nome del carattere non viene riconosciuto, il testo viene visualizzato in Arial.

Alcuni caratteri possono influire sullo spessore del testo. Se una richiesta di aggiornamento specifica sia i valori fontFamily sia bold, viene utilizzato il valore bold esplicitamente impostato.

fontSize

object (Dimension)

Le dimensioni del carattere del testo. Al momento della lettura, fontSize verrà specificato in punti.

baselineOffset

enum (BaselineOffset)

Offset verticale del testo rispetto alla posizione normale.

Il testo con offset di base SUPERSCRIPT o SUBSCRIPT viene visualizzato automaticamente in una dimensione del carattere più piccola, calcolato in base al campo fontSize. Il campo fontSize stesso non è interessato dalle modifiche apportate in questo campo.

smallCaps

boolean

Indica se il testo è in minuscolo.

strikethrough

boolean

Indica se il testo viene barrato o meno.

underline

boolean

Indica se il testo è sottolineato o meno.

weightedFontFamily

object (WeightedFontFamily)

La famiglia di caratteri e lo spessore del testo.

Questo campo è un'estensione di fontFamily che supporta lo spessore esplicito dei caratteri senza compromettere la compatibilità con le versioni precedenti. Di conseguenza, quando leggi lo stile di un intervallo di testo, il valore di weightedFontFamily#fontFamily sarà sempre uguale a quello di fontFamily. Tuttavia, durante la scrittura, se entrambi i campi sono inclusi nella maschera del campo (sia esplicitamente che tramite carattere jolly "*"), i rispettivi valori vengono riconciliati come segue:

  • Se fontFamily è impostato e weightedFontFamily non lo è, il valore di fontFamily viene applicato con ponderazione 400 ("normale").
  • Se entrambi i campi sono impostati, il valore di fontFamily deve corrispondere a quello di weightedFontFamily#fontFamily. In questo caso, vengono applicati lo spessore e la famiglia di caratteri di weightedFontFamily. In caso contrario, viene restituito un errore di richiesta 400 non valido.
  • Se weightedFontFamily è impostato e fontFamily non lo è, vengono applicati la famiglia e lo spessore di caratteri di weightedFontFamily.
  • Se non si imposta nessuno dei due campi, la famiglia di caratteri e lo spessore del testo ereditano dall'elemento principale. Tieni presente che queste proprietà non possono ereditare le proprietà separatamente.

Se una richiesta di aggiornamento specifica sia i valori weightedFontFamily sia bold, viene applicato prima weightedFontFamily, poi bold.

Se weightedFontFamily#weight non è impostato, il valore predefinito è 400.

Se weightedFontFamily è impostato, anche weightedFontFamily#fontFamily deve essere impostato con un valore non vuoto. In caso contrario, viene restituito un errore di richiesta 400 non valido.

Colore facoltativo

Un colore che può essere completamente opaco o completamente trasparente.

Rappresentazione JSON 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Campi
opaqueColor

object (OpaqueColor)

Se impostata, verrà utilizzato come colore opaco. Se non viene configurato, si tratta di un colore trasparente.

Offset base di riferimento

Modalità di offset verticale del testo rispetto alla posizione normale.

Enum
BASELINE_OFFSET_UNSPECIFIED L'offset riferimento del testo viene ereditato dalla riga principale.
NONE Il testo non viene offset verticale.
SUPERSCRIPT Il testo è sfalsato verticalmente verso l'alto (apice).
SUBSCRIPT Il testo è spostato verticalmente verso il basso (pedice).

Famiglia di caratteri ponderata

Rappresenta una famiglia di caratteri e uno spessore utilizzati per applicare uno stile a TextRun.

Rappresentazione JSON 
{
  "fontFamily": string,
  "weight": integer
}
Campi
fontFamily

string

La famiglia di caratteri del testo.

La famiglia di caratteri può essere qualsiasi carattere dal menu Carattere di Presentazioni o da Google Fonts. Se il nome del carattere non viene riconosciuto, il testo viene visualizzato in Arial.

weight

integer

Lo spessore del testo visualizzato. Questo campo può avere qualsiasi valore che sia un multiplo di 100 compreso tra 100 e 900 inclusi. Questo intervallo corrisponde ai valori numerici descritti nella Specifica CSS 2.1, sezione 15.6, con i valori non numerici non consentiti. Le ponderazioni maggiori o uguali a 700 sono considerate in grassetto e le ponderazioni inferiori a 700 non sono in grassetto. Il valore predefinito è 400 ("normale").

TextRun

Un tipo di TextElement che rappresenta un'esecuzione di testo che ha tutti lo stesso stile.

Rappresentazione JSON 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Campi
content

string

Il testo di questa esecuzione.

style

object (TextStyle)

Lo stile applicato a questa esecuzione.

Testo automatico

Un tipo di TextElement che rappresenta il testo automatico.

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

enum (Type)

Il tipo di questo testo automatico.

content

string

I contenuti visualizzati di questo testo automatico, se disponibili.

style

object (TextStyle)

Lo stile applicato a questo testo automatico.

Tipo

I tipi di testo automatico

Enum
TYPE_UNSPECIFIED Un tipo di testo automatico non specificato.
SLIDE_NUMBER Digita per il testo automatico che rappresenta il numero di diapositiva corrente.

Elenco

Un elenco descrive l'aspetto dei punti elenco appartenenti ai paragrafi associati a un elenco. Un paragrafo che fa parte di un elenco ha un riferimento implicito all'ID di quell'elenco.

Rappresentazione JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Campi
listId

string

ID dell'elenco.

nestingLevel

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

Una mappa dei livelli di nidificazione alle proprietà dei punti elenco al livello associato. Un elenco è composto da un massimo di nove livelli di annidamento, pertanto i valori possibili per le chiavi di questa mappa sono compresi tra 0 e 8.

Livello di Nesting

Contiene proprietà che descrivono l'aspetto di un elenco puntato a un determinato livello di nidificazione.

Rappresentazione JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Campi
bulletStyle

object (TextStyle)

Lo stile di un punto elenco a questo livello di nidificazione.