Excel.ConditionalRangeFont class

このオブジェクトは、オブジェクトのフォント属性 (フォント スタイル、色など) を表します。

Extends

注釈

[ API セット: ExcelApi 1.6 ]

プロパティ

bold

フォントが太字かどうかを指定します。

color

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

context

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

italic

フォントが斜体かどうかを指定します。

strikethrough

フォントの取り消し線の状態を指定します。

underline

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

メソッド

clear()

フォントの書式設定をリセットします。

load(options)

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

load(propertyNames)

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

load(propertyNamesAndPaths)

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

set(properties, options)

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

set(properties)

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

toJSON()

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

プロパティの詳細

bold

フォントが太字かどうかを指定します。

bold: boolean;

プロパティ値

boolean

注釈

[ API セット: ExcelApi 1.6 ]

color

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

color: string;

プロパティ値

string

注釈

[ API セット: ExcelApi 1.6 ]

context

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

context: RequestContext;

プロパティ値

italic

フォントが斜体かどうかを指定します。

italic: boolean;

プロパティ値

boolean

注釈

[ API セット: ExcelApi 1.6 ]

strikethrough

フォントの取り消し線の状態を指定します。

strikethrough: boolean;

プロパティ値

boolean

注釈

[ API セット: ExcelApi 1.6 ]

underline

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

underline: Excel.ConditionalRangeFontUnderlineStyle | "None" | "Single" | "Double";

プロパティ値

Excel.ConditionalRangeFontUnderlineStyle | "None" | "Single" | "Double"

注釈

[ API セット: ExcelApi 1.6 ]

メソッドの詳細

clear()

フォントの書式設定をリセットします。

clear(): void;

戻り値

void

注釈

[ API セット: ExcelApi 1.6 ]

load(options)

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

load(options?: Excel.Interfaces.ConditionalRangeFontLoadOptions): Excel.ConditionalRangeFont;

パラメーター

options
Excel.Interfaces.ConditionalRangeFontLoadOptions

読み込むオブジェクトのプロパティのオプションを提供します。

戻り値

load(propertyNames)

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

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

パラメーター

propertyNames

string | string[]

読み込むプロパティを指定するコンマ区切り文字列または文字列の配列。

戻り値

load(propertyNamesAndPaths)

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

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

パラメーター

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select は読み込むプロパティを指定するコンマ区切りの文字列で、 propertyNamesAndPaths.expand は読み込むナビゲーション プロパティを指定するコンマ区切りの文字列です。

戻り値

set(properties, options)

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

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

パラメーター

properties
Excel.Interfaces.ConditionalRangeFontUpdateData

メソッドが呼び出されるオブジェクトのプロパティに等形的に構造化されたプロパティを持つ JavaScript オブジェクト。

options
OfficeExtension.UpdateOptions

properties オブジェクトが読み取り専用プロパティを設定しようとした場合にエラーを抑制するオプションを提供します。

戻り値

void

set(properties)

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

set(properties: Excel.ConditionalRangeFont): void;

パラメーター

戻り値

void

toJSON()

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

toJSON(): Excel.Interfaces.ConditionalRangeFontData;

戻り値