Class CellImage

تصویر سلولی

مقدار تصویر را در یک سلول نشان می‌دهد. برای افزودن تصویر به یک سلول، باید با استفاده از SpreadsheetApp.newCellImage() و CellImageBuilder یک مقدار تصویر جدید برای تصویر ایجاد کنید. سپس می‌توانید Range.setValue(value) یا Range.setValues(values) برای افزودن مقدار تصویر به سلول استفاده کنید.

خواص

ملک نوع توضیحات
value Type Value Type نوع مقدار تصویر سلول، که Value Type.IMAGE است.

روش‌ها

روش نوع بازگشتی شرح مختصر
get Alt Text Description() String توضیحات متن جایگزین (alt text) را برای این تصویر برمی‌گرداند.
get Alt Text Title() String عنوان متن جایگزین (alt text) را برای این تصویر برمی‌گرداند.
get Content Url() String یک URL میزبانی شده توسط گوگل را به تصویر برمی‌گرداند.
to Builder() Cell Image Builder بر اساس ویژگی‌های تصویر فعلی، یک سازنده تصویر سلول ایجاد می‌کند.

مستندات دقیق

getAltTextDescription()

توضیحات متن جایگزین (alt text) را برای این تصویر برمی‌گرداند.

بازگشت

String - توضیحات متن جایگزین.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAltTextTitle()

عنوان متن جایگزین (alt text) را برای این تصویر برمی‌گرداند.

بازگشت

String - عنوان متن جایگزین.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getContentUrl()

یک URL میزبانی‌شده توسط گوگل را به تصویر برمی‌گرداند. این URL با حساب درخواست‌کننده برچسب‌گذاری شده است، بنابراین هر کسی که URL را داشته باشد، عملاً به عنوان درخواست‌کننده اصلی به تصویر دسترسی پیدا می‌کند. در صورت تغییر تنظیمات اشتراک‌گذاری صفحه گسترده، ممکن است دسترسی به تصویر از بین برود. URL برگردانده شده پس از مدت کوتاهی منقضی می‌شود.

const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  console.log(value.getContentUrl());
}

بازگشت

String - آدرس اینترنتی تصویر که توسط گوگل میزبانی شده است.

toBuilder()

بر اساس ویژگی‌های تصویر فعلی، یک سازنده تصویر سلول ایجاد می‌کند. از CellImageBuilder.setSourceUrl(url) برای تنظیم آدرس اینترنتی منبع تصویر جدید استفاده کنید. سپس می‌توانید آن را با استفاده از Range.setValue(value) یا Range.setValues(values) به یک سلول اضافه کنید.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const range = ss.getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  const newImage =
      value.toBuilder()
          .setSourceUrl(
              'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png',
              )
          .build();
  const newRange = ss.getRange("Sheet1!A2");
  newRange.setValue(newImage);
}

بازگشت

CellImageBuilder - سازنده‌ای که بر اساس ویژگی‌های تصویر داده شده، یک نوع مقدار تصویر ایجاد می‌کند.

متدهای منسوخ شده