عنصر يمثّل خلية في الجدول. يحتوي TableCell
دائمًا على TableRow
وقد يحتوي على عناصر ListItem
أو Paragraph
أو Table
. لمزيد من المعلومات حول بنية المستند، يمكنك الاطّلاع على دليل توسيع مستندات Google.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
appendHorizontalRule() | HorizontalRule | لإنشاء HorizontalRule جديدة وإلحاقها بها. |
appendImage(image) | InlineImage | إنشاء InlineImage جديد وإرفاقه من كائن ثنائي كبير محدد للصورة. |
appendImage(image) | InlineImage | لإلحاق InlineImage المُقدَّم. |
appendListItem(listItem) | ListItem | لإلحاق ListItem المُقدَّم. |
appendListItem(text) | ListItem | لإنشاء ListItem جديدة وإلحاقها بها. |
appendParagraph(paragraph) | Paragraph | لإلحاق Paragraph المُقدَّم. |
appendParagraph(text) | Paragraph | لإنشاء Paragraph جديدة وإلحاقها بها. |
appendTable() | Table | لإنشاء Table جديدة وإلحاقها بها. |
appendTable(cells) | Table | لإلحاق Table جديدة تحتوي على الخلايا المحددة |
appendTable(table) | Table | لإلحاق Table المُقدَّم. |
clear() | TableCell | محو محتوى العنصر. |
copy() | TableCell | عرض نسخة منفصلة من العنصر الحالي بشكل منفصل. |
editAsText() | Text | للحصول على نسخة Text من العنصر الحالي للتعديل. |
findElement(elementType) | RangeElement | يبحث في محتوى العنصر الفرعي عن النوع المحدّد. |
findElement(elementType, from) | RangeElement | يبحث في محتوى العنصر الفرعي من النوع المحدّد، بدءًا من
RangeElement المحدّد. |
findText(searchPattern) | RangeElement | يبحث في محتوى العنصر عن نمط النص المحدّد باستخدام التعبيرات العادية. |
findText(searchPattern, from) | RangeElement | يبحث في محتوى العنصر عن نمط النص المحدَّد، بدءًا من نتيجة بحث معيّنة. |
getAttributes() | Object | لاسترداد سمات العنصر\u39s. |
getBackgroundColor() | String | استرداد لون الخلفية |
getChild(childIndex) | Element | لاسترداد العنصر الفرعي في الفهرس الفرعي المحدد. |
getChildIndex(child) | Integer | لاسترداد الفهرس الفرعي للعنصر الفرعي المحدد. |
getColSpan() | Integer | لاسترداد امتداد العمود، وهو عدد أعمدة خلايا الجدول التي تمتد إليها هذه الخلية. |
getLinkUrl() | String | لاسترداد عنوان URL للرابط. |
getNextSibling() | Element | لاسترداد العنصر التالي. |
getNumChildren() | Integer | لاسترداد عدد العناصر الثانوية |
getPaddingBottom() | Number | لاسترداد المساحة السفلية في النقاط. |
getPaddingLeft() | Number | لاسترداد المساحة المتروكة اليسرى بالنقاط. |
getPaddingRight() | Number | لاسترجاع المساحة المتروكة الصحيحة بالنقاط. |
getPaddingTop() | Number | لاسترداد المساحة المتروكة العلوية بالنقاط. |
getParent() | ContainerElement | لاسترداد العنصر الرئيسي للعنصر. |
getParentRow() | TableRow | استرداد TableRow التي تحتوي على TableCell الحالية |
getParentTable() | Table | استرداد Table التي تحتوي على TableCell الحالية |
getPreviousSibling() | Element | لاسترجاع العنصر السابق الذي يشبه العنصر نفسه. |
getRowSpan() | Integer | لاسترداد امتداد الصف، وهو عدد صفوف خلايا الجدول التي تمتد إليها هذه الخلية. |
getText() | String | لاسترداد محتوى العنصر كسلسلة نصية. |
getTextAlignment() | TextAlignment | لمحاذاة النص. |
getType() | ElementType | لاسترداد العنصر ElementType 's. |
getVerticalAlignment() | VerticalAlignment | لاسترداد VerticalAlignment |
getWidth() | Number | لاسترداد عرض العمود الذي يحتوي على الخلية، بالنقاط. |
insertHorizontalRule(childIndex) | HorizontalRule | إنشاء HorizontalRule جديدة وإدراجها في الفهرس المحدّد. |
insertImage(childIndex, image) | InlineImage | إنشاء وإدراج InlineImage من كائن الصورة الثنائي الكبير، في الفهرس المحدد. |
insertImage(childIndex, image) | InlineImage | إدراج InlineImage المحددة في الفهرس المحدد. |
insertListItem(childIndex, listItem) | ListItem | إدراج ListItem المحددة في الفهرس المحدد. |
insertListItem(childIndex, text) | ListItem | إنشاء ListItem جديدة وإدراجها في الفهرس المحدّد. |
insertParagraph(childIndex, paragraph) | Paragraph | إدراج Paragraph المحددة في الفهرس المحدد. |
insertParagraph(childIndex, text) | Paragraph | إنشاء Paragraph جديدة وإدراجها في الفهرس المحدّد. |
insertTable(childIndex) | Table | إنشاء Table جديدة وإدراجها في الفهرس المحدّد. |
insertTable(childIndex, cells) | Table | إنشاء وإدراج Table جديدة تحتوي على الخلايا المحددة، في الفهرس المحدد. |
insertTable(childIndex, table) | Table | إدراج Table المحددة في الفهرس المحدد. |
isAtDocumentEnd() | Boolean | تحدِّد هذه السياسة ما إذا كان العنصر سيكون في نهاية Document . |
merge() | TableCell | لدمج العنصر مع العنصر التابع السابق من النوع نفسه. |
removeChild(child) | TableCell | إزالة العنصر الفرعي المحدد. |
removeFromParent() | TableCell | إزالة العنصر من العنصر الرئيسي. |
replaceText(searchPattern, replacement) | Element | استبدال جميع تكرارات نمط نص معين بسلسلة استبدال محددة، باستخدام التعبيرات العادية. |
setAttributes(attributes) | TableCell | تحدد سمات العنصر\u39;s. |
setBackgroundColor(color) | TableCell | لضبط لون الخلفية. |
setLinkUrl(url) | TableCell | لضبط عنوان URL للرابط. |
setPaddingBottom(paddingBottom) | TableCell | لضبط المساحة المتروكة السفلية بالنقاط |
setPaddingLeft(paddingLeft) | TableCell | لضبط المساحة المتروكة اليسرى بالنقاط. |
setPaddingRight(paddingTop) | TableCell | لضبط المساحة المتروكة اليمنى، بالنقاط. |
setPaddingTop(paddingTop) | TableCell | لضبط المساحة المتروكة العلوية بالنقاط. |
setText(text) | TableCell | لضبط المحتوى كنص عادي |
setTextAlignment(textAlignment) | TableCell | لضبط محاذاة النص. |
setVerticalAlignment(alignment) | TableCell | لضبط المحاذاة العمودية. |
setWidth(width) | TableCell | لضبط عرض العمود الذي يحتوي على الخلية الحالية، بالنقاط. |
المستندات التفصيلية
appendHorizontalRule()
لإنشاء HorizontalRule
جديدة وإلحاقها بها.
سيتم تضمين HorizontalRule
في Paragraph
جديدة.
تذكرة ذهاب وعودة
HorizontalRule
— القاعدة الأفقية الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendImage(image)
إنشاء InlineImage
جديد وإرفاقه من كائن ثنائي كبير محدد للصورة.
سيتم تضمين InlineImage
في Paragraph
جديدة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
image | BlobSource | بيانات الصورة. |
تذكرة ذهاب وعودة
InlineImage
- الصورة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendImage(image)
لإلحاق InlineImage
المُقدَّم.
سيتم تضمين InlineImage
في Paragraph
جديدة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
image | InlineImage | بيانات الصورة. |
تذكرة ذهاب وعودة
InlineImage
— الصورة المضافة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendListItem(listItem)
لإلحاق ListItem
المُقدَّم.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
listItem | ListItem | عنصر القائمة الذي سيتم إلحاقه |
تذكرة ذهاب وعودة
ListItem
— عنصر القائمة المُلحق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendListItem(text)
لإنشاء ListItem
جديدة وإلحاقها بها.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | String | محتوى النص |
تذكرة ذهاب وعودة
ListItem
— عنصر القائمة الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendParagraph(paragraph)
لإلحاق Paragraph
المُقدَّم.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
paragraph | Paragraph | الفقرة المطلوب إلحاقها |
تذكرة ذهاب وعودة
Paragraph
— الفقرة الملحقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendParagraph(text)
لإنشاء Paragraph
جديدة وإلحاقها بها.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | String | محتوى النص |
تذكرة ذهاب وعودة
Paragraph
- الفقرة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendTable()
appendTable(cells)
لإلحاق Table
جديدة تحتوي على الخلايا المحددة
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
cells | String[][] | محتوى النص لخلايا الجدول المطلوب إضافته إلى الجدول الجديد |
تذكرة ذهاب وعودة
Table
— الجدول الملحق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendTable(table)
لإلحاق Table
المُقدَّم.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
table | Table | الجدول الذي سيتم إلحاقه |
تذكرة ذهاب وعودة
Table
— الجدول الملحق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
clear()
copy()
عرض نسخة منفصلة من العنصر الحالي بشكل منفصل.
يتم أيضًا نسخ أي عناصر فرعية موجودة في العنصر. لا يحتوي العنصر الجديد على عنصر رئيسي.
تذكرة ذهاب وعودة
TableCell
— النسخة الجديدة:
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
editAsText()
للحصول على نسخة Text
من العنصر الحالي للتعديل.
يمكنك استخدام editAsText
للتلاعب بمحتوى العناصر في شكل نص منسَّق. ويتجاهل الوضع editAsText
العناصر غير النصية (مثل InlineImage
وHorizontalRule
).
تتم إزالة العناصر الفرعية المضمّنة بالكامل داخل نطاق نصي محذوف من العنصر.
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);
تذكرة ذهاب وعودة
Text
— نسخة نصية من العنصر الحالي
findElement(elementType)
يبحث في محتوى العنصر الفرعي عن النوع المحدّد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
elementType | ElementType | نوع العنصر المطلوب البحث عنه |
تذكرة ذهاب وعودة
RangeElement
- نتيجة بحث تشير إلى موضع عنصر البحث
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findElement(elementType, from)
يبحث في محتوى العنصر الفرعي من النوع المحدّد، بدءًا من
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; } }
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
elementType | ElementType | نوع العنصر المطلوب البحث عنه |
from | RangeElement | نتيجة البحث للبحث من |
تذكرة ذهاب وعودة
RangeElement
- نتيجة بحث تشير إلى الموضع التالي لعنصر البحث
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern)
يبحث في محتوى العنصر عن نمط النص المحدّد باستخدام التعبيرات العادية.
لا تتوفّر مجموعة فرعية من ميزات التعبير العادي في JavaScript بشكل كامل، مثل مجموعات الالتقاط ومفاتيح تعديل الوضع.
تتم مطابقة نمط التعبير العادي المقدَّم بشكل مستقل مع كل نص يحتوي على العنصر الحالي.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
searchPattern | String | النمط المطلوب البحث عنه |
تذكرة ذهاب وعودة
RangeElement
- نتيجة بحث تشير إلى موضع نص البحث، أو قيمة فارغة في حال عدم التطابق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
يبحث في محتوى العنصر عن نمط النص المحدَّد، بدءًا من نتيجة بحث معيّنة.
لا تتوفّر مجموعة فرعية من ميزات التعبير العادي في JavaScript بشكل كامل، مثل مجموعات الالتقاط ومفاتيح تعديل الوضع.
تتم مطابقة نمط التعبير العادي المقدَّم بشكل مستقل مع كل نص يحتوي على العنصر الحالي.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
searchPattern | String | النمط المطلوب البحث عنه |
from | RangeElement | نتيجة البحث للبحث من |
تذكرة ذهاب وعودة
RangeElement
- نتيجة بحث تشير إلى الموضع التالي لنص البحث، أو قيمة فارغة في حال عدم وجود مطابقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAttributes()
لاسترداد سمات العنصر\u39s.
النتيجة هي كائن يحتوي على خاصية لكل سمة عنصر صالحة حيث يتوافق
كل اسم سمة مع عنصر في تعداد 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]); }
تذكرة ذهاب وعودة
Object
- سمات العنصر
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getBackgroundColor()
استرداد لون الخلفية
تذكرة ذهاب وعودة
String
- لون الخلفية، بتنسيق تدوين CSS (مثل '#ffffff'
)
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getChild(childIndex)
لاسترداد العنصر الفرعي في الفهرس الفرعي المحدد.
// 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."); }
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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
getColSpan()
لاسترداد امتداد العمود، وهو عدد أعمدة خلايا الجدول التي تمتد إليها هذه الخلية. يبلغ طول الخلية غير المدمجة {0}1.
تذكرة ذهاب وعودة
Integer
- نطاق العمود أو 0 لخلية تم دمجها في خلية أخرى
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLinkUrl()
لاسترداد عنوان URL للرابط.
تذكرة ذهاب وعودة
String
— عنوان URL للرابط أو قيمة فارغة إذا كان العنصر يحتوي على قيم متعددة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
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()
لاسترداد عدد العناصر الثانوية
// 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.");
تذكرة ذهاب وعودة
Integer
— عدد الأطفال
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingBottom()
لاسترداد المساحة السفلية في النقاط.
تذكرة ذهاب وعودة
Number
- المساحة المتروكة السفلية، بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingLeft()
لاسترداد المساحة المتروكة اليسرى بالنقاط.
تذكرة ذهاب وعودة
Number
- المساحة المتروكة اليسرى، بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingRight()
لاسترجاع المساحة المتروكة الصحيحة بالنقاط.
تذكرة ذهاب وعودة
Number
- المساحة المتروكة اليمنى، بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPaddingTop()
لاسترداد المساحة المتروكة العلوية بالنقاط.
تذكرة ذهاب وعودة
Number
: المساحة المتروكة العلوية بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
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
getParentRow()
استرداد TableRow
التي تحتوي على TableCell
الحالية
تذكرة ذهاب وعودة
TableRow
- صف الجدول الذي يتضمن الخلية الحالية
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParentTable()
استرداد Table
التي تحتوي على TableCell
الحالية
تذكرة ذهاب وعودة
Table
— الجدول الذي يحتوي على الخلية الحالية
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
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
getRowSpan()
لاسترداد امتداد الصف، وهو عدد صفوف خلايا الجدول التي تمتد إليها هذه الخلية. يبلغ طول الخلية غير المُدمجة 1 صف.
تذكرة ذهاب وعودة
Integer
- صف الصف أو 0 لخلية تم دمجها فوق خلية أخرى
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
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
's.
استخدِم getType()
لتحديد النوع الدقيق لعنصر معيّن.
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.'); }
تذكرة ذهاب وعودة
ElementType
— نوع العنصر.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getVerticalAlignment()
لاسترداد VerticalAlignment
تذكرة ذهاب وعودة
VerticalAlignment
- المحاذاة العمودية
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getWidth()
لاسترداد عرض العمود الذي يحتوي على الخلية، بالنقاط.
تذكرة ذهاب وعودة
Number
- عرض العمود، بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertHorizontalRule(childIndex)
إنشاء HorizontalRule
جديدة وإدراجها في الفهرس المحدّد.
سيتم تضمين القاعدة الأفقية في Paragraph
جديدة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي سيتم إدراج العنصر فيه |
تذكرة ذهاب وعودة
HorizontalRule
— القاعدة الأفقية الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
إنشاء وإدراج InlineImage
من كائن الصورة الثنائي الكبير، في الفهرس المحدد.
سيتم تضمين الصورة في Paragraph
جديد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي سيتم إدراج العنصر فيه |
image | BlobSource | بيانات الصورة. |
تذكرة ذهاب وعودة
InlineImage
— الصورة المضمَّنة المدرجة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
إدراج InlineImage
المحددة في الفهرس المحدد.
سيتم تضمين الصورة في Paragraph
جديد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي سيتم إدراج العنصر فيه |
image | InlineImage | الصورة المطلوب إدراجها |
تذكرة ذهاب وعودة
InlineImage
— الصورة المضمَّنة المدرجة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertListItem(childIndex, listItem)
إدراج ListItem
المحددة في الفهرس المحدد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي سيتم إدراج العنصر فيه |
listItem | ListItem | عنصر القائمة المراد إدراجه |
تذكرة ذهاب وعودة
ListItem
— إدراج عنصر قائمة جديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertListItem(childIndex, text)
إنشاء ListItem
جديدة وإدراجها في الفهرس المحدّد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي سيتم إدراج العنصر فيه |
text | String | محتوى النص |
تذكرة ذهاب وعودة
ListItem
— عنصر القائمة الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, paragraph)
إدراج Paragraph
المحددة في الفهرس المحدد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي سيتم إدراج العنصر فيه |
paragraph | Paragraph | الفقرة المطلوب إدراجها |
تذكرة ذهاب وعودة
Paragraph
— الفقرة المُدرَجة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, text)
إنشاء Paragraph
جديدة وإدراجها في الفهرس المحدّد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي سيتم إدراج العنصر فيه |
text | String | محتوى النص |
تذكرة ذهاب وعودة
Paragraph
- الفقرة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTable(childIndex)
إنشاء Table
جديدة وإدراجها في الفهرس المحدّد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي سيتم إدراج العنصر فيه |
تذكرة ذهاب وعودة
Table
— الجدول الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTable(childIndex, cells)
إنشاء وإدراج Table
جديدة تحتوي على الخلايا المحددة، في الفهرس المحدد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي سيتم إدراجه |
cells | String[][] | محتوى النص لخلايا الجدول المطلوب إضافته إلى الجدول الجديد |
تذكرة ذهاب وعودة
Table
— الجدول الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTable(childIndex, table)
إدراج Table
المحددة في الفهرس المحدد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي سيتم إدراج العنصر فيه |
table | Table | الجدول المطلوب إدراجه |
تذكرة ذهاب وعودة
Table
— الجدول المدرج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
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
merge()
لدمج العنصر مع العنصر التابع السابق من النوع نفسه.
يمكن دمج عناصر ElementType
فقط. يتم نقل أي عناصر فرعية مضمّنة في العنصر الحالي إلى العنصر السابق.
تتم إزالة العنصر الحالي من المستند.
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();
تذكرة ذهاب وعودة
TableCell
— العنصر المُدمج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeChild(child)
إزالة العنصر الفرعي المحدد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
child | Element | العنصر الفرعي المطلوب إزالته |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeFromParent()
إزالة العنصر من العنصر الرئيسي.
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(); }
تذكرة ذهاب وعودة
TableCell
- العنصر الذي تمت إزالته
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
replaceText(searchPattern, replacement)
استبدال جميع تكرارات نمط نص معين بسلسلة استبدال محددة، باستخدام التعبيرات العادية.
يتم تمرير نمط البحث كسلسلة، وليس كائن تعبير عادي في JavaScript. ونتيجةً لذلك، ستحتاج إلى تخطي أي شرطة مائلة للخلف في النمط.
تستخدم هذه الطرق مكتبة التعبيرات العادية RE2 الخاصة بـ Google\u39; ، ما يحدّ من البنية المتوافقة.
تتم مطابقة نمط التعبير العادي المقدَّم بشكل مستقل مع كل نص يحتوي على العنصر الحالي.
var body = DocumentApp.getActiveDocument().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
setAttributes(attributes)
تحدد سمات العنصر\u39;s.
يجب أن تكون معلّمة السمات المحدّدة عنصرًا يكون فيه كل اسم موقع عنصرًا في تعداد DocumentApp.Attribute
وتكون كل قيمة سمة هي القيمة الجديدة التي سيتم تطبيقها.
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);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
attributes | Object | سمات العنصر\39;s. |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setBackgroundColor(color)
لضبط لون الخلفية.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | String | لون الخلفية، منسَّق بتدوين CSS (مثل '#ffffff' ) |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLinkUrl(url)
لضبط عنوان URL للرابط.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
url | String | عنوان URL للرابط |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingBottom(paddingBottom)
لضبط المساحة المتروكة السفلية بالنقاط
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
paddingBottom | Number | المساحة المتروكة السفلية بالنقاط |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingLeft(paddingLeft)
لضبط المساحة المتروكة اليسرى بالنقاط.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
paddingLeft | Number | المساحة المتروكة اليسرى بالنقاط |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingRight(paddingTop)
لضبط المساحة المتروكة اليمنى، بالنقاط.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
paddingTop | Number | المساحة المتروكة اليمنى بالنقاط |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setPaddingTop(paddingTop)
لضبط المساحة المتروكة العلوية بالنقاط.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
paddingTop | Number | المساحة المتروكة العلوية بالنقاط |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setText(text)
لضبط المحتوى كنص عادي
ملاحظة: يتم محو المحتوى الحالي.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | String | المحتوى النصي الجديد |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
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 be superscript. var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
textAlignment | TextAlignment | نوع محاذاة النص المراد تطبيقه |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setVerticalAlignment(alignment)
لضبط المحاذاة العمودية.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
alignment | VerticalAlignment | المحاذاة العمودية |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setWidth(width)
لضبط عرض العمود الذي يحتوي على الخلية الحالية، بالنقاط.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
width | Number | عرض العمود، بالنقاط |
تذكرة ذهاب وعودة
TableCell
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents