Tablo hücresini temsil eden bir öğe. Table her zaman Table içinde yer alır ve List, Paragraph veya Table öğelerini içerebilir. Belge yapısı hakkında daha fazla bilgi için Google Dokümanlar'ı genişletme rehberine bakın.
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
append | Horizontal | Yeni bir Horizontal oluşturur ve ekler. |
append | Inline | Belirtilen resim blob'undan yeni bir Inline oluşturur ve ekler. |
append | Inline | Belirtilen Inline eklenir. |
append | List | Belirtilen List eklenir. |
append | List | Yeni bir List oluşturur ve ekler. |
append | Paragraph | Belirtilen Paragraph eklenir. |
append | Paragraph | Yeni bir Paragraph oluşturur ve ekler. |
append | Table | Yeni bir Table oluşturur ve ekler. |
append | Table | Belirtilen hücreleri içeren yeni bir Table ekler. |
append | Table | Belirtilen Table eklenir. |
clear() | Table | Öğenin içeriğini temizler. |
copy() | Table | Geçerli öğenin ayrılmış, derin bir kopyasını döndürür. |
edit | Text | Düzenlemek için mevcut öğenin Text sürümünü alır. |
find | Range | Öğenin içeriğinde, belirtilen türde bir alt öğe arar. |
find | Range | Belirtilen Range ile başlayarak, belirtilen türde bir alt öğe için öğenin içeriğini arar. |
find | Range | Normal ifadeleri kullanarak öğenin içeriğinde belirtilen metin kalıbını arar. |
find | Range | Belirtilen metin kalıbını, belirli bir arama sonucundan başlayarak öğenin içeriğinde arar. |
get | Object | Öğenin özelliklerini alır. |
get | String|null | Arka plan rengini alır. |
get | Element | Belirtilen alt dizindeki alt öğeyi alır. |
get | Integer | Belirtilen alt öğenin alt dizinini alır. |
get | Integer | Hücrenin kapsadığı tablo hücrelerinin sütun sayısı olan sütun aralığını alır. |
get | String|null | Bağlantı URL'sini alır. |
get | Element|null | Öğenin sonraki kardeş öğesini alır. |
get | Integer | Çocuk sayısını alır. |
get | Number|null | Alt dolguyu puan cinsinden alır. |
get | Number|null | Sol dolguyu puan cinsinden alır. |
get | Number|null | Sağ dolguyu puan cinsinden alır. |
get | Number|null | Üst dolguyu puan cinsinden alır. |
get | Container | Öğenin üst öğesini alır. |
get | Table | Mevcut Table öğesini içeren Table öğesini alır. |
get | Table|null | Mevcut Table öğesini içeren Table öğesini alır. |
get | Element|null | Öğenin önceki kardeş öğesini alır. |
get | Integer | Satır aralığını (bu hücrenin kapsadığı tablo hücresi satırlarının sayısı) alır. |
get | String | Öğenin içeriğini metin dizesi olarak alır. |
get | Text | Metin hizalamasını alır. |
get | Element | Öğenin Element değerini alır. |
get | Vertical | Vertical öğesini alır. |
get | Number|null | Hücreyi içeren sütunun genişliğini punto cinsinden alır. |
insert | Horizontal | Belirtilen dizinde yeni bir Horizontal oluşturur ve ekler. |
insert | Inline | Belirtilen görüntü blob'undan belirtilen dizinde bir Inline oluşturur ve ekler. |
insert | Inline | Belirtilen dizine verilen Inline öğesini ekler. |
insert | List | Belirtilen dizine verilen List öğesini ekler. |
insert | List | Belirtilen dizinde yeni bir List oluşturur ve ekler. |
insert | Paragraph | Belirtilen dizine verilen Paragraph öğesini ekler. |
insert | Paragraph | Belirtilen dizinde yeni bir Paragraph oluşturur ve ekler. |
insert | Table | Belirtilen dizinde yeni bir Table oluşturur ve ekler. |
insert | Table | Belirtilen hücreleri içeren yeni bir Table oluşturup belirtilen dizine ekler. |
insert | Table | Belirtilen dizine verilen Table öğesini ekler. |
is | Boolean | Öğenin Document sonunda olup olmadığını belirler. |
merge() | Table | Öğeyi, aynı türdeki önceki kardeş öğeyle birleştirir. |
remove | Table | Belirtilen alt öğeyi kaldırır. |
remove | Table | Öğeyi üst öğesinden kaldırır. |
replace | Element | Normal ifadeleri kullanarak belirli bir metin kalıbının tüm örneklerini belirli bir yeni dizeyle değiştirir. |
set | Table | Öğenin özelliklerini ayarlar. |
set | Table | Arka plan rengini ayarlar. |
set | Table | Bağlantı URL'sini ayarlar. |
set | Table | Alt dolguyu puan cinsinden ayarlar. |
set | Table | Sol dolguyu puan cinsinden ayarlar. |
set | Table | Sağ dolguyu puan cinsinden ayarlar. |
set | Table | Üst dolguyu puan cinsinden ayarlar. |
set | Table | İçeriği düz metin olarak ayarlar. |
set | Table | Metin hizalamasını ayarlar. |
set | Table | Dikey hizalamayı ayarlar. |
set | Table | Geçerli hücreyi içeren sütunun genişliğini punto cinsinden ayarlar. |
Ayrıntılı belgeler
append Horizontal Rule()
Yeni bir Horizontal oluşturur ve ekler.
Horizontal, yeni bir Paragraph içinde yer alır.
Return
Horizontal: Yeni yatay kural
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Image(image)
Belirtilen resim blob'undan yeni bir Inline oluşturur ve ekler.
Inline, yeni bir Paragraph içinde yer alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
image | Blob | Resim verileri |
Return
Inline: Yeni resim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Image(image)
Belirtilen Inline eklenir.
Inline, yeni bir Paragraph içinde yer alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
image | Inline | Resim verileri |
Return
Inline: Eklenen resim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append List Item(listItem)
Belirtilen List eklenir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
list | List | Eklenecek liste öğesi |
Return
List — eklenen liste öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append List Item(text)
Yeni bir List oluşturur ve ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
text | String | metin içerikleri |
Return
List: Yeni liste öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Paragraph(paragraph)
Belirtilen Paragraph eklenir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
paragraph | Paragraph | eklenecek paragraf |
Return
Paragraph — eklenen paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Paragraph(text)
Yeni bir Paragraph oluşturur ve ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
text | String | metin içerikleri |
Return
Paragraph — yeni paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Table()
Yeni bir Table oluşturur ve ekler.
Return
Table: Yeni tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Table(cells)
Belirtilen hücreleri içeren yeni bir Table ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
cells | String[][] | Yeni tabloya eklenecek tablo hücrelerinin metin içerikleri |
Return
Table: Eklenen tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Table(table)
Belirtilen Table eklenir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
table | Table | eklenecek tablo |
Return
Table: Eklenen tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
clear()
copy()
Geçerli öğenin ayrılmış, derin bir kopyasını döndürür.
Öğede bulunan tüm alt öğeler de kopyalanır. Yeni öğenin üst öğesi yok.
Return
Table: Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
edit As Text()
Düzenlemek için mevcut öğenin Text sürümünü alır.
Öğelerin içeriğini zengin metin olarak değiştirmek için edit kullanın. edit modu, metin olmayan öğeleri (ör. Inline ve Horizontal) yoksayar.
Silinen bir metin aralığında tamamen yer alan alt öğeler, öğeden kaldırılır.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Insert two paragraphs separated by a paragraph containing an // horizontal rule. body.insertParagraph(0, 'An editAsText sample.'); body.insertHorizontalRule(0); body.insertParagraph(0, 'An example.'); // Delete " sample.\n\n An" removing the horizontal rule in the process. body.editAsText().deleteText(14, 25);
Return
Text: Geçerli öğenin metin sürümü
find Element(elementType)
Öğenin içeriğinde, belirtilen türde bir alt öğe arar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
element | Element | Aranacak öğe türü. |
Return
Range: Arama öğesinin konumunu gösteren bir arama sonucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
find Element(elementType, from)
Belirtilen Range ile başlayarak, belirtilen türde bir alt öğe için öğenin içeriğini arar.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Define the search parameters. let searchResult = null; // Search until the paragraph is found. while ( (searchResult = body.findElement( DocumentApp.ElementType.PARAGRAPH, searchResult, ))) { const par = searchResult.getElement().asParagraph(); if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) { // Found one, update and stop. par.setText('This is the first header.'); break; } }
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
element | Element | Aranacak öğe türü. |
from | Range | Arama yapılacak arama sonucu. |
Return
Range: Arama öğesinin sonraki konumunu gösteren bir arama sonucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
find Text(searchPattern)
Normal ifadeleri kullanarak öğenin içeriğinde belirtilen metin kalıbını arar.
JavaScript normal ifade özelliklerinin bir alt kümesi (ör. yakalama grupları ve mod değiştiriciler) tam olarak desteklenmez.
Sağlanan normal ifade kalıbı, mevcut öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
search | String | Aranacak desen |
Return
Range — arama metninin konumunu gösteren bir arama sonucu veya eşleşme yoksa null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
find Text(searchPattern, from)
Belirtilen metin kalıbını, belirli bir arama sonucundan başlayarak öğenin içeriğinde arar.
JavaScript normal ifade özelliklerinin bir alt kümesi (ör. yakalama grupları ve mod değiştiriciler) tam olarak desteklenmez.
Sağlanan normal ifade kalıbı, mevcut öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
search | String | Aranacak desen |
from | Range | Arama yapılacak arama sonucu |
Return
Range: Arama metninin bir sonraki konumunu gösteren bir arama sonucu veya eşleşme yoksa null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Attributes()
Öğenin özelliklerini alır.
Sonuç, her geçerli öğe özelliği için bir özellik içeren bir nesnedir. Her özellik adı, Document numaralandırmasındaki bir öğeye karşılık gelir.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Append a styled paragraph. const par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. const atts = par.getAttributes(); // Log the paragraph attributes. for (const att in atts) { Logger.log(`${att}:${atts[att]}`); }
Return
Object: Öğenin özellikleri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Background Color()
Arka plan rengini alır.
Return
String|null: CSS gösterimiyle biçimlendirilmiş arka plan rengi ('#ffffff' gibi)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Child(childIndex)
Belirtilen alt dizindeki alt öğeyi alır.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Obtain the first element in the tab. const firstChild = body.getChild(0); // If it's a paragraph, set its contents. if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) { firstChild.asParagraph().setText('This is the first paragraph.'); }
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Alınacak alt öğenin dizini. |
Return
Element: Belirtilen dizindeki alt öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Child Index(child)
Belirtilen alt öğenin alt dizinini alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Element | Dizinin alınacağı alt öğe. |
Return
Integer: Çocuk dizini.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Col Span()
Hücrenin kapsadığı tablo hücrelerinin sütun sayısı olan sütun aralığını alır. Birleştirilmemiş hücrelerin sütun aralığı 1'dir.
Return
Integer: Sütun aralığı veya başka bir hücre tarafından birleştirilmiş bir hücre için 0
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Link Url()
Bağlantı URL'sini alır.
Return
String|null: Bağlantı URL'si veya öğe bu özellik için birden fazla değer içeriyorsa null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Next Sibling()
Öğenin sonraki kardeş öğesini alır.
Bir sonraki kardeş öğe, aynı üst öğeye sahiptir ve geçerli öğeyi takip eder.
Return
Element|null: Sonraki kardeş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Num Children()
Çocuk sayısını alır.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Log the number of elements in the tab. Logger.log(`There are ${body.getNumChildren()} elements in the tab's body.`);
Return
Integer: Çocuk sayısı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Padding Bottom()
Alt dolguyu puan cinsinden alır.
Return
Number|null: Punto cinsinden alt dolgu
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Padding Left()
Sol dolguyu puan cinsinden alır.
Return
Number|null: Sol dolgu (puan cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Padding Right()
Sağ dolguyu puan cinsinden alır.
Return
Number|null: Sağ dolgu (puan cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Padding Top()
Üst dolguyu puan cinsinden alır.
Return
Number|null: Üst dolgu (puan cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Parent()
Öğenin üst öğesini alır.
Üst öğe, geçerli öğeyi içerir.
Return
Container: Üst öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Parent Row()
Mevcut Table öğesini içeren Table öğesini alır.
Return
Table: Geçerli hücreyi içeren tablo satırı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Parent Table()
Mevcut Table öğesini içeren Table öğesini alır.
Return
Table|null: Geçerli hücreyi içeren tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Previous Sibling()
Öğenin önceki kardeş öğesini alır.
Önceki kardeş öğe, aynı üst öğeye sahiptir ve geçerli öğeden önce gelir.
Return
Element|null: Önceki kardeş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Row Span()
Satır aralığını (bu hücrenin kapsadığı tablo hücresi satırlarının sayısı) alır. Birleştirilmemiş hücrelerin satır aralığı 1'dir.
Return
Integer: Başka bir hücre tarafından birleştirilmiş bir hücre için satır aralığı veya 0
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Text()
Öğenin içeriğini metin dizesi olarak alır.
Return
String: Öğenin metin dizesi olarak içeriği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Text Alignment()
Metin hizalamasını alır. Kullanılabilir hizalama türleri Document, Document ve Document'dir.
Return
Text: Metin hizalama türü veya metin birden fazla metin hizalama türü içeriyorsa ya da metin hizalama hiç ayarlanmamışsa null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Type()
Öğenin Element değerini alır.
Belirli bir öğenin tam türünü belirlemek için get kullanın.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Obtain the first element in the active tab's body. const firstChild = body.getChild(0); // Use getType() to determine the element's type. if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) { Logger.log('The first element is a paragraph.'); } else { Logger.log('The first element is not a paragraph.'); }
Return
Element: Öğe türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Vertical Alignment()
Vertical öğesini alır.
Return
Vertical: Dikey hizalama
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Width()
Hücreyi içeren sütunun genişliğini punto cinsinden alır.
Return
Number|null: Sütun genişliği (punto cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Horizontal Rule(childIndex)
Belirtilen dizinde yeni bir Horizontal oluşturur ve ekler.
Yatay çizgi yeni bir Paragraph içinde yer alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | öğenin ekleneceği dizin |
Return
Horizontal: Yeni yatay kural
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Image(childIndex, image)
Belirtilen görüntü blob'undan belirtilen dizinde bir Inline oluşturur ve ekler.
Resim, yeni bir Paragraph içinde yer alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | öğenin ekleneceği dizin |
image | Blob | Resim verileri |
Return
Inline: Eklenen satır içi resim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Image(childIndex, image)
Belirtilen dizine verilen Inline öğesini ekler.
Resim, yeni bir Paragraph içinde yer alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | öğenin ekleneceği dizin |
image | Inline | eklenecek resim |
Return
Inline: Eklenen satır içi resim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert List Item(childIndex, listItem)
Belirtilen dizine verilen List öğesini ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | öğenin ekleneceği dizin |
list | List | Eklenecek liste öğesi |
Return
List: Yeni liste öğesi eklendi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert List Item(childIndex, text)
Belirtilen dizinde yeni bir List oluşturur ve ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | öğenin ekleneceği dizin |
text | String | metin içerikleri |
Return
List: Yeni liste öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Paragraph(childIndex, paragraph)
Belirtilen dizine verilen Paragraph öğesini ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | öğenin ekleneceği dizin |
paragraph | Paragraph | eklenecek paragraf |
Return
Paragraph: Eklenen paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Paragraph(childIndex, text)
Belirtilen dizinde yeni bir Paragraph oluşturur ve ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | öğenin ekleneceği dizin |
text | String | metin içerikleri |
Return
Paragraph — yeni paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Table(childIndex)
Belirtilen dizinde yeni bir Table oluşturur ve ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | öğenin ekleneceği dizin |
Return
Table: Yeni tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Table(childIndex, cells)
Belirtilen hücreleri içeren yeni bir Table oluşturup belirtilen dizine ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | eklenecek dizin |
cells | String[][] | Yeni tabloya eklenecek tablo hücrelerinin metin içerikleri |
Return
Table: Yeni tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Table(childIndex, table)
Belirtilen dizine verilen Table öğesini ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | öğenin ekleneceği dizin |
table | Table | eklenecek tablo |
Return
Table: Eklenen tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
is At Document End()
Öğenin Document sonunda olup olmadığını belirler.
Return
Boolean: Öğenin sekmenin sonunda olup olmadığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
merge()
Öğeyi, aynı türdeki önceki kardeş öğeyle birleştirir.
Yalnızca aynı Element öğeleri birleştirilebilir. Geçerli öğede bulunan tüm alt öğeler, önceki kardeş öğeye taşınır.
Mevcut öğe dokümandan kaldırılır.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document's active tab. const par1 = body.appendParagraph('Paragraph 1.'); const par2 = body.appendParagraph('Paragraph 2.'); // Merge the newly added paragraphs into a single paragraph. par2.merge(); // Example 2: Merge table cells // Create a two-dimensional array containing the table's cell contents. const cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'], ]; // Build a table from the array. const table = body.appendTable(cells); // Get the first row in the table. const row = table.getRow(0); // Get the two cells in this row. const cell1 = row.getCell(0); const cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. const merged = cell2.merge();
Return
Table: Birleştirilmiş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
remove Child(child)
Belirtilen alt öğeyi kaldırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Element | kaldırılacak alt öğe |
Return
Table: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
remove From Parent()
Öğeyi üst öğesinden kaldırır.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Remove all images in the active tab's body. const imgs = body.getImages(); for (let i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
Return
Table: Kaldırılan öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
replace Text(searchPattern, replacement)
Normal ifadeleri kullanarak belirli bir metin kalıbının tüm örneklerini belirli bir yeni dizeyle değiştirir.
Arama kalıbı, JavaScript normal ifade nesnesi olarak değil, dize olarak iletilir. Bu nedenle, desendeki tüm ters eğik çizgileri çıkış karakteriyle belirtmeniz gerekir.
Bu yöntem, desteklenen söz dizimini sınırlayan Google'ın RE2 normal ifade kitaplığını kullanır.
Sağlanan normal ifade kalıbı, mevcut öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText('^.*Apps ?Script.*$', 'Apps Script');
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
search | String | Aranacak normal ifade kalıbı |
replacement | String | Değiştirme için kullanılacak metin |
Return
Element: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Attributes(attributes)
Öğenin özelliklerini ayarlar.
Belirtilen özellikler parametresi, her özellik adının Document numaralandırmasındaki bir öğe ve her özellik değerinin uygulanacak yeni değer olduğu bir nesne olmalıdır.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Define a custom paragraph style. const style = {}; style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] = DocumentApp.HorizontalAlignment.RIGHT; style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri'; style[DocumentApp.Attribute.FONT_SIZE] = 18; style[DocumentApp.Attribute.BOLD] = true; // Append a plain paragraph. const par = body.appendParagraph('A paragraph with custom style.'); // Apply the custom style. par.setAttributes(style);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
attributes | Object | Öğenin özellikleri. |
Return
Table: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Background Color(color)
Arka plan rengini ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
color | String | CSS gösterimiyle biçimlendirilmiş arka plan rengi (ör. '#ffffff') |
Return
Table: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Link Url(url)
Bağlantı URL'sini ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
url | String | Bağlantı URL'si |
Return
Table: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Padding Bottom(paddingBottom)
Alt dolguyu puan cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
padding | Number | Alt dolgu (punto cinsinden) |
Return
Table: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Padding Left(paddingLeft)
Sol dolguyu puan cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
padding | Number | Sol dolgu (puan cinsinden) |
Return
Table: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Padding Right(paddingRight)
Sağ dolguyu puan cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
padding | Number | Puan cinsinden sağ dolgu. |
Return
Table: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Padding Top(paddingTop)
Üst dolguyu puan cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
padding | Number | üst dolgu (puan cinsinden) |
Return
Table: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Text(text)
İçeriği düz metin olarak ayarlar.
Not: Mevcut içerikler temizlenir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
text | String | yeni metin içerikleri |
Return
Table: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Text Alignment(textAlignment)
Metin hizalamasını ayarlar. Kullanılabilir hizalama türleri Document, Document ve Document'dir.
// Make the entire first paragraph in the active tab be superscript. const documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); const text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
text | Text | Uygulanacak metin hizalama türü |
Return
Table: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Vertical Alignment(alignment)
Dikey hizalamayı ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
alignment | Vertical | dikey hizalama |
Return
Table: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Width(width)
Geçerli hücreyi içeren sütunun genişliğini punto cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
width | Number | Sütun genişliği (punto cinsinden) |
Return
Table: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents