Doküman gövdesini temsil eden bir öğe. Body
; ListItem
, Paragraph
, Table
ve TableOfContents
öğeleri içerebilir. Belge yapısı hakkında daha fazla bilgi edinmek için Google Dokümanlar'ı genişletme kılavuzuna bakın.
Body
genellikle HeaderSection
, FooterSection
ve FootnoteSection
öğeleri hariç tüm doküman içeriklerini içerir.
var doc = DocumentApp.getActiveDocument(); var body = doc.getBody(); // Append a paragraph and a page break to the document body section directly. body.appendParagraph("A paragraph."); body.appendPageBreak();
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 | Belirtilen metin içeriklerini içeren yeni bir ListItem oluşturur ve ekler. |
appendPageBreak() | PageBreak | Yeni bir PageBreak oluşturup ekler. |
appendPageBreak(pageBreak) | PageBreak | Belirtilen PageBreak dizesini ekler. |
appendParagraph(paragraph) | Paragraph | Belirtilen Paragraph dizesini ekler. |
appendParagraph(text) | Paragraph | Belirtilen metin içeriklerini içeren yeni bir Paragraph oluşturur ve ekler. |
appendTable() | Table | Yeni bir Table oluşturup ekler. |
appendTable(cells) | Table | Belirtilen her bir dize değeri için TableCell içeren yeni bir Table ekler. |
appendTable(table) | Table | Belirtilen Table dizesini ekler. |
clear() | Body | Öğenin içeriğini temizler. |
copy() | Body | 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. |
getChild(childIndex) | Element | Belirtilen alt dizindeki alt öğeyi alır. |
getChildIndex(child) | Integer | Belirtilen alt öğe için alt dizini alır. |
getHeadingAttributes(paragraphHeading) | Object | Sağlanan ParagraphHeading için özellik grubunu alır. |
getImages() | InlineImage[] | Bölümdeki tüm InlineImages öğelerini getirir. |
getListItems() | ListItem[] | Bölümdeki tüm ListItems öğelerini getirir. |
getMarginBottom() | Number | Alt kenar boşluğunu punto cinsinden alır. |
getMarginLeft() | Number | Sol kenar boşluğunu punto cinsinden alır. |
getMarginRight() | Number | Sağ kenar boşluğunu alır. |
getMarginTop() | Number | Üst kenar boşluğunu alır. |
getNumChildren() | Integer | Alt öğe sayısını alır. |
getPageHeight() | Number | Sayfa yüksekliğini punto cinsinden alır. |
getPageWidth() | Number | Sayfa genişliğini punto cinsinden alır. |
getParagraphs() | Paragraph[] | Bölümde yer alan tüm Paragraphs öğelerini alır (ListItems dahil). |
getParent() | ContainerElement | Öğenin üst öğesini alır. |
getTables() | Table[] | Bölümdeki tüm Tables öğelerini getirir. |
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. |
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, belirtilen metin içeriklerini içeren yeni bir ListItem oluşturur ve ekler. |
insertPageBreak(childIndex) | PageBreak | Belirtilen dizinde yeni bir PageBreak oluşturur ve ekler. |
insertPageBreak(childIndex, pageBreak) | PageBreak | Belirtilen PageBreak öğesini belirtilen dizine ekler. |
insertParagraph(childIndex, paragraph) | Paragraph | Belirtilen Paragraph öğesini belirtilen dizine ekler. |
insertParagraph(childIndex, text) | Paragraph | Belirtilen dizinde, belirtilen metin içeriklerini içeren 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. |
removeChild(child) | Body | Belirtilen alt öğeyi 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) | Body | Öğenin özelliklerini ayarlar. |
setHeadingAttributes(paragraphHeading, attributes) | Body | Sağlanan ParagraphHeading için özellikleri ayarlar. |
setMarginBottom(marginBottom) | Body | Alt kenar boşluğunu punto cinsinden ayarlar. |
setMarginLeft(marginLeft) | Body | Sol kenar boşluğunu punto cinsinden ayarlar. |
setMarginRight(marginRight) | Body | Doğru kenar boşluğunu punto cinsinden ayarlar. |
setMarginTop(marginTop) | Body | Üst kenar boşluğunu ayarlar. |
setPageHeight(pageHeight) | Body | Sayfa yüksekliğini punto cinsinden ayarlar. |
setPageWidth(pageWidth) | Body | Sayfa genişliğini punto cinsinden ayarlar. |
setText(text) | Body | İçeriği düz metin olarak ayarlar. |
setTextAlignment(textAlignment) | Body | Metin hizalamasını 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.
Bu resim, yeni bir Paragraph
öğesi içinde yer alacak.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
image | BlobSource | 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
appendImage(image)
Belirtilen InlineImage
dizesini ekler.
InlineImage
, yeni bir Paragraph
içinde yer alacak.
Mevcut bir InlineImage
kopyasını eklerken bu appendImage
sürümünü kullanın.
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.
Mevcut bir ListItem
kopyasını eklerken bu appendListItem
sürümünü kullanın.
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)
Belirtilen metin içeriklerini içeren yeni bir ListItem
oluşturur ve ekler.
Ardışık liste öğeleri aynı listenin parçası olarak eklenir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | liste öğesinin 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
appendPageBreak()
Yeni bir PageBreak
oluşturup ekler.
PageBreak
, yeni bir Paragraph
içinde yer alacak.
Return
PageBreak
- yeni sayfa sonu
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
appendPageBreak(pageBreak)
Belirtilen PageBreak
dizesini ekler.
PageBreak
, yeni bir Paragraph
içinde yer alacak.
Mevcut bir PageBreak
kopyasını eklerken bu appendPageBreak
sürümünü kullanın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
pageBreak | PageBreak | eklenecek sayfa sonu |
Return
PageBreak
: eklenen sayfa sonu
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.
Mevcut bir Paragraph
kopyasını eklerken bu appendParagraph
sürümünü kullanın.
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)
Belirtilen metin içeriklerini içeren yeni bir Paragraph
oluşturur ve ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | paragrafın 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.
Google Dokümanlar dokümanları bir tabloyla bitemeyeceği için bu yöntem tablodan sonra boş bir paragraf da 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 her bir dize değeri için TableCell
içeren yeni bir Table
ekler.
Google Dokümanlar dokümanları bir tabloyla bitemeyeceği için bu yöntem tablodan sonra boş bir paragraf da 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.
Mevcut bir Table
kopyasını eklerken bu appendTable
sürümünü kullanın.
Google Dokümanlar dokümanları bir tabloyla bitemeyeceği için bu yöntem tablodan sonra boş bir paragraf da 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
Body
: 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
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
getHeadingAttributes(paragraphHeading)
Sağlanan ParagraphHeading
için özellik grubunu alır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
paragraphHeading | ParagraphHeading | özellikleri alınacak başlık |
Return
Object
: Özelliklerin ve geçerli değerlerinin bir eşlemesi
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
getImages()
Bölümdeki tüm InlineImages
öğelerini getirir.
Return
InlineImage[]
— bölüm resimleri
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
getListItems()
Bölümdeki tüm ListItems
öğelerini getirir.
Return
ListItem[]
- bölüm listesi öğeleri
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
getMarginBottom()
Alt kenar boşluğunu punto cinsinden alır.
Return
Number
— puan cinsinden alt kenar boşluğu
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
getMarginLeft()
Sol kenar boşluğunu punto cinsinden alır.
Return
Number
— sol kenar boşluğu (punto cinsinden)
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
getMarginRight()
Sağ kenar boşluğunu alır.
Return
Number
— punto cinsinden sağ kenar boşluğu
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
getMarginTop()
Üst kenar boşluğunu alır.
Return
Number
— puan cinsinden üst kenar boşluğu
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
getPageHeight()
Sayfa yüksekliğini punto cinsinden alır.
Return
Number
— sayfa yüksekliği (punto cinsinden)
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
getPageWidth()
Sayfa genişliğini punto cinsinden alır.
Return
Number
— punto cinsinden sayfa 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
getParagraphs()
Bölümde yer alan tüm Paragraphs
öğelerini alır (ListItems
dahil).
Return
Paragraph[]
— bölüm paragrafları
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
getTables()
Bölümdeki tüm Tables
öğelerini getirir.
Return
Table[]
: bölüm tabloları
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
insertHorizontalRule(childIndex)
Belirtilen dizinde yeni bir HorizontalRule
oluşturur ve ekler.
HorizontalRule
, 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.
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 | ekleneceği dizin |
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
insertListItem(childIndex, text)
Belirtilen dizinde, belirtilen metin içeriklerini içeren yeni bir ListItem
oluşturur ve ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | ekleneceği dizin |
text | String | liste öğesinin 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
insertPageBreak(childIndex)
Belirtilen dizinde yeni bir PageBreak
oluşturur ve ekler.
PageBreak
, yeni bir Paragraph
içinde yer alacak.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | öğenin ekleneceği dizin |
Return
PageBreak
- yeni sayfa sonu
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
insertPageBreak(childIndex, pageBreak)
Belirtilen PageBreak
öğesini belirtilen dizine ekler.
PageBreak
, yeni bir Paragraph
içinde yer alacak.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | öğenin ekleneceği dizin |
pageBreak | PageBreak | eklenecek p[yaş aralığı |
Return
PageBreak
- eklenen sayfa sonu
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 | 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, belirtilen metin içeriklerini içeren yeni bir Paragraph
oluşturur ve ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | ekleneceği dizin |
text | String | paragrafın 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 | 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 | 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
removeChild(child)
Belirtilen alt öğeyi kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Element | kaldırılacak alt öğe |
Return
Body
- 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
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
Body
: 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
setHeadingAttributes(paragraphHeading, attributes)
Sağlanan ParagraphHeading
için özellikleri ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
paragraphHeading | ParagraphHeading | özellikleri ayarlanacak başlık |
attributes | Object | bir özellik ve değerler haritası oluşturabilirsiniz. |
Return
Body
- 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
setMarginBottom(marginBottom)
Alt kenar boşluğunu punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
marginBottom | Number | punto cinsinden alt kenar boşluğu |
Return
Body
- 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
setMarginLeft(marginLeft)
Sol kenar boşluğunu punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
marginLeft | Number | punto cinsinden sol kenar boşluğu |
Return
Body
- 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
setMarginRight(marginRight)
Doğru kenar boşluğunu punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
marginRight | Number | sağ kenar boşluğu |
Return
Body
- 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
setMarginTop(marginTop)
Üst kenar boşluğunu ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
marginTop | Number | punto cinsinden üst kenar boşluğu |
Return
Body
- 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
setPageHeight(pageHeight)
Sayfa yüksekliğini punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
pageHeight | Number | punto cinsinden sayfa yüksekliği |
Return
Body
- 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
setPageWidth(pageWidth)
Sayfa genişliğini punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
pageWidth | Number | punto cinsinden sayfa genişliği |
Return
Body
- 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
Body
- 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
Body
- 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