Class ContainerInfo
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
معلوماتالحاوية
الوصول إلى موضع الرسم البياني ضمن ورقة يمكن تعديلها باستخدام الدالة EmbeddedChart.modify().
const sheet = SpreadsheetApp.getActiveSheet();
const chart = sheet.getCharts()[0];
const modifiedChart = chart.modify().setPosition(5, 5, 0, 0).build();
sheet.updateChart(modifiedChart);
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
getAnchorColumn() | Integer | يتم تثبيت الجانب الأيمن من الرسم البياني في هذا العمود. |
getAnchorRow() | Integer | يتم تثبيت الجانب العلوي من الرسم البياني في هذا الصف. |
getOffsetX() | Integer | يتم إزاحة الزاوية العلوية اليسرى من الرسم البياني عن عمود الربط بهذا العدد من وحدات البكسل. |
getOffsetY() | Integer | يتم إزاحة الزاوية العلوية اليسرى من الرسم البياني عن صف التثبيت بهذا العدد من وحدات البكسل. |
مستندات مفصّلة
getAnchorColumn()
يتم تثبيت الجانب الأيمن من الرسم البياني في هذا العمود.
الإرجاع
Integer: عمود مفهرس من 1 (أي أنّ العمود C هو 3).
getAnchorRow()
يتم تثبيت الجانب العلوي من الرسم البياني في هذا الصف.
الإرجاع
Integer: صف مفهرس برقم 1 (أي أنّ الصف 5 يعرض 5).
getOffsetX()
يتم إزاحة الزاوية العلوية اليسرى من الرسم البياني عن عمود الربط بهذا العدد من وحدات البكسل.
الإرجاع
Integer: الإزاحة الأفقية بالبكسل للزاوية العلوية اليسرى من الرسم البياني
getOffsetY()
يتم إزاحة الزاوية العلوية اليسرى من الرسم البياني عن صف التثبيت بهذا العدد من وحدات البكسل.
الإرجاع
Integer: الإزاحة العمودية بالبكسل للزاوية العلوية اليسرى من الرسم البياني.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eContainerInfo\u003c/code\u003e allows you to access and update an embedded chart's position within a Google Sheet.\u003c/p\u003e\n"],["\u003cp\u003eYou can get the chart's anchor column and row, which determine its main positioning.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eOffsetX\u003c/code\u003e and \u003ccode\u003eOffsetY\u003c/code\u003e properties provide pixel-level control over the chart's placement relative to the anchor point.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003emodify()\u003c/code\u003e and \u003ccode\u003esetPosition()\u003c/code\u003e functions along with \u003ccode\u003eupdateChart()\u003c/code\u003e to change the chart's position programmatically.\u003c/p\u003e\n"]]],[],null,["# Class ContainerInfo\n\nContainerInfo\n\nAccess the chart's position within a sheet. Can be updated using the [EmbeddedChart.modify()](/apps-script/reference/spreadsheet/embedded-chart#modify()) function.\n\n```javascript\nconst sheet = SpreadsheetApp.getActiveSheet();\nconst chart = sheet.getCharts()[0];\nconst modifiedChart = chart.modify().setPosition(5, 5, 0, 0).build();\nsheet.updateChart(modifiedChart);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------|-------------|------------------------------------------------------------------------------------------|\n| [getAnchorColumn()](#getAnchorColumn()) | `Integer` | The chart's left side is anchored in this column. |\n| [getAnchorRow()](#getAnchorRow()) | `Integer` | The chart's top side is anchored in this row. |\n| [getOffsetX()](#getOffsetX()) | `Integer` | The chart's upper left hand corner is offset from the anchor column by this many pixels. |\n| [getOffsetY()](#getOffsetY()) | `Integer` | The chart's upper left hand corner is offset from the anchor row by this many pixels. |\n\nDetailed documentation\n----------------------\n\n### `get``Anchor``Column()`\n\nThe chart's left side is anchored in this column.\n\n#### Return\n\n\n`Integer` --- 1-indexed column (that is, column C is 3).\n\n*** ** * ** ***\n\n### `get``Anchor``Row()`\n\nThe chart's top side is anchored in this row.\n\n#### Return\n\n\n`Integer` --- 1-indexed row (that is, row 5 returns 5).\n\n*** ** * ** ***\n\n### `get``Offset``X()`\n\nThe chart's upper left hand corner is offset from the anchor column by this many pixels.\n\n#### Return\n\n\n`Integer` --- The horizontal offset in pixels for the upper left hand corner of the chart.\n\n*** ** * ** ***\n\n### `get``Offset``Y()`\n\nThe chart's upper left hand corner is offset from the anchor row by this many pixels.\n\n#### Return\n\n\n`Integer` --- The vertical offset in pixels for the upper left hand corner of the chart."]]
