רכיב שמייצג פסקה. Paragraph
יכול להכיל את Equation
, Footnote
, HorizontalRule
, InlineDrawing
, InlineImage
, PageBreak
,
ו-Text
רכיבים. למידע נוסף על מבנה המסמך, אפשר לעיין במדריך להרחבת Google Docs.
Paragraphs
לא יכול להכיל תווים בשורה חדשה. תווי השורה החדשה ("\n") הם
הומרה לתווי מעבר שורה ("\r").
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a tab header paragraph. var header = body.appendParagraph("A Document"); header.setHeading(DocumentApp.ParagraphHeading.HEADING1); // Append a section header paragraph. var section = body.appendParagraph("Section 1"); section.setHeading(DocumentApp.ParagraphHeading.HEADING2); // Append a regular paragraph. body.appendParagraph("This is a typical paragraph.");
שיטות
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
addPositionedImage(image) | PositionedImage | יצירה והוספה של PositionedImage חדש מ-blob של התמונה שצוין. |
appendHorizontalRule() | HorizontalRule | יצירה והוספה של HorizontalRule חדש. |
appendInlineImage(image) | InlineImage | יצירה והוספה של InlineImage חדש מ-blob של התמונה שצוין. |
appendInlineImage(image) | InlineImage | הפונקציה מצרפת את הערך של InlineImage הנתון. |
appendPageBreak() | PageBreak | יצירה והוספה של PageBreak חדש. |
appendPageBreak(pageBreak) | PageBreak | הפונקציה מצרפת את הערך של PageBreak הנתון. |
appendText(text) | Text | יצירה והוספה של רכיב Text חדש עם התוכן שצוין. |
appendText(text) | Text | מצרף את הרכיב Text הנתון. |
clear() | Paragraph | ניקוי התוכן של הרכיב. |
copy() | Paragraph | הפונקציה מחזירה עותק עמוק בנפרד עבור הרכיב הנוכחי. |
editAsText() | Text | מתקבלת גרסת Text של הרכיב הנוכחי, לעריכה. |
findElement(elementType) | RangeElement | חיפוש תוכן הרכיב כדי למצוא צאצא מהסוג שצוין. |
findElement(elementType, from) | RangeElement | מחפש את תוכן הרכיב כדי למצוא צאצא מהסוג שצוין, החל מ-
ציינת RangeElement . |
findText(searchPattern) | RangeElement | חיפוש תוכן הרכיב לפי דפוס הטקסט שצוין באמצעות ביטויים רגולריים. |
findText(searchPattern, from) | RangeElement | חיפוש תוכן הרכיב לפי תבנית הטקסט שצוינה, החל ממאפיין נתון בתוצאות החיפוש. |
getAlignment() | HorizontalAlignment | אחזור של HorizontalAlignment . |
getAttributes() | Object | אחזור המאפיינים של הרכיב. |
getChild(childIndex) | Element | אחזור רכיב הצאצא באינדקס הצאצא שצוין. |
getChildIndex(child) | Integer | אחזור של אינדקס הצאצא לרכיב הצאצא שצוין. |
getHeading() | ParagraphHeading | אחזור של ParagraphHeading . |
getIndentEnd() | Number | אחזור של סוף כניסת הפיסקה בנקודות. |
getIndentFirstLine() | Number | אחזור של כניסת השורה הראשונה בנקודות. |
getIndentStart() | Number | אחזור של כניסת ההתחלה. |
getLineSpacing() | Number | אחזור של המרווח בין השורות בנקודות. |
getLinkUrl() | String | אחזור כתובת ה-URL של הקישור. |
getNextSibling() | Element | אחזור של רכיב האח הבא של הרכיב. |
getNumChildren() | Integer | אחזור של מספר הילדים. |
getParent() | ContainerElement | אחזור הרכיב ההורה של הרכיב. |
getPositionedImage(id) | PositionedImage | הפונקציה מקבלת PositionedImage לפי מזהה התמונה. |
getPositionedImages() | PositionedImage[] | כל PositionedImage האובייקטים מוצמדים לפסקה. |
getPreviousSibling() | Element | אחזור של רכיב האח הקודם של הרכיב. |
getSpacingAfter() | Number | אחזור הריווח אחרי הרכיב, בנקודות. |
getSpacingBefore() | Number | אחזור של הריווח לפני הרכיב, בנקודות. |
getText() | String | אחזור תוכן הרכיב כמחרוזת טקסט. |
getTextAlignment() | TextAlignment | מקבל את היישור של הטקסט. |
getType() | ElementType | מאחזר את ElementType של הרכיב. |
insertHorizontalRule(childIndex) | HorizontalRule | יצירה והוספה של HorizontalRule באינדקס שצוין. |
insertInlineImage(childIndex, image) | InlineImage | יצירה והוספה של InlineImage חדש מ-blob של התמונה שצוין, במיקום שצוין
להוסיף לאינדקס. |
insertInlineImage(childIndex, image) | InlineImage | מוסיפה את InlineImage הנתון באינדקס שצוין. |
insertPageBreak(childIndex) | PageBreak | יצירה והוספה של PageBreak חדש באינדקס שצוין. |
insertPageBreak(childIndex, pageBreak) | PageBreak | מוסיפה את PageBreak הנתון באינדקס שצוין. |
insertText(childIndex, text) | Text | יצירה והוספה של רכיב טקסט חדש באינדקס שצוין. |
insertText(childIndex, text) | Text | הוספת רכיב ה-Text הנתון באינדקס שצוין, עם הטקסט שצוין
תוכן. |
isAtDocumentEnd() | Boolean | הפונקציה קובעת אם הרכיב נמצא בסוף Document . |
isLeftToRight() | Boolean | מאחזר את ההגדרה משמאל לימין. |
merge() | Paragraph | ממזג את הרכיב עם האח הקודם מאותו סוג. |
removeChild(child) | Paragraph | הסרת רכיב הצאצא שצוין. |
removeFromParent() | Paragraph | הסרת הרכיב מרכיב ההורה שלו. |
removePositionedImage(id) | Boolean | מסירה PositionedImage לפי מזהה התמונה. |
replaceText(searchPattern, replacement) | Element | מחליפה את כל המופעים של תבנית טקסט נתונה במחרוזת החלפה נתונה, באמצעות הפונקציה הרגילה הבעות פנים. |
setAlignment(alignment) | Paragraph | מגדיר את HorizontalAlignment . |
setAttributes(attributes) | Paragraph | מגדיר את המאפיינים של הרכיב. |
setHeading(heading) | Paragraph | מגדיר את ParagraphHeading . |
setIndentEnd(indentEnd) | Paragraph | מגדיר את כניסת הסיום, בנקודות. |
setIndentFirstLine(indentFirstLine) | Paragraph | מגדיר את כניסת השורה הראשונה בנקודות. |
setIndentStart(indentStart) | Paragraph | מגדיר את כניסת ההתחלה בנקודות. |
setLeftToRight(leftToRight) | Paragraph | מגדיר את ההגדרה משמאל לימין. |
setLineSpacing(multiplier) | Paragraph | מגדירה את המרווח בין השורות ככמות שמציינת את מספר השורות שישמשו לריווח. |
setLinkUrl(url) | Paragraph | מגדיר את כתובת האתר של הקישור. |
setSpacingAfter(spacingAfter) | Paragraph | המדיניות הזו מגדירה את הריווח אחרי הרכיב, בנקודות. |
setSpacingBefore(spacingBefore) | Paragraph | מגדיר את הריווח לפני הרכיב, בנקודות. |
setText(text) | void | מגדיר את תוכן הפסקה כטקסט. |
setTextAlignment(textAlignment) | Paragraph | מגדיר את יישור הטקסט. |
מסמכי תיעוד מפורטים
addPositionedImage(image)
יצירה והוספה של PositionedImage
חדש מ-blob של התמונה שצוין.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById(DOCUMENT_ID); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Fetches the specified image URL. const image = UrlFetchApp.fetch('https://fonts.gstatic.com/s/i/productlogos/apps_script/v10/web-24dp/logo_apps_script_color_1x_web_24dp.png'); // Adds the image to the tab, anchored to the first paragraph. paragraph.addPositionedImage(image);
פרמטרים
שם | סוג | תיאור |
---|---|---|
image | BlobSource | נתוני התמונה. |
חזרה
PositionedImage
– התמונה שממוקמת במיקום החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendHorizontalRule()
יצירה והוספה של HorizontalRule
חדש.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById(DOCUMENT_ID); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a horizontal line under the first paragraph. paragraph.appendHorizontalRule();
חזרה
HorizontalRule
– הכלל האופקי החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendInlineImage(image)
יצירה והוספה של InlineImage
חדש מ-blob של התמונה שצוין.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById(DOCUMENT_ID); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Fetches the image from the specified image URL. const image = UrlFetchApp .fetch('https://fonts.gstatic.com/s/i/productlogos/apps_script/v10/web-96dp/logo_apps_script_color_1x_web_96dp.png'); // Adds the image to the first paragraph. paragraph.appendInlineImage(image);
פרמטרים
שם | סוג | תיאור |
---|---|---|
image | BlobSource | נתוני התמונה. |
חזרה
InlineImage
– התמונה שמצורפת.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendInlineImage(image)
הפונקציה מצרפת את הערך של InlineImage
הנתון.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById(DOCUMENT_ID); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Makes a copy of the first image in the body. const image = body.getImages()[0].copy();; // Adds the image to the first paragraph. paragraph.appendInlineImage(image);
פרמטרים
שם | סוג | תיאור |
---|---|---|
image | InlineImage | נתוני התמונה. |
חזרה
InlineImage
– התמונה שמצורפת.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendPageBreak()
יצירה והוספה של PageBreak
חדש.
הערה: לא ניתן לכלול את PageBreaks
בתוך TableCells
.
אם הרכיב הנוכחי נמצא בתא בטבלה, המערכת תחריג חריג.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById(DOCUMENT_ID); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a page break after the first paragraph. paragraph.appendPageBreak();
חזרה
PageBreak
— הרכיב החדש של מעבר דף.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendPageBreak(pageBreak)
הפונקציה מצרפת את הערך של PageBreak
הנתון.
הערה: לא ניתן לכלול את הפרמטר PageBreaks
בתוך TableCells
.
אם הרכיב הנוכחי קיים בתא בטבלה, הסקריפט יוסיף חריג.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById(DOCUMENT_ID); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a page break after the first paragraph. const pageBreak = paragraph.appendPageBreak(); // Makes a copy of the page break. const newPageBreak = pageBreak.copy(); // Adds the copied page break to the paragraph. paragraph.appendPageBreak(newPageBreak);
פרמטרים
שם | סוג | תיאור |
---|---|---|
pageBreak | PageBreak | מעבר הדף שצריך לצרף. |
חזרה
PageBreak
— הרכיב של מעבר דף שצורף.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendText(text)
יצירה והוספה של רכיב Text
חדש עם התוכן שצוין.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById(DOCUMENT_ID); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a string to the paragraph. paragraph.appendText('This is a new sentence.');
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | String | תוכן הטקסט. |
חזרה
Text
– רכיב הטקסט החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendText(text)
מצרף את הרכיב Text
הנתון.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById(DOCUMENT_ID); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Gets the text from the first paragraph in the body. const paragraph1 = body.getParagraphs()[0]; const text = paragraph1.getText(); // Gets the third paragraph in the body. const paragraph3 = body.getParagraphs()[2]; // Adds the text from the first paragraph to the third paragraph. paragraph3.appendText(text);
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | Text | רכיב הטקסט שיש לצרף. |
חזרה
Text
– רכיב הטקסט שצורף.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
clear()
copy()
הפונקציה מחזירה עותק עמוק בנפרד עבור הרכיב הנוכחי.
כל רכיבי הצאצא שקיימים ברכיב מועתקים גם כן. ברכיב החדש אין הורה.
חזרה
Paragraph
– העותק החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
editAsText()
מתקבלת גרסת Text
של הרכיב הנוכחי, לעריכה.
אפשר להשתמש ב-editAsText
כדי לבצע מניפולציות על התוכן של הרכיבים כטקסט עשיר. מצב editAsText
מתעלם מאלמנטים שאינם טקסט (כמו InlineImage
ו-HorizontalRule
).
רכיבי צאצא הכלולים בטווח טקסט שנמחק יוסרו מהרכיב.
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);
חזרה
Text
– גרסת טקסט של הרכיב הנוכחי
findElement(elementType)
חיפוש תוכן הרכיב כדי למצוא צאצא מהסוג שצוין.
פרמטרים
שם | סוג | תיאור |
---|---|---|
elementType | ElementType | סוג הרכיב שצריך לחפש. |
חזרה
RangeElement
- תוצאת חיפוש שמציינת את המיקום של רכיב החיפוש.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findElement(elementType, from)
מחפש את תוכן הרכיב כדי למצוא צאצא מהסוג שצוין, החל מ-
ציינת 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; } }
פרמטרים
שם | סוג | תיאור |
---|---|---|
elementType | ElementType | סוג הרכיב שצריך לחפש. |
from | RangeElement | תוצאת החיפוש שממנה יש לחפש. |
חזרה
RangeElement
- תוצאת חיפוש שמציינת את המיקום הבא של רכיב החיפוש.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern)
חיפוש תוכן הרכיב לפי דפוס הטקסט שצוין באמצעות ביטויים רגולריים.
אין תמיכה מלאה בקבוצת משנה של תכונות הביטויים הרגולריים של JavaScript, כגון לתעד קבוצות ותנאים.
תבנית הביטויים הרגולריים שסופקה מותאמת בנפרד לכל בלוק טקסט שכלול ברכיב הנוכחי.
פרמטרים
שם | סוג | תיאור |
---|---|---|
searchPattern | String | הדפוס שצריך לחפש |
חזרה
RangeElement
- תוצאת חיפוש שמציינת את המיקום של טקסט החיפוש, או ערך null אם אין
להתאים
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
חיפוש תוכן הרכיב לפי תבנית הטקסט שצוינה, החל ממאפיין נתון תוצאת חיפוש.
אין תמיכה מלאה בקבוצת משנה של תכונות הביטויים הרגולריים של JavaScript, כגון לתעד קבוצות ותנאים.
תבנית הביטויים הרגולריים שסופקה מותאמת בנפרד לכל בלוק טקסט שכלול ברכיב הנוכחי.
פרמטרים
שם | סוג | תיאור |
---|---|---|
searchPattern | String | הדפוס שצריך לחפש |
from | RangeElement | תוצאת החיפוש שממנה יש לחפש |
חזרה
RangeElement
- תוצאת חיפוש שמציינת את המיקום הבא של טקסט החיפוש, או ערך null אם אין
להתאים
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAlignment()
אחזור של HorizontalAlignment
.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById(DOCUMENT_ID); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Sets the horizontal alignment to left for the first paragraph. paragraph.setAlignment(DocumentApp.HorizontalAlignment.LEFT); // Gets the horizontal alignment of the first paragraph and logs it to the console. console.log(paragraph.getAlignment().toString());
חזרה
HorizontalAlignment
– היישור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAttributes()
אחזור המאפיינים של הרכיב.
התוצאה היא אובייקט שמכיל מאפיין לכל מאפיין חוקי של רכיב שבו כל אחד
שם המאפיין תואם לפריט בספירה 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]); }
חזרה
Object
– המאפיינים של הרכיב.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getChild(childIndex)
אחזור הרכיב הצאצא באינדקס הצאצא שצוין.
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."); }
פרמטרים
שם | סוג | תיאור |
---|---|---|
childIndex | Integer | האינדקס של רכיב הצאצא לאחזור. |
חזרה
Element
– רכיב הצאצא באינדקס שצוין.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getChildIndex(child)
אחזור של אינדקס הצאצא לרכיב הצאצא שצוין.
פרמטרים
שם | סוג | תיאור |
---|---|---|
child | Element | רכיב הצאצא שעבורו יש לאחזר את האינדקס. |
חזרה
Integer
– אינדקס הצאצא.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getHeading()
אחזור של ParagraphHeading
.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById(DOCUMENT_ID); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Adds a paragraph to the body. const paragraph = body.appendParagraph('Title heading'); // Sets the paragraph heading style to 'Title.' paragraph.setHeading(DocumentApp.ParagraphHeading.TITLE); // Gets the heading style and logs it to the console. console.log(paragraph.getHeading().toString());
חזרה
ParagraphHeading
– הכותרת.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getIndentEnd()
אחזור של סוף כניסת הפיסקה בנקודות.
חזרה
Number
– כניסת הסוף בנקודות
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getIndentFirstLine()
אחזור של כניסת השורה הראשונה בנקודות.
חזרה
Number
– כניסת השורה הראשונה בנקודות
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getIndentStart()
אחזור של כניסת ההתחלה.
חזרה
Number
– כניסת הפיסקה מתחילה
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLineSpacing()
אחזור של המרווח בין השורות בנקודות.
חזרה
Number
– המרווח בין השורות בנקודות
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLinkUrl()
אחזור כתובת ה-URL של הקישור.
חזרה
String
– כתובת ה-URL של הקישור, או ערך null אם הרכיב מכיל כמה ערכים למאפיין הזה
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNextSibling()
אחזור של רכיב האח הבא של הרכיב.
לאח הבא יש את אותו הורה והוא עוקב אחרי הרכיב הנוכחי.
חזרה
Element
— רכיב האח הבא.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNumChildren()
אחזור של מספר הילדים.
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.");
חזרה
Integer
– מספר הילדים.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParent()
אחזור הרכיב ההורה של הרכיב.
רכיב ההורה מכיל את הרכיב הנוכחי.
חזרה
ContainerElement
– רכיב ההורה.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPositionedImage(id)
הפונקציה מקבלת PositionedImage
לפי מזהה התמונה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
id | String | מזהה התמונה |
חזרה
PositionedImage
– התמונה שממוקמת
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPositionedImages()
כל PositionedImage
האובייקטים מוצמדים לפסקה.
חזרה
PositionedImage[]
- רשימה של תמונות ממוקמות
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPreviousSibling()
אחזור של רכיב האח הקודם של הרכיב.
לאחות הקודמת יש אותו הורה ולפני הרכיב הנוכחי.
חזרה
Element
— רכיב האח הקודם.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getSpacingAfter()
אחזור הריווח אחרי הרכיב, בנקודות.
חזרה
Number
– הריווח אחרי הרכיב, בנקודות
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getSpacingBefore()
אחזור של הריווח לפני הרכיב, בנקודות.
חזרה
Number
– הריווח לפני הרכיב, בנקודות
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getText()
אחזור תוכן הרכיב כמחרוזת טקסט.
חזרה
String
– תוכן הרכיב כמחרוזת טקסט
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTextAlignment()
מקבל את היישור של הטקסט. סוגי ההתאמה הזמינים הם DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
ו-DocumentApp.TextAlignment.SUPERSCRIPT
.
חזרה
TextAlignment
- סוג היישור של הטקסט, או null
אם הטקסט מכיל כמה סוגים של טקסט
יישור או אם יישור הטקסט מעולם לא הוגדר
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getType()
מאחזר את ElementType
של הרכיב.
משתמשים בפונקציה 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.'); }
חזרה
ElementType
– סוג הרכיב.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertHorizontalRule(childIndex)
יצירה והוספה של HorizontalRule
באינדקס שצוין.
פרמטרים
שם | סוג | תיאור |
---|---|---|
childIndex | Integer | האינדקס שבו יש להכניס את הרכיב |
חזרה
HorizontalRule
– רכיב הכלל האופקי החדש
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertInlineImage(childIndex, image)
יצירה והוספה של InlineImage
חדש מ-blob של התמונה שצוין, בציון שצוין
להוסיף לאינדקס.
פרמטרים
שם | סוג | תיאור |
---|---|---|
childIndex | Integer | האינדקס שבו יש להכניס את הרכיב |
image | BlobSource | נתוני התמונה |
חזרה
InlineImage
- רכיב התמונה המוטבעת שהוכנס
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertInlineImage(childIndex, image)
מוסיפה את InlineImage
הנתון באינדקס שצוין.
פרמטרים
שם | סוג | תיאור |
---|---|---|
childIndex | Integer | האינדקס שבו יש להכניס את הרכיב |
image | InlineImage | נתוני התמונה |
חזרה
InlineImage
- רכיב התמונה המוטבעת שהוכנס
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex)
יצירה והוספה של PageBreak
חדש באינדקס שצוין.
הערה: לא ניתן לכלול את PageBreaks
בתוך TableCells
.
אם הרכיב הנוכחי נמצא בתא בטבלה, המערכת תחריג חריג.
פרמטרים
שם | סוג | תיאור |
---|---|---|
childIndex | Integer | האינדקס שבו יש להכניס את הרכיב |
חזרה
PageBreak
- הרכיב החדש של מעבר דף
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex, pageBreak)
מוסיפה את PageBreak
הנתון באינדקס שצוין.
הערה: לא ניתן לכלול את PageBreaks
בתוך TableCells
.
אם הרכיב הנוכחי נמצא בתא בטבלה, המערכת תחריג חריג.
פרמטרים
שם | סוג | תיאור |
---|---|---|
childIndex | Integer | האינדקס שבו יש להכניס את הרכיב |
pageBreak | PageBreak | את [מעבר הגיל כדי להוסיף |
חזרה
PageBreak
- הרכיב של מעבר דף שנוסף
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertText(childIndex, text)
יצירה והוספה של רכיב טקסט חדש באינדקס שצוין.
פרמטרים
שם | סוג | תיאור |
---|---|---|
childIndex | Integer | האינדקס שבו יש להכניס את הרכיב |
text | String | תוכן הטקסט |
חזרה
Text
– רכיב הטקסט החדש
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertText(childIndex, text)
הוספת רכיב ה-Text
הנתון באינדקס שצוין, עם הטקסט שצוין
תוכן.
פרמטרים
שם | סוג | תיאור |
---|---|---|
childIndex | Integer | האינדקס שבו יש להכניס את הרכיב |
text | Text | רכיב הטקסט להוספה |
חזרה
Text
– רכיב הטקסט שהוכנס
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isAtDocumentEnd()
הפונקציה קובעת אם הרכיב נמצא בסוף Document
.
חזרה
Boolean
– האם הרכיב נמצא בסוף הכרטיסייה.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isLeftToRight()
מאחזר את ההגדרה משמאל לימין.
חזרה
Boolean
– ההגדרה משמאל לימין
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
merge()
ממזג את הרכיב עם האח הקודם מאותו סוג.
אפשר למזג רק רכיבים של אותו ElementType
. רכיבי צאצא שנכללים
הרכיב הנוכחי מועבר לרכיב האח הקודם.
הרכיב הנוכחי יוסר מהמסמך.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document's active tab. 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();
חזרה
Paragraph
– הרכיב שמוזג.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeChild(child)
הסרת רכיב הצאצא שצוין.
פרמטרים
שם | סוג | תיאור |
---|---|---|
child | Element | רכיב הצאצא להסרה |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeFromParent()
הסרת הרכיב מרכיב ההורה שלו.
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(); }
חזרה
Paragraph
– הרכיב שהוסר.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removePositionedImage(id)
מסירה PositionedImage
לפי מזהה התמונה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
id | String | מזהה התמונה |
חזרה
Boolean
– האם התמונה שצוינה הוסרה או לא
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
replaceText(searchPattern, replacement)
מחליפה את כל המופעים של תבנית טקסט נתונה במחרוזת החלפה נתונה, באמצעות הפונקציה הרגילה הבעות פנים.
דפוס החיפוש מועבר כמחרוזת, ולא כאובייקט של ביטוי רגולרי של JavaScript. לכן, צריך לסמן בתו בריחה (escape) את כל הלוכסן ההפוך בדפוס.
בשיטה הזאת נעשה שימוש במודל RE2 הרגיל של Google של ביטויים, שמגבילה את התחביר הנתמך.
תבנית הביטויים הרגולריים שסופקה מותאמת בנפרד לכל בלוק טקסט שכלול ברכיב הנוכחי.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText("^.*Apps ?Script.*$", "Apps Script");
פרמטרים
שם | סוג | תיאור |
---|---|---|
searchPattern | String | דפוס הביטוי הרגולרי שצריך לחפש |
replacement | String | הטקסט שישמש כתחליף |
חזרה
Element
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAlignment(alignment)
מגדיר את HorizontalAlignment
.
פרמטרים
שם | סוג | תיאור |
---|---|---|
alignment | HorizontalAlignment | היישור האופקי |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAttributes(attributes)
מגדיר את המאפיינים של הרכיב.
פרמטר המאפיינים שצוין חייב להיות אובייקט שבו כל שם מאפיין הוא פריט ב-
הספירה של DocumentApp.Attribute
וכל ערך מאפיין הוא הערך החדש שצריך
הוחלו.
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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
attributes | Object | המאפיינים של הרכיב. |
חזרה
Paragraph
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setHeading(heading)
מגדיר את ParagraphHeading
.
פרמטרים
שם | סוג | תיאור |
---|---|---|
heading | ParagraphHeading | הכותרת |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setIndentEnd(indentEnd)
מגדיר את כניסת הסיום, בנקודות.
פרמטרים
שם | סוג | תיאור |
---|---|---|
indentEnd | Number | כניסת הקצה, בנקודות |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setIndentFirstLine(indentFirstLine)
מגדיר את כניסת השורה הראשונה בנקודות.
פרמטרים
שם | סוג | תיאור |
---|---|---|
indentFirstLine | Number | כניסת השורה הראשונה בנקודות |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setIndentStart(indentStart)
מגדיר את כניסת ההתחלה בנקודות.
פרמטרים
שם | סוג | תיאור |
---|---|---|
indentStart | Number | כניסת ההתחלה, בנקודות |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLeftToRight(leftToRight)
מגדיר את ההגדרה משמאל לימין.
פרמטרים
שם | סוג | תיאור |
---|---|---|
leftToRight | Boolean | ההגדרה משמאל לימין |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLineSpacing(multiplier)
מגדיר את המרווח בין השורות ככמות שמציינת את מספר השורות שישמשו לריווח.
פרמטרים
שם | סוג | תיאור |
---|---|---|
multiplier | Number | את מספר השורות |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLinkUrl(url)
מגדיר את כתובת האתר של הקישור.
פרמטרים
שם | סוג | תיאור |
---|---|---|
url | String | כתובת האתר של הקישור |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setSpacingAfter(spacingAfter)
המדיניות הזו מגדירה את הריווח אחרי הרכיב, בנקודות.
פרמטרים
שם | סוג | תיאור |
---|---|---|
spacingAfter | Number | הריווח אחרי הרכיב, בנקודות |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setSpacingBefore(spacingBefore)
מגדיר את הריווח לפני הרכיב, בנקודות.
פרמטרים
שם | סוג | תיאור |
---|---|---|
spacingBefore | Number | הריווח לפני הרכיב, בנקודות |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setText(text)
מגדיר את תוכן הפסקה כטקסט.
הערה: התוכן הקיים נמחק.
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | String | תוכן הטקסט החדש |
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTextAlignment(textAlignment)
מגדיר את יישור הטקסט. סוגי ההתאמה הזמינים הם DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
ו-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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
textAlignment | TextAlignment | סוג היישור של הטקסט שרוצים להחיל |
חזרה
Paragraph
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents