Excel.Workbook class

このブックを含む Excel アプリケーション インスタンスを表します。

readonly application: Excel.Application;

プロパティ値

注釈

[API セット: ExcelApi 1.1]

ブックが自動保存モードかどうかを指定します。

readonly autoSave: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

ブックの一部であるバインドのコレクションを表します。

readonly bindings: Excel.BindingCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.1]

Excel 計算エンジンのバージョンとして数字を返します。

readonly calculationEngineVersion: number;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

関連付けられている実際のデータ ポイントをブックの全グラフが追跡している場合、true となります。 グラフがデータ ポイントのインデックスを追跡する場合は false。

chartDataPointTrack: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

ブックに関連付けられているコメントのコレクションを表します。

readonly comments: Excel.CommentCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.10]

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

context: RequestContext;

プロパティ値

このブックに含まれるカスタム XML パーツのコレクションを表します。

readonly customXmlParts: Excel.CustomXmlPartCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.5]

ブック内のすべてのデータ接続を表します。

readonly dataConnections: Excel.DataConnectionCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

計算に使用できるワークシート関数のコレクションを表します。

readonly functions: Excel.Functions;

プロパティ値

注釈

[API セット: ExcelApi 1.2]

ブックが最後に保存されてから変更が行われたかどうかを指定します。 変更したブックを保存せずに、または保存を求めるメッセージが表示されずに閉じる場合は、このプロパティを true に設定できます。

isDirty: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

ブックで使用可能なリンクされたエンティティ データ ドメインのコレクションを返します。

readonly linkedEntityDataDomains: Excel.LinkedEntityDataDomainCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.19]

ブックの名前を取得します。

readonly name: string;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

ブック スコープの名前付き項目 (名前付き範囲と定数) のコレクションを表します。

readonly names: Excel.NamedItemCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.1]

ブック内のすべてのノート オブジェクトのコレクションを返します。

readonly notes: Excel.NoteCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.18]

ブックに関連付けられているピボットテーブルのコレクションを表します。

readonly pivotTables: Excel.PivotTableCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.3]

ブックに関連付けられている PivotTableStyle のコレクションを表します。

readonly pivotTableStyles: Excel.PivotTableStyleCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.10]

ブックがローカルまたはオンラインのどちらに保存されたことがあるかを指定します。

readonly previouslySaved: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

ブックのプロパティを取得します。

readonly properties: Excel.DocumentProperties;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

ブックの保護オブジェクトを返します。

readonly protection: Excel.WorkbookProtection;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

ブックの一部である Power Query クエリのコレクションを返します。

readonly queries: Excel.QueryCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.14]

ブックが読み取り専用モードで開かれている場合は true を返します。

readonly readOnly: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.8]

ブックに関連付けられている設定のコレクションを表します。

readonly settings: Excel.SettingCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.4]

ブックに関連付けられているスライサーのコレクションを表します。

readonly slicers: Excel.SlicerCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.10]

ブックに関連付けられている SlicerStyle のコレクションを表します。

readonly slicerStyles: Excel.SlicerStyleCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.10]

ブックに関連付けられているスタイルのコレクションを表します。

readonly styles: Excel.StyleCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

ブックに関連付けられているテーブルのコレクションを表します。

readonly tables: Excel.TableCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.1]

ブックに関連付けられている TableStyle のコレクションを表します。

readonly tableStyles: Excel.TableStyleCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.10]

ブックに関連付けられている TimelineStyle のコレクションを表します。

readonly timelineStyles: Excel.TimelineStyleCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.10]

ブックを表示桁数でのみ計算する場合、true となります。 このプロパティを false から true に切り替えると、データの精度が完全に失われます。

usePrecisionAsDisplayed: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

ブックに関連付けられているワークシートのコレクションを表します。

readonly worksheets: Excel.WorksheetCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.1]

現在のブックを閉じます。

close(closeBehavior?: Excel.CloseBehavior): void;

パラメーター

返品

注釈

[API セット: ExcelApi 1.11]

現在のブックを閉じます。

close(closeBehavior?: "Save" | "SkipSave"): void;

パラメーター

返品

注釈

[API セット: ExcelApi 1.11]

ブックで現在アクティブなセルを取得します。

getActiveCell(): Excel.Range;

返品

注釈

[API セット: ExcelApi 1.7]

ブックで現在アクティブになっているグラフを取得します。 アクティブなグラフがない場合は、 ItemNotFound 例外がスローされます。

getActiveChart(): Excel.Chart;

返品

注釈

[API セット: ExcelApi 1.9]

ブックで現在アクティブになっているグラフを取得します。 アクティブなグラフがない場合、このメソッドは isNullObject プロパティが true に設定されたオブジェクトを返します。 詳細については、「 *OrNullObject のメソッドとプロパティ」を参照してください。

getActiveChartOrNullObject(): Excel.Chart;

返品

注釈

[API セット: ExcelApi 1.9]

ブック内のアクティブな図形を取得します。 アクティブな図形がない場合は ItemNotFound エラーをスローします。

getActiveShape(): Excel.Shape;

返品

注釈

[API セット: ExcelApi 1.19]

ブック内のアクティブな図形を取得します。 アクティブな図形がない場合、このメソッドは isNullObject プロパティが true に設定されたオブジェクトを返します。 詳細については、「 *OrNullObject のメソッドとプロパティ」を参照してください。

getActiveShapeOrNullObject(): Excel.Shape;

返品

注釈

[API セット: ExcelApi 1.19]

ブックで現在アクティブになっているスライサーを取得します。 アクティブなスライサーがない場合は、 ItemNotFound 例外がスローされます。

getActiveSlicer(): Excel.Slicer;

返品

注釈

[API セット: ExcelApi 1.10]

ブックで現在アクティブになっているスライサーを取得します。 アクティブなスライサーがない場合、このメソッドは isNullObject プロパティが true に設定されたオブジェクトを返します。 詳細については、「 *OrNullObject のメソッドとプロパティ」を参照してください。

getActiveSlicerOrNullObject(): Excel.Slicer;

返品

注釈

[API セット: ExcelApi 1.10]

ブックが複数のユーザーによって (共同編集により) 編集されている場合は true を返します。 ブックの状態が変更されてから、その変更がメソッドの結果に反映されるまでに多少の時間がかかる場合があることに注意してください。

getIsActiveCollabSession(): OfficeExtension.ClientResult<boolean>;

返品

注釈

[API セット: ExcelApi 1.9]

指定されたLinkedEntityIdに基づいてLinkedEntityCellValueを返します。

getLinkedEntityCellValue(linkedEntityCellValueId: LinkedEntityId): OfficeExtension.ClientResult<LinkedEntityCellValue>;

パラメーター

返品

注釈

[API セット: ExcelApi 1.16]

現在選択されている単一の範囲をブックから取得します。 複数の範囲が選択されている場合、このメソッドはエラーをスローします。

getSelectedRange(): Excel.Range;

返品

注釈

[API セット: ExcelApi 1.1]

ブックから現在選択されている 1 つまたは複数の範囲を取得します。 getSelectedRange() とは異なり、このメソッドは、選択したすべての範囲を表す RangeAreas オブジェクトを返します。

getSelectedRanges(): Excel.RangeAreas;

返品

注釈

[API セット: ExcelApi 1.9]

指定したワークシートをソース ブックから現在のブックに挿入します。

extensionHardening Windows レジストリ キーは、この API に影響します。 base64File パラメーターによって定義されたファイル拡張子は、挿入されたファイルの実際のファイルの種類と一致する必要があります。 extensionHardeningが不一致を拒否するように設定されており、ファイル拡張子が実際のファイルの種類と一致しない場合、この API は次のエラーをスローします: "拡張子の強化ポリシーにより、この操作は許可されていません。"

insertWorksheetsFromBase64(base64File: string, options?: Excel.InsertWorksheetOptions): OfficeExtension.ClientResult<string[]>;

パラメーター

返品

新しく挿入された各ワークシートに対応する ID の配列。

注釈

[API セット: ExcelApi 1.13]

この API は現在、Windows 版、Mac 版、Web 版の Office でのみサポートされています。 Excel on the web では、この API はグラフ、コメント、ピボットテーブル、またはスライサーの挿入をサポートしていません。

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

load(options?: Excel.Interfaces.WorkbookLoadOptions): Excel.Workbook;

パラメーター

返品

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

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

パラメーター

返品

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

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

パラメーター

返品

現在のブックを保存します。

save(saveBehavior?: Excel.SaveBehavior): void;

パラメーター

返品

注釈

[API セット: ExcelApi 1.11]

現在のブックを保存します。

save(saveBehavior?: "Save" | "Prompt"): void;

パラメーター

返品

注釈

[API セット: ExcelApi 1.11]

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

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

パラメーター

返品

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

set(properties: Excel.Workbook): void;

パラメーター

返品

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

toJSON(): Excel.Interfaces.WorkbookData;

返品

ブックがアクティブ化されたときに発生します。 注: ブックが開かれたときに、このイベントは発生しません。

readonly onActivated: OfficeExtension.EventHandlers<Excel.WorkbookActivatedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.13]

ブックの自動保存設定が変更されたときに発生します。

readonly onAutoSaveSettingChanged: OfficeExtension.EventHandlers<Excel.WorkbookAutoSaveSettingChangedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.9]

ドキュメント内で選択が変更されるときに発生します。

readonly onSelectionChanged: OfficeExtension.EventHandlers<Excel.SelectionChangedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.2]