Excel.WorksheetCollection class

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

context: RequestContext;

プロパティ値

このコレクション内に読み込まれた子アイテムを取得します。

readonly items: Excel.Worksheet[];

プロパティ値

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

add(name?: string): Excel.Worksheet;

パラメーター

返品

注釈

[API セット: ExcelApi 1.1]

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

getActiveWorksheet(): Excel.Worksheet;

返品

注釈

[API セット: ExcelApi 1.1]

コレクションに含まれるワークシートの数を取得します。

getCount(visibleOnly?: boolean): OfficeExtension.ClientResult<number>;

パラメーター

返品

注釈

[API セット: ExcelApi 1.4]

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

getFirst(visibleOnly?: boolean): Excel.Worksheet;

パラメーター

返品

注釈

[API セット: ExcelApi 1.5]

名前または ID を使用して、ワークシート オブジェクトを取得します。

getItem(key: string): Excel.Worksheet;

パラメーター

返品

注釈

[API セット: ExcelApi 1.1]

名前または ID を使用して、ワークシート オブジェクトを取得します。 ワークシートが存在しない場合、このメソッドは isNullObject プロパティが true に設定されたオブジェクトを返します。 詳細については、「 *OrNullObject のメソッドとプロパティ」を参照してください。

getItemOrNullObject(key: string): Excel.Worksheet;

パラメーター

返品

注釈

[API セット: ExcelApi 1.4]

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

getLast(visibleOnly?: boolean): Excel.Worksheet;

パラメーター

返品

注釈

[API セット: ExcelApi 1.5]

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

load(options?: Excel.Interfaces.WorksheetCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions): Excel.WorksheetCollection;

パラメーター

返品

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

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

パラメーター

返品

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

load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.WorksheetCollection;

パラメーター

返品

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

toJSON(): Excel.Interfaces.WorksheetCollectionData;

返品

ブック内のいずれかのワークシートがアクティブ化されたときに発生します。

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

イベントの種類

注釈

[API セット: ExcelApi 1.7]

ブックに新しいワークシートが追加されたときに発生します。

readonly onAdded: OfficeExtension.EventHandlers<Excel.WorksheetAddedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.7]

ブック内の任意のワークシートが計算されるときに発生します。

readonly onCalculated: OfficeExtension.EventHandlers<Excel.WorksheetCalculatedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.8]

ブックのワークシートが変更されたときに発生します。

readonly onChanged: OfficeExtension.EventHandlers<Excel.WorksheetChangedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.9]

1 つ以上の列を並べ替えたときに発生します。 これは、左から右に並べ替えを実行したときに発生します。

readonly onColumnSorted: OfficeExtension.EventHandlers<Excel.WorksheetColumnSortedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.10]

ブック内のいずれかのワークシートが非アクティブ化されたときに発生します。

readonly onDeactivated: OfficeExtension.EventHandlers<Excel.WorksheetDeactivatedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.7]

ワークシートがブックから削除されたときに発生します。

readonly onDeleted: OfficeExtension.EventHandlers<Excel.WorksheetDeletedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.7]

ブック内のいずれかのワークシートの形式が変更されたときに発生します。

readonly onFormatChanged: OfficeExtension.EventHandlers<Excel.WorksheetFormatChangedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.9]

このコレクションのいずれかのワークシートで 1 つ以上の数式が変更されたときに発生します。 このイベントは、数式の計算の結果のデータ値ではなく、数式自体が変更されたときに発生します。

readonly onFormulaChanged: OfficeExtension.EventHandlers<Excel.WorksheetFormulaChangedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.13]

ブック内でワークシートが移動されたときに発生します。 このイベントは、ワークシートがブック内で直接移動された場合にのみトリガーされます。 このイベントは、新しいワークシートが挿入されたときなど、間接的にワークシートの位置が変更され、既存のワークシートの位置が変更された場合にはトリガーされません。

readonly onMoved: OfficeExtension.EventHandlers<Excel.WorksheetMovedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.17]

ワークシート コレクション内でワークシート名が変更されたときに発生します。

readonly onNameChanged: OfficeExtension.EventHandlers<Excel.WorksheetNameChangedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.17]

ワークシートの保護状態が変更されたときに発生します。

readonly onProtectionChanged: OfficeExtension.EventHandlers<Excel.WorksheetProtectionChangedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.14]

特定のワークシートで 1 つ以上の行の非表示状態が変更されたときに発生します。

readonly onRowHiddenChanged: OfficeExtension.EventHandlers<Excel.WorksheetRowHiddenChangedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.11]

1 つ以上の行を並べ替えたときに発生します。 これは、上から下に並べ替えを実行したときに発生します。

readonly onRowSorted: OfficeExtension.EventHandlers<Excel.WorksheetRowSortedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.10]

ワークシートで選択範囲を変更したときに発生します。

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

イベントの種類

注釈

[API セット: ExcelApi 1.9]

ワークシート コレクションで左クリック/タップ操作が行われたときに発生します。 次の場合、クリックしてもこのイベントは発生しません。 - ユーザーがマウスをドラッグして複数選択した場合。 - 数式参照用にセル引数が選択されている場合、ユーザーはモードのセルを選択します。

readonly onSingleClicked: OfficeExtension.EventHandlers<Excel.WorksheetSingleClickedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.10]

ワークシート コレクションでワークシートの表示が変更されたときに発生します。

readonly onVisibilityChanged: OfficeExtension.EventHandlers<Excel.WorksheetVisibilityChangedEventArgs>;

イベントの種類

注釈

[API セット: ExcelApi 1.17]