Class PictureFill
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پر کردن تصویر پرکننده‌ای که تصویری را به‌اندازه‌ی ظرفش کشیده است.
مستندات دقیق
get As(contentType)
داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. این روش پسوند مناسب را به نام فایل اضافه می کند - به عنوان مثال، "myfile.pdf". با این حال، فرض می‌کند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل می شود.
برای مشاهده سهمیه های روزانه برای تبدیل، به سهمیه خدمات Google مراجعه کنید. دامنه‌های جدید Google Workspace ممکن است به طور موقت مشمول سهمیه‌های سخت‌گیرانه‌تر شوند.
پارامترها
| نام | تایپ کنید | توضیحات |
|---|
content Type | String | نوع MIME برای تبدیل. برای اکثر حباب‌ها، 'application/pdf' تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از 'image/bmp' ، 'image/gif' ، 'image/jpeg' یا 'image/png' نیز معتبر هستند. برای سند Google Docs، 'text/markdown' نیز معتبر است. |
بازگشت
Blob - داده ها به عنوان یک لکه.
get Blob()
داده های داخل این شی را به صورت حباب برگردانید.
بازگشت
Blob - داده ها به عنوان یک لکه.
get Content Url()
یک URL برای تصویر دریافت می کند.
این URL با حساب درخواست کننده برچسب گذاری شده است، بنابراین هر کسی که URL را داشته باشد به عنوان درخواست کننده اصلی به تصویر دسترسی پیدا می کند. در صورت تغییر تنظیمات اشتراک‌گذاری ارائه، ممکن است دسترسی به تصویر از بین برود. URL پس از مدت کوتاهی منقضی می شود.
بازگشت
String
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Source Url()
در صورت موجود بودن، نشانی اینترنتی منبع تصویر را دریافت می کند.
هنگامی که یک تصویر توسط URL درج می شود، URL ارائه شده در هنگام درج تصویر را برمی گرداند.
بازگشت
String - نشانی وب تصویر یا اگر تصویر دارای URL منبع نباشد، null
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003ePictureFill is a tool that stretches an image to fit the dimensions of its container.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods like \u003ccode\u003egetAs\u003c/code\u003e, \u003ccode\u003egetBlob\u003c/code\u003e, \u003ccode\u003egetContentUrl\u003c/code\u003e, and \u003ccode\u003egetSourceUrl\u003c/code\u003e to manipulate the image data and URLs.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetContentUrl\u003c/code\u003e and \u003ccode\u003egetSourceUrl\u003c/code\u003e methods require specific authorization scopes for use.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003egetContentUrl\u003c/code\u003e provides a temporary, access-controlled image URL, \u003ccode\u003egetSourceUrl\u003c/code\u003e retrieves the original URL if the image was inserted via URL.\u003c/p\u003e\n"]]],["PictureFill renders an image stretched to its container's dimensions. Key actions include: `getAs(contentType)` returning blob data converted to a specified type, with filename adjustments; `getBlob()` returning data as a blob; `getContentUrl()` retrieving a URL to the image, expiring after a short time and tied to the requester's account. Lastly, `getSourceUrl()` fetches the original image's source URL, if available, otherwise returning null. These method are accessible if authorized by the correct scopes.\n"],null,["# Class PictureFill\n\nPictureFill\n\nA fill that renders an image that's stretched to the dimensions of its container. \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| [getContentUrl()](#getContentUrl()) | `String` | Gets a URL to the image. |\n| [getSourceUrl()](#getSourceUrl()) | `String` | Gets the image's source URL, if available. |\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``Content``Url()`\n\nGets a URL to the image.\n\nThis URL is tagged with the account of the requester, so anyone with the URL effectively\naccesses the image as the original requester. Access to the image may be lost if the\npresentation's sharing settings change. The URL expires after a short period of time.\n\n#### Return\n\n\n`String`\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Source``Url()`\n\nGets the image's source URL, if available.\n\nWhen an image is inserted by URL, returns the URL provided during image insertion.\n\n#### Return\n\n\n`String` --- the image URL or `null` if the image does not have a source URL\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`"]]
