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

Class RangeBuilder

يشير ذلك المصطلح إلى أداة إنشاء تُستخدَم لإنشاء كائنات Range من عناصر المستند.

// Change the user's selection to a range that includes every table in the active tab.
var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`addElement(element)`	`RangeBuilder`	لإضافة `Element` بالكامل إلى `RangeBuilder`
`addElement(textElement, startOffset, endOffsetInclusive)`	`RangeBuilder`	تتم إضافة عنصر `Text` جزئي إلى عنصر `RangeBuilder` هذا.
`addElementsBetween(startElement, endElementInclusive)`	`RangeBuilder`	تتم إضافة عنصرين كاملين وجميع العناصر بينهما إلى `RangeBuilder`.
`addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)`	`RangeBuilder`	تتم إضافة عنصري `Text` جزئيين وجميع العناصر بينهما إلى `RangeBuilder`.
`addRange(range)`	`RangeBuilder`	لإضافة محتوى `Range` آخر إلى `RangeBuilder`
`build()`	`Range`	تنشئ `Range` من الإعدادات المطبّقة على أداة الإنشاء.
`getRangeElements()`	`RangeElement[]`	للحصول على جميع العناصر في `Range`، بما في ذلك أي عناصر `Text` جزئية (على سبيل المثال، في الحالة تحديد يتضمن جزءًا فقط من عنصر `Text`).

طرق متوقّفة نهائيًا

الطريقة	نوع الإرجاع	وصف قصير
`getSelectedElements()`	`RangeElement[]`	تحصل على جميع العناصر التي اختارها المستخدم في المثيل المفتوح للمستند، بما في ذلك أي `Text` تم اختياره جزئيًا عناصر.

الوثائق التفصيلية

`addElement(element)`

لإضافة Element بالكامل إلى RangeBuilder

المعلمات

الاسم	النوع	الوصف
`element`	`Element`	العنصر المراد إضافته

الإرجاع

RangeBuilder — أداة الإنشاء هذه، للسلاسل

التفويض

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

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

`addElement(textElement, startOffset, endOffsetInclusive)`

تتم إضافة عنصر Text جزئي إلى عنصر RangeBuilder هذا.

المعلمات

الاسم	النوع	الوصف
`textElement`	`Text`	العنصر النصي المراد إضافته جزئيًا
`startOffset`	`Integer`	عدد الأحرف قبل الحرف الأول المراد تضمينه (أي فهرس الحرف الأول في النطاق)
`endOffsetInclusive`	`Integer`	عدد الأحرف التي سيتم تضمينها قبل الحرف الأخير المطلوب (أي فهرس الحرف الأخير في النطاق)

الإرجاع

RangeBuilder — أداة الإنشاء هذه، للسلاسل

التفويض

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

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

`addElementsBetween(startElement, endElementInclusive)`

تتم إضافة عنصرين كاملين وجميع العناصر بينهما إلى RangeBuilder.

المعلمات

الاسم	النوع	الوصف
`startElement`	`Element`	العنصر الأول الذي ستتم إضافته
`endElementInclusive`	`Element`	العنصر الأخير الذي ستتم إضافته

الإرجاع

RangeBuilder — أداة الإنشاء هذه، للسلاسل

التفويض

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

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

`addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)`

تتم إضافة عنصري Text جزئيين وجميع العناصر بينهما إلى RangeBuilder.

المعلمات

الاسم	النوع	الوصف
`startTextElement`	`Text`	العنصر النصي الأول ستتم إضافته جزئيًا
`startOffset`	`Integer`	عدد الأحرف قبل الحرف الأول من `startTextElement` المراد تضمينه (أي فهرس الحرف الأول في النطاق)
`endTextElementInclusive`	`Text`	العنصر النصي الأخير المراد إضافته جزئيًا
`endOffsetInclusive`	`Integer`	عدد الأحرف قبل الحرف الأخير من `endTextElementInclusive` المراد تضمينه (أي فهرس الحرف الأخير في النطاق)

الإرجاع

RangeBuilder — أداة الإنشاء هذه، للسلاسل

التفويض

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

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

`addRange(range)`

لإضافة محتوى Range آخر إلى RangeBuilder

المعلمات

الاسم	النوع	الوصف
`range`	`Range`	النطاق الذي يجب إضافة عناصره

الإرجاع

RangeBuilder — أداة الإنشاء هذه، للسلاسل

التفويض

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

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

`build()`

تنشئ Range من الإعدادات المطبّقة على أداة الإنشاء.

الإرجاع

Range - النطاق الذي تم إنشاؤه حديثًا

`getRangeElements()`

للحصول على جميع العناصر في Range، بما في ذلك أي عناصر Text جزئية (على سبيل المثال، في الحالة تحديد يتضمن جزءًا فقط من عنصر Text). لتحديد ما إذا كان تم تضمين عنصر Text جزئيًا فقط في النطاق، ويمكنك الاطّلاع على RangeElement.isPartial().

الإرجاع

RangeElement[] - مصفوفة من العناصر بالترتيب الذي تظهر به في المستند

التفويض

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

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

طرق متوقّفة نهائيًا

`getSelectedElements()`

تمّت إزالة هذا العمود. تغيّر الاسم إلى "getRangeElements()".

تحصل على جميع العناصر التي اختارها المستخدم في المثيل المفتوح للمستند، بما في ذلك أي Text تم اختياره جزئيًا عناصر.

الإرجاع

RangeElement[] - مصفوفة من العناصر المختارة أو المحددة جزئيًا، بالترتيب الذي تظهر به في مستند

التفويض

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

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