Class RangeElement

RangeElement

برنامج تضمين حول Element مع إزاحة محتملة للبداية والنهاية تسمح هذه الإزاحة نطاق من الأحرف في Text لتمثيله في نتائج البحث وتحديدات المستندات والنطاقات المُعنونة.

الطُرق

الطريقةنوع الإرجاعوصف قصير
getElement()Elementالحصول على Element الذي يتوافق مع RangeElement
getEndOffsetInclusive()Integerللحصول على موضع نهاية نطاق جزئي داخل عنصر النطاق.
getStartOffset()Integerيحصل على موضع بداية نطاق جزئي داخل عنصر النطاق.
isPartial()Booleanتحدد ما إذا كان عنصر النطاق هذا يغطي العنصر بالكامل أم اختيارًا جزئيًا أحرف العنصر.

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

getElement()

الحصول على Element الذي يتوافق مع RangeElement 

// 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: العنصر المتجاوب مع عنصر RangeElement هذا

التفويض

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

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

getEndOffsetInclusive()

للحصول على موضع نهاية نطاق جزئي داخل عنصر النطاق. إذا كان العنصر عبارة عن Text ويعرض العنصر isPartial() القيمة true، وتكون الإزاحة هي عدد الأحرف قبل آخر حرف في النطاق (أي فهرس الحرف الأخير في النطاق)؛ بأي نوع آخر في هذه الحالة، تُرجع هذه الطريقة القيمة -1.

الإرجاع

Integer: بالنسبة إلى عناصر Text، سيتم عدد الأحرف قبل الحرف الأخير في النطاق؛ للعناصر الأخرى، -1

التفويض

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

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

getStartOffset()

يحصل على موضع بداية نطاق جزئي داخل عنصر النطاق. إذا كان العنصر عبارة عن Text ويعرض العنصر isPartial() القيمة true، وتكون الإزاحة هي عدد الأحرف التي تسبق بداية النطاق (أي فهرس الحرف الأول في النطاق)؛ في أي حالة أخرى، فإن هذا تُرجع الطريقة -1.

الإرجاع

Integer: بالنسبة إلى عناصر Text، سيتم عدد الأحرف قبل بداية النطاق؛ للعناصر الأخرى، -1

التفويض

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

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

isPartial()

تحدد ما إذا كان عنصر النطاق هذا يغطي العنصر بالكامل أم اختيارًا جزئيًا أحرف العنصر. يمكن أن تكون بداية ونهاية نطاق عنصر النطاق الجزئي باستخدام getStartOffset() وgetEndOffsetInclusive() على التوالي.

الإرجاع

Boolean — true إذا كان العنصر مضمّنًا جزئيًا false إن لم يكن

التفويض

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

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