يشير ذلك المصطلح إلى أداة تُستخدَم لإنشاء عناصر Range
من عناصر المستند.
// Change the user's selection to a range that includes every table in the document. var doc = DocumentApp.getActiveDocument(); var rangeBuilder = doc.newRange(); var tables = doc.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 ). |
الوثائق التفصيلية
addElement(element)
إضافة Element
بالكامل إلى RangeBuilder
المَعلمات
الاسم | Type | الوصف |
---|---|---|
element | Element | العنصر المراد إضافته |
استرجاع الكرة
RangeBuilder
: أداة إنشاء السلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
addElement(textElement, startOffset, endOffsetInclusive)
لإضافة عنصر Text
جزئي إلى عنصر RangeBuilder
هذا.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
textElement | Text | العنصر النصي المراد إضافته جزئيًا |
startOffset | Integer | عدد الأحرف قبل الحرف الأول المطلوب تضمينه (أي فهرس الحرف الأول في النطاق) |
endOffsetInclusive | Integer | عدد الأحرف قبل الحرف الأخير المطلوب تضمينه (أي فهرس آخر حرف في النطاق) |
استرجاع الكرة
RangeBuilder
: أداة إنشاء السلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
addElementsBetween(startElement, endElementInclusive)
لإضافة عنصرين كاملين، وجميع العناصر بينهما، إلى هذا RangeBuilder
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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