سازنده برای CellImage . این سازنده مقدار تصویر مورد نیاز برای افزودن یک تصویر به یک سلول را ایجاد می کند.
خواص
| ویژگی | تایپ کنید | شرح |
|---|---|---|
valueType | ValueType | فیلدی که روی ValueType.IMAGE تنظیم شده است که نشان دهنده نوع مقدار تصویر است. |
مواد و روش ها
| روش | نوع برگشت | توضیح مختصر |
|---|---|---|
build() | CellImage | نوع مقدار تصویر مورد نیاز برای افزودن یک تصویر به یک سلول را ایجاد می کند. |
getAltTextDescription() | String | توضیحات متن جایگزین را برای این تصویر برمی گرداند. |
getAltTextTitle() | String | عنوان متن جایگزین را برای این تصویر برمی گرداند. |
getContentUrl() | String | یک URL میزبانی شده توسط Google را به تصویر برمی گرداند. |
getUrl() | String | آدرس منبع تصویر را دریافت می کند. اگر URL در دسترس نباشد، null برمی‌گرداند. |
setAltTextDescription(description) | CellImage | توضیحات متن جایگزین را برای این تصویر تنظیم می کند. |
setAltTextTitle(title) | CellImage | عنوان متن جایگزین را برای این تصویر تنظیم می کند. |
setSourceUrl(url) | CellImageBuilder | URL منبع تصویر را تنظیم می کند. |
toBuilder() | CellImageBuilder | سازنده ای ایجاد می کند که یک تصویر را به یک نوع مقدار تصویر تبدیل می کند تا بتوانید آن را در یک سلول قرار دهید. |
مستندات دقیق
build()
نوع مقدار تصویر مورد نیاز برای افزودن یک تصویر به یک سلول را ایجاد می کند. مقدار تصویر از ویژگی های تصویر اضافه شده به سازنده، مانند URL منبع ساخته می شود.
برگشت
CellImage - نمایشی از تصویر برای افزودن به یک سلول.
getAltTextDescription()
توضیحات متن جایگزین را برای این تصویر برمی گرداند.
برگشت
String - توضیحات متن جایگزین.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
عنوان متن جایگزین را برای این تصویر برمی گرداند.
برگشت
String - عنوان متن جایگزین.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getContentUrl()
یک URL میزبانی شده توسط Google را به تصویر برمی گرداند. این URL با حساب درخواست کننده برچسب گذاری شده است، بنابراین هر کسی که URL را داشته باشد به عنوان درخواست کننده اصلی به تصویر دسترسی پیدا می کند. در صورت تغییر تنظیمات اشتراک‌گذاری صفحه‌گسترده، ممکن است دسترسی به تصویر از بین برود. URL برگشتی پس از مدت کوتاهی منقضی می شود.
برگشت
String - نشانی اینترنتی تصویر که توسط گوگل میزبانی شده است.
getUrl()
آدرس منبع تصویر را دریافت می کند. اگر URL در دسترس نباشد، null برمی‌گرداند. اگر تصویر توسط URL با استفاده از یک API درج شده باشد، این روش URL ارائه شده در هنگام درج تصویر را برمی گرداند.
برگشت
String - URL تصویر در صورت موجود بودن؛ اگر تصویر در دسترس نباشد یا URL منبع نداشته باشد، null برمی‌گرداند.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setAltTextDescription(description)
توضیحات متن جایگزین را برای این تصویر تنظیم می کند.
مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
description | String | توضیحات متن جایگزین جدید برای تصویر. |
برگشت
CellImage - این تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setAltTextTitle(title)
عنوان متن جایگزین را برای این تصویر تنظیم می کند.
مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
title | String | عنوان متن جایگزین جدید برای تصویر. |
برگشت
CellImage - این تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setSourceUrl(url)
URL منبع تصویر را تنظیم می کند.
مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
url | String | URL برای تصویر. |
برگشت
CellImageBuilder - این سازنده، برای زنجیر کردن.
toBuilder()
سازنده ای ایجاد می کند که یک تصویر را به یک نوع مقدار تصویر تبدیل می کند تا بتوانید آن را در یک سلول قرار دهید. قبل از اینکه یک تصویر در یک سلول قرار گیرد، باید به عنوان یک نوع مقدار تصویر ایجاد شود. سپس می توانید با استفاده از Range.setValue(value) یا Range.setValues(values) آن را به یک سلول اضافه کنید.
برگشت
CellImageBuilder - سازنده ای که یک نوع مقدار تصویر را بر اساس ویژگی های تصویر داده شده ایجاد می کند.