غلاف حول Element مع إزاحة محتملة للبدء والانتهاء تسمح هذه العناصر المرجعية بتمثيل
نطاق من الأحرف ضمن عنصر Text
في نتائج البحث وعمليات اختيار المستندات والنطاقات المُسمّاة.
الطُرق
| الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
|---|---|---|
get | Element | تحصل على Element الذي يتوافق مع هذا Range. |
get | Integer | تحصل على موضع نهاية نطاق جزئي ضمن عنصر النطاق. |
get | Integer | تحصل على موضع بداية نطاق جزئي ضمن عنصر النطاق. |
is | Boolean | تحدِّد ما إذا كان عنصر النطاق هذا يغطي العنصر بأكمله أو اختيارًا جزئيًا من أحرف العنصر. |
مستندات تفصيلية
get Element()
تحصل على Element الذي يتوافق مع هذا Range.
const rangeElement = DocumentApp.getActiveDocument().getSelection().getRangeElements()[0]; // Log debug information about a range element. Logger.log(`Element type: ${rangeElement.getElement().getType()}`); if (rangeElement.isPartial()) { Logger.log(`The character range begins at ${rangeElement.getStartOffset()}`); Logger.log( `The character range ends at ${rangeElement.getEndOffsetInclusive()}`, ); } else { Logger.log('The entire range element is included.'); }
الإرجاع
Element: العنصر الذي يتوافق مع هذا Range
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get End Offset Inclusive()
تحصل على موضع نهاية نطاق جزئي ضمن عنصر النطاق. إذا كان العنصر هو عنصر
Text وعرض is القيمة true، يكون البدء هو عدد الأحرف قبل الحرف
الأول في النطاق (أي فهرس الحرف الأول في النطاق). وفي أي حالة
أخرى، تعرض هذه الطريقة القيمة -1.
الإرجاع
Integer — بالنسبة إلى عناصر Text، هو
عدد الأحرف قبل الحرف الأخير في النطاق، وبالنسبة إلى العناصر الأخرى، هو -1
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Start Offset()
تحصل على موضع بداية نطاق جزئي ضمن عنصر النطاق. إذا كان العنصر هو عنصر
Text وعرضت is القيمة true، يكون البادئة هو عدد الأحرف قبل بداية
النطاق (أي فهرس الحرف الأول في النطاق). وفي أي حالة أخرى، تعرض هذه العبارة
-1.
الإرجاع
Integer: بالنسبة إلى عناصر Text، هو
عدد الأحرف قبل بداية النطاق، وبالنسبة إلى العناصر الأخرى، هو -1
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
is Partial()
تحدِّد ما إذا كان عنصر النطاق هذا يغطي العنصر بأكمله أو اختيارًا جزئيًا من
أحرف العنصر. يمكن تحديد بداية ونهاية نطاق عنصر النطاق الجزئي باستخدام get وget على التوالي.
الإرجاع
Boolean: true إذا كان العنصر مضمّنًا جزئيًا، false إذا لم يكن كذلك
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents