ExcelScript.RangeFont interface

フォントの太字の状態を表します。

getBold(): boolean;

戻り値

テキストの色の HTML カラー コード表現 (たとえば、#FF0000 は赤を表します)。

getColor(): string;

戻り値

フォントの斜体の状態を指定します。

getItalic(): boolean;

戻り値

フォント名 ("Calibri" など)。 名前の長さは 31 文字を超えてはなりません。

getName(): string;

戻り値

フォント サイズ。

getSize(): number;

戻り値

フォントの取り消し線の状態を指定します。 null値は、範囲全体に均一な取り消し線設定がないことを示します。

getStrikethrough(): boolean;

戻り値

フォントの添字の状態を指定します。 範囲のすべてのフォントが添字である場合は、 true を返します。 範囲のすべてのフォントが上付きまたは標準 (上付き文字も下付き文字もない) の場合は、 false を返します。 それ以外の場合は null を返します。

getSubscript(): boolean;

戻り値

フォントの上付き文字の状態を指定します。 範囲のすべてのフォントが上付きである場合は、 true を返します。 範囲のすべてのフォントが添字または標準 (上付き文字も下付き文字もない) の場合は、 false を返します。 それ以外の場合は null を返します。

getSuperscript(): boolean;

戻り値

範囲フォントの色を明るくまたは暗くする倍精度浮動小数点型 (double) を指定します。 値は -1 (最も暗い) から 1 (最も明るい) の間で、元の色の場合は 0 です。 null値は、範囲全体に均一なフォントtintAndShade設定がないことを示します。

getTintAndShade(): number;

戻り値

フォントに適用する下線の種類。 詳細は「ExcelScript.RangeUnderlineStyle」をご覧ください。

getUnderline(): RangeUnderlineStyle;

戻り値

フォントの太字の状態を表します。

setBold(bold: boolean): void;

パラメーター

戻り値

例

/**
 * This script bolds the text of cell A1.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Bold the font for that cell
  cell.getFormat().getFont().setBold(true);
}

テキストの色の HTML カラー コード表現 (たとえば、#FF0000 は赤を表します)。

setColor(color: string): void;

パラメーター

戻り値

フォントの斜体の状態を指定します。

setItalic(italic: boolean): void;

パラメーター

戻り値

フォント名 ("Calibri" など)。 名前の長さは 31 文字を超えてはなりません。

setName(name: string): void;

パラメーター

戻り値

例

/**
 * This script sets the font style of A1 to Arial.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Adjust the font settings for that cell.
  cell.getFormat().getFont().setName("Arial");
}

フォント サイズ。

setSize(size: number): void;

パラメーター

戻り値

例

/**
 * This script sets the font size of A1 to 16.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Adjust the font settings for that cell.clear
  cell.getFormat().getFont().setSize(16);
}

フォントの取り消し線の状態を指定します。 null値は、範囲全体に均一な取り消し線設定がないことを示します。

setStrikethrough(strikethrough: boolean): void;

パラメーター

戻り値

フォントの添字の状態を指定します。 範囲のすべてのフォントが添字である場合は、 true を返します。 範囲のすべてのフォントが上付きまたは標準 (上付き文字も下付き文字もない) の場合は、 false を返します。 それ以外の場合は null を返します。

setSubscript(subscript: boolean): void;

パラメーター

戻り値

フォントの上付き文字の状態を指定します。 範囲のすべてのフォントが上付きである場合は、 true を返します。 範囲のすべてのフォントが添字または標準 (上付き文字も下付き文字もない) の場合は、 false を返します。 それ以外の場合は null を返します。

setSuperscript(superscript: boolean): void;

パラメーター

戻り値

範囲フォントの色を明るくまたは暗くする倍精度浮動小数点型 (double) を指定します。 値は -1 (最も暗い) から 1 (最も明るい) の間で、元の色の場合は 0 です。 null値は、範囲全体に均一なフォントtintAndShade設定がないことを示します。

setTintAndShade(tintAndShade: number): void;

パラメーター

戻り値

フォントに適用する下線の種類。 詳細は「ExcelScript.RangeUnderlineStyle」をご覧ください。

setUnderline(underline: RangeUnderlineStyle): void;

パラメーター

戻り値