Control.ControlCollection.SetChildIndex(Control, Int32) Method

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Sets the index of the specified child control in the collection to the specified index value.

public:
 void SetChildIndex(System::Windows::Forms::Control ^ child, int newIndex);

public:
 virtual void SetChildIndex(System::Windows::Forms::Control ^ child, int newIndex);

public void SetChildIndex (System.Windows.Forms.Control child, int newIndex);

public virtual void SetChildIndex (System.Windows.Forms.Control child, int newIndex);

member this.SetChildIndex : System.Windows.Forms.Control * int -> unit

abstract member SetChildIndex : System.Windows.Forms.Control * int -> unit
override this.SetChildIndex : System.Windows.Forms.Control * int -> unit

Public Sub SetChildIndex (child As Control, newIndex As Integer)

Public Overridable Sub SetChildIndex (child As Control, newIndex As Integer)

Parameters

child: Control

The child control to search for.

newIndex: Int32

The new index value of the control.

Exceptions

ArgumentException

The child control is not in the Control.ControlCollection.

Remarks

When SetChildIndex is called, the Control referred to by the child parameter is moved to the position specified by newIndex and the other Control references in the Control.ControlCollection are reordered to accommodate the move. The control with an index value of zero is at the top of the z-order, and higher numbers are closer to the bottom.

Applies to

Jaa