Excel.WorksheetChangedEventArgs interface
Fornece informações sobre a planilha que gerou o evento alterado.
Comentários
[Conjunto de apis: ExcelApi 1.7]
Propriedades
| address | Obtém o endereço do intervalo que representa a área alterada de uma planilha específica. |
| change |
Representa uma alteração na direção que as células em uma planilha deslocarão quando uma célula ou células forem excluídas ou inseridas. Isso inclui os dois cenários a seguir. 1. A direção (como para baixo ou para a direita) que as células existentes deslocarão quando uma ou mais novas células forem inseridas em uma planilha. 2. A direção (como para cima ou para a esquerda) que as células restantes deslocarão quando uma ou mais células forem excluídas de uma planilha. |
| change |
Obtém o tipo de alteração que representa como o evento alterado é disparado. Consulte |
| details | Representa as informações sobre os detalhes da alteração. Essa propriedade pode ser recuperada quando o evento alterado é disparado em uma única célula. Se o evento alterado for disparado em várias células, essa propriedade não poderá ser recuperada. |
| source | Obtém a origem do evento. Consulte |
| trigger |
Representa a origem do gatilho do evento. Por exemplo, identifica se esse suplemento local dispara o evento. |
| type | Obtém o tipo do evento. Consulte |
| worksheet |
Obtém a ID da planilha na qual os dados foram alterados. |
Métodos
| get |
Obtém o intervalo que representa a área alterada de uma planilha específica. [Conjunto de apis: ExcelApi 1.8] |
| get |
Obtém o intervalo que representa a área alterada de uma planilha específica. Pode retornar o objeto null. [Conjunto de apis: ExcelApi 1.8] |
Detalhes da propriedade
address
Obtém o endereço do intervalo que representa a área alterada de uma planilha específica.
address: string;
Valor da propriedade
string
Comentários
[Conjunto de apis: ExcelApi 1.7]
changeDirectionState
Representa uma alteração na direção que as células em uma planilha deslocarão quando uma célula ou células forem excluídas ou inseridas. Isso inclui os dois cenários a seguir. 1. A direção (como para baixo ou para a direita) que as células existentes deslocarão quando uma ou mais novas células forem inseridas em uma planilha. 2. A direção (como para cima ou para a esquerda) que as células restantes deslocarão quando uma ou mais células forem excluídas de uma planilha.
changeDirectionState: Excel.ChangeDirectionState;
Valor da propriedade
Comentários
[Conjunto de apis: ExcelApi 1.14]
changeType
Obtém o tipo de alteração que representa como o evento alterado é disparado. Consulte Excel.DataChangeType para obter detalhes.
changeType: Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted";
Valor da propriedade
Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted"
Comentários
[Conjunto de apis: ExcelApi 1.7]
details
Representa as informações sobre os detalhes da alteração. Essa propriedade pode ser recuperada quando o evento alterado é disparado em uma única célula. Se o evento alterado for disparado em várias células, essa propriedade não poderá ser recuperada.
details: Excel.ChangedEventDetail;
Valor da propriedade
Comentários
[Conjunto de apis: ExcelApi 1.9]
source
Obtém a origem do evento. Consulte Excel.EventSource para obter detalhes.
source: Excel.EventSource | "Local" | "Remote";
Valor da propriedade
Excel.EventSource | "Local" | "Remote"
Comentários
[Conjunto de apis: ExcelApi 1.7]
triggerSource
Representa a origem do gatilho do evento. Por exemplo, identifica se esse suplemento local dispara o evento.
triggerSource: Excel.EventTriggerSource | "Unknown" | "ThisLocalAddin";
Valor da propriedade
Excel.EventTriggerSource | "Unknown" | "ThisLocalAddin"
Comentários
[Conjunto de apis: ExcelApi 1.14]
type
Obtém o tipo do evento. Consulte Excel.EventType para obter detalhes.
type: "WorksheetChanged";
Valor da propriedade
"WorksheetChanged"
Comentários
[Conjunto de apis: ExcelApi 1.7]
worksheetId
Obtém a ID da planilha na qual os dados foram alterados.
worksheetId: string;
Valor da propriedade
string
Comentários
[Conjunto de apis: ExcelApi 1.7]
Detalhes do método
getRange(ctx)
Obtém o intervalo que representa a área alterada de uma planilha específica.
[Conjunto de apis: ExcelApi 1.8]
getRange(ctx: Excel.RequestContext): Excel.Range;
Parâmetros
Retornos
getRangeOrNullObject(ctx)
Obtém o intervalo que representa a área alterada de uma planilha específica. Pode retornar o objeto null.
[Conjunto de apis: ExcelApi 1.8]
getRangeOrNullObject(ctx: Excel.RequestContext): Excel.Range;