Ta strona została przetłumaczona przez Cloud Translation API.

Interface Element

Ogólny element. Treści Document są reprezentowane jako elementy. Na przykład elementy ListItem, Paragraph i Table dziedziczą wszystkie metody zdefiniowane przez element Element, takie jak getType().

Implementacja klas

Nazwa	Krótki opis
`Body`	Treść karty w dokumencie Dokumentów Google.
`ContainerElement`	Element ogólny, który może zawierać inne elementy.
`Date`	Element reprezentujący sformatowaną datę
`Equation`	Element reprezentujący wyrażenie matematyczne.
`EquationFunction`	Element reprezentujący funkcję w ujęciu matematycznym `Equation`.
`EquationFunctionArgumentSeparator`	Element reprezentujący separator funkcji w funkcji matematycznej `Equation`.
`EquationSymbol`	Element reprezentujący symbol w matematycznym `Equation`.
`FooterSection`	Element reprezentujący sekcję stopki.
`Footnote`	Element reprezentujący przypis.
`FootnoteSection`	Element reprezentujący sekcję przypisu.
`HeaderSection`	Element reprezentujący sekcję nagłówka.
`HorizontalRule`	Element reprezentujący linię poziomą.
`InlineDrawing`	Element reprezentujący osadzony rysunek.
`InlineImage`	Element reprezentujący osadzony obraz.
`ListItem`	Element reprezentujący element listy.
`PageBreak`	Element reprezentujący podział strony.
`Paragraph`	Element reprezentujący akapit.
`Person`	Element reprezentujący link do osoby.
`RichLink`	Element reprezentujący link do zasobu Google, takiego jak plik na Dysku lub film w YouTube.
`Table`	Element reprezentujący tabelę.
`TableCell`	Element reprezentujący komórkę tabeli.
`TableOfContents`	Element zawierający spis treści.
`TableRow`	Element reprezentujący wiersz tabeli.
`Text`	Element reprezentujący region tekstu sformatowanego.
`UnsupportedElement`	Element reprezentujący region, który jest nieznany lub na który skrypt nie może wpływać, np. numer strony.

Metody

Metoda	Zwracany typ	Krótki opis
`asBody()`	`Body`	Zwraca bieżący element jako `Body`.
`asDate()`	`Date`	Zwraca bieżący element jako `Date`.
`asEquation()`	`Equation`	Zwraca bieżący element jako `Equation`.
`asEquationFunction()`	`EquationFunction`	Zwraca bieżący element jako `EquationFunction`.
`asEquationFunctionArgumentSeparator()`	`EquationFunctionArgumentSeparator`	Zwraca bieżący element jako `EquationFunctionArgumentSeparator`.
`asEquationSymbol()`	`EquationSymbol`	Zwraca bieżący element jako `EquationSymbol`.
`asFooterSection()`	`FooterSection`	Zwraca bieżący element jako `FooterSection`.
`asFootnote()`	`Footnote`	Zwraca bieżący element jako `Footnote`.
`asFootnoteSection()`	`FootnoteSection`	Zwraca bieżący element jako `FootnoteSection`.
`asHeaderSection()`	`HeaderSection`	Zwraca bieżący element jako `HeaderSection`.
`asHorizontalRule()`	`HorizontalRule`	Zwraca bieżący element jako `HorizontalRule`.
`asInlineDrawing()`	`InlineDrawing`	Zwraca bieżący element jako `InlineDrawing`.
`asInlineImage()`	`InlineImage`	Zwraca bieżący element jako `InlineImage`.
`asListItem()`	`ListItem`	Zwraca bieżący element jako `ListItem`.
`asPageBreak()`	`PageBreak`	Zwraca bieżący element jako `PageBreak`.
`asParagraph()`	`Paragraph`	Zwraca bieżący element jako `Paragraph`.
`asPerson()`	`Person`	Zwraca bieżący element jako `Person`.
`asRichLink()`	`RichLink`	Zwraca bieżący element jako `RichLink`, np. link do pliku Arkuszy Google.
`asTable()`	`Table`	Zwraca bieżący element jako `Table`.
`asTableCell()`	`TableCell`	Zwraca bieżący element jako `TableCell`.
`asTableOfContents()`	`TableOfContents`	Zwraca bieżący element jako `TableOfContents`.
`asTableRow()`	`TableRow`	Zwraca bieżący element jako `TableRow`.
`asText()`	`Text`	Zwraca bieżący element jako `Text`.
`copy()`	`Element`	Zwraca odłączoną, głęboką kopię bieżącego elementu.
`getAttributes()`	`Object`	Pobiera atrybuty elementu.
`getNextSibling()`	`Element`	Pobiera następny element nadrzędny.
`getParent()`	`ContainerElement`	Pobiera element nadrzędny.
`getPreviousSibling()`	`Element`	Pobiera poprzedni element nadrzędny elementu.
`getType()`	`ElementType`	Pobiera wartość atrybutu `ElementType` elementu.
`isAtDocumentEnd()`	`Boolean`	Określa, czy element znajduje się na końcu `Document`.
`merge()`	`Element`	Łączy element z poprzednim elementem tego samego typu.
`removeFromParent()`	`Element`	Usuwa element z jego elementu nadrzędnego.
`setAttributes(attributes)`	`Element`	Ustawia atrybuty elementu.

Szczegółowa dokumentacja

`asBody()`

Zwraca bieżący element jako Body.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

Body – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asDate()`

Zwraca bieżący element jako Date.

Jeśli wiesz, że element jest elementem Date, użyj tej metody, aby ustawić jego typ jako Date. Dzięki temu autouzupełnianie w edytorze Apps Script będzie wyświetlać metody, których możesz używać z użyciem Date.

Powrót

Date – bieżący element o typie Date.

Autoryzacja

Skrypty, które korzystają 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

`asEquation()`

Zwraca bieżący element jako Equation.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

Equation – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asEquationFunction()`

Zwraca bieżący element jako EquationFunction.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

EquationFunction – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asEquationFunctionArgumentSeparator()`

Zwraca bieżący element jako EquationFunctionArgumentSeparator.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

EquationFunctionArgumentSeparator – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asEquationSymbol()`

Zwraca bieżący element jako EquationSymbol.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

EquationSymbol – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asFooterSection()`

Zwraca bieżący element jako FooterSection.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

FooterSection – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asFootnote()`

Zwraca bieżący element jako Footnote.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

Footnote – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asFootnoteSection()`

Zwraca bieżący element jako FootnoteSection.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

FootnoteSection – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asHeaderSection()`

Zwraca bieżący element jako HeaderSection.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

HeaderSection – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asHorizontalRule()`

Zwraca bieżący element jako HorizontalRule.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

HorizontalRule – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asInlineDrawing()`

Zwraca bieżący element jako InlineDrawing.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

InlineDrawing – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asInlineImage()`

Zwraca bieżący element jako InlineImage.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

InlineImage – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asListItem()`

Zwraca bieżący element jako ListItem.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

ListItem – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asPageBreak()`

Zwraca bieżący element jako PageBreak.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

PageBreak – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asParagraph()`

Zwraca bieżący element jako Paragraph.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

Paragraph – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asPerson()`

Zwraca bieżący element jako Person.

Gdy wiesz, że element jest Person, użyj tej metody, aby ustawić jego typ jako osoba. Dzięki temu autouzupełnianie w edytorze Apps Script będzie wyświetlać metody, których możesz używać z elementem person.

Powrót

Person – bieżący element o typie Person.

Autoryzacja

Skrypty, które korzystają 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

`asRichLink()`

Zwraca bieżący element jako RichLink, np. link do pliku Arkuszy Google.

Jeśli wiesz, że element jest elementem RichLink, użyj tej metody, aby ustawić jego typ jako RichLink. Dzięki temu autouzupełnianie w edytorze Apps Script będzie wyświetlać metody, których możesz używać z użyciem RichLink.

Powrót

RichLink – bieżący element o typie RichLink.

Autoryzacja

Skrypty, które korzystają 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

`asTable()`

Zwraca bieżący element jako Table.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

Table – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asTableCell()`

Zwraca bieżący element jako TableCell.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

TableCell – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asTableOfContents()`

Zwraca bieżący element jako TableOfContents.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

TableOfContents – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asTableRow()`

Zwraca bieżący element jako TableRow.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

TableRow – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`asText()`

Zwraca bieżący element jako Text.

Używaj tej metody, aby ułatwić autouzupełnianie, gdy wiadomo, że dany element należy do określonego typu.

Powrót

Text – bieżący element.

Autoryzacja

Skrypty, które korzystają 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

`copy()`

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

Skopiowane zostaną też wszystkie elementy podrzędne obecne w danym elemencie. Nowy element nie ma rodzica.

Powrót

Element – nowa kopia.

Autoryzacja

Skrypty, które korzystają 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ść dla każdego prawidłowego atrybutu elementu, przy czym każda nazwa właściwości odpowiada elementowi w wyliczeniu DocumentApp.Attribute.

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

// Append a styled paragraph.
const par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
const atts = par.getAttributes();

// Log the paragraph attributes.
for (const att in atts) {
  Logger.log(`${att}:${atts[att]}`);
}

Powrót

Object – atrybuty elementu.

Autoryzacja

Skrypty, które korzystają 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

`getNextSibling()`

Pobiera następny element nadrzędny.

Następny element równego rzędu ma tego samego rodzica i następuje po bieżącym elemencie.

Powrót

Element – następny element równorzędny.

Autoryzacja

Skrypty, które korzystają 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.

Element nadrzędny zawiera bieżący element.

Powrót

ContainerElement – element nadrzędny.

Autoryzacja

Skrypty, które korzystają 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

`getPreviousSibling()`

Pobiera poprzedni element nadrzędny elementu.

Poprzedni element ma tego samego rodzica i poprzedza bieżący element.

Powrót

Element – poprzedni równorzędny element.

Autoryzacja

Skrypty, które korzystają 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ść atrybutu ElementType elementu.

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

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

// Obtain the first element in the active tab's body.

const firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

Powrót

ElementType – typ elementu.

Autoryzacja

Skrypty, które korzystają 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

`isAtDocumentEnd()`

Określa, czy element znajduje się na końcu Document.

Powrót

Boolean – określa, czy element znajduje się na końcu karty.

Autoryzacja

Skrypty, które korzystają 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

`merge()`

Łączy element z poprzednim elementem tego samego typu.

Można scalać tylko elementy tego samego ElementType. Wszystkie elementy podrzędne zawarte w bieżącym elemencie zostaną przeniesione do poprzedniego elementu nadrzędnego.

Bieżący element zostanie usunięty z dokumentu.

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

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
const par1 = body.appendParagraph('Paragraph 1.');
const par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
const cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2'],
];
// Build a table from the array.
const table = body.appendTable(cells);
// Get the first row in the table.
const row = table.getRow(0);
// Get the two cells in this row.
const cell1 = row.getCell(0);
const cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
const merged = cell2.merge();

Powrót

Element – scalony element.

Autoryzacja

Skrypty, które korzystają 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 jego elementu nadrzędnego.

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

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

Powrót

Element – usunięty element.

Autoryzacja

Skrypty, które korzystają 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.

Parametr specified attributes musi być obiektem, w którym każda nazwa właściwości jest elementem zbioru wyliczenia DocumentApp.Attribute, a każda wartość właściwości jest nową wartością do zastosowania.

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

// Define a custom paragraph style.
const style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
const par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

Parametry

Nazwa	Typ	Opis
`attributes`	`Object`	atrybuty elementu,

Powrót

Element – bieżący element.

Autoryzacja

Skrypty, które korzystają 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