Excel.WorksheetChangedEventArgs interface
変更イベントを発生させたワークシートに関する情報を提供します。
注釈
[API セット: ExcelApi 1.7]
プロパティ
| address | 特定のワークシートで変更されたエリアを表す範囲のアドレスを取得します。 |
| change |
セルが削除または挿入されたときに、ワークシート内のセルがずれる方向の変更を表します。 これには、次の 2 つのシナリオが含まれます。 1. 新しいセルがワークシートに挿入されたときに、既存のセルがシフトされる方向 (下や右など)。 2. ワークシートからセルが削除されたときに残りのセルがシフトされる方向 (上や左など)。 |
| change |
変更されたイベントのトリガー方法を表す変更の種類を取得します。 詳細は「 |
| details | 変更の詳細に関する情報を表します。 このプロパティは、変更されたイベントが 1 つのセルでトリガーされたときに取得できます。 change イベントが複数のセルでトリガーされた場合、このプロパティは取得できません。 |
| source | イベントのソースを取得します。 詳細は「 |
| trigger |
イベントのトリガー ソースを表します。 たとえば、このローカル アドインがイベントをトリガーするかどうかを識別します。 |
| type | イベントの種類を取得します。 詳細は「 |
| worksheet |
データが変更されたワークシートの ID を取得します。 |
メソッド
| get |
特定のワークシートで変更されたエリアを表す範囲を取得します。 [API セット: ExcelApi 1.8] |
| get |
特定のワークシートで変更されたエリアを表す範囲を取得します。 null オブジェクトを返すこともあります。 [API セット: ExcelApi 1.8] |
プロパティの詳細
address
特定のワークシートで変更されたエリアを表す範囲のアドレスを取得します。
address: string;プロパティ値
string
注釈
[API セット: ExcelApi 1.7]
changeDirectionState
セルが削除または挿入されたときに、ワークシート内のセルがずれる方向の変更を表します。 これには、次の 2 つのシナリオが含まれます。 1. 新しいセルがワークシートに挿入されたときに、既存のセルがシフトされる方向 (下や右など)。 2. ワークシートからセルが削除されたときに残りのセルがシフトされる方向 (上や左など)。
changeDirectionState: Excel.ChangeDirectionState;プロパティ値
注釈
[API セット: ExcelApi 1.14]
changeType
変更されたイベントのトリガー方法を表す変更の種類を取得します。 詳細は「Excel.DataChangeType」をご覧ください。
changeType: Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted";プロパティ値
Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted"
注釈
[API セット: ExcelApi 1.7]
details
変更の詳細に関する情報を表します。 このプロパティは、変更されたイベントが 1 つのセルでトリガーされたときに取得できます。 change イベントが複数のセルでトリガーされた場合、このプロパティは取得できません。
details: Excel.ChangedEventDetail;プロパティ値
注釈
[API セット: ExcelApi 1.9]
source
イベントのソースを取得します。 詳細は「Excel.EventSource」をご覧ください。
source: Excel.EventSource | "Local" | "Remote";プロパティ値
Excel.EventSource | "Local" | "Remote"
注釈
[API セット: ExcelApi 1.7]
triggerSource
イベントのトリガー ソースを表します。 たとえば、このローカル アドインがイベントをトリガーするかどうかを識別します。
triggerSource: Excel.EventTriggerSource | "Unknown" | "ThisLocalAddin";プロパティ値
Excel.EventTriggerSource | "Unknown" | "ThisLocalAddin"
注釈
[API セット: ExcelApi 1.14]
type
イベントの種類を取得します。 詳細は「Excel.EventType」をご覧ください。
type: "WorksheetChanged";プロパティ値
"WorksheetChanged"
注釈
[API セット: ExcelApi 1.7]
worksheetId
データが変更されたワークシートの ID を取得します。
worksheetId: string;プロパティ値
string
注釈
[API セット: ExcelApi 1.7]
メソッドの詳細
getRange(ctx)
特定のワークシートで変更されたエリアを表す範囲を取得します。
[API セット: ExcelApi 1.8]
getRange(ctx: Excel.RequestContext): Excel.Range;パラメーター
返品
getRangeOrNullObject(ctx)
特定のワークシートで変更されたエリアを表す範囲を取得します。 null オブジェクトを返すこともあります。
[API セット: ExcelApi 1.8]
getRangeOrNullObject(ctx: Excel.RequestContext): Excel.Range;