Instance Method

insertSubview(_:at:)

Inserts a subview at the specified index.

Declaration

func insertSubview(_ view: UIView, at index: Int)

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

var superview: UIView?

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

var subviews: [UIView]

The receiver’s immediate subviews.

var window: UIWindow?

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

func addSubview(UIView)

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

func bringSubview(toFront: UIView)

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

func sendSubview(toBack: UIView)

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

func removeFromSuperview()

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

func insertSubview(UIView, aboveSubview: UIView)

Inserts a view above another view in the view hierarchy.

func insertSubview(UIView, belowSubview: UIView)

Inserts a view below another view in the view hierarchy.

func exchangeSubview(at: Int, withSubviewAt: Int)

Exchanges the subviews at the specified indices.

func isDescendant(of: UIView)

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