Skip to main content
Row

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

Workbook.ActiveSheetChanging Event

Occurs when an active worksheet in a workbook is about to be changed.

You need a license for the DevExpress Office File API Subscription or DevExpress Universal Subscription to use this event in production code.

Namespace: DevExpress.Spreadsheet

Assembly: DevExpress.Docs.v24.2.dll

NuGet Package: DevExpress.Document.Processor

#Declaration

#Event Data

The ActiveSheetChanging event's data class is ActiveSheetChangingEventArgs. The following properties provide information specific to this event:

Property Description
Cancel Gets or sets whether the changing the active sheet should be canceled.
NewActiveSheetName Gets the name of the new active worksheet. Inherited from ActiveSheetChangeEventArgsBase.
OldActiveSheetName Gets the name of the old active worksheet. Inherited from ActiveSheetChangeEventArgsBase.

#Remarks

The ActiveSheetChanging event allows you to perform any actions before an active worksheet is changed via the Spreadsheet API (by using the WorksheetCollection.ActiveWorksheet property). You can cancel changing the active worksheet by setting the event parameter’s Cancel property to true.

After an active worksheet has been changed, the Workbook.ActiveSheetChanged event is raised.

When a worksheet is removed from the workbook, the ActiveSheetChanging event does not occur, although the Workbook.ActiveSheetChanged event is fired.

Note

This event does not occur by default. The event fires only if the WorkbookEventOptions.RaiseOnModificationsViaAPI property is true.

See Also