This topic has not yet been rated - Rate this topic

Control.ControlCollection.SetChildIndex Method

.NET Framework 4.5

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 child Control to search for.

newIndex: Type: System.Int32
The new index value of the control.

Exceptions

Exception	Condition
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.

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Control.ControlCollection Class

System.Windows.Forms Namespace

GetChildIndex

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)