Class DocumentTriggerBuilder
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
أداةإنشاءالمشغّلات في "مستندات Google"
أداة إنشاء لعوامل تشغيل المستندات
مستندات تفصيلية
create()
لإنشاء عامل التشغيل الجديد وإرجاعه
الإرجاع
Trigger: عبارة التشغيل الجديدة.
onOpen()
تُحدِّد عامل تشغيل سيتم تنشيطها عند فتح المستند.
const document = DocumentApp.getActiveDocument();
ScriptApp.newTrigger('myFunction').forDocument(document).onOpen().create();
الإرجاع
DocumentTriggerBuilder — هذا الرمز DocumentTriggerBuilder، لإنشاء سلسلة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe DocumentTriggerBuilder helps in creating and managing triggers for Google Docs.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods like \u003ccode\u003ecreate()\u003c/code\u003e to finalize the trigger and \u003ccode\u003eonOpen()\u003c/code\u003e to set a trigger for when the document is opened.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eonOpen()\u003c/code\u003e method allows you to specify a function to execute when a document is opened, enhancing document automation capabilities.\u003c/p\u003e\n"]]],["The `DocumentTriggerBuilder` class facilitates the creation of triggers for Google Documents. Key actions include `create()`, which generates and returns a new `Trigger` object, and `onOpen()`, which configures the trigger to activate when the document is opened. The `onOpen()` method returns the `DocumentTriggerBuilder` instance, allowing method chaining. The provided example demonstrates creating a trigger that runs \"myFunction\" upon document opening.\n"],null,["# Class DocumentTriggerBuilder\n\nDocumentTriggerBuilder\n\nA builder for document triggers. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------|--------------------------------------------------|-----------------------------------------------------------------|\n| [create()](#create()) | [Trigger](/apps-script/reference/script/trigger) | Creates and returns the new trigger. |\n| [onOpen()](#onOpen()) | [DocumentTriggerBuilder](#) | Specifies a trigger that will fire when the document is opened. |\n\nDetailed documentation\n----------------------\n\n### `create()`\n\nCreates and returns the new trigger.\n\n#### Return\n\n\n[Trigger](/apps-script/reference/script/trigger) --- The new trigger.\n\n*** ** * ** ***\n\n### `on``Open()`\n\nSpecifies a trigger that will fire when the document is opened.\n\n```javascript\nconst document = DocumentApp.getActiveDocument();\nScriptApp.newTrigger('myFunction').forDocument(document).onOpen().create();\n```\n\n#### Return\n\n\n[DocumentTriggerBuilder](#) --- This [DocumentTriggerBuilder](#), for chaining."]]
