ExcelScript.Workbook interface

パッケージ:

ExcelScript

ブックは、ワークシート、テーブル、範囲などの関連するブック オブジェクトを含む最上位のオブジェクトです。

注釈

例

/**
 * This script adds a new worksheet to the workbook, then switches to it.
 */
function main(workbook: ExcelScript.Workbook) {
  // Add a new worksheet with the default name.
  let worksheet = workbook.addWorksheet();

  // Switch focus to the new worksheet.
  worksheet.activate();
}

メソッド

addBinding(range, bindingType, id)	特定の範囲に新しいバインドを追加します。
addBindingFromNamedItem(name, bindingType, id)	ブック内の名前付きアイテムに基づいて新しいバインドを追加します。 名前付き項目が複数の領域を参照している場合、 InvalidReference エラーが返されます。
addBindingFromSelection(bindingType, id)	現在の選択範囲に基づいて新しいバインドを追加します。 選択範囲に複数の領域がある場合は、 InvalidReference エラーが返されます。
addComment(cellAddress, content, contentType)	指定したセルで、指定した内容の新しいコメントを作成します。 指定 InvalidArgument された範囲が 1 つのセルより大きい場合、エラーがスローされます。
addCustomXmlPart(xml)	ブックに新しいカスタム XML パーツを追加します。
addNamedItem(name, reference, comment)	指定のスコープのコレクションに新しい名前を追加します。
addNamedItemFormulaLocal(name, formula, comment)	ユーザーのロケールを数式に使用して、指定のスコープのコレクションに新しい名前を追加します。
addPivotTable(name, source, destination)	指定したソース データに基づいてピボットテーブルを追加し、変換先範囲の左上のセルに挿入します。
addPivotTableStyle(name, makeUniqueName)	指定した名前の空白 PivotTableStyle を作成します。
addPredefinedCellStyle(name)	コレクションに新しいスタイルを追加します。
addSlicer(slicerSource, sourceField, slicerDestination)	ブックに新しいスライサーを追加します。
addSlicerStyle(name, makeUniqueName)	指定した名前の空白スライサー スタイルを作成します。
addTable(address, hasHeaders)	新しいテーブルを作成します。 範囲オブジェクトまたはソース アドレスにより、テーブルが追加されるワークシートが判断されます。 テーブルが追加できない場合 (たとえば、アドレスが無効な場合や、テーブルが別のテーブルと重複している場合) は、エラーがスローされます。
addTableStyle(name, makeUniqueName)	指定した名前の空白 TableStyle を作成します。
addTimelineStyle(name, makeUniqueName)	指定した名前の空白 TimelineStyle を作成します。
addWorksheet(name)	新しいワークシートをブックに追加します。 ワークシートは、既存のワークシートの末尾に追加されます。 新しく追加したワークシートをアクティブ化する場合は、 を呼び出 .activate() します。
breakAllLinksToLinkedWorkbooks()	リンクされたブックへのリンクをすべて解除します。 リンクが破損すると、ブック リンクを参照するすべての数式が完全に削除され、最後に取得された値に置き換えられます。
getActiveCell()	ブックで現在アクティブなセルを取得します。
getActiveChart()	ブックで現在アクティブになっているグラフを取得します。 アクティブなグラフがない場合、このメソッドは を返します undefined。
getActiveSlicer()	ブックで現在アクティブになっているスライサーを取得します。 アクティブなスライサーがない場合、このメソッドは を返します undefined。
getActiveWorksheet()	ブックの、現在作業中のワークシートを取得します。
getApplication()	このブックを含む Excel アプリケーション インスタンスを表します。
getAutoSave()	ブックが自動保存モードかどうかを指定します。
getBinding(id)	ID を使用してバインド オブジェクトを取得します。 バインド オブジェクトが存在しない場合、このメソッドは を返します undefined。
getBindings()	ブックの一部であるバインドのコレクションを表します。
getCalculationEngineVersion()	Excel 計算エンジンのバージョンとして数字を返します。
getChartDataPointTrack()	関連付けられている実際のデータ ポイントをブックの全グラフが追跡している場合、true となります。 False の場合、グラフは、データ ポイントのインデックスを追跡します。
getComment(commentId)	ID に基づいてコレクションからコメントを取得します。 コメント オブジェクトが存在しない場合、このメソッドは を返します undefined。
getCommentByCell(cellAddress)	指定したセルからコメントを取得します。 セルにコメントがない場合は、エラーがスローされます。
getCommentByReplyId(replyId)	指定された応答が接続されているコメントを取得します。
getComments()	ブックに関連付けられているコメントのコレクションを表します。
getCustomXmlPart(id)	ID に基づいて、カスタム XML パーツを取得します。 CustomXmlPartが存在しない場合、このメソッドは を返しますundefined。
getCustomXmlPartByNamespace(namespaceUri)	名前空間が指定された名前空間と一致するカスタム XML パーツの新しいコレクションを取得します。
getCustomXmlParts()	このブックに含まれるカスタム XML パーツのコレクションを表します。
getCustomXmlPartsByNamespace(namespaceUri)	名前空間が指定された名前空間と一致するカスタム XML パーツの新しいコレクションを取得します。
getDefaultPivotTableStyle()	親オブジェクトのスコープの既定のピボットテーブル スタイルを取得します。
getDefaultSlicerStyle()	親オブジェクトのスコープの既定値 SlicerStyle を取得します。
getDefaultTableStyle()	親オブジェクトのスコープの既定のテーブル スタイルを取得します。
getDefaultTimelineStyle()	親オブジェクトのスコープの既定のタイムライン スタイルを取得します。
getFirstWorksheet(visibleOnly)	コレクション内の最初のワークシートを取得します。
getIsDirty()	ブックが最後に保存されてから変更が加えられたかどうかを指定します。 このプロパティを に true 設定すると、変更したブックを保存せずに閉じるか、保存するように求められます。
getLastWorksheet(visibleOnly)	コレクション内の最後のワークシートを取得します。
getLinkedWorkbookByUrl(key)	リンクされたブックに関する情報を URL で取得します。 ブックが存在しない場合、このメソッドは を返します undefined。
getLinkedWorkbookRefreshMode()	ブック リンクの更新モードを表します。 このモードは、ブックに存在するすべてのブック リンクで同じです。
getLinkedWorkbooks()	リンクされたブックのコレクションを返します。 数式では、ブック リンクを使用して、現在のブックの外部にあるデータ (セル値と名前) を参照できます。
getName()	ブックの名前を取得します。
getNamedItem(name)	名前を NamedItem 使用してオブジェクトを取得します。 オブジェクトが存在しない場合、このメソッドは を返します undefined。
getNames()	ブックスコープの名前付き項目 (名前付き範囲と定数) のコレクションを表します。
getPivotTable(name)	名前に基づいてピボットテーブルを取得します。 ピボットテーブルが存在しない場合、このメソッドは を返します undefined。
getPivotTables()	ブックに関連付けられているピボットテーブルのコレクションを表します。
getPivotTableStyle(name)	名前で を PivotTableStyle 取得します。 PivotTableStyleが存在しない場合、このメソッドは を返しますundefined。
getPivotTableStyles()	ブックに関連付けられている PivotTableStyle のコレクションを表します。
getPredefinedCellStyle(name)	名前に基づいてスタイルを取得します。 style オブジェクトが存在しない場合、このメソッドは を返します undefined。
getPredefinedCellStyles()	ブックに関連付けられているスタイルのコレクションを表します。
getPreviouslySaved()	ブックがローカルまたはオンラインで保存されたかどうかを指定します。
getProperties()	ブックのプロパティを取得します。
getProtection()	ブックの保護オブジェクトを返します。
getQueries()	ブックの一部であるPower Queryクエリのコレクションを返します。
getQuery(key)	コレクションの名前に基づいてクエリを取得します。
getReadOnly()	ブックが true 読み取り専用モードで開いている場合は を返します。
getSelectedRange()	ブックから現在選択されている 1 つの範囲を取得します。 複数の範囲が選択されている場合、このメソッドはエラーをスローします。
getSelectedRanges()	ブックから現在選択されている 1 つまたは複数の範囲を取得します。 とは異なり getSelectedRange()、このメソッドは RangeAreas 、選択したすべての範囲を表す オブジェクトを返します。
getSlicer(key)	名前または ID を使用してスライサーを取得します。 スライサーが存在しない場合、このメソッドは を返します undefined。
getSlicers()	ブックに関連付けられているスライサーのコレクションを表します。
getSlicerStyle(name)	名前で を SlicerStyle 取得します。 スライサー スタイルが存在しない場合、このメソッドは を返します undefined。
getSlicerStyles()	ブックに関連付けられている SlicerStyle のコレクションを表します。
getTable(key)	名前または ID でテーブルを取得します。 テーブルが存在しない場合、このメソッドは を返します undefined。
getTables()	ブックに関連付けられているテーブルのコレクションを表します。
getTableStyle(name)	名前で を TableStyle 取得します。 テーブル スタイルが存在しない場合、このメソッドは を返します undefined。
getTableStyles()	ブックに関連付けられている TableStyle のコレクションを表します。
getTimelineStyle(name)	名前で を TimelineStyle 取得します。 タイムライン スタイルが存在しない場合、このメソッドは を返しますundefined。
getTimelineStyles()	ブックに関連付けられている TimelineStyle のコレクションを表します。
getUsePrecisionAsDisplayed()	ブックを表示桁数でのみ計算する場合、true となります。 このプロパティを から false に切り替えると、データの精度が完全に true失われます。
getWorksheet(key)	名前または ID を使用して、ワークシート オブジェクトを取得します。 ワークシートが存在しない場合、このメソッドは を返します undefined。
getWorksheets()	ブックに関連付けられているワークシートのコレクションを表します。
refreshAllDataConnections()	すべてのデータ接続を更新するように要求します。
refreshAllLinksToLinkedWorkbooks()	すべてのブック リンクを更新するように要求します。
refreshAllPivotTables()	コレクション内のすべてのピボットテーブルを更新します。
setChartDataPointTrack(chartDataPointTrack)	関連付けられている実際のデータ ポイントをブックの全グラフが追跡している場合、true となります。 False の場合、グラフは、データ ポイントのインデックスを追跡します。
setDefaultPivotTableStyle(newDefaultStyle)	親オブジェクトのスコープで使用する既定のピボットテーブル スタイルを設定します。
setDefaultSlicerStyle(newDefaultStyle)	親オブジェクトのスコープで使用する既定のスライサー スタイルを設定します。
setDefaultTableStyle(newDefaultStyle)	親オブジェクトのスコープで使用する既定のテーブル スタイルを設定します。
setDefaultTimelineStyle(newDefaultStyle)	親オブジェクトのスコープで使用する既定のタイムライン スタイルを設定します。
setIsDirty(isDirty)	ブックが最後に保存されてから変更が加えられたかどうかを指定します。 このプロパティを に true 設定すると、変更したブックを保存せずに閉じるか、保存するように求められます。
setLinkedWorkbookRefreshMode(linkedWorkbookRefreshMode)	ブック リンクの更新モードを表します。 このモードは、ブックに存在するすべてのブック リンクで同じです。
setUsePrecisionAsDisplayed(usePrecisionAsDisplayed)	ブックを表示桁数でのみ計算する場合、true となります。 このプロパティを から false に切り替えると、データの精度が完全に true失われます。

メソッドの詳細

addBinding(range, bindingType, id)

特定の範囲に新しいバインドを追加します。

addBinding(
            range: Range | string,
            bindingType: BindingType,
            id: string
        ): Binding;

パラメーター

range

ExcelScript.Range | string

バインドをバインドする範囲です。 オブジェクトまたは文字列を指定できます Range 。 文字列の場合は、シート名を含む完全なアドレスが含まれている必要があります

bindingType

ExcelScript.BindingType

バインドの種類。 ExcelScript.BindingTypeを参照してください。

id

string

バインドの名前。

戻り値

ExcelScript.Binding

addBindingFromNamedItem(name, bindingType, id)

ブック内の名前付きアイテムに基づいて新しいバインドを追加します。 名前付き項目が複数の領域を参照している場合、 InvalidReference エラーが返されます。

addBindingFromNamedItem(
            name: string,
            bindingType: BindingType,
            id: string
        ): Binding;

パラメーター

name

string

バインドの作成元の名前です。

bindingType

ExcelScript.BindingType

バインドの種類。 ExcelScript.BindingTypeを参照してください。

id

string

バインドの名前。

戻り値

ExcelScript.Binding

addBindingFromSelection(bindingType, id)

現在の選択範囲に基づいて新しいバインドを追加します。 選択範囲に複数の領域がある場合は、 InvalidReference エラーが返されます。

addBindingFromSelection(bindingType: BindingType, id: string): Binding;

パラメーター

bindingType

ExcelScript.BindingType

バインドの種類。 ExcelScript.BindingTypeを参照してください。

id

string

バインドの名前。

戻り値

ExcelScript.Binding

addComment(cellAddress, content, contentType)

指定したセルで、指定した内容の新しいコメントを作成します。 指定 InvalidArgument された範囲が 1 つのセルより大きい場合、エラーがスローされます。

addComment(
            cellAddress: Range | string,
            content: CommentRichContent | string,
            contentType?: ContentType
        ): Comment;

パラメーター

cellAddress

ExcelScript.Range | string

コメントが追加されるセル。 オブジェクトまたは文字列を Range 指定できます。 文字列の場合は、シート名を含む完全なアドレスを含む必要があります。 指定 InvalidArgument された範囲が 1 つのセルより大きい場合、エラーがスローされます。

content

ExcelScript.CommentRichContent | string

コメントの内容。 これは、文字列または CommentRichContent オブジェクトのいずれかです。 文字列はプレーン テキストに使用されます。 CommentRichContent オブジェクトを使用すると、メンションなどの他のコメント機能を使用できます。

contentType

ExcelScript.ContentType

省略可能です。 コメントに含まれるコンテンツの種類。 既定値は enum です ContentType.Plain。

戻り値

ExcelScript.Comment

addCustomXmlPart(xml)

ブックに新しいカスタム XML パーツを追加します。

addCustomXmlPart(xml: string): CustomXmlPart;

パラメーター

xml

string

XML コンテンツ。 有効な XML フラグメントである必要があります。

戻り値

ExcelScript.CustomXmlPart

addNamedItem(name, reference, comment)

指定のスコープのコレクションに新しい名前を追加します。

addNamedItem(
            name: string,
            reference: Range | string,
            comment?: string
        ): NamedItem;

パラメーター

name

string

名前付きの項目の名前。

reference

ExcelScript.Range | string

名前が参照する数式または範囲。

comment

string

省略可能です。 名前付き項目に関連付けられているコメント。

戻り値

ExcelScript.NamedItem

例

/**
 * This script creates a named formula and uses it in another part of the workbook.
 */
function main(workbook: ExcelScript.Workbook) {
  // Create a named item for a formula.
  // This formula is the sum of the cells F2:F21 on Sheet1.
  const namedItem: ExcelScript.NamedItem = workbook.addNamedItem(
    "GrandTotal", 
    "=SUM(Sheet1!$F$2:$F$21)", 
    "The sum of table sums."
  );

  // Add this named formula to a new sheet in the workbook.
  const otherSheet = workbook.addWorksheet();
  otherSheet.getRange("A1").setFormula(namedItem.getFormula());

  // Switch to the new worksheet.
  otherSheet.activate();
}

addNamedItemFormulaLocal(name, formula, comment)

ユーザーのロケールを数式に使用して、指定のスコープのコレクションに新しい名前を追加します。

addNamedItemFormulaLocal(
            name: string,
            formula: string,
            comment?: string
        ): NamedItem;

パラメーター

name

string

名前付きの項目の名前。

formula

string

名前が参照するユーザーのロケールの数式。

comment

string

オプション。 名前付き項目に関連付けられているコメント。

戻り値

ExcelScript.NamedItem

addPivotTable(name, source, destination)

指定したソース データに基づいてピボットテーブルを追加し、変換先範囲の左上のセルに挿入します。

