Instance Method

insertSubview:aboveSubview:

Inserts a view above another view in the view hierarchy.

Declaration

- (void)insertSubview:(UIView *)view aboveSubview:(UIView *)siblingSubview;

Parameters

view

The view to insert. It’s removed from its superview if it’s not a sibling of siblingSubview.

siblingSubview

The sibling view that will be behind the inserted view.

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:atIndex:

Inserts a subview at the specified index.

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