تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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`	يسترد سمات العنصر.
`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` للعنصر.
`getVerticalAlignment()`	`VerticalAlignment`	لاسترداد `VerticalAlignment`.
`getWidth()`	`Number`	لاسترداد عرض العمود الذي يحتوي على الخلية، بالنقاط.
`insertHorizontalRule(childIndex)`	`HorizontalRule`	تنشئ السمة `HorizontalRule` جديدة وإدراجها في الفهرس المحدّد.
`insertImage(childIndex, image)`	`InlineImage`	تنشئ وإدراج `InlineImage` من الكائن الثنائي الكبير (blob) الخاص بالصورة المحدد، الفهرس.
`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`	يعيّن سمات العنصر.
`setBackgroundColor(color)`	`TableCell`	لضبط لون الخلفية.
`setLinkUrl(url)`	`TableCell`	لضبط عنوان URL للرابط.
`setPaddingBottom(paddingBottom)`	`TableCell`	لضبط المساحة المتروكة السفلية بالنقاط.
`setPaddingLeft(paddingLeft)`	`TableCell`	لضبط المساحة المتروكة اليسرى بالنقاط.
`setPaddingRight(paddingRight)`	`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()`

تنشئ سمة Table جديدة وتلحقها

الإرجاع

Table: الجدول الجديد

التفويض

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

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

`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()`

يؤدي إلى محو محتوى العنصر.

الإرجاع

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().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 — نتيجة بحث تشير إلى موضع نص البحث أو "فارغ" إذا لم يكن هناك مطابقة

التفويض

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

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

`findText(searchPattern, from)`

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

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

المعلمات

الاسم	النوع	الوصف
`searchPattern`	`String`	النمط للبحث عن
`from`	`RangeElement`	نتيجة البحث للبحث منها

الإرجاع

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

التفويض

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

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

`getBackgroundColor()`

لاسترداد لون الخلفية.

الإرجاع

String - لون الخلفية، منسَّق بترميز CSS (مثل '#ffffff')

التفويض

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

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

`getColSpan()`

تسترد امتداد العمود، وهو عدد أعمدة خلايا الجدول التي تمتد هذه الخلية إليها. تحتوي الخلايا غير المدمجة على امتداد عمودي قدره 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()`

لاسترداد عدد الأطفال.

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

`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 للعنصر.

استخدِم 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

`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 من الكائن الثنائي الكبير (blob) الخاص بالصورة المحدد، الفهرس.

سيتم تضمين الصورة في 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 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();

الإرجاع

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

الإرجاع

TableCell — العنصر الذي تمت إزالته

التفويض

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

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

`replaceText(searchPattern, replacement)`

لاستبدال جميع ورود نمط نص معين بسلسلة استبدال معينة، باستخدام والتعبيرات.

ويتم تمرير نمط البحث كسلسلة، وليس ككائن تعبير عادي في JavaScript. لهذا السبب، ستحتاج إلى تجنب أي شرطات مائلة للخلف في النمط.

تستخدم هذه الطرق طريقة 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

`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`	سمات العنصر.

الإرجاع

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(paddingRight)`

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

المعلمات

الاسم	النوع	الوصف
`paddingRight`	`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 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`	نوع محاذاة النص لتطبيقه

الإرجاع

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