This documentation is archived and is not being maintained.

StatusBar.StatusBarPanelCollection.Insert Method

Inserts the specified StatusBarPanel into the collection at the specified index.

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

public virtual void Insert(
	int index,
	StatusBarPanel value
)

Parameters

index
Type: System.Int32
The zero-based index location where the panel is inserted.
value
Type: System.Windows.Forms.StatusBarPanel
A StatusBarPanel representing the panel to insert.

ExceptionCondition
ArgumentNullException

The value parameter is null.

ArgumentException

The value parameter's parent is not null.

ArgumentOutOfRangeException

The index parameter is less than zero or greater than the value of the Count property of the StatusBar.StatusBarPanelCollection class.

InvalidEnumArgumentException

The AutoSize property of the value parameter's panel is not a valid StatusBarPanelAutoSize value.

You can add panels to a StatusBar control to display more than one type of information. The Insert method enables you to create a new StatusBarPanel and insert it at a specific location within the collection. The order in which panels are located in the StatusBar.StatusBarPanelCollection represents the order that panels are displayed within the StatusBar control. Panels are displayed from left to right starting with the first panel in the collection. The RightToLeft property of the StatusBar control does not change the order in which panels are displayed in the StatusBar. To add a panel to the end of the collection, use the Add method. To add a set of panels to the collection in a single operation, use the AddRange method.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

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.
Show: