Class TableCell

TableCell

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öntemDönüş türüKısa açıklama
appendHorizontalRule()HorizontalRuleYeni bir HorizontalRule oluşturup ekler.
appendImage(image)InlineImageBelirtilen resim blob'undan yeni bir InlineImage oluşturur ve ekler.
appendImage(image)InlineImageBelirtilen InlineImage dizesini ekler.
appendListItem(listItem)ListItemBelirtilen ListItem dizesini ekler.
appendListItem(text)ListItemYeni bir ListItem oluşturup ekler.
appendParagraph(paragraph)ParagraphBelirtilen Paragraph dizesini ekler.
appendParagraph(text)ParagraphYeni bir Paragraph oluşturup ekler.
appendTable()TableYeni bir Table oluşturup ekler.
appendTable(cells)TableBelirtilen hücreleri içeren yeni bir Table ekler.
appendTable(table)TableBelirtilen Table dizesini ekler.
clear()TableCellÖğenin içeriğini temizler.
copy()TableCellGeçerli öğenin ayrı, derin bir kopyasını döndürür.
editAsText()TextDü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)RangeElementBelirtilen RangeElement öğesinden başlayarak, öğenin içeriğinde belirtilen türde bir alt öğe arar.
findText(searchPattern)RangeElementNormal ifadeler kullanarak, belirtilen metin kalıbı için öğenin içeriğinde arama yapar.
findText(searchPattern, from)RangeElementBelirli bir arama sonucundan başlayarak, belirtilen metin kalıbı için öğenin içeriğinde arama yapar.
getAttributes()ObjectÖğenin özelliklerini alır.
getBackgroundColor()StringArka plan rengini alır.
getChild(childIndex)ElementBelirtilen alt dizindeki alt öğeyi alır.
getChildIndex(child)IntegerBelirtilen alt öğe için alt dizini alır.
getColSpan()IntegerBu hücrenin kapladığı tablo hücrelerinin sütun sayısı olan sütun aralığını alır.
getLinkUrl()StringBağlantı URL'sini alır.
getNextSibling()ElementÖğenin sonraki eşdüzey öğesini alır.
getNumChildren()IntegerAlt öğe sayısını alır.
getPaddingBottom()NumberNokta cinsinden alt dolguyu alır.
getPaddingLeft()NumberNokta cinsinden sol dolguyu alır.
getPaddingRight()NumberNokta cinsinden sağ dolguyu alır.
getPaddingTop()NumberNokta cinsinden üst dolguyu alır.
getParent()ContainerElementÖğenin üst öğesini alır.
getParentRow()TableRowGeçerli TableCell öğesini içeren TableRow öğesini alır.
getParentTable()TableGeçerli TableCell öğesini içeren Table öğesini alır.
getPreviousSibling()ElementÖğenin önceki eşdüzey öğesini alır.
getRowSpan()IntegerBu 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()TextAlignmentMetin hizalamasını sağlar.
getType()ElementTypeÖğenin ElementType değerini alır.
getVerticalAlignment()VerticalAlignmentVerticalAlignment öğesini getirir.
getWidth()NumberHücreyi içeren sütunun genişliğini nokta cinsinden alır.
insertHorizontalRule(childIndex)HorizontalRuleBelirtilen dizinde yeni bir HorizontalRule oluşturur ve ekler.
insertImage(childIndex, image)InlineImageBelirtilen resim blob'undan, belirtilen dizinde bir InlineImage oluşturur ve ekler.
insertImage(childIndex, image)InlineImageBelirtilen InlineImage öğesini belirtilen dizine ekler.
insertListItem(childIndex, listItem)ListItemBelirtilen ListItem öğesini belirtilen dizine ekler.
insertListItem(childIndex, text)ListItemBelirtilen dizinde yeni bir ListItem oluşturur ve ekler.
insertParagraph(childIndex, paragraph)ParagraphBelirtilen Paragraph öğesini belirtilen dizine ekler.
insertParagraph(childIndex, text)ParagraphBelirtilen dizinde yeni bir Paragraph oluşturur ve ekler.
insertTable(childIndex)TableBelirtilen dizinde yeni bir Table oluşturur ve ekler.
insertTable(childIndex, cells)TableBelirtilen hücreleri içeren, belirtilen dizinde yeni bir Table oluşturur ve ekler.
insertTable(childIndex, table)TableBelirtilen 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)TableCellBelirtilen alt öğeyi kaldırır.
removeFromParent()TableCellÖğeyi üst öğesinden kaldırır.
replaceText(searchPattern, replacement)ElementNormal 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)TableCellArka plan rengini ayarlar.
setLinkUrl(url)TableCellBağlantı URL'sini ayarlar.
setPaddingBottom(paddingBottom)TableCellAlt dolguyu punto cinsinden ayarlar.
setPaddingLeft(paddingLeft)TableCellSol dolguyu punto cinsinden ayarlar.
setPaddingRight(paddingRight)TableCellDoğ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)TableCellMetin hizalamasını ayarlar.
setVerticalAlignment(alignment)TableCellDikey hizalamayı ayarlar.
setWidth(width)TableCellGeç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

