ExcelScript.TextRange interface

Пакет:

ExcelScript

Содержит текст, присоединенный к фигуре, в дополнение к свойствам и методам для управления текстом.

Комментарии

Примеры

/**
 * This script adds text to a shape.
 */
function main(workbook: ExcelScript.Workbook) {
  // Create a hexagon shape in the current worksheet.
  const sheet = workbook.getActiveWorksheet();
  const hexagon = sheet.addGeometricShape(ExcelScript.GeometricShapeType.hexagon);
  
  // Set the text of the shape.
  const hexText: ExcelScript.TextRange = hexagon.getTextFrame().getTextRange();
  hexText.setText("Forest");
}

Методы

getFont()	ShapeFont Возвращает объект , представляющий атрибуты шрифта для текстового диапазона.
getSubstring(start, length)	Возвращает объект TextRange для подстроки в указанном диапазоне.
getText()	Представляет содержимое с обычным текстом в диапазоне текста.
setText(text)	Представляет содержимое с обычным текстом в диапазоне текста.

Сведения о методе

getFont()

ShapeFont Возвращает объект , представляющий атрибуты шрифта для текстового диапазона.

getFont(): ShapeFont;

Возвращаемое значение

ExcelScript.ShapeFont

Примеры

/**
 * This sample sets the font of a shape to be bold. 
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first shape in the current worksheet.
  const sheet = workbook.getActiveWorksheet();
  const shape = sheet.getShapes()[0];

  // Get the text font from the shape.
  const text: ExcelScript.TextRange = shape.getTextFrame().getTextRange();
  const shapeTextFont: ExcelScript.ShapeFont = text.getFont();

  // Set the font to be bold.
  shapeTextFont.setBold(true);
}

getSubstring(start, length)

Возвращает объект TextRange для подстроки в указанном диапазоне.

getSubstring(start: number, length?: number): TextRange;

Параметры

start

number

Отсчитываемый от нуля индекс первого символа, который будет получен из текстового диапазона.

length

number

Необязательный параметр. Количество символов, возвращаемых в новом текстовом диапазоне. Если длина опущена, будут возвращены все символы от начала до конца последнего абзаца текстового диапазона.

Возвращаемое значение

ExcelScript.TextRange

getText()

Представляет содержимое с обычным текстом в диапазоне текста.

getText(): string;

Возвращаемое значение

string

Примеры

/**
 * This script writes all the text from the workbook's geometric shapes in a new worksheet.
 */
function main(workbook: ExcelScript.Workbook) {
  // Create a new worksheet.
  const shapeTextSheet = workbook.addWorksheet("ShapeText");
  let shapeTextValues: string[][] = [];

  // Get the text from every geometric shape in every worksheet.
  workbook.getWorksheets().forEach((sheet) => {
    sheet.getShapes().forEach((shape) => {
      if (shape.getType() === ExcelScript.ShapeType.geometricShape)
      shapeTextValues.push([
        sheet.getName(),
        shape.getGeometricShapeType().toString(),
        shape.getTextFrame().getTextRange().getText()]);
    });
  });

  // Add the text to the new worksheet.
  const range = shapeTextSheet.getRangeByIndexes(
    0,
    0, 
    shapeTextValues.length, 
    shapeTextValues[0].length);
  range.setValues(shapeTextValues);
}

setText(text)

Представляет содержимое с обычным текстом в диапазоне текста.

setText(text: string): void;

Параметры

text

string

Возвращаемое значение

void