Worksheet.PivotTableBeforeCommitChanges Event (Excel)
Occurs before changes are committed against the OLAP data source for a PivotTable.
Version Information
Version Added: Excel 2010
Syntax
expression .PivotTableBeforeCommitChanges(TargetPivotTable, ValueChangeStart, ValueChangeEnd, Cancel)
expression A variable that represents a Worksheet object.
Parameters
Name |
Required/Optional |
Data Type |
Description |
|---|---|---|---|
TargetPivotTable |
Required |
The PivotTable that contains the changes to commit. |
|
ValueChangeStart |
Required |
Long |
The index to the first change in the associated PivotTableChangeList object. The index is specified by the Order property of the ValueChange object in the PivotTableChangeList collection. |
ValueChangeEnd |
Required |
Long |
The index to the last change in the associated PivotTableChangeList object. The index is specified by the Order property of the ValueChange object in the PivotTableChangeList collection. |
Cancel |
Required |
Boolean |
False when the event occurs. If the event procedure sets this argument to True, the changes are not committed against the OLAP data source of the PivotTable. |
Return Value
Nothing
Remarks
The PivotTableBeforeCommitChanges event occurs immediately before Excel executes a COMMIT TRANSACTION against the PivotTable's OLAP data source, and immediately after the user has chosen to save changes for the whole PivotTable.
Example
The following code example prompts the user before changes are commited to the PivotTable's OLAP data source.
Sub Worksheet_PivotTableBeforeCommitChanges(ByVal TargetPivotTable As PivotTable, _
ByVal ValueChangeStart As Long, ByVal ValueChangeEnd As Long, Cancel As Boolean)
Dim UserChoice As VbMsgBoxResult
UserChoice = MsgBox("Allow updates to be saved to: " + TargetPivotTable.Name + "?", vbYesNo)
If UserChoice = vbNo Then Cancel = True
End Sub