Class TableCell

TabloHücre

Tablo hücresini temsil eden bir öğe. TableCell her zaman bir TableRow içinde yer alır ve ListItem, 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ö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şturup ekler.
appendImage(image)InlineImageBelirtilen InlineImage değerini ekler.
appendListItem(listItem)ListItemBelirtilen ListItem değerini ekler.
appendListItem(text)ListItemYeni bir ListItem oluşturup ekler.
appendParagraph(paragraph)ParagraphBelirtilen Paragraph değerini 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 değerini ekler.
clear()TableCellÖğenin içeriğini temizler.
copy()TableCellGeçerli öğenin ayrılmış, derin bir kopyasını döndürür.
editAsText()TextDüzenlemek için mevcut öğenin Text sürümünü alır.
findElement(elementType)RangeElementÖğenin içeriğini, belirtilen türün bir alt öğesi için arar.
findElement(elementType, from)RangeElementBelirtilen RangeElement öğesinden başlayarak öğenin içeriğini, belirtilen türün bir alt öğesi için arar.
findText(searchPattern)RangeElementNormal ifadeleri kullanarak öğenin içeriğinde belirtilen metin kalıbını arar.
findText(searchPattern, from)RangeElementBelirli bir arama sonucundan başlayarak öğenin içeriğini belirtilen metin kalıbıyla arar.
getAttributes()ObjectÖğenin özelliklerini alır.
getBackgroundColor()StringArka plan rengini alır.
getChild(childIndex)ElementBelirtilen alt öğe dizininde alt öğeyi alır.
getChildIndex(child)IntegerBelirtilen alt öğenin alt öğe dizini döndürülür.
getColSpan()IntegerBu hücrenin kapsadığı tablo hücresi sütunlarının sayısı olan sütun kapsamını alır.
getLinkUrl()StringBağlantı URL'sini alır.
getNextSibling()ElementÖğenin sonraki kardeş öğesini alır.
getNumChildren()IntegerÇocuk sayısını alır.
getPaddingBottom()NumberAlt dolguyu nokta cinsinden alır.
getPaddingLeft()NumberSol dolguyu noktalar cinsinden alır.
getPaddingRight()NumberSağ dolguyu puan cinsinden alır.
getPaddingTop()NumberÜst dolguyu noktalar cinsinden alır.
getParent()ContainerElementÖğenin üst öğesini alır.
getParentRow()TableRowMevcut TableCell değerini içeren TableRow değerini alır.
getParentTable()TableMevcut TableCell değerini içeren Table değerini alır.
getPreviousSibling()ElementÖğenin önceki kardeş öğesini alır.
getRowSpan()IntegerBu hücrenin kapsadığı tablo hücresi satırlarının sayısı olan satır aralığını alır.
getText()StringÖğenin içeriğini metin dizesi olarak alır.
getTextAlignment()TextAlignmentMetin hizalamasını alır.
getType()ElementTypeÖğenin ElementType değerini alır.
getVerticalAlignment()VerticalAlignmentVerticalAlignment öğesini alır.
getWidth()NumberHücreyi içeren sütunun genişliğini, punto cinsinden alır.
insertHorizontalRule(childIndex)HorizontalRuleBelirtilen dizinde yeni bir HorizontalRule oluşturup ekler.
insertImage(childIndex, image)InlineImageBelirtilen resim blob'undan, belirtilen dizinde bir InlineImage oluşturup ekler.
insertImage(childIndex, image)InlineImageBelirtilen InlineImage öğesini belirtilen dizin içine ekler.
insertListItem(childIndex, listItem)ListItemBelirtilen ListItem öğesini belirtilen dizin içine ekler.
insertListItem(childIndex, text)ListItemBelirtilen dizinde yeni bir ListItem oluşturup ekler.
insertParagraph(childIndex, paragraph)ParagraphBelirtilen Paragraph öğesini belirtilen dizin içine ekler.
insertParagraph(childIndex, text)ParagraphBelirtilen dizinde yeni bir Paragraph oluşturup ekler.
insertTable(childIndex)TableBelirtilen dizinde yeni bir Table oluşturup ekler.
insertTable(childIndex, cells)TableBelirtilen dizinde, belirtilen hücreleri içeren yeni bir Table oluşturup ekler.
insertTable(childIndex, table)TableBelirtilen Table öğesini belirtilen dizin içine ekler.
isAtDocumentEnd()BooleanÖğenin Document'ün sonunda olup olmadığını belirler.
merge()TableCellÖğeyi, aynı türdeki önceki kardeş öğeyle birleştirir.
removeChild(child)TableCellBelirtilen alt öğeyi kaldırır.
removeFromParent()TableCellÖğeyi üst öğesinden kaldırır.
replaceText(searchPattern, replacement)ElementNormal ifadeler kullanılarak belirli bir metin kalıbının tüm örnekleri belirli bir değiştirme dizesiyle değiştirilir.
setAttributes(attributes)TableCellÖğenin özelliklerini ayarlar.
setBackgroundColor(color)TableCellArka plan rengini ayarlar.
setLinkUrl(url)TableCellBağlantı URL'sini ayarlar.
setPaddingBottom(paddingBottom)TableCellAlt dolguyu nokta cinsinden ayarlar.
setPaddingLeft(paddingLeft)TableCellSol dolguyu nokta cinsinden ayarlar.
setPaddingRight(paddingRight)TableCellSağ dolguyu puan cinsinden ayarlar.
setPaddingTop(paddingTop)TableCellÜst dolguyu piksel 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ı dokümanlar

