تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
النطاق
نطاق من العناصر في مستند يتم تمثيل اختيار المستخدم على أنّه Range، من بين
استخدامات أخرى. لا يمكن للنصوص البرمجية الوصول إلا إلى اختيار المستخدم الذي يشغّل النص البرمجي، وفقط إذا كان النص البرمجي مرتبطًا بالمستند.
// Bold all selected text.constselection=DocumentApp.getActiveDocument().getSelection();if(selection){constelements=selection.getRangeElements();for(leti=0;i < elements.length;i++){constelement=elements[i];// Only modify elements that can be edited as text; skip images and other// non-text elements.if(element.getElement().editAsText){consttext=element.getElement().editAsText();// Bold the selected part of the element, or the full element if it's// completely selected.if(element.isPartial()){text.setBold(element.getStartOffset(),element.getEndOffsetInclusive(),true,);}else{text.setBold(true);}}}}
تحصل على جميع العناصر التي اختارها المستخدم في النسخة المفتوحة من المستند، بما في ذلك
أي Text
عناصر تم اختيارها جزئيًا.
مستندات تفصيلية
getRangeElements()
تحصل على جميع العناصر في هذا Range، بما في ذلك أي عناصر Text جزئية (على سبيل المثال، في حال
اختيار يتضمّن جزءًا فقط من عنصر Text). لتحديد ما إذا كان عنصر
Text مضمّنًا جزئيًا فقط في النطاق، اطّلِع على RangeElement.isPartial().
الإرجاع
RangeElement[]: صفيف من العناصر بترتيب ظهورها في المستند
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["A `Range` represents a range of elements in a Google Doc, often used to represent the user's selection."],["Scripts can only access the selection of the user who is running them within the bound document."],["The `getRangeElements()` method retrieves all elements within the range, including partially selected text elements."],["The `getSelectedElements()` method is deprecated and has been replaced by `getRangeElements()`."]]],[]]