Tablo hücresini temsil eden bir öğe. TableCell
her zaman bir TableRow
içinde bulunur ve ListItem
, Paragraph
veya Table
öğeleri içerebilir. Doküman yapısı hakkında daha fazla bilgi için Google Dokümanlar'ın kapsamını genişletme kılavuzuna bakın.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
appendHorizontalRule() | HorizontalRule | Yeni bir HorizontalRule oluşturup ekler. |
appendImage(image) | InlineImage | Belirtilen resim blob'undan yeni bir InlineImage oluşturur ve ekler. |
appendImage(image) | InlineImage | Belirtilen InlineImage dizesini ekler. |
appendListItem(listItem) | ListItem | Belirtilen ListItem dizesini ekler. |
appendListItem(text) | ListItem | Yeni bir ListItem oluşturup ekler. |
appendParagraph(paragraph) | Paragraph | Belirtilen Paragraph dizesini ekler. |
appendParagraph(text) | Paragraph | Yeni bir Paragraph oluşturup ekler. |
appendTable() | Table | Yeni bir Table oluşturup ekler. |
appendTable(cells) | Table | Belirtilen hücreleri içeren yeni bir Table ekler. |
appendTable(table) | Table | Belirtilen Table dizesini ekler. |
clear() | TableCell | Öğenin içeriğini temizler. |
copy() | TableCell | Geçerli öğenin ayrı, derin bir kopyasını döndürür. |
editAsText() | Text | Düzenleme için geçerli öğenin Text sürümünü alır. |
findElement(elementType) | RangeElement | Öğenin içeriğinde, belirtilen türde bir alt öğe arar. |
findElement(elementType, from) | RangeElement | Belirtilen RangeElement öğesinden başlayarak, öğenin içeriğinde belirtilen türde bir alt öğe arar. |
findText(searchPattern) | RangeElement | Normal ifadeler kullanarak, belirtilen metin kalıbı için öğenin içeriğinde arama yapar. |
findText(searchPattern, from) | RangeElement | Belirli bir arama sonucundan başlayarak, belirtilen metin kalıbı için öğenin içeriğinde arama yapar. |
getAttributes() | Object | Öğenin özelliklerini alır. |
getBackgroundColor() | String | Arka plan rengini alır. |
getChild(childIndex) | Element | Belirtilen alt dizindeki alt öğeyi alır. |
getChildIndex(child) | Integer | Belirtilen alt öğe için alt dizini alır. |
getColSpan() | Integer | Bu hücrenin kapladığı tablo hücrelerinin sütun sayısı olan sütun aralığını alır. |
getLinkUrl() | String | Bağlantı URL'sini alır. |
getNextSibling() | Element | Öğenin sonraki eşdüzey öğesini alır. |
getNumChildren() | Integer | Alt öğe sayısını alır. |
getPaddingBottom() | Number | Nokta cinsinden alt dolguyu alır. |
getPaddingLeft() | Number | Nokta cinsinden sol dolguyu alır. |
getPaddingRight() | Number | Nokta cinsinden sağ dolguyu alır. |
getPaddingTop() | Number | Nokta cinsinden üst dolguyu alır. |
getParent() | ContainerElement | Öğenin üst öğesini alır. |
getParentRow() | TableRow | Geçerli TableCell öğesini içeren TableRow öğesini alır. |
getParentTable() | Table | Geçerli TableCell öğesini içeren Table öğesini alır. |
getPreviousSibling() | Element | Öğenin önceki eşdüzey öğesini alır. |
getRowSpan() | Integer | Bu hücrenin kapladığı tablo hücrelerinin satır sayısı olan satır aralığını alır. |
getText() | String | Öğenin içeriğini metin dizesi olarak alır. |
getTextAlignment() | TextAlignment | Metin hizalamasını sağlar. |
getType() | ElementType | Öğenin ElementType değerini alır. |
getVerticalAlignment() | VerticalAlignment | VerticalAlignment öğesini getirir. |
getWidth() | Number | Hücreyi içeren sütunun genişliğini nokta cinsinden alır. |
insertHorizontalRule(childIndex) | HorizontalRule | Belirtilen dizinde yeni bir HorizontalRule oluşturur ve ekler. |
insertImage(childIndex, image) | InlineImage | Belirtilen resim blob'undan, belirtilen dizinde bir InlineImage oluşturur ve ekler. |
insertImage(childIndex, image) | InlineImage | Belirtilen InlineImage öğesini belirtilen dizine ekler. |
insertListItem(childIndex, listItem) | ListItem | Belirtilen ListItem öğesini belirtilen dizine ekler. |
insertListItem(childIndex, text) | ListItem | Belirtilen dizinde yeni bir ListItem oluşturur ve ekler. |
insertParagraph(childIndex, paragraph) | Paragraph | Belirtilen Paragraph öğesini belirtilen dizine ekler. |
insertParagraph(childIndex, text) | Paragraph | Belirtilen dizinde yeni bir Paragraph oluşturur ve ekler. |
insertTable(childIndex) | Table | Belirtilen dizinde yeni bir Table oluşturur ve ekler. |
insertTable(childIndex, cells) | Table | Belirtilen hücreleri içeren, belirtilen dizinde yeni bir Table oluşturur ve ekler. |
insertTable(childIndex, table) | Table | Belirtilen Table öğesini belirtilen dizine ekler. |
isAtDocumentEnd() | Boolean | Öğenin, Document öğesinin sonunda olup olmadığını belirler. |
merge() | TableCell | Öğeyi, aynı türdeki önceki eşdüzey öğe ile birleştirir. |
removeChild(child) | TableCell | Belirtilen alt öğeyi kaldırır. |
removeFromParent() | TableCell | Öğeyi üst öğesinden kaldırır. |
replaceText(searchPattern, replacement) | Element | Normal ifadeler kullanarak belirli bir metin kalıbının tüm tekrarlarını verilen bir yeni dizeyle değiştirir. |
setAttributes(attributes) | TableCell | Öğenin özelliklerini ayarlar. |
setBackgroundColor(color) | TableCell | Arka plan rengini ayarlar. |
setLinkUrl(url) | TableCell | Bağlantı URL'sini ayarlar. |
setPaddingBottom(paddingBottom) | TableCell | Alt dolguyu punto cinsinden ayarlar. |
setPaddingLeft(paddingLeft) | TableCell | Sol dolguyu punto cinsinden ayarlar. |
setPaddingRight(paddingRight) | TableCell | Doğru dolguyu punto cinsinden ayarlar. |
setPaddingTop(paddingTop) | TableCell | Üst dolguyu punto cinsinden ayarlar. |
setText(text) | TableCell | İçeriği düz metin olarak ayarlar. |
setTextAlignment(textAlignment) | TableCell | Metin hizalamasını ayarlar. |
setVerticalAlignment(alignment) | TableCell | Dikey hizalamayı ayarlar. |
setWidth(width) | TableCell | Geçerli hücreyi içeren sütunun genişliğini punto cinsinden ayarlar. |
Ayrıntılı belgeler
appendHorizontalRule()
Yeni bir HorizontalRule
oluşturup ekler.
HorizontalRule
, yeni bir Paragraph
içinde yer alacak.
Return
HorizontalRule
- yeni yatay kural
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendImage(image)
Belirtilen resim blob'undan yeni bir InlineImage
oluşturur ve ekler.
InlineImage
, yeni bir Paragraph
içinde yer alacak.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
image | BlobSource | resim verileri |
Return
InlineImage
- yeni resim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendImage(image)
Belirtilen InlineImage
dizesini ekler.
InlineImage
, yeni bir Paragraph
içinde yer alacak.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
image | InlineImage | resim verileri |
Return
InlineImage
- eklenen resim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendListItem(listItem)
Belirtilen ListItem
dizesini ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
listItem | ListItem | eklenecek liste öğesi |
Return
ListItem
- eklenen liste öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendListItem(text)
Yeni bir ListItem
oluşturup ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | metin içeriği |
Return
ListItem
- yeni liste öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendParagraph(paragraph)
Belirtilen Paragraph
dizesini ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
paragraph | Paragraph | eklenecek paragraf |
Return
Paragraph
— eklenen paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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çeriği |
Return
Paragraph
— yeni paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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ı, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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çeriği |
Return
Table
- eklenen tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendTable(table)
Belirtilen Table
dizesini ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
table | Table | eklenecek tablo |
Return
Table
- eklenen tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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ı, derin bir kopyasını döndürür.
Öğede bulunan alt öğeler de kopyalanır. Yeni öğenin bir üst öğesi yoktur.
Return
TableCell
: Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
editAsText()
Düzenleme için geçerli öğenin Text
sürümünü alır.
Öğe içeriklerini zengin metin olarak değiştirmek için editAsText
kullanın. editAsText
modu, metin olmayan öğeleri (InlineImage
ve HorizontalRule
gibi) yoksayar.
Tamamen silinmiş bir metin aralığı içinde yer alan alt öğeler öğeden kaldırılır.
var body = DocumentApp.getActiveDocument().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ü
findElement(elementType)
Öğenin içeriğinde, belirtilen türde bir alt öğe arar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
elementType | ElementType | aranacak öğe türü |
Return
RangeElement
: Arama öğesinin konumunu belirten arama sonucu
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findElement(elementType, from)
Belirtilen RangeElement
öğesinden başlayarak, öğenin içeriğinde belirtilen türde bir alt öğe arar.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Define the search parameters. var searchType = DocumentApp.ElementType.PARAGRAPH; var searchHeading = DocumentApp.ParagraphHeading.HEADING1; var searchResult = null; // Search until the paragraph is found. while (searchResult = body.findElement(searchType, searchResult)) { var par = searchResult.getElement().asParagraph(); if (par.getHeading() == searchHeading) { // Found one, update and stop. par.setText('This is the first header.'); return; } }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
elementType | ElementType | aranacak öğe türü |
from | RangeElement | arama yapılacak arama sonucunu |
Return
RangeElement
: Arama öğesinin sonraki konumunu belirten arama sonucu
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern)
Normal ifadeler kullanarak, belirtilen metin kalıbı için öğenin içeriğinde arama yapar.
JavaScript normal ifade özelliklerinin bir alt kümesi (ör. yakalama grupları ve mod değiştiricileri) 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 |
---|---|---|
searchPattern | String | mola vermek için |
Return
RangeElement
: Arama metninin konumunu gösteren arama sonucu veya eşleşme yoksa null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
Belirli bir arama sonucundan başlayarak, belirtilen metin kalıbı için öğenin içeriğinde arama yapar.
JavaScript normal ifade özelliklerinin bir alt kümesi (ör. yakalama grupları ve mod değiştiricileri) 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 |
---|---|---|
searchPattern | String | mola vermek için |
from | RangeElement | arama yapılacak arama sonucunu |
Return
RangeElement
: Arama metninin sonraki konumunu veya eşleşme yoksa null değerini gösteren arama sonucu
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAttributes()
Öğenin özelliklerini alır.
Sonuç, geçerli her öğe özelliği için bir özellik içeren bir nesnedir. Burada her özellik adı, DocumentApp.Attribute
numaralandırmasındaki bir öğeye karşılık gelir.
var body = DocumentApp.getActiveDocument().getBody(); // Append a styled paragraph. var par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. var atts = par.getAttributes(); // Log the paragraph attributes. for (var att in atts) { Logger.log(att + ":" + atts[att]); }
Return
Object
: Öğenin özellikleridir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getBackgroundColor()
Arka plan rengini alır.
Return
String
: CSS gösteriminde biçimlendirilmiş arka plan rengi ('#ffffff'
gibi)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getChild(childIndex)
Belirtilen alt dizindeki alt öğeyi alır.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Obtain the first element in the document. var 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 |
---|---|---|
childIndex | Integer | alt öğenin dizini |
Return
Element
- belirtilen dizindeki alt öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getChildIndex(child)
Belirtilen alt öğe için alt dizini alır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Element | dizini alınacak alt öğe |
Return
Integer
- alt dizin
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getColSpan()
Bu hücrenin kapladığı 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
— Başka bir hücreyle birleştirilmiş bir hücrenin sütun kapsamı veya 0 değeri
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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; öğe, bu özellik için birden fazla değer içeriyorsa null ifadesini içerir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNextSibling()
Öğenin sonraki eşdüzey öğesini alır.
Bir sonraki kardeş aynı üst öğeye sahiptir ve geçerli öğeyi takip eder.
Return
Element
: Sonraki kardeş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNumChildren()
Alt öğe sayısını alır.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Log the number of elements in the document. Logger.log("There are " + body.getNumChildren() + " elements in the document body.");
Return
Integer
- çocuk sayısı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingBottom()
Nokta cinsinden alt dolguyu alır.
Return
Number
— punto cinsinden alt dolgu
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingLeft()
Nokta cinsinden sol dolguyu alır.
Return
Number
— punto cinsinden sol dolgu
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingRight()
Nokta cinsinden sağ dolguyu alır.
Return
Number
— punto cinsinden sağ dolgu
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingTop()
Nokta cinsinden üst dolguyu alır.
Return
Number
— punto cinsinden üst dolgu
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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
ContainerElement
: Üst öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParentRow()
Geçerli TableCell
öğesini içeren TableRow
öğesini alır.
Return
TableRow
: Geçerli hücreyi içeren tablo satırı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParentTable()
Geçerli TableCell
öğesini içeren Table
öğesini alır.
Return
Table
: Geçerli hücreyi içeren tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPreviousSibling()
Öğenin önceki eşdüzey öğesini alır.
Önceki eşdüzey öğe aynı üst öğeye sahiptir ve geçerli öğeden önce gelir.
Return
Element
: Önceki kardeş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getRowSpan()
Bu hücrenin kapladığı tablo hücrelerinin satır sayısı olan satır aralığını alır. Birleştirilmemiş hücrelerin satır aralığı 1'dir.
Return
Integer
- Başka bir hücreyle birleştirilmiş bir hücrenin satır aralığı veya 0 değeri
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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
: Metin dizesi olarak öğenin içeriği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTextAlignment()
Metin hizalamasını sağlar. Kullanılabilir hizalama türleri şunlardır: DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
ve DocumentApp.TextAlignment.SUPERSCRIPT
.
Return
TextAlignment
: Metin hizalamasının türü veya metin birden çok türde metin hizalaması içeriyorsa ya da metin hizalaması hiç ayarlanmadıysa null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getType()
Öğenin ElementType
değerini alır.
Belirli bir öğenin tam türünü belirlemek için getType()
kullanın.
var body = DocumentApp.getActiveDocument().getBody(); // Obtain the first element in the document body. var 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
ElementType
: Öğe türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getVerticalAlignment()
VerticalAlignment
öğesini getirir.
Return
VerticalAlignment
— dikey hizalama
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getWidth()
Hücreyi içeren sütunun genişliğini nokta cinsinden alır.
Return
Number
- Nokta cinsinden sütun genişliği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertHorizontalRule(childIndex)
Belirtilen dizinde yeni bir HorizontalRule
oluşturur ve ekler.
Yatay kural, yeni bir Paragraph
içinde yer alacak.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | öğenin ekleneceği dizin |
Return
HorizontalRule
- yeni yatay kural
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Belirtilen resim blob'undan, belirtilen dizinde bir InlineImage
oluşturur ve ekler.
Bu resim, yeni bir Paragraph
öğesi içinde yer alacak.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | öğenin ekleneceği dizin |
image | BlobSource | resim verileri |
Return
InlineImage
— eklenen satır içi resim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Belirtilen InlineImage
öğesini belirtilen dizine ekler.
Bu resim, yeni bir Paragraph
öğesi içinde yer alacak.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | öğenin ekleneceği dizin |
image | InlineImage | eklenecek resim |
Return
InlineImage
— eklenen satır içi resim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertListItem(childIndex, listItem)
Belirtilen ListItem
öğesini belirtilen dizine ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | öğenin ekleneceği dizin |
listItem | ListItem | eklenecek liste öğesi |
Return
ListItem
— yeni liste öğesi eklendi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertListItem(childIndex, text)
Belirtilen dizinde yeni bir ListItem
oluşturur ve ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | öğenin ekleneceği dizin |
text | String | metin içeriği |
Return
ListItem
- yeni liste öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, paragraph)
Belirtilen Paragraph
öğesini belirtilen dizine ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | öğenin ekleneceği dizin |
paragraph | Paragraph | eklenecek paragraf |
Return
Paragraph
— eklenen paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, text)
Belirtilen dizinde yeni bir Paragraph
oluşturur ve ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | öğenin ekleneceği dizin |
text | String | metin içeriği |
Return
Paragraph
— yeni paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTable(childIndex)
Belirtilen dizinde yeni bir Table
oluşturur ve ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | öğenin ekleneceği dizin |
Return
Table
- yeni tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTable(childIndex, cells)
Belirtilen hücreleri içeren, belirtilen dizinde yeni bir Table
oluşturur ve ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | ekleneceği dizin |
cells | String[][] | yeni tabloya eklenecek tablo hücrelerinin metin içeriği |
Return
Table
- yeni tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTable(childIndex, table)
Belirtilen Table
öğesini belirtilen dizine ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | öğenin ekleneceği dizin |
table | Table | eklenecek tablo |
Return
Table
- eklenen tablo
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isAtDocumentEnd()
Öğenin, Document
öğesinin sonunda olup olmadığını belirler.
Return
Boolean
: Öğenin dokümanın sonunda olup olmadığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 eşdüzey öğe ile birleştirir.
Yalnızca aynı ElementType
öğesinin öğeleri birleştirilebilir. Geçerli öğenin içerdiği tüm alt öğeler, önceki eşdüzey öğeye taşınır.
Geçerli öğe dokümandan kaldırılır.
var body = DocumentApp.getActiveDocument().getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document. var par1 = body.appendParagraph('Paragraph 1.'); var 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. var cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'] ]; // Build a table from the array. var table = body.appendTable(cells); // Get the first row in the table. var row = table.getRow(0); // Get the two cells in this row. var cell1 = row.getCell(0); var cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. var merged = cell2.merge();
Return
TableCell
: Birleştirilmiş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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
TableCell
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeFromParent()
Öğeyi üst öğesinden kaldırır.
var body = DocumentApp.getActiveDocument().getBody(); // Remove all images in the document body. var imgs = body.getImages(); for (var i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
Return
TableCell
: Kaldırılan öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
replaceText(searchPattern, replacement)
Normal ifadeler kullanarak belirli bir metin kalıbının tüm tekrarlarını verilen bir yeni dizeyle değiştirir.
Arama kalıbı bir JavaScript normal ifade nesnesi olarak değil, bir dize olarak iletilir. Bu nedenle, kalıptaki ters eğik çizgileri kod dışına almanız gerekir.
Bu yöntem, Google'ın RE2 normal ifade kitaplığını kullanır. Bu kitaplık, desteklenen söz dizimini sınırlar.
Sağlanan normal ifade kalıbı, geçerli öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.
var body = DocumentApp.getActiveDocument().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText("^.*Apps ?Script.*$", "Apps Script");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
searchPattern | String | normal ifade kalıbını |
replacement | String | metin yerine |
Return
Element
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAttributes(attributes)
Öğenin özelliklerini ayarlar.
Belirtilen özellik parametresi, her özellik adının DocumentApp.Attribute
numaralandırmasındaki bir öğe ve her özellik değerinin ise uygulanacak yeni değer olduğu bir nesne olmalıdır.
var body = DocumentApp.getActiveDocument().getBody(); // Define a custom paragraph style. var 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. var 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
TableCell
: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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 gösteriminde biçimlendirilmiş arka plan rengi ('#ffffff' gibi) |
Return
TableCell
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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
TableCell
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingBottom(paddingBottom)
Alt dolguyu punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
paddingBottom | Number | punto cinsinden alt dolgu |
Return
TableCell
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingLeft(paddingLeft)
Sol dolguyu punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
paddingLeft | Number | punto cinsinden sol dolgu |
Return
TableCell
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingRight(paddingRight)
Doğru dolguyu punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
paddingRight | Number | Nokta cinsinden sağ dolgu. |
Return
TableCell
: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingTop(paddingTop)
Üst dolguyu punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
paddingTop | Number | punto cinsinden üst dolgu |
Return
TableCell
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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 temizlenir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | yeni metin içeriği |
Return
TableCell
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTextAlignment(textAlignment)
Metin hizalamasını ayarlar. Kullanılabilir hizalama türleri şunlardır: DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
ve DocumentApp.TextAlignment.SUPERSCRIPT
.
// Make the entire first paragraph be superscript. var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
textAlignment | TextAlignment | uygulanacak metin hizalamasının türü |
Return
TableCell
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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 | VerticalAlignment | dikey hizalama |
Return
TableCell
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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 | punto cinsinden sütun genişliği |
Return
TableCell
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents