Class TableCell

خلية الجدول

عنصر يمثّل خلية في الجدول. يحتوي 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 جديدة.

المعلّمات

الاسمالنوعالوصف
imageBlobSourceبيانات الصورة.

تذكرة ذهاب وعودة

InlineImage - الصورة الجديدة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendImage(image)

لإلحاق InlineImage المُقدَّم.

سيتم تضمين InlineImage في Paragraph جديدة.

المعلّمات

الاسمالنوعالوصف
imageInlineImageبيانات الصورة.

تذكرة ذهاب وعودة

InlineImage — الصورة المضافة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendListItem(listItem)

لإلحاق ListItem المُقدَّم.

المعلّمات

الاسمالنوعالوصف
listItemListItemعنصر القائمة الذي سيتم إلحاقه

تذكرة ذهاب وعودة

ListItem — عنصر القائمة المُلحق

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendListItem(text)

لإنشاء ListItem جديدة وإلحاقها بها.

المعلّمات

الاسمالنوعالوصف
textStringمحتوى النص

تذكرة ذهاب وعودة

ListItem — عنصر القائمة الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendParagraph(paragraph)

لإلحاق Paragraph المُقدَّم.

المعلّمات

الاسمالنوعالوصف
paragraphParagraphالفقرة المطلوب إلحاقها

تذكرة ذهاب وعودة

Paragraph — الفقرة الملحقة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendParagraph(text)

لإنشاء Paragraph جديدة وإلحاقها بها.

المعلّمات

الاسمالنوعالوصف
textStringمحتوى النص

تذكرة ذهاب وعودة

Paragraph - الفقرة الجديدة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable()

لإنشاء Table جديدة وإلحاقها بها.

تذكرة ذهاب وعودة

Table — الجدول الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable(cells)

لإلحاق Table جديدة تحتوي على الخلايا المحددة

المعلّمات

الاسمالنوعالوصف
cellsString[][]محتوى النص لخلايا الجدول المطلوب إضافته إلى الجدول الجديد

تذكرة ذهاب وعودة

Table — الجدول الملحق

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable(table)

لإلحاق Table المُقدَّم.

المعلّمات

الاسمالنوعالوصف
tableTableالجدول الذي سيتم إلحاقه

تذكرة ذهاب وعودة

Table — الجدول الملحق

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

clear()

محو محتوى العنصر.

تذكرة ذهاب وعودة

TableCell — العنصر الحالي


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)

يبحث في محتوى العنصر الفرعي عن النوع المحدّد.

المعلّمات

الاسمالنوعالوصف
elementTypeElementTypeنوع العنصر المطلوب البحث عنه

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
elementTypeElementTypeنوع العنصر المطلوب البحث عنه
fromRangeElementنتيجة البحث للبحث من

تذكرة ذهاب وعودة

RangeElement - نتيجة بحث تشير إلى الموضع التالي لعنصر البحث

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

findText(searchPattern)

يبحث في محتوى العنصر عن نمط النص المحدّد باستخدام التعبيرات العادية.

لا تتوفّر مجموعة فرعية من ميزات التعبير العادي في JavaScript بشكل كامل، مثل مجموعات الالتقاط ومفاتيح تعديل الوضع.

تتم مطابقة نمط التعبير العادي المقدَّم بشكل مستقل مع كل نص يحتوي على العنصر الحالي.

المعلّمات

الاسمالنوعالوصف
searchPatternStringالنمط المطلوب البحث عنه

تذكرة ذهاب وعودة

RangeElement - نتيجة بحث تشير إلى موضع نص البحث، أو قيمة فارغة في حال عدم التطابق

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

findText(searchPattern, from)

يبحث في محتوى العنصر عن نمط النص المحدَّد، بدءًا من نتيجة بحث معيّنة.

لا تتوفّر مجموعة فرعية من ميزات التعبير العادي في JavaScript بشكل كامل، مثل مجموعات الالتقاط ومفاتيح تعديل الوضع.

تتم مطابقة نمط التعبير العادي المقدَّم بشكل مستقل مع كل نص يحتوي على العنصر الحالي.

المعلّمات

الاسمالنوعالوصف
searchPatternStringالنمط المطلوب البحث عنه
fromRangeElementنتيجة البحث للبحث من

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
childIndexIntegerفهرس العنصر الفرعي لاسترداده

تذكرة ذهاب وعودة

Element — العنصر الفرعي في الفهرس المحدد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getChildIndex(child)

لاسترداد الفهرس الفرعي للعنصر الفرعي المحدد.

المعلّمات

الاسمالنوعالوصف
childElementالعنصر الفرعي الذي سيتم استرداد الفهرس له

تذكرة ذهاب وعودة

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 جديدة.

المعلّمات

الاسمالنوعالوصف
childIndexIntegerالفهرس الذي سيتم إدراج العنصر فيه

تذكرة ذهاب وعودة

HorizontalRule — القاعدة الأفقية الجديدة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertImage(childIndex, image)

إنشاء وإدراج InlineImage من كائن الصورة الثنائي الكبير، في الفهرس المحدد.

سيتم تضمين الصورة في Paragraph جديد.

المعلّمات

الاسمالنوعالوصف
childIndexIntegerالفهرس الذي سيتم إدراج العنصر فيه
imageBlobSourceبيانات الصورة.

تذكرة ذهاب وعودة

InlineImage — الصورة المضمَّنة المدرجة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertImage(childIndex, image)

إدراج InlineImage المحددة في الفهرس المحدد.

سيتم تضمين الصورة في Paragraph جديد.

المعلّمات

الاسمالنوعالوصف
childIndexIntegerالفهرس الذي سيتم إدراج العنصر فيه
imageInlineImageالصورة المطلوب إدراجها

تذكرة ذهاب وعودة

InlineImage — الصورة المضمَّنة المدرجة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertListItem(childIndex, listItem)

إدراج ListItem المحددة في الفهرس المحدد.

المعلّمات

الاسمالنوعالوصف
childIndexIntegerالفهرس الذي سيتم إدراج العنصر فيه
listItemListItemعنصر القائمة المراد إدراجه

تذكرة ذهاب وعودة

ListItem — إدراج عنصر قائمة جديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertListItem(childIndex, text)

إنشاء ListItem جديدة وإدراجها في الفهرس المحدّد.

المعلّمات

الاسمالنوعالوصف
childIndexIntegerالفهرس الذي سيتم إدراج العنصر فيه
textStringمحتوى النص

تذكرة ذهاب وعودة

ListItem — عنصر القائمة الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertParagraph(childIndex, paragraph)

إدراج Paragraph المحددة في الفهرس المحدد.

المعلّمات

الاسمالنوعالوصف
childIndexIntegerالفهرس الذي سيتم إدراج العنصر فيه
paragraphParagraphالفقرة المطلوب إدراجها

تذكرة ذهاب وعودة

Paragraph — الفقرة المُدرَجة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertParagraph(childIndex, text)

إنشاء Paragraph جديدة وإدراجها في الفهرس المحدّد.

المعلّمات

الاسمالنوعالوصف
childIndexIntegerالفهرس الذي سيتم إدراج العنصر فيه
textStringمحتوى النص

تذكرة ذهاب وعودة

Paragraph - الفقرة الجديدة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex)

إنشاء Table جديدة وإدراجها في الفهرس المحدّد.

المعلّمات

الاسمالنوعالوصف
childIndexIntegerالفهرس الذي سيتم إدراج العنصر فيه

تذكرة ذهاب وعودة

Table — الجدول الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex, cells)

إنشاء وإدراج Table جديدة تحتوي على الخلايا المحددة، في الفهرس المحدد.

المعلّمات

الاسمالنوعالوصف
childIndexIntegerالفهرس الذي سيتم إدراجه
cellsString[][]محتوى النص لخلايا الجدول المطلوب إضافته إلى الجدول الجديد

تذكرة ذهاب وعودة

Table — الجدول الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex, table)

إدراج Table المحددة في الفهرس المحدد.

المعلّمات

الاسمالنوعالوصف
childIndexIntegerالفهرس الذي سيتم إدراج العنصر فيه
tableTableالجدول المطلوب إدراجه

تذكرة ذهاب وعودة

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)

إزالة العنصر الفرعي المحدد.

المعلّمات

الاسمالنوعالوصف
childElementالعنصر الفرعي المطلوب إزالته

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
searchPatternStringنمط التعبير العادي للبحث عن
replacementStringالنص المطلوب استخدامه كبديل

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
attributesObjectسمات العنصر\39;s.

تذكرة ذهاب وعودة

TableCell — العنصر الحالي.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setBackgroundColor(color)

لضبط لون الخلفية.

المعلّمات

الاسمالنوعالوصف
colorStringلون الخلفية، منسَّق بتدوين CSS (مثل '#ffffff')

تذكرة ذهاب وعودة

TableCell — العنصر الحالي

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setLinkUrl(url)

لضبط عنوان URL للرابط.

المعلّمات

الاسمالنوعالوصف
urlStringعنوان URL للرابط

تذكرة ذهاب وعودة

TableCell — العنصر الحالي

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingBottom(paddingBottom)

لضبط المساحة المتروكة السفلية بالنقاط

المعلّمات

الاسمالنوعالوصف
paddingBottomNumberالمساحة المتروكة السفلية بالنقاط

تذكرة ذهاب وعودة

TableCell — العنصر الحالي

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingLeft(paddingLeft)

لضبط المساحة المتروكة اليسرى بالنقاط.

المعلّمات

الاسمالنوعالوصف
paddingLeftNumberالمساحة المتروكة اليسرى بالنقاط

تذكرة ذهاب وعودة

TableCell — العنصر الحالي

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingRight(paddingTop)

لضبط المساحة المتروكة اليمنى، بالنقاط.

المعلّمات

الاسمالنوعالوصف
paddingTopNumberالمساحة المتروكة اليمنى بالنقاط

تذكرة ذهاب وعودة

TableCell — العنصر الحالي

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingTop(paddingTop)

لضبط المساحة المتروكة العلوية بالنقاط.

المعلّمات

الاسمالنوعالوصف
paddingTopNumberالمساحة المتروكة العلوية بالنقاط

تذكرة ذهاب وعودة

TableCell — العنصر الحالي

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setText(text)

لضبط المحتوى كنص عادي

ملاحظة: يتم محو المحتوى الحالي.

المعلّمات

الاسمالنوعالوصف
textStringالمحتوى النصي الجديد

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
textAlignmentTextAlignmentنوع محاذاة النص المراد تطبيقه

تذكرة ذهاب وعودة

TableCell — العنصر الحالي

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setVerticalAlignment(alignment)

لضبط المحاذاة العمودية.

المعلّمات

الاسمالنوعالوصف
alignmentVerticalAlignmentالمحاذاة العمودية

تذكرة ذهاب وعودة

TableCell — العنصر الحالي

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setWidth(width)

لضبط عرض العمود الذي يحتوي على الخلية الحالية، بالنقاط.

المعلّمات

الاسمالنوعالوصف
widthNumberعرض العمود، بالنقاط

تذكرة ذهاب وعودة

TableCell — العنصر الحالي

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents