Excel.RangeFont class

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

bold: boolean;

プロパティ値

注釈

[ API セット: ExcelApi 1.1 ]

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

color: string;

プロパティ値

注釈

[ API セット: ExcelApi 1.1 ]

オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。

context: RequestContext;

プロパティ値

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

italic: boolean;

プロパティ値

注釈

[ API セット: ExcelApi 1.1 ]

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

name: string;

プロパティ値

注釈

[ API セット: ExcelApi 1.1 ]

例

// Change the font of the selected range to "Impact".
await Excel.run(async (context) => {
  const selection = context.workbook.getSelectedRange();
  selection.format.font.name = "Impact";
  await context.sync();
});

フォント サイズ。

size: number;

プロパティ値

注釈

[ API セット: ExcelApi 1.1 ]

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

strikethrough: boolean;

プロパティ値

注釈

[ API セット: ExcelApi 1.9 ]

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

subscript: boolean;

プロパティ値

注釈

[ API セット: ExcelApi 1.9 ]

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

superscript: boolean;

プロパティ値

注釈

[ API セット: ExcelApi 1.9 ]

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

tintAndShade: number;

プロパティ値

注釈

[ API セット: ExcelApi 1.9 ]

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

underline: Excel.RangeUnderlineStyle | "None" | "Single" | "Double" | "SingleAccountant" | "DoubleAccountant";

プロパティ値

注釈

[ API セット: ExcelApi 1.1 ]

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(options?: Excel.Interfaces.RangeFontLoadOptions): Excel.RangeFont;

パラメーター

戻り値

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNames?: string | string[]): Excel.RangeFont;

パラメーター

戻り値

例

await Excel.run(async (context) => { 
    const sheetName = "Sheet1";
    const rangeAddress = "F:G";
    const worksheet = context.workbook.worksheets.getItem(sheetName);
    const range = worksheet.getRange(rangeAddress);
    const rangeFont = range.format.font;
    rangeFont.load('name');
    await context.sync();
    console.log(rangeFont.name);
});

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.RangeFont;

パラメーター

戻り値

オブジェクトの複数のプロパティを同時に設定します。 適切なプロパティを持つプレーン オブジェクトまたは同じ型の別の API オブジェクトを渡すことができます。

set(properties: Interfaces.RangeFontUpdateData, options?: OfficeExtension.UpdateOptions): void;

パラメーター

戻り値

既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを同時に設定します。

set(properties: Excel.RangeFont): void;

パラメーター

戻り値

API オブジェクトがJSON.stringify()に渡されたときにより便利な出力を提供するために、JavaScript toJSON() メソッドをオーバーライドします。 (JSON.stringify、それに渡されるオブジェクトの toJSON メソッドを呼び出します)。元の Excel.RangeFont オブジェクトは API オブジェクトですが、 toJSON メソッドは、元のオブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト ( Excel.Interfaces.RangeFontData として型指定) を返します。

toJSON(): Excel.Interfaces.RangeFontData;

戻り値