ExcelScript.ShapeFont interface

Пакет:

ExcelScript

Представляет атрибуты шрифта, такие как имя шрифта, размер шрифта и цвет, для объекта фигуры TextRange .

Замечания

Примеры

/**
 * 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);
}

Методика

getBold()	Указывает, является ли шрифт полужирным. Возвращает значение null , если содержит TextRange как полужирные, так и не полужирные фрагменты текста.
getColor()	Представление цветового кода HTML для цвета текста (например, "#FF0000" представляет красный цвет). Возвращает значение null , если объект TextRange содержит фрагменты текста с разными цветами.
getItalic()	Указывает, применяется ли курсив. Возвращает значение null , если содержит TextRange как курсивные, так и не курсивные фрагменты текста.
getName()	Представляет имя шрифта (например, "Calibri"). Если текст является сложным или восточноазиатским языком, это соответствующее имя шрифта; в противном случае это латинское имя шрифта.
getSize()	Представляет размер шрифта в пунктах (например, 11). Возвращает значение null , если объект TextRange содержит фрагменты текста с разными размерами шрифта.
getUnderline()	Тип подчеркивания, применяемый для шрифта. Возвращает значение null , если объект TextRange содержит фрагменты текста с разными стилями подчеркивания. Дополнительные сведения см. в этой ExcelScript.ShapeFontUnderlineStyle статье.
setBold(bold)	Указывает, является ли шрифт полужирным. Возвращает значение null , если содержит TextRange как полужирные, так и не полужирные фрагменты текста.
setColor(color)	Представление цветового кода HTML для цвета текста (например, "#FF0000" представляет красный цвет). Возвращает значение null , если объект TextRange содержит фрагменты текста с разными цветами.
setItalic(italic)	Указывает, применяется ли курсив. Возвращает значение null , если содержит TextRange как курсивные, так и не курсивные фрагменты текста.
setName(name)	Представляет имя шрифта (например, "Calibri"). Если текст является сложным или восточноазиатским языком, это соответствующее имя шрифта; в противном случае это латинское имя шрифта.
setSize(size)	Представляет размер шрифта в пунктах (например, 11). Возвращает значение null , если объект TextRange содержит фрагменты текста с разными размерами шрифта.
setUnderline(underline)	Тип подчеркивания, применяемый для шрифта. Возвращает значение null , если объект TextRange содержит фрагменты текста с разными стилями подчеркивания. Дополнительные сведения см. в этой ExcelScript.ShapeFontUnderlineStyle статье.

Подробнее о методе

getBold()

Указывает, является ли шрифт полужирным. Возвращает значение null , если содержит TextRange как полужирные, так и не полужирные фрагменты текста.

getBold(): boolean;

Возвращает

boolean

getColor()

Представление цветового кода HTML для цвета текста (например, "#FF0000" представляет красный цвет). Возвращает значение null , если объект TextRange содержит фрагменты текста с разными цветами.

getColor(): string;

Возвращает

string

getItalic()

Указывает, применяется ли курсив. Возвращает значение null , если содержит TextRange как курсивные, так и не курсивные фрагменты текста.

getItalic(): boolean;

Возвращает

boolean

getName()

Представляет имя шрифта (например, "Calibri"). Если текст является сложным или восточноазиатским языком, это соответствующее имя шрифта; в противном случае это латинское имя шрифта.

getName(): string;

Возвращает

string

getSize()

Представляет размер шрифта в пунктах (например, 11). Возвращает значение null , если объект TextRange содержит фрагменты текста с разными размерами шрифта.

getSize(): number;

Возвращает

number

getUnderline()

Тип подчеркивания, применяемый для шрифта. Возвращает значение null , если объект TextRange содержит фрагменты текста с разными стилями подчеркивания. Дополнительные сведения см. в этой ExcelScript.ShapeFontUnderlineStyle статье.

getUnderline(): ShapeFontUnderlineStyle;

Возвращает

ExcelScript.ShapeFontUnderlineStyle

setBold(bold)

Указывает, является ли шрифт полужирным. Возвращает значение null , если содержит TextRange как полужирные, так и не полужирные фрагменты текста.

setBold(bold: boolean): void;

Параметры

bold

boolean

Возвращает

void

setColor(color)

Представление цветового кода HTML для цвета текста (например, "#FF0000" представляет красный цвет). Возвращает значение null , если объект TextRange содержит фрагменты текста с разными цветами.

setColor(color: string): void;

Параметры

color

string

Возвращает

void

setItalic(italic)

Указывает, применяется ли курсив. Возвращает значение null , если содержит TextRange как курсивные, так и не курсивные фрагменты текста.

setItalic(italic: boolean): void;

Параметры

italic

boolean

Возвращает

void

setName(name)

Представляет имя шрифта (например, "Calibri"). Если текст является сложным или восточноазиатским языком, это соответствующее имя шрифта; в противном случае это латинское имя шрифта.

setName(name: string): void;

Параметры

name

string

Возвращает

void

setSize(size)

Представляет размер шрифта в пунктах (например, 11). Возвращает значение null , если объект TextRange содержит фрагменты текста с разными размерами шрифта.

setSize(size: number): void;

Параметры

size

number

Возвращает

void

setUnderline(underline)

Тип подчеркивания, применяемый для шрифта. Возвращает значение null , если объект TextRange содержит фрагменты текста с разными стилями подчеркивания. Дополнительные сведения см. в этой ExcelScript.ShapeFontUnderlineStyle статье.

setUnderline(underline: ShapeFontUnderlineStyle): void;

Параметры

underline

ExcelScript.ShapeFontUnderlineStyle

Возвращает

void