addPivotTable(
            name: string,
            source: Range | string | Table,
            destination: Range | string
        ): PivotTable;

パラメーター

name

string

新しいピボットテーブルの名前。

source

ExcelScript.Range | string | ExcelScript.Table

新しいピボットテーブルのソース データは、範囲 (またはワークシート名を含む文字列アドレス) またはテーブルのいずれかです。

destination

ExcelScript.Range | string

ピボットテーブル レポートの配置先範囲 (結果のレポートを配置するワークシートの範囲) の左上端のセルを指定します。

戻り値

ExcelScript.PivotTable

例

/**
 * This script creates a PivotTable from an existing table and adds it to an existing worksheet.
 * This script assumes there is a table in the current worksheet with columns named "Type" and "Sales".
 * It also assumes there is a worksheet named "PivotSheet".
 */
function main(workbook: ExcelScript.Workbook) {
  // Create a PivotTable based on a table in the current worksheet.
  let sheet = workbook.getActiveWorksheet();
  let table = sheet.getTables()[0];
  let pivotTable = workbook.addPivotTable("My Pivot", table, "PivotSheet!A1");

  // Add fields to the PivotTable to show "Sales" per "Type".
  pivotTable.addRowHierarchy(pivotTable.getHierarchy("Type"));
  pivotTable.addDataHierarchy(pivotTable.getHierarchy("Sales"));
}

addPivotTableStyle(name, makeUniqueName)

指定した名前の空白 PivotTableStyle を作成します。

addPivotTableStyle(
            name: string,
            makeUniqueName?: boolean
        ): PivotTableStyle;

パラメーター

name

string

新しいピボットテーブル スタイルの一意の名前。 名前が既に InvalidArgument 使用されている場合は、エラーがスローされます。

makeUniqueName

boolean

オプション。 既定値は falseです。 の場合 trueは、必要に応じて一意にするために、名前に番号が追加されます。

戻り値

ExcelScript.PivotTableStyle

addPredefinedCellStyle(name)

コレクションに新しいスタイルを追加します。

addPredefinedCellStyle(name: string): void;

パラメーター

name

string

追加するスタイルの名前。

戻り値

void

addSlicer(slicerSource, sourceField, slicerDestination)

ブックに新しいスライサーを追加します。

addSlicer(
            slicerSource: string | PivotTable | Table,
            sourceField: string | PivotField | number | TableColumn,
            slicerDestination?: string | Worksheet
        ): Slicer;

パラメーター

slicerSource

string | ExcelScript.PivotTable | ExcelScript.Table

新しいスライサーの基になるデータ ソース。 オブジェクト、 PivotTable オブジェクト、 Table または文字列を指定できます。 ピボットテーブル オブジェクトが渡されると、データ ソースがオブジェクトの PivotTable ソースになります。 オブジェクトが Table 渡されると、データ ソースは Table オブジェクトになります。 文字列が渡されると、ピボットテーブルまたはテーブルの名前または ID として解釈されます。

sourceField

string | ExcelScript.PivotField | number | ExcelScript.TableColumn

フィルター処理するデータ ソースのフィールド。 オブジェクト、オブジェクト、TableColumnの IDPivotField、または の名前または ID を指定TableColumnできますPivotField。

slicerDestination

string | ExcelScript.Worksheet

省略可能です。 新しいスライサーが作成されるワークシート。 オブジェクトまたはワークシートの Worksheet 名前または ID を指定できます。 スライサー コレクションがワークシートから取得される場合は、このパラメーターを省略できます。

戻り値

ExcelScript.Slicer

例

/**
 * This script adds a slicer for an existing PivotTable.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the PivotTable named "Farm Pivot".
  const farmPivot = workbook.getPivotTable("Farm Pivot");

  // Create the slicer. 
  // Note that this assumes "Type" is already added as a hierarchy to the PivotTable.
  const fruitSlicer: ExcelScript.Slicer = workbook.addSlicer(
    farmPivot, /* The table or PivotTale to be sliced. */
    farmPivot.getHierarchy("Type").getFields()[0] /* What source field to use as the slicer options. */
  );

  // Select the items to display.
  fruitSlicer.selectItems(["Lemon", "Lime"]);

  // Set the left margin of the slicer.
  fruitSlicer.setLeft(400);
}

addSlicerStyle(name, makeUniqueName)

指定した名前の空白スライサー スタイルを作成します。

addSlicerStyle(name: string, makeUniqueName?: boolean): SlicerStyle;

パラメーター

name

string

新しいスライサー スタイルの一意の名前。 名前が既に InvalidArgument 使用されている場合は、例外がスローされます。

makeUniqueName

boolean

省略可能です。 既定値は falseです。 の場合 trueは、必要に応じて一意にするために、名前に番号が追加されます。

戻り値

ExcelScript.SlicerStyle

addTable(address, hasHeaders)

新しいテーブルを作成します。 範囲オブジェクトまたはソース アドレスにより、テーブルが追加されるワークシートが判断されます。 テーブルが追加できない場合 (たとえば、アドレスが無効な場合や、テーブルが別のテーブルと重複している場合) は、エラーがスローされます。

addTable(address: Range | string, hasHeaders: boolean): Table;

パラメーター

address

ExcelScript.Range | string

Rangeオブジェクト、またはデータ ソースを表す範囲の文字列アドレスまたは名前。 アドレスにシート名が含まれていない場合は、現在作業中のシートが使用されます。

