TabControl.DeselectTab Method (TabPage) (System.Windows.Forms)

DeselectTab Method (TabPage)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2010/.NET Framework 4

Other versions are also available for the following:

.NET Framework Class Library

TabControl..::.DeselectTab Method (TabPage)

Makes the tab following the specified TabPage the current tab.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Syntax

Visual Basic

Public Sub DeselectTab ( _
    tabPage As TabPage _
)

public void DeselectTab(
    TabPage tabPage
)

Visual C++

public:
void DeselectTab(
    TabPage^ tabPage
)

member DeselectTab : 
        tabPage:TabPage -> unit

Parameters

tabPage: Type: System.Windows.Forms..::.TabPage
The TabPage to deselect.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	index is less than 0 or greater than the number of TabPage controls in the TabPages collection minus 1. -or- tabPage is not in the TabPages collection.
ArgumentNullException	tabPage is nullNothingnullptra null reference (Nothing in Visual Basic).

Exception

Condition

ArgumentOutOfRangeException

index is less than 0 or greater than the number of TabPage controls in the TabPages collection minus 1.

-or-

tabPage is not in the TabPages collection.

ArgumentNullException

tabPage is nullNothingnullptra null reference (Nothing in Visual Basic).

Remarks

Use this method to programmatically deselect a particular tab in a TabControl. If there are at least two tabs in the control, the tab following the specified tab becomes the current tab. If the specified tab is the last tab in the control, the first tab becomes the current tab.

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

TabControl Class

DeselectTab Overload

System.Windows.Forms Namespace