Class Chart
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قائمة الأغاني الرائجة
عنصر رسم بياني يمكن تحويله إلى صورة ثابتة. بالنسبة إلى الرسومات البيانية المضمّنة في جداول البيانات،
يُرجى الاطّلاع على EmbeddedChart.
الطُرق
| الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
getAs(contentType) | Blob | عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد |
getBlob() | Blob | عرض البيانات داخل هذا الكائن ككتلة بيانات |
getOptions() | ChartOptions | تعرِض هذه الدالة خيارات هذا الرسم البياني، مثل الارتفاع والألوان والأُسس. |
مستندات تفصيلية
getAs(contentType)
عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد تُضيف هذه
الطريقة امتداد اسم الملف المناسب، على سبيل المثال "myfile.pdf". ومع ذلك، فإنه
يفترض أنّ جزء اسم الملف الذي يلي النقطة الأخيرة (إن وُجد) هو امتداد
حالي يجب استبداله. ونتيجةً لذلك، يصبح ملف ShoppingList.12.25.2014 هو
ShoppingList.12.25.pdf.
للاطّلاع على الحصص اليومية للإحالات الناجحة، يُرجى الاطّلاع على الحصص لخدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا مؤقتًا لحدود برمجية
أكثر صرامة.
المعلَمات
| الاسم | النوع | الوصف |
contentType | String | نوع MIME المطلوب التحويل إليه بالنسبة إلى معظم العناصر المصغّرة، يكون 'application/pdf' هو
الخيار الوحيد الصالح. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يمكن استخدام أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png'
أيضًا. بالنسبة إلى مستند "مستندات Google"، يكون 'text/markdown' صالحًا أيضًا. |
الإرجاع
Blob: البيانات بتنسيق ملف نصي
getBlob()
عرض البيانات داخل هذا الكائن ككتلة بيانات
الإرجاع
Blob: البيانات بتنسيق ملف نصي
getOptions()
تعرِض هذه الدالة خيارات هذا الرسم البياني، مثل الارتفاع والألوان والأُسس.
الخيارات المعروضة غير قابلة للتغيير.
الإرجاع
ChartOptions - خيارات هذا الرسم البياني، مثل الارتفاع والألوان والأُسس
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eA Chart object can be converted into a static image and offers methods to manipulate its data and appearance.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetAs()\u003c/code\u003e method allows for data export in various formats like PDF, BMP, GIF, JPEG, or PNG, applying appropriate filename extensions.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetBlob()\u003c/code\u003e method returns the chart's data as a blob, providing a general way to access its raw content.\u003c/p\u003e\n"],["\u003cp\u003eChart customization is enabled through the \u003ccode\u003egetOptions()\u003c/code\u003e method, which gives access to properties such as height, colors, and axes but in an immutable format.\u003c/p\u003e\n"]]],[],null,["# Class Chart\n\nChart\n\nA Chart object, which can be converted to a static image. For charts embedded in spreadsheets,\nsee [EmbeddedChart](../spreadsheet/embedded-chart.html). \n\n### Methods\n\n| Method | Return type | Brief description |\n|--------------------------------------|-------------------------------------------------------------|---------------------------------------------------------------------------------------|\n| [getAs(contentType)](#getAs(String)) | [Blob](../base/blob.html) | Return the data inside this object as a blob converted to the specified content type. |\n| [getBlob()](#getBlob()) | [Blob](../base/blob.html) | Return the data inside this object as a blob. |\n| [getOptions()](#getOptions()) | [ChartOptions](/apps-script/reference/charts/chart-options) | Returns the options for this chart, such as height, colors, and axes. |\n\nDetailed documentation\n----------------------\n\n### `get``As(contentType)`\n\nReturn the data inside this object as a blob converted to the specified content type. This\nmethod adds the appropriate extension to the filename---for example, \"myfile.pdf\". However, it\nassumes that the part of the filename that follows the last period (if any) is an existing\nextension that should be replaced. Consequently, \"ShoppingList.12.25.2014\" becomes\n\"ShoppingList.12.25.pdf\".\n\nTo view the daily quotas for conversions, see [Quotas for Google\nServices](https://developers.google.com/apps-script/guides/services/quotas). Newly created Google Workspace domains might be temporarily subject to stricter\nquotas.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `content``Type` | `String` | The MIME type to convert to. For most blobs, `'application/pdf'` is the only valid option. For images in BMP, GIF, JPEG, or PNG format, any of `'image/bmp'`, `'image/gif'`, `'image/jpeg'`, or `'image/png'` are also valid. For a Google Docs document, `'text/markdown'` is also valid. |\n\n#### Return\n\n\n[Blob](../base/blob.html) --- The data as a blob.\n\n*** ** * ** ***\n\n### `get``Blob()`\n\nReturn the data inside this object as a blob.\n\n#### Return\n\n\n[Blob](../base/blob.html) --- The data as a blob.\n\n*** ** * ** ***\n\n### `get``Options()`\n\nReturns the options for this chart, such as height, colors, and axes.\n\nThe returned options are immutable.\n\n#### Return\n\n\n[ChartOptions](/apps-script/reference/charts/chart-options) --- The options for this chart, such as height, colors, and axes."]]