hasHeaders

boolean

インポートされるデータに列ラベルがあるかどうかを示すブール値。 ソースにヘッダーが含まれていない場合 (つまり、このプロパティが に false設定されている場合)、Excel はヘッダーを自動的に生成し、データを 1 行ずつシフトします。

戻り値

ExcelScript.Table

例

/**
 * This sample converts the information in the first worksheet
 * into a table with headers.
*/
function main(workbook: ExcelScript.Workbook) {
  // This assumes there is one contiguous range in the first worksheet.
  const dataRange = workbook.getFirstWorksheet().getUsedRange();
  
  // Add a table at the workbook level.
  workbook.addTable(dataRange.getAddress(), true);
}

addTableStyle(name, makeUniqueName)

指定した名前の空白 TableStyle を作成します。

addTableStyle(name: string, makeUniqueName?: boolean): TableStyle;

パラメーター

name

string

新しいテーブル スタイルの一意の名前。 名前が既に InvalidArgument 使用されている場合は、エラーがスローされます。

makeUniqueName

boolean

オプション。 既定値は falseです。 の場合 trueは、必要に応じて一意にするために、名前に番号が追加されます。

戻り値

ExcelScript.TableStyle

addTimelineStyle(name, makeUniqueName)

指定した名前の空白 TimelineStyle を作成します。

addTimelineStyle(name: string, makeUniqueName?: boolean): TimelineStyle;

パラメーター

name

string

新しいタイムライン スタイルの一意の名前。 名前が既に InvalidArgument 使用されている場合は、エラーがスローされます。

makeUniqueName

boolean

省略可能です。 既定値は falseです。 の場合 trueは、必要に応じて一意にするために、名前に番号が追加されます。

戻り値

ExcelScript.TimelineStyle

addWorksheet(name)

新しいワークシートをブックに追加します。 ワークシートは、既存のワークシートの末尾に追加されます。 新しく追加したワークシートをアクティブ化する場合は、 を呼び出 .activate() します。

addWorksheet(name?: string): Worksheet;

パラメーター

name

string

省略可能です。 追加するワークシートの名前。 指定した場合、名前は一意である必要があります。 指定されていない場合は、Excel が新しいワークシートの名前を決定します。

戻り値

ExcelScript.Worksheet

例

/**
 * This script adds a new worksheet named "Data" to the workbook.
 * If a worksheet with that name already exists, the script logs a note.
 */
function main(workbook: ExcelScript.Workbook) {
  // Check if the "Data" worksheet already exists.
  if (workbook.getWorksheet("Data")) {
    console.log("The Data worksheet is already in the workbook.");
  } else {
    // Add a new worksheet.
    let worksheet = workbook.addWorksheet("Data");
  }
}

breakAllLinksToLinkedWorkbooks()

リンクされたブックへのリンクをすべて解除します。 リンクが破損すると、ブック リンクを参照するすべての数式が完全に削除され、最後に取得された値に置き換えられます。

breakAllLinksToLinkedWorkbooks(): void;

戻り値

void

getActiveCell()

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

getActiveCell(): Range;

戻り値

ExcelScript.Range

例

/**
 * This script logs the value of the current active cell. 
 * If multiple cells are selected, the top-leftmost cell will be logged.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current active cell in the workbook.
  let cell = workbook.getActiveCell();
  console.log(`The current cell's value is ${cell.getValue()}`);
}

getActiveChart()

ブックで現在アクティブになっているグラフを取得します。 アクティブなグラフがない場合、このメソッドは を返します undefined。

getActiveChart(): Chart;

戻り値

ExcelScript.Chart

getActiveSlicer()

ブックで現在アクティブになっているスライサーを取得します。 アクティブなスライサーがない場合、このメソッドは を返します undefined。

getActiveSlicer(): Slicer;

戻り値

ExcelScript.Slicer

getActiveWorksheet()

ブックの、現在作業中のワークシートを取得します。

getActiveWorksheet(): Worksheet;

戻り値

ExcelScript.Worksheet

getApplication()

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

getApplication(): Application;

戻り値

ExcelScript.Application

getAutoSave()

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

getAutoSave(): boolean;

戻り値

boolean

getBinding(id)

ID を使用してバインド オブジェクトを取得します。 バインド オブジェクトが存在しない場合、このメソッドは を返します undefined。

getBinding(id: string): Binding | undefined;

パラメーター

id

string

取得するバインド オブジェクトの ID。

戻り値

ExcelScript.Binding | undefined

getBindings()

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

getBindings(): Binding[];

戻り値

ExcelScript.Binding[]

getCalculationEngineVersion()

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

getCalculationEngineVersion(): number;

戻り値

number

getChartDataPointTrack()

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

getChartDataPointTrack(): boolean;

戻り値

boolean

getComment(commentId)

ID に基づいてコレクションからコメントを取得します。 コメント オブジェクトが存在しない場合、このメソッドは を返します undefined。

getComment(commentId: string): Comment | undefined;

パラメーター

commentId

string

コメントの識別子。

戻り値

ExcelScript.Comment | undefined

getCommentByCell(cellAddress)

指定したセルからコメントを取得します。 セルにコメントがない場合は、エラーがスローされます。

getCommentByCell(cellAddress: Range | string): Comment;

パラメーター

cellAddress

ExcelScript.Range | string

コメントがオンになっているセル。 オブジェクトまたは文字列を Range 指定できます。 文字列の場合は、シート名を含む完全なアドレスを含む必要があります。 指定 InvalidArgument された範囲が 1 つのセルより大きい場合、エラーがスローされます。

戻り値

ExcelScript.Comment

getCommentByReplyId(replyId)

指定された応答が接続されているコメントを取得します。

getCommentByReplyId(replyId: string): Comment;

パラメーター

replyId

string

コメント応答の識別子。

戻り値

ExcelScript.Comment

getComments()

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

getComments(): Comment[];

戻り値

ExcelScript.Comment[]

getCustomXmlPart(id)

ID に基づいて、カスタム XML パーツを取得します。 CustomXmlPartが存在しない場合、このメソッドは を返しますundefined。

getCustomXmlPart(id: string): CustomXmlPart | undefined;

パラメーター

id

string

取得するオブジェクトの ID。

戻り値

ExcelScript.CustomXmlPart | undefined

getCustomXmlPartByNamespace(namespaceUri)

警告

この API は非推奨になりました。

Use getCustomXmlPartsByNamespace instead.

名前空間が指定された名前空間と一致するカスタム XML パーツの新しいコレクションを取得します。

getCustomXmlPartByNamespace(namespaceUri: string): CustomXmlPart[];

パラメーター

namespaceUri

string

これは完全修飾スキーマ URI である必要があります。たとえば、"http://schemas.contoso.com/review/1.0"。

戻り値

ExcelScript.CustomXmlPart[]

getCustomXmlParts()

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

getCustomXmlParts(): CustomXmlPart[];

戻り値

ExcelScript.CustomXmlPart[]

getCustomXmlPartsByNamespace(namespaceUri)

名前空間が指定された名前空間と一致するカスタム XML パーツの新しいコレクションを取得します。

getCustomXmlPartsByNamespace(namespaceUri: string): CustomXmlPart[];

パラメーター

namespaceUri

string

これは完全修飾スキーマ URI である必要があります。たとえば、"http://schemas.contoso.com/review/1.0"。

戻り値

ExcelScript.CustomXmlPart[]

getDefaultPivotTableStyle()

親オブジェクトのスコープの既定のピボットテーブル スタイルを取得します。

getDefaultPivotTableStyle(): PivotTableStyle;

戻り値

ExcelScript.PivotTableStyle

getDefaultSlicerStyle()

親オブジェクトのスコープの既定値 SlicerStyle を取得します。

getDefaultSlicerStyle(): SlicerStyle;

戻り値

ExcelScript.SlicerStyle

getDefaultTableStyle()

親オブジェクトのスコープの既定のテーブル スタイルを取得します。

getDefaultTableStyle(): TableStyle;

戻り値

ExcelScript.TableStyle

getDefaultTimelineStyle()

親オブジェクトのスコープの既定のタイムライン スタイルを取得します。

getDefaultTimelineStyle(): TimelineStyle;

戻り値

ExcelScript.TimelineStyle

getFirstWorksheet(visibleOnly)

コレクション内の最初のワークシートを取得します。

getFirstWorksheet(visibleOnly?: boolean): Worksheet;

パラメーター

visibleOnly

boolean

省略可能です。 の場合 trueは、非表示のワークシートをスキップして、表示されているワークシートのみを考慮します。

戻り値

ExcelScript.Worksheet

getIsDirty()

ブックが最後に保存されてから変更が加えられたかどうかを指定します。 このプロパティを に true 設定すると、変更したブックを保存せずに閉じるか、保存するように求められます。

getIsDirty(): boolean;

戻り値

boolean

getLastWorksheet(visibleOnly)

コレクション内の最後のワークシートを取得します。

getLastWorksheet(visibleOnly?: boolean): Worksheet;

パラメーター

visibleOnly

boolean

省略可能です。 の場合 trueは、非表示のワークシートをスキップして、表示されているワークシートのみを考慮します。

戻り値

ExcelScript.Worksheet

getLinkedWorkbookByUrl(key)

リンクされたブックに関する情報を URL で取得します。 ブックが存在しない場合、このメソッドは を返します undefined。

getLinkedWorkbookByUrl(key: string): LinkedWorkbook | undefined;

パラメーター

key

string

リンクされたブックの URL。

戻り値

ExcelScript.LinkedWorkbook | undefined

getLinkedWorkbookRefreshMode()

ブック リンクの更新モードを表します。 このモードは、ブックに存在するすべてのブック リンクで同じです。

getLinkedWorkbookRefreshMode(): WorkbookLinksRefreshMode;

戻り値

ExcelScript.WorkbookLinksRefreshMode

例

/**
 * This script refreshes all the links to external workbooks, 
 * if the linked workbook refresh mode is set to manual.
 * To learn about linked workbooks, see https://support.microsoft.com/office/create-an-external-reference-link-to-a-cell-range-in-another-workbook-c98d1803-dd75-4668-ac6a-d7cca2a9b95f.
 */
function main(workbook: ExcelScript.Workbook) {
  // Check the refresh mode.
  if (workbook.getLinkedWorkbookRefreshMode() === ExcelScript.WorkbookLinksRefreshMode.manual) {
    console.log("Refreshing workbook links");

    // Trigger a refresh of linked workbook content.
    workbook.refreshAllLinksToLinkedWorkbooks();
  }
}

getLinkedWorkbooks()

リンクされたブックのコレクションを返します。 数式では、ブック リンクを使用して、現在のブックの外部にあるデータ (セル値と名前) を参照できます。

getLinkedWorkbooks(): LinkedWorkbook[];

