StatusBar.StatusBarPanelCollection.AddRange(StatusBarPanel[]) Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adds an array of StatusBarPanel objects to the collection.

public:
 virtual void AddRange(cli::array <System::Windows::Forms::StatusBarPanel ^> ^ panels);

public virtual void AddRange (System.Windows.Forms.StatusBarPanel[] panels);

abstract member AddRange : System.Windows.Forms.StatusBarPanel[] -> unit
override this.AddRange : System.Windows.Forms.StatusBarPanel[] -> unit

Public Overridable Sub AddRange (panels As StatusBarPanel())

Parameters

panels

StatusBarPanel[]

An array of StatusBarPanel objects to add.

Exceptions

ArgumentNullException

The array of StatusBarPanel objects being added to the collection was null.

Remarks

You can add panels to a StatusBar control to display more than one type of information. The AddRange method adds an array of StatusBarPanel objects specified in the panels parameter to the collection. All existing panels in the collection are removed from the collection before inserting new panels. 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 single StatusBarPanel to the collection, use the Add method. To insert a panel at a specific position in the StatusBar control (and in this collection), use the Insert method.

See also

• StatusBarPanel
• Add(String)
• Insert(Int32, StatusBarPanel)