StatusBar.StatusBarPanelCollection.Insert(Int32, StatusBarPanel) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Inserts the specified StatusBarPanel into the collection at the specified index.
public:
virtual void Insert(int index, System::Windows::Forms::StatusBarPanel ^ value);
public virtual void Insert (int index, System.Windows.Forms.StatusBarPanel value);
abstract member Insert : int * System.Windows.Forms.StatusBarPanel -> unit
override this.Insert : int * System.Windows.Forms.StatusBarPanel -> unit
Public Overridable Sub Insert (index As Integer, value As StatusBarPanel)
Parameters
- index
- Int32
The zero-based index location where the panel is inserted.
- value
- StatusBarPanel
A StatusBarPanel representing the panel to insert.
Exceptions
The value
parameter is null
.
The value
parameter's parent is not null
.
The index
parameter is less than zero or greater than the value of the Count property of the StatusBar.StatusBarPanelCollection class.
The AutoSize property of the value
parameter's panel is not a valid StatusBarPanelAutoSize value.
Remarks
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.