Control.ControlCollection.SetChildIndex Method (Control, Int32)

 

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

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

public virtual void SetChildIndex(
	Control child,
	int newIndex
)

Parameters

child
Type: System.Windows.Forms.Control

The childControl to search for.

newIndex
Type: System.Int32

The new index value of the control.

Exception Condition
ArgumentException

The child control is not in the Control.ControlCollection.

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.

.NET Framework
Available since 1.1
Return to top
Show: