Class HeaderSection

HeaderSection

Element reprezentujący sekcję nagłówka. Element Document zawiera zwykle nie więcej niż 1 element HeaderSection. Element HeaderSection może zawierać elementy ListItem, Paragraph i Table. Więcej informacji na temat struktury dokumentu znajdziesz w przewodniku po rozszerzaniu Dokumentów Google.

Metody

MetodaZwracany typKrótki opis
appendHorizontalRule()HorizontalRuleTworzy i dołącza nowy element HorizontalRule.
appendImage(image)InlineImageTworzy i dołącza nowy element InlineImage z określonego obiektu blob obrazu.
appendImage(image)InlineImageDodaje podaną wartość InlineImage.
appendListItem(listItem)ListItemDodaje podaną wartość ListItem.
appendListItem(text)ListItemTworzy i dołącza nowy element ListItem zawierający podaną zawartość tekstową.
appendParagraph(paragraph)ParagraphDodaje podaną wartość Paragraph.
appendParagraph(text)ParagraphTworzy i dołącza nowy element Paragraph zawierający podaną zawartość tekstową.
appendTable()TableTworzy i dołącza nowy element Table.
appendTable(cells)TableDodaje nowy ciąg Table zawierający TableCell dla każdej określonej wartości ciągu znaków.
appendTable(table)TableDodaje podaną wartość Table.
clear()HeaderSectionCzyści zawartość elementu.
copy()HeaderSectionZwraca odłączoną, głęboką kopię bieżącego elementu.
editAsText()TextPobiera do edycji wersję Text bieżącego elementu.
findElement(elementType)RangeElementPrzeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu.
findElement(elementType, from)RangeElementPrzeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu, zaczynając od określonego elementu RangeElement.
findText(searchPattern)RangeElementPrzeszukuje zawartość elementu pod kątem określonego wzorca tekstowego przy użyciu wyrażeń regularnych.
findText(searchPattern, from)RangeElementPrzeszukuje zawartość elementu według określonego wzorca tekstowego, zaczynając od danego 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 dane (InlineImages) zawarte w sekcji.
getListItems()ListItem[]Pobiera wszystkie dane (ListItems) zawarte w sekcji.
getNumChildren()IntegerPobiera liczbę elementów podrzędnych.
getParagraphs()Paragraph[]Pobiera wszystkie dane (Paragraphs) zawarte w sekcji (w tym ListItems).
getParent()ContainerElementPobiera element nadrzędny elementu.
getTables()Table[]Pobiera wszystkie dane (Tables) zawarte w sekcji.
getText()StringPobiera zawartość elementu jako ciąg tekstowy.
getTextAlignment()TextAlignmentWyrównuje tekst.
getType()ElementTypePobiera ElementType elementu.
insertHorizontalRule(childIndex)HorizontalRuleTworzy i wstawia nowy element HorizontalRule w określonym indeksie.
insertImage(childIndex, image)InlineImageTworzy i wstawia InlineImage z określonego obiektu blob obrazu o określonym indeksie.
insertImage(childIndex, image)InlineImageWstawia podany InlineImage w określonym indeksie.
insertListItem(childIndex, listItem)ListItemWstawia podany ListItem w określonym indeksie.
insertListItem(childIndex, text)ListItemTworzy i wstawia w określonym indeksie nowy obiekt ListItem zawierający określoną zawartość tekstową.
insertParagraph(childIndex, paragraph)ParagraphWstawia podany Paragraph w określonym indeksie.
insertParagraph(childIndex, text)ParagraphTworzy i wstawia w określonym indeksie nowy obiekt Paragraph zawierający określoną zawartość tekstową.
insertTable(childIndex)TableTworzy i wstawia nowy element Table w określonym indeksie.
insertTable(childIndex, cells)TableTworzy i wstawia nowy element Table zawierający określone komórki w określonym indeksie.
insertTable(childIndex, table)TableWstawia podany Table w określonym indeksie.
removeChild(child)HeaderSectionUsuwa określony element podrzędny.
removeFromParent()HeaderSectionUsuwa element z elementu nadrzędnego.
replaceText(searchPattern, replacement)ElementZastępuje wszystkie wystąpienia danego wzorca tekstowego danym zastępczym ciągiem znaków przy użyciu wyrażeń regularnych.
setAttributes(attributes)HeaderSectionUstawia atrybuty elementu.
setText(text)HeaderSectionUstawia zawartość jako zwykły tekst.
setTextAlignment(textAlignment)HeaderSectionUstawia wyrównanie tekstu.

Szczegółowa dokumentacja

appendHorizontalRule()

Tworzy i dołącza nowy element HorizontalRule.

Pole HorizontalRule będzie zawarte w nowym obiekcie Paragraph.

Powroty

HorizontalRule – nowa linia pozioma,

Upoważnienie

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 element InlineImage z określonego obiektu blob obrazu.

Obraz zostanie umieszczony w nowym elemencie Paragraph.

Parametry

NazwaTypOpis
imageBlobSourcedane obrazu

Powroty

InlineImage – dołączony obraz,

Upoważnienie

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)

Dodaje podaną wartość InlineImage.

Pole InlineImage będzie zawarte w nowym obiekcie Paragraph.

Użyj tej wersji appendImage, dołączając kopię istniejącego obiektu InlineImage.

Parametry

NazwaTypOpis
imageInlineImagedane obrazu

Powroty

InlineImage – dołączony obraz,

Upoważnienie

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)

Dodaje podaną wartość ListItem.

Użyj tej wersji appendListItem, dołączając kopię istniejącego obiektu ListItem.

Parametry

NazwaTypOpis
listItemListItemelement listy, który ma zostać dołączony

Powroty

ListItem – dołączony element listy,

Upoważnienie

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 element ListItem zawierający podaną zawartość tekstową.

Kolejne pozycje na liście są dodawane do tej samej listy.

Parametry

NazwaTypOpis
textStringzawartość tekstu elementu listy

Powroty

ListItem – nowy element listy,

Upoważnienie

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)

Dodaje podaną wartość Paragraph.

Użyj tej wersji appendParagraph, dołączając kopię istniejącego obiektu Paragraph.

Parametry

NazwaTypOpis
paragraphParagraphakapit, który chcesz dołączyć

Powroty

Paragraph – dołączony akapit.

Upoważnienie

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 element Paragraph zawierający podaną zawartość tekstową.

Parametry

NazwaTypOpis
textStringzawartość akapitu,

Powroty

Paragraph – nowy akapit

Upoważnienie

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 dodaje też pusty akapit po tabeli, ponieważ dokumenty Google nie mogą kończyć się tabelą.

Powroty

Table – nowa tabela

Upoważnienie

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 ciąg Table zawierający TableCell dla każdej określonej wartości ciągu znaków.

Ta metoda dodaje też pusty akapit po tabeli, ponieważ dokumenty Google nie mogą kończyć się tabelą.

Parametry

NazwaTypOpis
cellsString[][]zawartość tekstową komórek tabeli, które mają zostać dodane do nowej tabeli;

Powroty

Table – dołączona tabela,

Upoważnienie

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)

Dodaje podaną wartość Table.

Użyj tej wersji appendTable, dołączając kopię istniejącego obiektu Table. Ta metoda dodaje też pusty akapit po tabeli, ponieważ dokumenty Google nie mogą kończyć się tabelą.

Parametry

NazwaTypOpis
tableTabletabelę do dołączenia

Powroty

Table – dołączona tabela,

Upoważnienie

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()

Czyści zawartość elementu.

Powroty

HeaderSection – bieżący element,


copy()

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

Kopiowane są też wszystkie elementy podrzędne występujące w elemencie. Nowy element nie ma elementu nadrzędnego.

Powroty

HeaderSection – nowa kopia.

Upoważnienie

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 do edycji wersję Text bieżącego elementu.

editAsText służy do manipulowania zawartością elementów pod postacią tekstu sformatowanego. Tryb editAsText ignoruje elementy inne niż tekstowe (takie jak InlineImage i HorizontalRule).

Elementy podrzędne w pełni zawarte w usuniętym zakresie tekstu są z niego usuwane.

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

Powroty

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;

Powroty

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

Upoważnienie

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 podrzędnego określonego typu, zaczynając od określonego elementu RangeElement.

// 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;
  }
}

Parametry

NazwaTypOpis
elementTypeElementTypetyp szukanego elementu;
fromRangeElementwynik wyszukiwania, który ma być wyszukiwany

Powroty

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

Upoważnienie

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 tekstowego przy użyciu wyrażeń regularnych.

Podzbiór funkcji wyrażeń regularnych JavaScript nie jest w pełni obsługiwany, np. grupy przechwytywania i modyfikatory trybów.

Podany wzorzec wyrażenia regularnego jest dopasowywany niezależnie do każdego bloku tekstowego w bieżącym elemencie.

Parametry

NazwaTypOpis
searchPatternStringwzór do wyszukania

Powroty

RangeElement – wynik wyszukiwania wskazujący pozycję wyszukiwanego tekstu lub wartość null, jeśli nie ma żadnego dopasowania.

Upoważnienie

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 według określonego wzorca tekstowego, zaczynając od danego wyniku wyszukiwania.

Podzbiór funkcji wyrażeń regularnych JavaScript nie jest w pełni obsługiwany, np. grupy przechwytywania i modyfikatory trybów.

Podany wzorzec wyrażenia regularnego jest dopasowywany niezależnie do każdego bloku tekstowego w bieżącym elemencie.

Parametry

NazwaTypOpis
searchPatternStringwzór do wyszukania
fromRangeElementwynik wyszukiwania, który ma być wyszukiwany

Powroty

RangeElement – wynik wyszukiwania wskazujący następną pozycję wyszukiwanego tekstu lub wartość null, jeśli nie ma dopasowania.

Upoważnienie

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.

W efekcie powstanie obiekt zawierający właściwość każdego prawidłowego atrybutu elementu, w którym każda nazwa właściwości odpowiada elementowi w wyliczeniu DocumentApp.Attribute.

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]);
}

Powroty

Object – atrybuty elementu.

Upoważnienie

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.

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

Parametry

NazwaTypOpis
childIndexIntegerindeks elementu podrzędnego do pobrania

Powroty

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

Upoważnienie

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, z którego ma zostać pobrany indeks;

Powroty

Integer – indeks podrzędny.

Upoważnienie

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 dane (InlineImages) zawarte w sekcji.

Powroty

InlineImage[] – obrazy sekcji,

Upoważnienie

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 dane (ListItems) zawarte w sekcji.

Powroty

ListItem[] – elementy listy,

Upoważnienie

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ę elementów podrzędnych.

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

Powroty

Integer – liczba dzieci,

Upoważnienie

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 dane (Paragraphs) zawarte w sekcji (w tym ListItems).

Powroty

Paragraph[] – akapity sekcji,

Upoważnienie

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 element bieżący.

Powroty

ContainerElement – element nadrzędny.

Upoważnienie

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 dane (Tables) zawarte w sekcji.

Powroty

Table[] – tabele sekcji,

Upoważnienie

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.

Powroty

String – zawartość elementu jako ciąg tekstowy;

Upoważnienie

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()

Wyrównuje tekst. Dostępne typy wyrównywania to DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT i DocumentApp.TextAlignment.SUPERSCRIPT.

Powroty

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

Upoważnienie

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 ElementType elementu.

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

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.');
}

Powroty

ElementType – typ elementu.

Upoważnienie

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 element HorizontalRule w określonym indeksie.

Pole HorizontalRule będzie zawarte w nowym obiekcie Paragraph.

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element

Powroty

HorizontalRule – nowa linia pozioma,

Upoważnienie

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 InlineImage z określonego obiektu blob obrazu o określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element
imageBlobSourcedane obrazu

Powroty

InlineImage – wstawiony obraz w treści;

Upoważnienie

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 podany InlineImage w określonym indeksie.

Obraz zostanie umieszczony w nowym elemencie Paragraph.

Parametry

NazwaTypOpis
childIndexIntegerindeks, w którym ma zostać wstawiony element
imageInlineImageobraz do wstawienia

Powroty

InlineImage – wstawiony obraz w treści;

Upoważnienie

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 podany ListItem w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić
listItemListItemelement listy do wstawienia

Powroty

ListItem – wstawiony element listy,

Upoważnienie

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 w określonym indeksie nowy obiekt ListItem zawierający określoną zawartość tekstową.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić
textStringzawartość tekstu elementu listy

Powroty

ListItem – nowy element listy,

Upoważnienie

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 podany Paragraph w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić
paragraphParagraphakapit do wstawienia

Powroty

Paragraph – wstawiony akapit,

Upoważnienie

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 w określonym indeksie nowy obiekt Paragraph zawierający określoną zawartość tekstową.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić
textStringzawartość akapitu,

Powroty

Paragraph – nowy akapit

Upoważnienie

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 element Table w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić

Powroty

Table – nowa tabela

Upoważnienie

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 element Table zawierający określone komórki w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić
cellsString[][]zawartość tekstową komórek tabeli, które mają zostać dodane do nowej tabeli;

Powroty

Table – nowa tabela

Upoważnienie

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 podany Table w określonym indeksie.

Parametry

NazwaTypOpis
childIndexIntegerindeks, do którego należy wstawić
tableTabletabelę do wstawienia

Powroty

Table – wstawiona tabela.

Upoważnienie

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

Powroty

HeaderSection – bieżący element,

Upoważnienie

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 body = DocumentApp.getActiveDocument().getBody();

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

Powroty

HeaderSection – usunięty element

Upoważnienie

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 zastępczym ciągiem znaków przy użyciu wyrażeń regularnych.

Wzorzec wyszukiwania jest przekazywany jako ciąg znaków, a nie obiekt wyrażenia regularnego JavaScript. Z tego powodu musisz zmienić znaczenie ukośnika lewego we wzorcu.

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

Podany wzorzec wyrażenia regularnego jest dopasowywany niezależnie do każdego bloku tekstowego w bieżącym elemencie.

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

Powroty

Element – bieżący element,

Upoważnienie

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 wyliczeniu DocumentApp.Attribute, a każda wartość właściwości jest nową wartością do zastosowania.

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

Parametry

NazwaTypOpis
attributesObjectAtrybuty elementu.

Powroty

HeaderSection – bieżący element.

Upoważnienie

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: dotychczasowe treści zostaną wyczyszczone.

Parametry

NazwaTypOpis
textStringnowa zawartość tekstu,

Powroty

HeaderSection – bieżący element,

Upoważnienie

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)

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

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

Parametry

NazwaTypOpis
textAlignmentTextAlignmenttyp wyrównania tekstu do zastosowania;

Powroty

HeaderSection – bieżący element,

Upoważnienie

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