AdTürAçıklama
imageBlobSourceresim 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

AdTürAçıklama
imageInlineImageresim 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

AdTürAçıklama
listItemListItemeklenecek 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

AdTürAçıklama
textStringmetin 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

AdTürAçıklama
paragraphParagrapheklenecek 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

AdTürAçıklama
textStringmetin 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

AdTürAçıklama
cellsString[][]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

AdTürAçıklama
tableTableeklenecek 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()

Öğenin içeriğini temizler.

Return

TableCell - geçerli öğe


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

AdTürAçıklama
elementTypeElementTypearanacak öğ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

AdTürAçıklama
elementTypeElementTypearanacak öğe türü
fromRangeElementarama 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

AdTürAçıklama
searchPatternStringmola 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

AdTürAçıklama
searchPatternStringmola vermek için
fromRangeElementarama 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

AdTürAçıklama
childIndexIntegeralt öğ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

AdTürAçıklama
childElementdizini 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

AdTürAçıklama
childIndexIntegeröğ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

AdTürAçıklama
childIndexIntegeröğenin ekleneceği dizin
imageBlobSourceresim 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

AdTürAçıklama
childIndexIntegeröğenin ekleneceği dizin
imageInlineImageeklenecek 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

AdTürAçıklama
childIndexIntegeröğenin ekleneceği dizin
listItemListItemeklenecek 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

AdTürAçıklama
childIndexIntegeröğenin ekleneceği dizin
textStringmetin 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

AdTürAçıklama
childIndexIntegeröğenin ekleneceği dizin
paragraphParagrapheklenecek 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

AdTürAçıklama
childIndexIntegeröğenin ekleneceği dizin
textStringmetin 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

AdTürAçıklama
childIndexIntegeröğ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

AdTürAçıklama
childIndexIntegerekleneceği dizin
cellsString[][]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

AdTürAçıklama
childIndexIntegeröğenin ekleneceği dizin
tableTableeklenecek 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

AdTürAçıklama
childElementkaldı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

AdTürAçıklama
searchPatternStringnormal ifade kalıbını
replacementStringmetin 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

AdTürAçıklama
attributesObjectÖğ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

AdTürAçıklama
colorStringCSS 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

AdTürAçıklama
urlStringbağ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

AdTürAçıklama
paddingBottomNumberpunto 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

AdTürAçıklama
paddingLeftNumberpunto 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

AdTürAçıklama
paddingRightNumberNokta 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

AdTürAçıklama
paddingTopNumberpunto 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

AdTürAçıklama
textStringyeni 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

AdTürAçıklama
textAlignmentTextAlignmentuygulanacak 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

AdTürAçıklama
alignmentVerticalAlignmentdikey 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

AdTürAçıklama
widthNumberpunto 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