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: