يتم ربط النص البرمجي بملف "جداول بيانات Google" أو "مستندات Google" أو "العروض التقديمية من Google" أو "نماذج Google" إذا تم إنشاؤه من هذا المستند بدلاً من نص برمجي مستقل. يُسمى الملف الذي يتم إرفاق نص برمجي مرتبط به "container;" عادةً ما تعمل النصوص البرمجية المرتبطة مثل النصوص البرمجية المستقلة باستثناء أنها لا تظهر في Google Drive، ولا يمكن فصلها عن الملف الذي ترتبط بها، وتحصل على بعض الامتيازات الخاصة عن الملف الرئيسي.
يُرجى العِلم أنه يمكن أيضًا ربط النصوص البرمجية بمواقع Google، إلا أن هذه النصوص البرمجية يتم نشرها في معظم الأحيان كتطبيقات ويب. يمكن أيضًا أن تصبح النصوص البرمجية المرتبطة بـ "جداول بيانات Google" أو "مستندات Google" أو "العروض التقديمية من Google" أو "نماذج Google" تطبيقات ويب، إلا أن هذا الأمر غير شائع.
إنشاء نص برمجي مرتبط
"مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google"
لإنشاء نص برمجي مرتبط في "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google"، افتح مستندًا في "مستندات Google" أو جدول بيانات في "جداول بيانات Google" أو عرضًا تقديميًا في "العروض التقديمية من Google" وانقر على الإضافات & gt; برمجة تطبيقات Google. لإعادة فتح النص البرمجي في المستقبل، يمكنك تنفيذ الأمر نفسه أو فتح النص البرمجي من لوحة بيانات برمجة التطبيقات.
نماذج Google
لإنشاء نص برمجي مرتبط في "نماذج Google"، افتح نموذجًا وانقر على رمز المزيد > محرِّر النص البرمجي. لإعادة فتح النص البرمجي في المستقبل، نفِّذ الإجراء نفسه أو افتح النص البرمجي من لوحة بيانات برمجة التطبيقات.
طُرق خاصة
يمكن أن تستدعّ النصوص البرمجية المقيّدة بعض الطرق التي لا تستطيع النصوص البرمجية المستقلة تنفيذها:
- تسمح
getActiveSpreadsheet()وgetActiveDocument()وgetActivePresentation()وgetActiveForm()النصوص البرمجية المرتبطة بالإشارة إلى الملف الرئيسي بدون الرجوع إلى معرّف الملف. - تتيح
getUiللنصوص البرمجية المرتبطة الوصول إلى واجهة المستخدم للملف الرئيسي لإضافة القوائم المخصّصة ومربّعات الحوار والأشرطة الجانبية. - في "جداول بيانات Google " و
getActiveSheet()وgetActiveRange()وgetActiveCell()السماح للنص البرمجي بتحديد ورقة البيانات الحالية للمستخدم، أو نطاق الخلايا المحدد، أو الخلية الفردية المحددة.setActiveSheet(sheet)وsetActiveRange(range)سمح للنص البرمجي بتغيير هذه الاختيارات. - في "مستندات Google"، يتيح
getCursor()وgetSelection()للنص البرمجي تحديد موضع مؤشر الماوس أو النص المحدد.setCursor(position)وsetSelection(range)تسمح للنص البرمجي بتغيير هذه المواقع.
لمزيد من المعلومات، يمكنك الاطّلاع على دليل توسيع "جداول بيانات Google" أو دليل تمديد "مستندات Google".
القوائم ومربّعات الحوار والأشرطة الجانبية المخصّصة
يمكن للنصوص البرمجية المقيّدة تخصيص "جداول بيانات Google" و"مستندات Google" و"نماذج Google" من خلال إضافة القوائم المخصّصة ومربّعات الحوار أو الأشرطة الجانبية. تذكّر أن النص البرمجي يمكن أن يتفاعل فقط مع واجهة المستخدم للمثيل الحالي من ملف مفتوح. وهذا يعني أن النص البرمجي المرتبط بمستند واحد لا يمكن أن يؤثر في واجهة المستخدم لمستند آخر.
الإضافات
تعمل الإضافات داخل Gmail و"جداول بيانات Google" و"مستندات Google" و"العروض التقديمية من Google" و"نماذج Google". إذا كنت قد طوّرت نصًا برمجيًا مقيّدًا أو مستقلًا وكنت تريد مشاركته مع العالم، تتيح لك "برمجة التطبيقات" نشر النص البرمجي كإضافة حتى يتمكن المستخدمون الآخرون من تثبيته من متجر الإضافات.
الكائن Triggers
يمكن أن تستخدم النصوص البرمجية المقيّدة عوامل تشغيل بسيطة، مثل دالة onOpen() الخاصة، التي تعمل تلقائيًا عند فتح الملف بواسطة مستخدم لديه حق التعديل. وكما هو الحال مع جميع أنواع النصوص البرمجية، يمكنها أيضًا استخدام مشغّلات قابلة للتثبيت.
الدوال المخصّصة
الدالة المخصّصة هي دالة واردة في نص برمجي مرتبط بـ "جداول بيانات Google"، والتي تطلبها مباشرةً من خلية باستخدام البنية =myFunctionName(). وبالتالي، تشبه الدوال المخصّصة مئات
الدوال المضمّنة في "جداول بيانات Google"
مثل AVERAGE أو
SUM باستثناء أنّك تحدِّد
سلوك الدوال المخصّصة.
الوصول إلى النصوص البرمجية المرتبطة
يمكن فقط للمستخدمين الذين لديهم الإذن بتعديل الحاوية تشغيل النص البرمجي المرتبط بها. لا يمكن للمتعاونين الذين لديهم حق الوصول إلى الملف الشخصي فقط فتح محرّر النص البرمجي، ولكن عند إنشاء نسخة من الملف الرئيسي، سيصبحون مالكين للنسخة وسيتمكنون من الاطّلاع على نسخة من النص البرمجي وتشغيلها.