Instance Method

insertSubview:atIndex:

Inserts a subview at the specified index.

Declaration

- (void)insertSubview:(UIView *)view atIndex:(NSInteger)index;

Parameters

view

The view to insert. This value cannot be nil.

index

The index in the array of the subviews property at which to insert the view. Subview indices start at 0 and cannot be greater than the number of subviews.

Discussion

This method establishes a strong reference to view and sets its next responder to the receiver, which is its new superview.

Views can have only one superview. If view already has a superview and that view is not the receiver, this method removes the previous superview before making the receiver its new superview.

See Also

Managing the View Hierarchy

superview

The receiver’s superview, or nil if it has none.

subviews

The receiver’s immediate subviews.

window

The receiver’s window object, or nil if it has none.

- addSubview:

Adds a view to the end of the receiver’s list of subviews.

- bringSubviewToFront:

Moves the specified subview so that it appears on top of its siblings.

- sendSubviewToBack:

Moves the specified subview so that it appears behind its siblings.

- removeFromSuperview

Unlinks the view from its superview and its window, and removes it from the responder chain.

- insertSubview:aboveSubview:

Inserts a view above another view in the view hierarchy.

- insertSubview:belowSubview:

Inserts a view below another view in the view hierarchy.

- exchangeSubviewAtIndex:withSubviewAtIndex:

Exchanges the subviews at the specified indices.

- isDescendantOfView:

Returns a Boolean value indicating whether the receiver is a subview of a given view or identical to that view.