Enum EventType
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
نوعالحدث
تشير هذه السمة إلى نوع الحدث الذي تم تشغيله.
لاستدعاء قائمة أرقام صحيحة، عليك استدعاء الصف الرئيسي والاسم والخاصية. مثلاً:
ScriptApp.EventType.CLOCK
أماكن إقامة
الموقع | النوع | الوصف |
CLOCK | Enum | يتم تنشيط عامل التشغيل بعد وصول الحدث المستنِد إلى الوقت إلى وقت محدّد. |
ON_OPEN | Enum | يتم تشغيل العامل المشغِّل بعد أن يفتح المستخدم ملف "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google". |
ON_EDIT | Enum | يتم تنشيط العامل المشغِّل بعد أن يعدّل المستخدم ملف "جداول بيانات Google" (على سبيل المثال، عن طريق إدخال قيمة
جديدة في خلية، ما يُعدّ تعديلاً بدلاً من تغيير). |
ON_FORM_SUBMIT | Enum | يتم تشغيل العامل المشغِّل بعد أن يردّ المستخدم على نموذج Google. يتوفّر هذا المشغِّل إما في
نموذج Google نفسه أو في ملف "جداول بيانات Google" الذي يرسل النموذج ردوده إليه. |
ON_CHANGE | Enum | يتم تنشيط العامل المشغِّل بعد أن يغيّر المستخدم ملف "جداول بيانات Google" (على سبيل المثال، من خلال إضافة صف،
يُحتسَب ذلك كتغيير بدلاً من تعديل). |
ON_EVENT_UPDATED | Enum | يتم تنشيط العامل المشغِّل بعد إنشاء حدث أو تعديله أو حذفه في "تقويم Google" المحدَّد. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eEventType\u003c/code\u003e is an enumeration used to define the type of event that triggers a script to run.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eEventType\u003c/code\u003e enum includes properties such as \u003ccode\u003eCLOCK\u003c/code\u003e, \u003ccode\u003eON_OPEN\u003c/code\u003e, \u003ccode\u003eON_EDIT\u003c/code\u003e, \u003ccode\u003eON_FORM_SUBMIT\u003c/code\u003e, \u003ccode\u003eON_CHANGE\u003c/code\u003e, and \u003ccode\u003eON_EVENT_UPDATED\u003c/code\u003e, each corresponding to a specific event trigger.\u003c/p\u003e\n"],["\u003cp\u003eTo call an enum property, use the syntax \u003ccode\u003eScriptApp.EventType.PROPERTY_NAME\u003c/code\u003e, replacing \u003ccode\u003ePROPERTY_NAME\u003c/code\u003e with the desired event type (e.g., \u003ccode\u003eScriptApp.EventType.CLOCK\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThese event triggers allow scripts to automatically execute in response to various actions within Google Apps like Docs, Sheets, Forms, and Calendar.\u003c/p\u003e\n"]]],[],null,["# Enum EventType\n\nEventType\n\nAn enumeration denoting the type of triggered event.\n\nTo call an enum, you call its parent class, name, and property. For example, `\nScriptApp.EventType.CLOCK`. \n\n### Properties\n\n| Property | Type | Description |\n|--------------------|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `CLOCK` | `Enum` | The trigger fires once the time-driven event reaches a specific time. |\n| `ON_OPEN` | `Enum` | The trigger fires once the user opens the Google Docs, Sheets, or Forms file. |\n| `ON_EDIT` | `Enum` | The trigger fires once the user edits the Google Sheets file (for example, by entering a new value into a cell, which counts as an edit instead of a change). |\n| `ON_FORM_SUBMIT` | `Enum` | The trigger fires once the user responds to a Google Form. This trigger is available either in the Google Form itself or in the Google Sheets file that the form sends its responses to. |\n| `ON_CHANGE` | `Enum` | The trigger fires once the user changes the Google Sheets file (for example, by adding a row, which counts as a change instead of an edit). |\n| `ON_EVENT_UPDATED` | `Enum` | The trigger fires once an event gets created, updated, or deleted on the specified Google Calendar. |"]]