Class Position

Posizione

Un riferimento a una posizione nella scheda del documento, relativa a un elemento specifico. Il cursore dell'utente è rappresentato da un Position, tra gli altri utilizzi. Gli script possono accedere al cursore dell'utente che li esegue solo se sono associati al documento. 

// Insert some text at the cursor position and make it bold.
const cursor = DocumentApp.getActiveDocument().getCursor();
if (cursor) {
  // Attempt to insert text at the cursor position. If the insertion returns
  // null, the cursor's containing element doesn't allow insertions, so show the
  // user an error message.
  const element = cursor.insertText('ಠ‿ಠ');
  if (element) {
    element.setBold(true);
  } else {
    DocumentApp.getUi().alert('Cannot insert text here.');
  }
} else {
  DocumentApp.getUi().alert('Cannot find a cursor.');
}

Metodi

MetodoTipo restituitoBreve descrizione
getElement()ElementRecupera l'elemento che contiene questo Position.
getOffset()IntegerOttiene la posizione relativa di questo Position all'interno dell'elemento che lo contiene.
getSurroundingText()TextCrea un elemento Text artificiale che rappresenta il testo e la formattazione di Paragraph o ListItem che contiene Position, direttamente o tramite una catena di elementi secondari.
getSurroundingTextOffset()IntegerRestituisce l'offset di questo Position all'interno dell'elemento Text restituito da getSurroundingText().
insertBookmark()BookmarkCrea e inserisce un nuovo Bookmark in questo Position.
insertInlineImage(image)InlineImage|nullCrea e inserisce un nuovo InlineImage in questo Position dal blob dell'immagine specificata.
insertText(text)Text|nullInserisce il testo specificato in questo Position.

Documentazione dettagliata

getElement()

Recupera l'elemento che contiene questo Position. Si tratta di un elemento Text o di un elemento contenitore come Paragraph. In entrambi i casi, la posizione relativa all'interno dell'elemento può essere determinata con getOffset().

Indietro

Element: il contenitore o l'elemento Text in cui si trova questo oggetto Position

getOffset()

Ottiene la posizione relativa di questo Position all'interno dell'elemento che lo contiene. Se l'elemento è un elemento Text, l'offset è il numero di caratteri prima di Position (ovvero l'indice del carattere dopo Position); per qualsiasi altro elemento, l'offset è il numero di elementi secondari prima di Position all'interno dello stesso elemento contenitore (ovvero l'indice dell'elemento secondario dopo Position).

Indietro

Integer: per gli elementi Text, il numero di caratteri prima di questo Position; per gli altri elementi, il numero di elementi secondari prima di questo Position all'interno dello stesso elemento contenitore

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getSurroundingText()

Crea un elemento Text artificiale che rappresenta il testo e la formattazione di Paragraph o ListItem che contiene Position, direttamente o tramite una catena di elementi secondari. Per determinare l'offset di Position nell'elemento Text restituito, utilizza getSurroundingTextOffset().

Indietro

Text: un elemento equivalente al risultato della chiamata di editAsText() su Paragraph o ListItem che contiene Position, direttamente o tramite una catena di elementi secondari

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getSurroundingTextOffset()

Restituisce l'offset di questo Position all'interno dell'elemento Text restituito da getSurroundingText(). L'offset è il numero di caratteri prima di Position (ovvero l'indice del carattere dopo Position).

Indietro

Integer: il numero di caratteri prima di questo Position in Paragraph o ListItem che contiene Position, direttamente o tramite una catena di elementi secondari

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

insertBookmark()

Crea e inserisce un nuovo Bookmark in questo Position.

Indietro

Bookmark: il nuovo segnalibro

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

insertInlineImage(image)

Crea e inserisce un nuovo InlineImage in questo Position dal blob dell'immagine specificata.

Parametri

NomeTipoDescrizione
imageBlobSourcei dati dell'immagine da inserire in questo Position

Indietro

InlineImage|null: il nuovo elemento immagine oppure null se l'elemento in cui si trova questo Position non consente l'inserimento di immagini

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

insertText(text)

Inserisce il testo specificato in questo Position. Questo metodo crea un nuovo elemento Text, anche se la stringa viene inserita all'interno di un elemento Text esistente, in modo che sia facile applicare uno stile al nuovo elemento.

Parametri

NomeTipoDescrizione
textStringla stringa da inserire in questo Position

Indietro

Text|null: il nuovo elemento di testo o null se l'elemento in cui si trova questo Position non consente l'inserimento di testo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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