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

Class InlineImage

Element reprezentujący umieszczony obraz. Element InlineImage może być zawarty w elemencie ListItem lub Paragraph, chyba że ListItem lub Paragraph znajduje się w obrębie znaczników FootnoteSection. Element InlineImage nie może zawierać żadnych innych elementów. Więcej informacji o strukturze dokumentów znajdziesz w przewodniku po rozszerzaniu Dokumentów Google.

Metody

Metoda	Zwracany typ	Krótki opis
`copy()`	`InlineImage`	Zwraca odłączoną, głęboką kopię bieżącego elementu.
`getAltDescription()`	`String`	Zwraca alternatywny opis obrazu.
`getAltTitle()`	`String`	Zwraca alternatywny tytuł obrazu.
`getAs(contentType)`	`Blob`	Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
`getAttributes()`	`Object`	Pobiera atrybuty elementu.
`getBlob()`	`Blob`	Zwracaj dane wewnątrz tego obiektu jako obiekt blob.
`getHeight()`	`Integer`	Pobiera wysokość obrazu w pikselach.
`getLinkUrl()`	`String`	Pobiera adres URL linku.
`getNextSibling()`	`Element`	Pobiera następny element równorzędny elementu.
`getParent()`	`ContainerElement`	Pobiera element nadrzędny elementu.
`getPreviousSibling()`	`Element`	Pobiera poprzedni element równorzędny.
`getType()`	`ElementType`	Pobiera `ElementType` elementu.
`getWidth()`	`Integer`	Pobiera szerokość obrazu w pikselach.
`isAtDocumentEnd()`	`Boolean`	Określa, czy element znajduje się na końcu parametru `Document`.
`merge()`	`InlineImage`	Łączy element z poprzednim elementem równorzędnym tego samego typu.
`removeFromParent()`	`InlineImage`	Usuwa element z elementu nadrzędnego.
`setAltDescription(description)`	`InlineImage`	Ustawia alternatywny opis obrazu.
`setAltTitle(title)`	`InlineImage`	Ustawia alternatywny tytuł obrazu.
`setAttributes(attributes)`	`InlineImage`	Ustawia atrybuty elementu.
`setHeight(height)`	`InlineImage`	Ustawia wysokość obrazu w pikselach.
`setLinkUrl(url)`	`InlineImage`	Ustawia adres URL linku.
`setWidth(width)`	`InlineImage`	Ustawia szerokość obrazu w pikselach.

Szczegółowa dokumentacja

`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

InlineImage – 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

`getAltDescription()`

Zwraca alternatywny opis obrazu.

Powroty

String – tytuł alternatywny lub null, jeśli element nie ma innego tytułu.

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

`getAltTitle()`

Zwraca alternatywny tytuł obrazu.

Powroty

String – tytuł alternatywny lub null, jeśli element nie ma innego tytułu.

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

`getAs(contentType)`

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mójplik.pdf”. Zakładamy jednak, że część nazwy pliku, która występuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W związku z tym „Lista zakupów.12.25.2014” zmieni się na „Lista zakupów.12.25.pdf”.

Aby sprawdzić dzienne limity konwersji, przeczytaj artykuł Limity w usługach Google. Nowo utworzone domeny Google Workspace mogą tymczasowo podlegać bardziej rygorystycznym limitom.

Parametry

Nazwa	Typ	Opis
`contentType`	`String`	Typ MIME, na który ma zostać przekonwertowany. W przypadku większości obiektów blob jedyną prawidłową opcją jest `'application/pdf'`. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG obowiązują dowolne z tych wartości: `'image/bmp'`, `'image/gif'`, `'image/jpeg'` i `'image/png'`.

Powroty

Blob – dane w postaci obiektu blob.

`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

`getBlob()`

Zwracaj dane wewnątrz tego obiektu jako obiekt blob.

Powroty

Blob – dane w postaci obiektu blob.

`getHeight()`

Pobiera wysokość obrazu w pikselach.

Powroty

Integer – wysokość obrazu w pikselach.

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

`getLinkUrl()`

Pobiera adres URL linku.

Powroty

String – adres URL linku lub null, jeśli element zawiera wiele wartości danego atrybutu.

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

`getNextSibling()`

Pobiera następny element równorzędny elementu.

Następne elementy nadrzędne mają ten sam element nadrzędny i następują po bieżącym elemencie.

Powroty

Element – następny element równorzę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

`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

`getPreviousSibling()`

Pobiera poprzedni element równorzędny.

Poprzedni element nadrzędny ma ten sam element nadrzędny i poprzedza bieżący element.

Powroty

Element – poprzedni element równorzę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

`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

`getWidth()`

Pobiera szerokość obrazu w pikselach.

Powroty

Integer – szerokość obrazu w pikselach.

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

`isAtDocumentEnd()`

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

Powroty

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

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

`merge()`

Łączy element z poprzednim elementem równorzędnym tego samego typu.

Można scalać tylko elementy elementu ElementType. Wszystkie elementy podrzędne zawarte w bieżącym elemencie są przenoszone do poprzedniego elementu równorzędnego.

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

var body = DocumentApp.getActiveDocument().getBody();
// Example 1: Merge paragraphs
// Append two paragraphs to the document.
var par1 = body.appendParagraph('Paragraph 1.');
var 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.
var cells = [
['Row 1, Cell 1', 'Row 1, Cell 2'],
['Row 2, Cell 1', 'Row 2, Cell 2']
];
// Build a table from the array.
var table = body.appendTable(cells);
// Get the first row in the table.
 var row = table.getRow(0);
// Get the two cells in this row.
var cell1 = row.getCell(0);
var cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
var merged = cell2.merge();

Powroty

InlineImage – scalony 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

InlineImage – 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

`setAltDescription(description)`

Ustawia alternatywny opis obrazu. Jeśli dany tytuł to null, ustawiany opis na pusty ciąg znaków.

Parametry

Nazwa	Typ	Opis
`description`	`String`	tytuł alternatywny

Powroty

InlineImage – bieżący obiekt,

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

`setAltTitle(title)`

Ustawia alternatywny tytuł obrazu. Jeśli podany tytuł to null, ustawia go na pusty ciąg znaków.

Parametry

Nazwa	Typ	Opis
`title`	`String`	tytuł alternatywny

Powroty

InlineImage – bieżący obiekt,

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

Nazwa	Typ	Opis
`attributes`	`Object`	Atrybuty elementu.

Powroty

InlineImage – 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

`setHeight(height)`

Ustawia wysokość obrazu w pikselach.

Parametry

Nazwa	Typ	Opis
`height`	`Integer`	wysokość obrazu w pikselach

Powroty

InlineImage – bieżący obiekt,

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

`setLinkUrl(url)`

Ustawia adres URL linku. Jeśli podany adres URL to null lub pusty ciąg znaków, ta metoda utworzy link z pustym adresem URL, który może być wyświetlany w Dokumentach Google jako „Nieprawidłowy link”.

Parametry

Nazwa	Typ	Opis
`url`	`String`	adres URL linku

Powroty

InlineImage – bieżący obiekt,

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

`setWidth(width)`

Ustawia szerokość obrazu w pikselach.

Parametry

Nazwa	Typ	Opis
`width`	`Integer`	szerokość obrazu w pikselach

Powroty

InlineImage – bieżący obiekt,

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