戻り値

ExcelScript.LinkedWorkbook[]

getName()

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

getName(): string;

戻り値

string

例

/**
 * This script logs the name of the workbook without the ".xlsx" extension.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the workbook's name.
  let name = workbook.getName();

  // Remove the file extension.
  name = name.substring(0, name.lastIndexOf(".xlsx"));

  // Display the name in the console.
  console.log(name);
}

getNamedItem(name)

名前を NamedItem 使用してオブジェクトを取得します。 オブジェクトが存在しない場合、このメソッドは を返します undefined。

getNamedItem(name: string): NamedItem | undefined;

パラメーター

name

string

名前付き項目名。

戻り値

ExcelScript.NamedItem | undefined

getNames()

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

getNames(): NamedItem[];

戻り値

ExcelScript.NamedItem[]

例

/**
 * This script looks for every named range with "Review" in the name 
 * and marks the range with a yellow fill.
 */
function main(workbook: ExcelScript.Workbook) {
  // Look at every named item in the workbook.
  workbook.getNames().forEach((namedItem) => {
    // Find names containing "Review".
    if (namedItem.getName().includes("Review")) {
      // Only change the fill color if the named item is a range (not a formula).
      let itemType: ExcelScript.NamedItemType = namedItem.getType();
      if (itemType === ExcelScript.NamedItemType.range) {
        // Set the range's fill color to yellow.
        namedItem.getRange().getFormat().getFill().setColor("yellow");
      }
    }
  });
}

getPivotTable(name)

名前に基づいてピボットテーブルを取得します。 ピボットテーブルが存在しない場合、このメソッドは を返します undefined。

getPivotTable(name: string): PivotTable | undefined;

パラメーター

name

string

取得するピボットテーブルの名前。

戻り値

ExcelScript.PivotTable | undefined

getPivotTables()

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

getPivotTables(): PivotTable[];

戻り値

ExcelScript.PivotTable[]

getPivotTableStyle(name)

名前で を PivotTableStyle 取得します。 PivotTableStyleが存在しない場合、このメソッドは を返しますundefined。

getPivotTableStyle(name: string): PivotTableStyle | undefined;

パラメーター

name

string

取得するピボットテーブル スタイルの名前。

戻り値

ExcelScript.PivotTableStyle | undefined

getPivotTableStyles()

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

getPivotTableStyles(): PivotTableStyle[];

戻り値

ExcelScript.PivotTableStyle[]

getPredefinedCellStyle(name)

名前に基づいてスタイルを取得します。 style オブジェクトが存在しない場合、このメソッドは を返します undefined。

getPredefinedCellStyle(name: string): PredefinedCellStyle | undefined;

パラメーター

name

string

取得するスタイルの名前。

戻り値

ExcelScript.PredefinedCellStyle | undefined

getPredefinedCellStyles()

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

getPredefinedCellStyles(): PredefinedCellStyle[];

戻り値

ExcelScript.PredefinedCellStyle[]

getPreviouslySaved()

ブックがローカルまたはオンラインで保存されたかどうかを指定します。

getPreviouslySaved(): boolean;

戻り値

boolean

getProperties()

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

getProperties(): DocumentProperties;

戻り値

ExcelScript.DocumentProperties

getProtection()

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

getProtection(): WorkbookProtection;

戻り値

ExcelScript.WorkbookProtection

getQueries()

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

getQueries(): Query[];

戻り値

ExcelScript.Query[]

getQuery(key)

コレクションの名前に基づいてクエリを取得します。

getQuery(key: string): Query;

パラメーター

key

string

大文字と小文字を区別しないクエリの名前。

戻り値

ExcelScript.Query

getReadOnly()

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

getReadOnly(): boolean;

戻り値

boolean

getSelectedRange()

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

getSelectedRange(): Range;

戻り値

ExcelScript.Range

getSelectedRanges()

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

getSelectedRanges(): RangeAreas;

戻り値

ExcelScript.RangeAreas

getSlicer(key)

名前または ID を使用してスライサーを取得します。 スライサーが存在しない場合、このメソッドは を返します undefined。

getSlicer(key: string): Slicer | undefined;

パラメーター

key

string

取得するスライサーの名前または ID。

戻り値

ExcelScript.Slicer | undefined

getSlicers()

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

getSlicers(): Slicer[];

戻り値

ExcelScript.Slicer[]

getSlicerStyle(name)

名前で を SlicerStyle 取得します。 スライサー スタイルが存在しない場合、このメソッドは を返します undefined。

getSlicerStyle(name: string): SlicerStyle | undefined;

パラメーター

name

string

取得するスライサー スタイルの名前。

戻り値

ExcelScript.SlicerStyle | undefined

getSlicerStyles()

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

getSlicerStyles(): SlicerStyle[];

戻り値

ExcelScript.SlicerStyle[]

getTable(key)

名前または ID でテーブルを取得します。 テーブルが存在しない場合、このメソッドは を返します undefined。

getTable(key: string): Table | undefined;

パラメーター

key

string

取得するテーブルの名前または ID。

戻り値

ExcelScript.Table | undefined

getTables()

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

getTables(): Table[];

戻り値

ExcelScript.Table[]

getTableStyle(name)

名前で を TableStyle 取得します。 テーブル スタイルが存在しない場合、このメソッドは を返します undefined。

getTableStyle(name: string): TableStyle | undefined;

パラメーター

name

string

取得するテーブル スタイルの名前。

戻り値

ExcelScript.TableStyle | undefined

getTableStyles()

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

getTableStyles(): TableStyle[];

戻り値

ExcelScript.TableStyle[]

getTimelineStyle(name)

名前で を TimelineStyle 取得します。 タイムライン スタイルが存在しない場合、このメソッドは を返しますundefined。

getTimelineStyle(name: string): TimelineStyle | undefined;

パラメーター

name

string

取得するタイムライン スタイルの名前。

戻り値

ExcelScript.TimelineStyle | undefined

getTimelineStyles()

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

getTimelineStyles(): TimelineStyle[];

戻り値

ExcelScript.TimelineStyle[]

getUsePrecisionAsDisplayed()

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

getUsePrecisionAsDisplayed(): boolean;

戻り値

boolean

getWorksheet(key)

名前または ID を使用して、ワークシート オブジェクトを取得します。 ワークシートが存在しない場合、このメソッドは を返します undefined。

getWorksheet(key: string): Worksheet | undefined;

パラメーター

key

string

ワークシートの名前または ID。

戻り値

ExcelScript.Worksheet | undefined

例

/**
 * This script switches the active view to a worksheet named "Data", if it exists.
 */
function main(workbook: ExcelScript.Workbook) {
  // Check if the "Data" worksheet exists.
  let dataWorksheet = workbook.getWorksheet("Data");
  if (dataWorksheet) {
    // Switch to the "Data" worksheet.
    dataWorksheet.activate();
  } else {
    console.log(`No worksheet named "Data" in this workbook.`);
  }
}

getWorksheets()

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

getWorksheets(): Worksheet[];

戻り値

ExcelScript.Worksheet[]

例

/**
 * This script logs the names of all the worksheets in the workbook.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get all the worksheets in the workbook. 
  let sheets = workbook.getWorksheets();

  // Get a list of all the worksheet names.
  let names = sheets.map ((sheet) => sheet.getName());

  // Write in the console all the worksheet names and the total count.
  console.log(names);
  console.log(`Total worksheets inside of this workbook: ${sheets.length}`);
}

refreshAllDataConnections()

すべてのデータ接続を更新するように要求します。

refreshAllDataConnections(): void;

戻り値

void

refreshAllLinksToLinkedWorkbooks()

すべてのブック リンクを更新するように要求します。

refreshAllLinksToLinkedWorkbooks(): void;

戻り値

void

refreshAllPivotTables()

コレクション内のすべてのピボットテーブルを更新します。

refreshAllPivotTables(): void;

戻り値

void

setChartDataPointTrack(chartDataPointTrack)

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

setChartDataPointTrack(chartDataPointTrack: boolean): void;

パラメーター

chartDataPointTrack

boolean

戻り値

void

setDefaultPivotTableStyle(newDefaultStyle)

親オブジェクトのスコープで使用する既定のピボットテーブル スタイルを設定します。

setDefaultPivotTableStyle(
            newDefaultStyle: PivotTableStyle | string
        ): void;

パラメーター

newDefaultStyle

ExcelScript.PivotTableStyle | string

PivotTableStyle新しい既定値であるオブジェクトまたはオブジェクトのPivotTableStyle名前。

戻り値

void

setDefaultSlicerStyle(newDefaultStyle)

親オブジェクトのスコープで使用する既定のスライサー スタイルを設定します。

setDefaultSlicerStyle(newDefaultStyle: SlicerStyle | string): void;

パラメーター

newDefaultStyle

ExcelScript.SlicerStyle | string

SlicerStyle新しい既定値であるオブジェクトまたはオブジェクトのSlicerStyle名前。

戻り値

void

setDefaultTableStyle(newDefaultStyle)

親オブジェクトのスコープで使用する既定のテーブル スタイルを設定します。

setDefaultTableStyle(newDefaultStyle: TableStyle | string): void;

パラメーター

newDefaultStyle

ExcelScript.TableStyle | string

TableStyle新しい既定値であるオブジェクトまたはオブジェクトのTableStyle名前。

戻り値

void

setDefaultTimelineStyle(newDefaultStyle)

親オブジェクトのスコープで使用する既定のタイムライン スタイルを設定します。

setDefaultTimelineStyle(newDefaultStyle: TimelineStyle | string): void;

パラメーター

newDefaultStyle

ExcelScript.TimelineStyle | string

TimelineStyle新しい既定値であるオブジェクトまたはオブジェクトのTimelineStyle名前。

戻り値

void

setIsDirty(isDirty)

ブックが最後に保存されてから変更が加えられたかどうかを指定します。 このプロパティを に true 設定すると、変更したブックを保存せずに閉じるか、保存するように求められます。

setIsDirty(isDirty: boolean): void;

パラメーター

isDirty

boolean

戻り値

void

setLinkedWorkbookRefreshMode(linkedWorkbookRefreshMode)

ブック リンクの更新モードを表します。 このモードは、ブックに存在するすべてのブック リンクで同じです。

setLinkedWorkbookRefreshMode(
            linkedWorkbookRefreshMode: WorkbookLinksRefreshMode
        ): void;

パラメーター

linkedWorkbookRefreshMode

ExcelScript.WorkbookLinksRefreshMode

戻り値

void

setUsePrecisionAsDisplayed(usePrecisionAsDisplayed)

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

setUsePrecisionAsDisplayed(usePrecisionAsDisplayed: boolean): void;

パラメーター

usePrecisionAsDisplayed

boolean

戻り値

void