Class CellImageBuilder

سازنده تصویر سلول

سازنده برای CellImage . این سازنده مقدار تصویر مورد نیاز برای افزودن تصویر به یک سلول را ایجاد می‌کند.

خواص

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

روش‌ها

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

مستندات دقیق

build()

نوع مقدار تصویر مورد نیاز برای افزودن تصویر به یک سلول را ایجاد می‌کند. مقدار تصویر از ویژگی‌های تصویر اضافه شده به سازنده، مانند URL منبع، ساخته می‌شود.

بازگشت

CellImage - نمایشی از تصویر برای اضافه کردن به یک سلول.

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

setAltTextDescription(description)

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

پارامترها

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

بازگشت

CellImage — این تصویر، برای زنجیره‌سازی.

مجوز

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

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

setAltTextTitle(title)

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

پارامترها

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

بازگشت

CellImage — این تصویر، برای زنجیره‌سازی.

مجوز

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

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

setSourceUrl(url)

آدرس منبع تصویر (URL) را تنظیم می‌کند.

پارامترها

نام نوع توضیحات
url String آدرس اینترنتی (URL) تصویر.

بازگشت

CellImageBuilder — این سازنده، برای زنجیره‌سازی.

toBuilder()

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

بازگشت

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

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