---
title: SAIFTabEventArgs
summary: API reference for SAIFTabEventArgs.
status: draft
owner: SAIF Documentation Team
last_reviewed: 2026-08-17
library: SAIF.Presentation.Web.Controls.V2
reference_type: package
---

# SAIFTabEventArgs

`SAIFTabEventArgs` carries the new and previous tab models for `SAIFTabs`' `BeforeSelectedIndexChanged`/`SelectedIndexChanged` events, and exposes a `Cancel` flag letting host pages veto a tab switch before it is committed.

## Purpose
- Give host pages enough context (which tab is being switched to/from) to validate or veto a tab change via `BeforeSelectedIndexChanged`.

## Context
- Namespace: `SAIF.Presentation.Web.Controls.V2`
- Assembly/package: Compiled into `SAIF.BOF.Presentation.Web.Infragistics103`*

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `NewTab` | `ReadOnly Property NewTab As TabSettings` | The tab the user clicked / is switching to. |
| `PrevTab` | `ReadOnly Property PrevTab As TabSettings` | The tab that was previously selected before this event. |
| `Cancel` | `Public Property Cancel As Boolean` | When set `True` by a `BeforeSelectedIndexChanged` handler, vetoes the pending tab switch so `SelectedIndexChanged` does not fire and the previous tab remains selected. |
| `New(inTabSettings, inPriorTab)` | `Public Sub New(ByVal inTabSettings As TabSettings, ByVal inPriorTab As TabSettings)` | Constructs event args with the new and prior tab models. |
| `New()` | `Public Sub New()` | Constructs event args with `Cancel` defaulted to `False` and no tab models set. |

## Inherited public members

`SAIFTabEventArgs` inherits from `EventArgs` (`System`), a framework base class rather than a documented SAIF dependency library.

| Member | Signature | Purpose |
| --- | --- | --- |
| `Empty` | `Public Shared ReadOnly Field Empty As EventArgs` | Reusable singleton event-args instance for events that need no payload. |
| `Equals(obj)` | `Public Overrides Function Equals(ByVal obj As Object) As Boolean` | Determines value equality using the framework base implementation. |
| `GetHashCode()` | `Public Overrides Function GetHashCode() As Integer` | Returns the framework hash code for the current event-args instance. |
| `GetType()` | `Public Function GetType() As Type` | Returns the runtime type of the current event-args instance. |
| `ToString()` | `Public Overrides Function ToString() As String` | Returns the framework string representation of the current event-args instance. |

Standard `Object` members are not re-documented here as they are unmodified framework behavior**.

## Behavioral notes
- Raised by `SAIFTabs.LinkButtonClick`; see [Tab selection](../../operations/tab-selection.md) for the full flow.


> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts. Statements
> marked with ** could not be confirmed; treat as unknown until verified.

## Sources
- SAIF.Presentation.Web.Controls.V2\TabSettings.vb