Class Comment
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
التعليق
تمثيل لعقدة Comment في XML
مستندات تفصيلية
detach()
تؤدي هذه العملية إلى فصل العقدة عن العقدة الرئيسية Element. إذا لم تكن للعقدة عنصر رئيسي، لن يكون لهذه الطريقة أي تأثير.
الإرجاع
Content - العقدة المنفصلة
getParentElement()
تحصل على العقدة الرئيسية Element للعقدة. إذا لم تكن للعقدة عنصر رئيسي، تعرِض هذه الطريقةnull.
الإرجاع
Element: العقدة الرئيسية Element
getText()
تحصل على القيمة النصية لعقدة Comment.
الإرجاع
String: القيمة النصية لعقدة Comment
getValue()
تحصل على القيمة النصية لجميع العقد التي تكون عناصر فرعية مباشرة أو غير مباشرة للعقدة، بالترتيب الذي
تظهر به في المستند.
الإرجاع
String: القيمة النصية لجميع العقد التي تكون عناصر ثانوية مباشرة أو غير مباشرة للعقدة
setText(text)
لضبط القيمة النصية لعقدة Comment
المعلَمات
| الاسم | النوع | الوصف |
text | String | قيمة النص المطلوب ضبطها |
الإرجاع
Comment: عقدة Comment لإنشاء سلاسل
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRepresents an XML \u003ccode\u003eComment\u003c/code\u003e node, providing methods for interaction.\u003c/p\u003e\n"],["\u003cp\u003eAllows detachment from parent element, retrieval of parent/text values, and text modification.\u003c/p\u003e\n"],["\u003cp\u003eIncludes \u003ccode\u003egetText()\u003c/code\u003e for the comment's text and \u003ccode\u003egetValue()\u003c/code\u003e for text of all child nodes.\u003c/p\u003e\n"],["\u003cp\u003eOffers \u003ccode\u003esetText()\u003c/code\u003e to modify the comment's text and \u003ccode\u003edetach()\u003c/code\u003e to remove it from its parent.\u003c/p\u003e\n"]]],["An XML `Comment` node can be manipulated using several methods. `detach()` removes the node from its parent element. `getParentElement()` retrieves the parent `Element` node, if any. `getText()` and `getValue()` return the text content of the `Comment` node and its children respectively. The `setText(text)` method updates the text content of the `Comment` node and supports method chaining by returning the updated `Comment` node.\n"],null,["# Class Comment\n\nComment\n\nA representation of an XML `Comment` node. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------|-------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|\n| [detach()](#detach()) | [Content](/apps-script/reference/xml-service/content) | Detaches the node from its parent [Element](/apps-script/reference/xml-service/element) node. |\n| [getParentElement()](#getParentElement()) | [Element](/apps-script/reference/xml-service/element) | Gets the node's parent [Element](/apps-script/reference/xml-service/element) node. |\n| [getText()](#getText()) | `String` | Gets the text value of the `Comment` node. |\n| [getValue()](#getValue()) | `String` | Gets the text value of all nodes that are direct or indirect children of the node, in the order they appear in the document. |\n| [setText(text)](#setText(String)) | [Comment](#) | Sets the text value of the `Comment` node. |\n\nDetailed documentation\n----------------------\n\n### `detach()`\n\nDetaches the node from its parent [Element](/apps-script/reference/xml-service/element) node. If the node does not have a parent,\nthis method has no effect.\n\n#### Return\n\n\n[Content](/apps-script/reference/xml-service/content) --- the detached node\n\n*** ** * ** ***\n\n### `get``Parent``Element()`\n\nGets the node's parent [Element](/apps-script/reference/xml-service/element) node. If the node does not have a parent, this method\nreturns `null`.\n\n#### Return\n\n\n[Element](/apps-script/reference/xml-service/element) --- the parent `Element` node\n\n*** ** * ** ***\n\n### `get``Text()`\n\nGets the text value of the `Comment` node.\n\n#### Return\n\n\n`String` --- the text value of the `Comment` node\n\n*** ** * ** ***\n\n### `get``Value()`\n\nGets the text value of all nodes that are direct or indirect children of the node, in the order\nthey appear in the document.\n\n#### Return\n\n\n`String` --- the text value of all nodes that are direct or indirect children of the node\n\n*** ** * ** ***\n\n### `set``Text(text)`\n\nSets the text value of the `Comment` node.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|-----------------------|\n| `text` | `String` | the text value to set |\n\n#### Return\n\n\n[Comment](#) --- the `Comment` node, for chaining"]]