appendHorizontalRule()

Yeni bir HorizontalRule oluşturup ekler.

HorizontalRule, yeni bir Paragraph içinde yer alır.

Return

HorizontalRule: 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 InlineImage oluşturup ekler.

InlineImage, yeni bir Paragraph içinde yer alır.

Parametreler

AdTürAçıklama
imageBlobSourceresim verileri

Return

InlineImage: 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 InlineImage değerini ekler.

InlineImage, yeni bir Paragraph içinde yer alır.

Parametreler

AdTürAçıklama
imageInlineImageresim verileri

Return

InlineImage: 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 ListItem değerini ekler.

Parametreler

AdTürAçıklama
listItemListItemEklenecek liste öğesi

Return

ListItem: 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 ListItem oluşturup ekler.

Parametreler

AdTürAçıklama
textStringmetin içerikleri

Return

ListItem: 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

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

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

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

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

Öğenin içeriğini temizler.

Return

TableCell: Geçerli öğe.


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

TableCell: 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 editAsText öğesini kullanın. editAsText modu, metin olmayan öğeleri (InlineImage ve HorizontalRule 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

AdTürAçıklama
elementTypeElementTypeAranacak öğe türü.

Return

RangeElement: 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 RangeElement öğ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

AdTürAçıklama
elementTypeElementTypeAranacak öğe türü.
fromRangeElementArama yapılacak arama sonucu.

Return

RangeElement: 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

AdTürAçıklama
searchPatternStringaranacak kalıp

Return

RangeElement: 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

AdTürAçıklama
searchPatternStringaranacak kalıp
fromRangeElementArama yapılacak arama sonucu

Return

RangeElement: 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ı, DocumentApp.Attribute 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

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

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

ContainerElement: Ü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 TableCell değerini içeren TableRow değerini alır.

Return

TableRow: 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 TableCell 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 DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT ve DocumentApp.TextAlignment.SUPERSCRIPT'dir.

Return

TextAlignment: 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 ElementType değerini alır.

Belirli bir öğenin tam türünü belirlemek için getType() öğ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

ElementType: Öğ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()

VerticalAlignment öğesini alır.

Return

VerticalAlignment: 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 HorizontalRule oluşturup ekler.

Yatay çizgi yeni bir Paragraph içinde yer alır.

Parametreler

AdTürAçıklama
childIndexIntegerÖğenin ekleneceği dizin

Return

HorizontalRule: 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 InlineImage oluşturup ekler.

Resim yeni bir Paragraph içinde yer alır.

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ı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 InlineImage öğesini belirtilen dizin içine ekler.

Resim yeni bir Paragraph içinde yer alır.

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ı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 ListItem öğesini belirtilen dizin içine 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ı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 ListItem oluşturup ekler.

Parametreler

AdTürAçıklama
childIndexIntegerÖğenin ekleneceği dizin
textStringmetin içerikleri

Return

ListItem: 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

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

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

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

AdTürAçıklama
childIndexIntegerEklemenin yapılacağı dizin
cellsString[][]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

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

TableCell: 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

AdTürAçıklama
childElementKaldırılacak alt öğe

Return

TableCell: 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

TableCell: 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

AdTürAçıklama
searchPatternStringAranacak normal ifade kalıbı
replacementStringDeğ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 DocumentApp.Attribute 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

AdTürAçıklama
attributesObjectÖğenin özellikleri.

Return

TableCell: 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

AdTürAçıklama
colorStringCSS notasyonunda biçimlendirilmiş arka plan rengi ('#ffffff' gibi)

Return

TableCell: 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

AdTürAçıklama
urlStringbağlantı URL'si

Return

TableCell: 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

AdTürAçıklama
paddingBottomNumberAlt dolgu (punto cinsinden)

Return

TableCell: 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

AdTürAçıklama
paddingLeftNumbersol dolgu, noktalar cinsinden

Return

TableCell: 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

AdTürAçıklama
paddingRightNumberSağ dolgu, noktalar cinsinden.

Return

TableCell: 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

AdTürAçıklama
paddingTopNumberÜst dolgu, noktalar cinsinden

Return

TableCell: 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

AdTürAçıklama
textStringyeni metin içerikleri

Return

TableCell: 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 DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT ve DocumentApp.TextAlignment.SUPERSCRIPT'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

AdTürAçıklama
textAlignmentTextAlignmentuygulanacak metin hizalamasının türü

Return

TableCell: 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

AdTürAçıklama
alignmentVerticalAlignmentdikey hizalama

Return

TableCell: 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

AdTürAçıklama
widthNumbersütun genişliği (punto cinsinden)

Return

TableCell: 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