Halaman ini diterjemahkan oleh Cloud Translation API.

Class Position

Referensi ke lokasi dalam dokumen, relatif terhadap elemen tertentu. Kursor pengguna direpresentasikan sebagai Position, di antara penggunaan lainnya. Skrip hanya dapat mengakses kursor pengguna yang menjalankan skrip, dan hanya jika skrip terikat ke dokumen.

// Insert some text at the cursor position and make it bold.
var 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.
  var element = cursor.insertText('ಠ‿ಠ');
  if (element) {
    element.setBold(true);
  } else {
    DocumentApp.getUi().alert('Cannot insert text here.');
  }
} else {
  DocumentApp.getUi().alert('Cannot find a cursor.');
}

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getElement()`	`Element`	Mendapatkan elemen yang berisi `Position` ini.
`getOffset()`	`Integer`	Mendapatkan lokasi relatif `Position` ini dalam elemen yang memuatnya.
`getSurroundingText()`	`Text`	Membuat elemen `Text` buatan yang merepresentasikan teks dan pemformatan `Paragraph` atau `ListItem` yang berisi `Position`, baik secara langsung maupun melalui rantai elemen turunan.
`getSurroundingTextOffset()`	`Integer`	Mendapatkan offset `Position` ini dalam elemen `Text` yang ditampilkan oleh `getSurroundingText()`.
`insertBookmark()`	`Bookmark`	Membuat dan menyisipkan `Bookmark` baru di `Position` ini.
`insertInlineImage(image)`	`InlineImage`	Membuat dan menyisipkan `InlineImage` baru pada `Position` ini dari blob gambar yang ditentukan.
`insertText(text)`	`Text`	Menyisipkan teks yang ditentukan pada `Position` ini.

Dokumentasi mendetail

`getElement()`

Mendapatkan elemen yang berisi Position ini. Ini dapat berupa elemen Text atau elemen penampung seperti Paragraph. Dalam kedua kasus tersebut, posisi relatif dalam elemen dapat ditentukan dengan getOffset().

Return

Element — penampung atau elemen Text tempat objek Position ini berada

`getOffset()`

Mendapatkan lokasi relatif Position ini dalam elemen yang memuatnya. Jika elemen adalah elemen Text, offsetnya adalah jumlah karakter sebelum Position (yaitu, indeks karakter setelah Position ini); untuk elemen lainnya, offsetnya adalah jumlah elemen turunan sebelum Position ini dalam elemen penampung yang sama (yaitu, indeks elemen turunan setelah Position).

Return

Integer — untuk elemen Text, jumlah karakter sebelum Position ini; untuk elemen lainnya, jumlah elemen turunan sebelum Position ini dalam elemen penampung yang sama

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getSurroundingText()`

Membuat elemen Text buatan yang merepresentasikan teks dan pemformatan Paragraph atau ListItem yang berisi Position, baik secara langsung maupun melalui rantai elemen turunan. Untuk menentukan offset Position dalam elemen Text yang ditampilkan, gunakan getSurroundingTextOffset().

Return

Text — elemen yang setara dengan hasil pemanggilan editAsText() pada Paragraph atau ListItem yang berisi Position, baik secara langsung atau melalui rantai elemen turunan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getSurroundingTextOffset()`

Mendapatkan offset Position ini dalam elemen Text yang ditampilkan oleh getSurroundingText(). Offset adalah jumlah karakter sebelum Position (yaitu, indeks karakter setelah Position ini).

Return

Integer — jumlah karakter sebelum Position ini dalam Paragraph atau ListItem yang berisi Position, baik secara langsung maupun melalui rantai elemen turunan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`insertBookmark()`

Membuat dan menyisipkan Bookmark baru di Position ini.

Return

Bookmark — bookmark baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`insertInlineImage(image)`

Membuat dan menyisipkan InlineImage baru pada Position ini dari blob gambar yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`image`	`BlobSource`	data gambar untuk disisipkan di `Position` ini

Return

InlineImage — elemen gambar baru, atau null jika elemen tempat Position ini berada tidak memungkinkan gambar untuk disisipkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`insertText(text)`

Menyisipkan teks yang ditentukan pada Position ini. Metode ini membuat elemen Text baru, meskipun string disisipkan dalam elemen Text yang ada, sehingga mudah untuk menata gaya elemen baru.

Parameter

Nama	Jenis	Deskripsi
`text`	`String`	string yang akan disisipkan di `Position` ini

Return

Text — elemen teks baru, atau null jika elemen tempat Position ini berada tidak memungkinkan penyisipan teks

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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