Class FooterSection

FooterSection

Element reprezentujący sekcję stopki. Typ Document zawiera zwykle maksymalnie 1 FooterSection. FooterSection może zawierać ListItem, Paragraph i Table elementów. Więcej informacji na temat struktury dokumentów znajdziesz w przewodniku po rozszerzaniu plików Dokumentów Google.

Metody

MetodaZwracany typKrótki opis
appendHorizontalRule()HorizontalRuleTworzy i dołącza nowy element HorizontalRule.
appendImage(image)InlineImageTworzy i dołącza nowy obiekt InlineImage z określonego obiektu blob obrazu.
appendImage(image)InlineImageDołącza podaną wartość InlineImage.
appendListItem(listItem)ListItemDołącza podaną wartość ListItem.
appendListItem(text)ListItemTworzy i dołącza nowy dokument ListItem zawierający określoną zawartość tekstu.
appendParagraph(paragraph)ParagraphDołącza podaną wartość Paragraph.
appendParagraph(text)ParagraphTworzy i dołącza nowy dokument Paragraph zawierający określoną zawartość tekstu.
appendTable()TableTworzy i dołącza nowy element Table.
appendTable(cells)TableDodaje nowy element Table zawierający TableCell dla każdej określonej wartości ciągu.
appendTable(table)TableDołącza podaną wartość Table.
clear()FooterSectionUsuwa zawartość elementu.
copy()FooterSectionZwraca odłączoną, głęboką kopię bieżącego elementu.
editAsText()TextPobiera wersję Text bieżącego elementu do edycji.
findElement(elementType)RangeElementPrzeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu.
findElement(elementType, from)RangeElementPrzeszukuje zawartość elementu pod kątem elementu potomnego określonego typu, zaczynając od określono RangeElement.
findText(searchPattern)RangeElementPrzeszukuje zawartość elementu pod kątem określonego wzorca tekstu przy użyciu wyrażeń regularnych.
findText(searchPattern, from)RangeElementPrzeszukuje zawartość elementu pod kątem określonego wzorca tekstu, zaczynając od podanego wyniku wyszukiwania.
getAttributes()ObjectPobiera atrybuty elementu.
getChild(childIndex)ElementPobiera element podrzędny z określonego indeksu podrzędnego.
getChildIndex(child)IntegerPobiera indeks podrzędny dla określonego elementu podrzędnego.
getImages()InlineImage[]Pobiera wszystkie zasoby InlineImages zawarte w sekcji.
getListItems()ListItem[]Pobiera wszystkie zasoby ListItems zawarte w sekcji.
getNumChildren()IntegerPobiera liczbę dzieci.
getParagraphs()Paragraph[]Pobiera wszystkie funkcje Paragraphs zawarte w sekcji (w tym ListItems).
getParent()ContainerElementPobiera element nadrzędny elementu.
getTables()Table[]Pobiera wszystkie zasoby Tables zawarte w sekcji.
getText()StringPobiera zawartość elementu jako ciąg tekstowy.
getTextAlignment()TextAlignmentPobiera wyrównanie tekstu.
getType()ElementTypePobiera wartość ElementType elementu.
insertHorizontalRule(childIndex)HorizontalRuleTworzy i wstawia nowy HorizontalRule w podanym indeksie.
insertImage(childIndex, image)InlineImageTworzy i wstawia obiekt InlineImage z określonego obiektu blob w określonym miejscu indeksu.
insertImage(childIndex, image)InlineImageWstawia podaną wartość InlineImage w określonym indeksie.
insertListItem(childIndex, listItem)ListItemWstawia podaną wartość ListItem w określonym indeksie.
insertListItem(childIndex, text)ListItemTworzy i wstawia nowy element ListItem w podanym indeksie, zawierający określony indeks zawartość tekstową.
insertParagraph(childIndex, paragraph)ParagraphWstawia podaną wartość Paragraph w określonym indeksie.
insertParagraph(childIndex, text)ParagraphTworzy i wstawia nowy element Paragraph w podanym indeksie, zawierający określony indeks zawartość tekstową.
insertTable(childIndex)TableTworzy i wstawia nowy Table w podanym indeksie.
insertTable(childIndex, cells)TableTworzy i wstawia nowy obiekt Table zawierający określone komórki w określonym indeksie.
insertTable(childIndex, table)TableWstawia podaną wartość Table w określonym indeksie.
removeChild(child)FooterSectionUsuwa określony element podrzędny.
removeFromParent()FooterSectionUsuwa element z elementu nadrzędnego.
replaceText(searchPattern, replacement)ElementZastępuje wszystkie wystąpienia danego wzorca tekstowego danym ciągiem zastępczym, stosując zwykłe wyrażeń.
setAttributes(attributes)FooterSectionUstawia atrybuty elementu.
setText(text)FooterSectionUstawia zawartość jako zwykły tekst.
setTextAlignment(textAlignment)FooterSectionOkreśla wyrównanie tekstu.

Szczegółowa dokumentacja

appendHorizontalRule()

Tworzy i dołącza nowy element HorizontalRule.

Element HorizontalRule zostanie zawarty w nowym elemencie Paragraph.

Powrót

HorizontalRule – nowa linia pozioma.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendImage(image)

Tworzy i dołącza nowy obiekt InlineImage z określonego obiektu blob obrazu.

Obraz zostanie umieszczony w nowym pliku Paragraph.

Parametry

NazwaTypOpis
imageBlobSourceDane obrazu.

Powrót

InlineImage – dołączony obraz.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendImage(image)

Dołącza podaną wartość InlineImage.

Element InlineImage zostanie zawarty w nowym elemencie Paragraph.

Użyj tej wersji appendImage, gdy dołączasz kopię istniejącego elementu InlineImage.

Parametry

NazwaTypOpis
imageInlineImageDane obrazu.

Powrót

InlineImage – dołączony obraz.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendListItem(listItem)

Dołącza podaną wartość ListItem.

Użyj tej wersji appendListItem, gdy dołączasz kopię istniejącego elementu ListItem.

Parametry

NazwaTypOpis
listItemListItemElement listy do dołączenia.

Powrót

ListItem – dołączony element listy.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendListItem(text)

Tworzy i dołącza nowy dokument ListItem zawierający określoną zawartość tekstu.

Kolejne elementy listy są dodawane jako część tej samej listy.

Parametry

NazwaTypOpis
textStringZawartość tekstowa elementu listy.

Powrót

ListItem – nowy element listy.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendParagraph(paragraph)

Dołącza podaną wartość Paragraph.

Użyj tej wersji appendParagraph, gdy dołączasz kopię istniejącego elementu Paragraph.

Parametry

NazwaTypOpis
paragraphParagraphAkapit do dołączenia.

Powrót

Paragraph – dołączony akapit.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendParagraph(text)

Tworzy i dołącza nowy dokument Paragraph zawierający określoną zawartość tekstu.

Parametry

NazwaTypOpis
textStringTreść akapitu.

Powrót

Paragraph – nowy akapit.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable()

Tworzy i dołącza nowy element Table.

Ta metoda spowoduje też dodanie pustego akapitu za tabelą, ponieważ dokumenty Dokumentów Google nie może kończyć się tabelą.

Powrót

Table – nowa tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable(cells)

Dodaje nowy element Table zawierający TableCell dla każdej określonej wartości ciągu.

Ta metoda spowoduje też dodanie pustego akapitu za tabelą, ponieważ dokumenty Dokumentów Google nie może kończyć się tabelą.

Parametry

NazwaTypOpis
cellsString[][]Zawartość tekstowa z komórek tabeli, które mają zostać dodane do nowej tabeli.

Powrót

Table – dołączona tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable(table)

Dołącza podaną wartość Table.

Użyj tej wersji appendTable, gdy dołączasz kopię istniejącego elementu Table. Ta metoda spowoduje też dodanie pustego akapitu za tabelą, ponieważ dokumenty Dokumentów Google nie może kończyć się tabelą.

Parametry

NazwaTypOpis
tableTableTabela do dołączenia.

Powrót

Table – dołączona tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

clear()

Usuwa zawartość elementu.

Powrót

FooterSection – bieżący element.


copy()

Zwraca odłączoną, głęboką kopię bieżącego elementu.

Skopiowane są też wszystkie elementy podrzędne zawarte w elemencie. Nowy element nie ma elementu nadrzędnego.

Powrót

FooterSection – nowa wersja,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

editAsText()

Pobiera wersję Text bieżącego elementu do edycji.

editAsText umożliwia manipulowanie zawartością elementów jako tekstu sformatowanego. Tryb editAsText ignoruje elementy inne niż tekstowe (np. InlineImage i HorizontalRule).

Elementy podrzędne, które w pełni znajdują się w usuniętym zakresie tekstowym, są usuwane z elementu.

var 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);

Powrót

Text – wersja tekstowa bieżącego elementu,


findElement(elementType)

Przeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu.

Parametry

NazwaTypOpis
elementTypeElementTypeTyp szukanego elementu.

Powrót

RangeElement – wynik wyszukiwania wskazujący pozycję elementu wyszukiwania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

findElement(elementType, from)

Przeszukuje zawartość elementu pod kątem elementu potomnego określonego typu, zaczynając od określono RangeElement.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().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;
  }
}

Parametry

NazwaTypOpis
elementTypeElementTypeTyp szukanego elementu.
fromRangeElementWynik wyszukiwania.

Powrót

RangeElement – wynik wyszukiwania wskazujący następną pozycję elementu wyszukiwania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

findText(searchPattern)

Przeszukuje zawartość elementu pod kątem określonego wzorca tekstu przy użyciu wyrażeń regularnych.

Niektóre funkcje wyrażeń regularnych JavaScript nie są w pełni obsługiwane, na przykład grup przechwytywania i modyfikatorów trybów.

Podany wzorzec wyrażeń regularnych jest niezależnie dopasowywany do każdego bloku tekstu zawarte w bieżącym elemencie.

Parametry

NazwaTypOpis
searchPatternStringwzorzec do wyszukania

Powrót

RangeElement – wynik wyszukiwania wskazujący pozycję szukanego tekstu lub wartość null, jeśli nie ma wartości; gra

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

findText(searchPattern, from)

Przeszukuje zawartość elementu pod kątem określonego wzorca tekstu, zaczynając od podanego wyniku wyszukiwania.

Niektóre funkcje wyrażeń regularnych JavaScript nie są w pełni obsługiwane, na przykład grup przechwytywania i modyfikatorów trybów.

Podany wzorzec wyrażeń regularnych jest niezależnie dopasowywany do każdego bloku tekstu zawarte w bieżącym elemencie.

Parametry

NazwaTypOpis
searchPatternStringwzorzec do wyszukania
fromRangeElementwynik wyszukiwania

Powrót

RangeElement – wynik wyszukiwania wskazujący następną pozycję wyszukiwanego tekstu lub wartość null, jeśli nie ma podanej wartości; gra

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getAttributes()

Pobiera atrybuty elementu.

Wynikiem jest obiekt zawierający właściwość każdego prawidłowego atrybutu elementu, nazwa właściwości odpowiada elementowi na liście DocumentApp.Attribute.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.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]);
}

Powrót

Object – atrybuty elementu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getChild(childIndex)

Pobiera element podrzędny z określonego indeksu podrzędnego.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Obtain the first element in the tab.
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.");
}

Parametry

NazwaTypOpis
childIndexIntegerIndeks elementu podrzędnego do pobrania.

Powrót

Element – element podrzędny o określonym indeksie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getChildIndex(child)

Pobiera indeks podrzędny dla określonego elementu podrzędnego.

Parametry

NazwaTypOpis
childElementElement podrzędny, dla którego ma zostać pobrany indeks.

Powrót

Integer – indeks podrzędny.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getImages()

Pobiera wszystkie zasoby InlineImages zawarte w sekcji.

Powrót

InlineImage[] – obrazy sekcji.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getListItems()

Pobiera wszystkie zasoby ListItems zawarte w sekcji.

Powrót

ListItem[] – elementy listy sekcji.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getNumChildren()

Pobiera liczbę dzieci.

var 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.");

Powrót

Integer – liczba dzieci.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getParagraphs()

Pobiera wszystkie funkcje Paragraphs zawarte w sekcji (w tym ListItems).

Powrót

Paragraph[] – akapity sekcji.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getParent()

Pobiera element nadrzędny elementu.

Element nadrzędny zawiera bieżący element.

Powrót

ContainerElement – element nadrzędny.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getTables()

Pobiera wszystkie zasoby Tables zawarte w sekcji.

Powrót

Table[] – tabele sekcji.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getText()

Pobiera zawartość elementu jako ciąg tekstowy.

Powrót

String – zawartość elementu w postaci ciągu tekstowego;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getTextAlignment()

Pobiera wyrównanie tekstu. Dostępne typy wyrównania to DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT i DocumentApp.TextAlignment.SUPERSCRIPT.

Powrót

TextAlignment – typ wyrównania tekstu lub null, jeśli tekst zawiera różne typy tekstu. lub jeśli wyrównanie tekstu nigdy nie zostało ustawione.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getType()

Pobiera wartość ElementType elementu.

Aby określić dokładny typ danego elementu, użyj właściwości getType().

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Obtain the first element in the active tab's 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.');
}

Powrót

ElementType – typ elementu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertHorizontalRule(childIndex)

Tworzy i wstawia nowy HorizontalRule w podanym indeksie.

Element HorizontalRule zostanie zawarty w nowym elemencie Paragraph.

Parametry

NazwaTypOpis
childIndexIntegerIndeks, w którym ma zostać wstawiony element.

Powrót

HorizontalRule – nowa linia pozioma.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertImage(childIndex, image)

Tworzy i wstawia obiekt InlineImage z określonego obiektu blob w określonym miejscu indeksu.

Parametry

NazwaTypOpis
childIndexIntegerIndeks, w którym ma zostać wstawiony element.
imageBlobSourceDane obrazu.

Powrót

InlineImage – wstawiony obraz w tekście.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertImage(childIndex, image)

Wstawia podaną wartość InlineImage w określonym indeksie.

Obraz zostanie umieszczony w nowym pliku Paragraph.

Parametry

NazwaTypOpis
childIndexIntegerIndeks, w którym ma zostać wstawiony element.
imageInlineImageObraz do wstawienia.

Powrót

InlineImage – wstawiony obraz w tekście.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertListItem(childIndex, listItem)

Wstawia podaną wartość ListItem w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerIndeks do wstawienia.
listItemListItemElement listy do wstawienia.

Powrót

ListItem – wstawiony element listy.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertListItem(childIndex, text)

Tworzy i wstawia nowy element ListItem w podanym indeksie, zawierający określony indeks zawartość tekstową.

Parametry

NazwaTypOpis
childIndexIntegerIndeks do wstawienia.
textStringZawartość tekstowa elementu listy.

Powrót

ListItem – nowy element listy.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertParagraph(childIndex, paragraph)

Wstawia podaną wartość Paragraph w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerIndeks do wstawienia.
paragraphParagraphAkapit do wstawienia.

Powrót

Paragraph – wstawiony akapit.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertParagraph(childIndex, text)

Tworzy i wstawia nowy element Paragraph w podanym indeksie, zawierający określony indeks zawartość tekstową.

Parametry

NazwaTypOpis
childIndexIntegerIndeks do wstawienia.
textStringTreść akapitu.

Powrót

Paragraph – nowy akapit.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex)

Tworzy i wstawia nowy Table w podanym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerIndeks do wstawienia.

Powrót

Table – nowa tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex, cells)

Tworzy i wstawia nowy obiekt Table zawierający określone komórki w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerIndeks do wstawienia.
cellsString[][]Zawartość tekstowa z komórek tabeli, które mają zostać dodane do nowej tabeli.

Powrót

Table – nowa tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex, table)

Wstawia podaną wartość Table w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerIndeks do wstawienia.
tableTableTabela do wstawienia.

Powrót

Table – wstawiona tabela.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeChild(child)

Usuwa określony element podrzędny.

Parametry

NazwaTypOpis
childElementElement podrzędny do usunięcia.

Powrót

FooterSection – bieżący element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeFromParent()

Usuwa element z elementu nadrzędnego.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab()
var body = documentTab.getBody();

// Remove all images in the active tab's body.
var imgs = body.getImages();
for (var i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Powrót

FooterSection – usunięty element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

replaceText(searchPattern, replacement)

Zastępuje wszystkie wystąpienia danego wzorca tekstowego danym ciągiem zastępczym, stosując zwykłe wyrażeń.

Wzorzec wyszukiwania jest przekazywany jako ciąg znaków, a nie obiekt wyrażenia regularnego JavaScript. Z tego powodu konieczne jest ominięcie ukośnika wstecznego we wzorcu.

Ta metoda korzysta ze standardowego algorytmu Google RE2 biblioteki wyrażeń, która ogranicza obsługiwaną składnię.

Podany wzorzec wyrażeń regularnych jest niezależnie dopasowywany do każdego bloku tekstu zawarte w bieżącym elemencie.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText("^.*Apps ?Script.*$", "Apps Script");

Parametry

NazwaTypOpis
searchPatternStringwzorzec wyrażenia regularnego do wyszukania
replacementStringtekst, który ma zostać użyty jako zamiennik

Powrót

Element – bieżący element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setAttributes(attributes)

Ustawia atrybuty elementu.

Określony parametr atrybutów musi być obiektem, w którym każda nazwa właściwości jest elementem w wyliczenie DocumentApp.Attribute, a każda wartość właściwości jest nową wartością do zastosowano.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.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);

Parametry

NazwaTypOpis
attributesObjectAtrybuty elementu.

Powrót

FooterSection – bieżący element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setText(text)

Ustawia zawartość jako zwykły tekst.

Uwaga: istniejąca zawartość zostanie wyczyszczona.

Parametry

NazwaTypOpis
textStringNowa zawartość tekstowa.

Powrót

FooterSection – bieżący element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setTextAlignment(textAlignment)

Określa wyrównanie tekstu. Dostępne typy wyrównania to DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT i DocumentApp.TextAlignment.SUPERSCRIPT.

// Make the entire first paragraph in the active tab be superscript.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var text = documentTab.getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

Parametry

NazwaTypOpis
textAlignmentTextAlignmenttyp wyrównania tekstu, który ma zostać zastosowany

Powrót

FooterSection – bieżący element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

Wycofane metody