Class CellImage

تصویر سلولی

یک مقدار تصویر را در یک سلول نشان می دهد. برای افزودن یک تصویر به یک سلول، باید با استفاده از Spreadsheet App.newCellImage() و Cell Image Builder یک مقدار تصویر جدید برای تصویر ایجاد کنید. سپس می توانید از Range.setValue(value) یا Range.setValues(values) برای اضافه کردن مقدار تصویر به سلول استفاده کنید.

خواص

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

روش ها

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

مستندات دقیق

get Alt Text Description()

توضیحات متن جایگزین را برای این تصویر برمی گرداند.

بازگشت

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

مجوز

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

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

get Alt Text Title()

عنوان متن جایگزین را برای این تصویر برمی گرداند.

بازگشت

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

مجوز

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

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

get Content Url()

URL میزبانی شده توسط Google را به تصویر برمی گرداند. این 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 - نشانی اینترنتی تصویر که توسط گوگل میزبانی شده است.

to Builder()

یک سازنده تصویر سلولی بر اساس ویژگی های تصویر فعلی ایجاد می کند. از Cell Image Builder.setSourceUrl(url) برای تنظیم 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);
}

بازگشت

Cell Image Builder - سازنده ای که یک نوع مقدار تصویر را بر اساس ویژگی های تصویر داده شده ایجاد می کند.

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