Tablo hücresini temsil eden bir öğe. Table
her zaman bir Table
içinde yer alır ve List
, Paragraph
veya Table
öğeleri içerebilir. Belge yapısı hakkında daha fazla bilgi için Google Dokümanlar'ı genişletme kılavuzuna bakın.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
append | Horizontal | Yeni bir Horizontal oluşturup ekler. |
append | Inline | Belirtilen resim blob'undan yeni bir Inline oluşturup ekler. |
append | Inline | Belirtilen Inline değerini ekler. |
append | List | Belirtilen List değerini ekler. |
append | List | Yeni bir List oluşturup ekler. |
append | Paragraph | Belirtilen Paragraph değerini ekler. |
append | Paragraph | Yeni bir Paragraph oluşturup ekler. |
append | Table | Yeni bir Table oluşturup ekler. |
append | Table | Belirtilen hücreleri içeren yeni bir Table ekler. |
append | Table | Belirtilen Table değerini ekler. |
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ğini, belirtilen türün bir alt öğesi için arar. |
find | Range | Belirtilen Range öğesinden başlayarak öğenin içeriğini, belirtilen türün bir alt öğesi için arar. |
find | Range | Normal ifadeleri kullanarak öğenin içeriğinde belirtilen metin kalıbını arar. |
find | Range | Belirli bir arama sonucundan başlayarak öğenin içeriğini belirtilen metin kalıbıyla arar. |
get | Object | Öğenin özelliklerini alır. |
get | String | Arka plan rengini alır. |
get | Element | Belirtilen alt öğe dizininde alt öğeyi alır. |
get | Integer | Belirtilen alt öğenin alt öğe dizini döndürülür. |
get | Integer | Bu hücrenin kapsadığı tablo hücresi sütunlarının sayısı olan sütun kapsamını alır. |
get | String | Bağlantı URL'sini alır. |
get | Element | Öğenin sonraki kardeş öğesini alır. |
get | Integer | Çocuk sayısını alır. |
get | Number | Alt dolguyu nokta cinsinden alır. |
get | Number | Sol dolguyu noktalar cinsinden alır. |
get | Number | Sağ dolguyu puan cinsinden alır. |
get | Number | Üst dolguyu noktalar cinsinden alır. |
get | Container | Öğenin üst öğesini alır. |
get | Table | Mevcut Table değerini içeren Table değerini alır. |
get | Table | Mevcut Table değerini içeren Table değerini alır. |
get | Element | Öğenin önceki kardeş öğesini alır. |
get | Integer | Bu hücrenin kapsadığı tablo hücresi satırlarının sayısı olan satır aralığını 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 | Hücreyi içeren sütunun genişliğini, punto cinsinden alır. |
insert | Horizontal | Belirtilen dizinde yeni bir Horizontal oluşturup ekler. |
insert | Inline | Belirtilen resim blob'undan, belirtilen dizinde bir Inline oluşturup ekler. |
insert | Inline | Belirtilen Inline öğesini belirtilen dizin içine ekler. |
insert | List | Belirtilen List öğesini belirtilen dizin içine ekler. |
insert | List | Belirtilen dizinde yeni bir List oluşturup ekler. |
insert | Paragraph | Belirtilen Paragraph öğesini belirtilen dizin içine ekler. |
insert | Paragraph | Belirtilen dizinde yeni bir Paragraph oluşturup ekler. |
insert | Table | Belirtilen dizinde yeni bir Table oluşturup ekler. |
insert | Table | Belirtilen dizinde, belirtilen hücreleri içeren yeni bir Table oluşturup ekler. |
insert | Table | Belirtilen Table öğesini belirtilen dizin içine ekler. |
is | Boolean | Öğenin Document 'ün 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 ifadeler kullanılarak belirli bir metin kalıbının tüm örnekleri belirli bir değiştirme dizesiyle değiştirilir. |
set | Table | Öğenin özelliklerini ayarlar. |
set | Table | Arka plan rengini ayarlar. |
set | Table | Bağlantı URL'sini ayarlar. |
set | Table | Alt dolguyu nokta cinsinden ayarlar. |
set | Table | Sol dolguyu nokta cinsinden ayarlar. |
set | Table | Sağ dolguyu puan cinsinden ayarlar. |
set | Table | Üst dolguyu piksel 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ı dokümanlar
appendHorizontalRule()
Yeni bir Horizontal
oluşturup ekler.
Horizontal
, yeni bir Paragraph
içinde yer alır.
Return
Horizontal
: yeni yatay kural
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendImage(image)
Belirtilen resim blob'undan yeni bir Inline
oluşturup 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendImage(image)
Belirtilen Inline
değerini ekler.
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendListItem(listItem)
Belirtilen List
değerini ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
list | List | Eklenecek liste öğesi |
Return
List
: Eklenen liste öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendListItem(text)
Yeni bir List
oluşturup ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | metin içerikleri |
Return
List
: yeni liste öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendParagraph(paragraph)
Belirtilen Paragraph
değerini ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
paragraph | Paragraph | eklenecek paragraf |
Return
Paragraph
: Eklenen paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendParagraph(text)
Yeni bir Paragraph
oluşturup ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | metin içerikleri |
Return
Paragraph
: Yeni paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendTable()
Yeni bir Table
oluşturup ekler.
Return
Table
: Yeni tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendTable(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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendTable(table)
Belirtilen Table
değerini ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
table | Table | eklenecek tablo |
Return
Table
: Eklenen tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
editAsText()
Düzenlemek için mevcut öğenin Text
sürümünü alır.
Öğe içeriklerini zengin metin olarak değiştirmek için edit
öğesini kullanın. edit
modu, metin olmayan öğeleri (Inline
ve Horizontal
gibi) yoksayar.
Silinen bir metin aralığının tamamına sahip 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
: Mevcut öğenin metin sürümü
findElement(elementType)
Öğenin içeriğini, belirtilen türün bir alt öğesi için arar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
element | Element | Aranacak öğe türü. |
Return
Range
: Arama öğesinin konumunu belirten bir arama sonucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findElement(elementType, from)
Belirtilen Range
öğesinden başlayarak öğenin içeriğini, belirtilen türün bir alt öğesi için 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(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ı, geçerli öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
search | String | aranacak kalıp |
Return
Range
: Arama metninin konumunu gösteren bir arama sonucudur veya eşleşme yoksa null değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
Belirli bir arama sonucundan başlayarak öğenin içeriğini belirtilen metin kalıbıyla 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ı, geçerli öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
search | String | aranacak kalıp |
from | Range | Arama yapılacak arama sonucu |
Return
Range
: Arama metninin sonraki konumunu gösteren bir arama sonucudur veya eşleşme yoksa null değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAttributes()
Öğenin özelliklerini alır.
Sonuç, her geçerli öğe özelliği için bir özellik içeren bir nesnedir. Bu nesnedeki her özellik adı, Document
dizininde 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getBackgroundColor()
Arka plan rengini alır.
Return
String
: CSS notasyonuyla biçimlendirilmiş arka plan rengi ('#ffffff'
gibi)
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getChild(childIndex)
Belirtilen alt öğe dizininde 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getChildIndex(child)
Belirtilen alt öğenin alt öğe dizini döndürülür.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Element | Dizininin alınacağı alt öğe. |
Return
Integer
: Alt dizin.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getColSpan()
Bu hücrenin kapsadığı tablo hücresi sütunlarının sayısı olan sütun kapsamını alır. Birleştirilmemiş hücrelerin sütun genişliği 1'dir.
Return
Integer
: Başka bir hücreyle birleştirilmiş bir hücre için sütun kapsamı veya 0
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLinkUrl()
Bağlantı URL'sini alır.
Return
String
: Bağlantı URL'si veya öğe bu özellik için birden fazla değer içeriyorsa null
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNextSibling()
Öğenin sonraki kardeş öğesini alır.
Bir sonraki kardeş öğe, aynı üst öğeye sahiptir ve geçerli öğeyi takip eder.
Return
Element
: Sonraki kardeş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNumChildren()
Ç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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingBottom()
Alt dolguyu nokta cinsinden alır.
Return
Number
: Alt dolgu (punto cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingLeft()
Sol dolguyu noktalar cinsinden alır.
Return
Number
: Sol dolgu (noktalar cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingRight()
Sağ dolguyu puan cinsinden alır.
Return
Number
: Sağ dolgu, noktalar cinsinden
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingTop()
Üst dolguyu noktalar cinsinden alır.
Return
Number
: Üst dolgu, puan cinsinden
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParent()
Öğenin üst öğesini alır.
Üst öğe, geçerli öğeyi içerir.
Return
Container
: Üst öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParentRow()
Mevcut Table
değerini içeren Table
değerini alır.
Return
Table
: Geçerli hücreyi içeren tablo satırı
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParentTable()
Mevcut Table
değerini içeren Table
değerini alır.
Return
Table
: Geçerli hücreyi içeren tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPreviousSibling()
Öğenin önceki kardeş öğesini alır.
Önceki kardeş öğe, aynı üst öğeye sahiptir ve geçerli öğeden önce gelir.
Return
Element
: Önceki kardeş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getRowSpan()
Bu hücrenin kapsadığı tablo hücresi satırlarının sayısı olan satır aralığını alır. Birleştirilmemiş hücrelerin satır kapsamı 1'dir.
Return
Integer
: Satır kapsamı veya başka bir hücreyle birleştirilmiş bir hücre için 0
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getText()
Öğ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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTextAlignment()
Metin hizalamasını alır. Kullanılabilir hizalama türleri Document
, Document
ve Document
'dir.
Return
Text
: Metin hizalamasının türü veya metin birden fazla metin hizası türü içeriyorsa ya da metin hizası hiç ayarlanmadıysa null
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getType()
Öğenin Element
değerini alır.
Belirli bir öğenin tam türünü belirlemek için get
öğesini 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getVerticalAlignment()
Vertical
öğesini alır.
Return
Vertical
: dikey hizalama
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getWidth()
Hücreyi içeren sütunun genişliğini, punto cinsinden alır.
Return
Number
: Sütun genişliği (punto cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertHorizontalRule(childIndex)
Belirtilen dizinde yeni bir Horizontal
oluşturup 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Belirtilen resim blob'undan, belirtilen dizinde bir Inline
oluşturup 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Belirtilen Inline
öğesini belirtilen dizin içine 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertListItem(childIndex, listItem)
Belirtilen List
öğesini belirtilen dizin içine 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertListItem(childIndex, text)
Belirtilen dizinde yeni bir List
oluşturup 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, paragraph)
Belirtilen Paragraph
öğesini belirtilen dizin içine 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, text)
Belirtilen dizinde yeni bir Paragraph
oluşturup 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTable(childIndex)
Belirtilen dizinde yeni bir Table
oluşturup ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Integer | Öğenin ekleneceği dizin |
Return
Table
: Yeni tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTable(childIndex, cells)
Belirtilen dizinde, belirtilen hücreleri içeren yeni bir Table
oluşturup ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Integer | Eklemenin yapılacağı dizin |
cells | String[][] | Yeni tabloya eklenecek tablo hücrelerinin metin içerikleri |
Return
Table
: Yeni tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTable(childIndex, table)
Belirtilen Table
öğesini belirtilen dizin içine 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isAtDocumentEnd()
Öğenin Document
'ün sonunda olup olmadığını belirler.
Return
Boolean
: Öğenin sekmenin sonunda olup olmadığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeChild(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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeFromParent()
Öğ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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
replaceText(searchPattern, replacement)
Normal ifadeler kullanılarak belirli bir metin kalıbının tüm örnekleri belirli bir değiştirme dizesiyle değiştirilir.
Arama kalıbı, JavaScript normal ifade nesnesi değil, dize olarak iletilir. Bu nedenle, kalıptaki tüm ters eğik çizgileri koddan çıkarmanız 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ı, geçerli öğ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şim olarak kullanılacak metin |
Return
Element
: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAttributes(attributes)
Öğenin özelliklerini ayarlar.
Belirtilen attributes parametresi, her bir özellik adının Document
numaralandırmasında bir öğe olduğu ve her bir ö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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setBackgroundColor(color)
Arka plan rengini ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | String | CSS notasyonunda biçimlendirilmiş arka plan rengi ('#ffffff' gibi) |
Return
Table
: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLinkUrl(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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingBottom(paddingBottom)
Alt dolguyu nokta 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingLeft(paddingLeft)
Sol dolguyu nokta cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
padding | Number | sol dolgu, noktalar cinsinden |
Return
Table
: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingRight(paddingRight)
Sağ dolguyu puan cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
padding | Number | Sağ dolgu, noktalar cinsinden. |
Return
Table
: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingTop(paddingTop)
Üst dolguyu piksel cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
padding | Number | Üst dolgu, noktalar cinsinden |
Return
Table
: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setText(text)
İçeriği düz metin olarak ayarlar.
Not: Mevcut içerikler silinir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | yeni metin içerikleri |
Return
Table
: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTextAlignment(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 hizalamasının türü |
Return
Table
: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setVerticalAlignment(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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setWidth(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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents