Instance Method


Adds a view to the end of the stack view gravity area.


func addView(_ view: NSView, in gravity: NSStackView.Gravity)



The view to add to the specified gravity area.


The gravity area that you are adding the specified view to. Valid values are those in the NSStackView.Gravity enumeration.


The location of a newly added view depends on the stack view layout direction and, for a horizontal stack view, on user interface language:

  • Horizontal: A newly added view appears at the trailing edge of the specified gravity area, as determined by the value of the inherited userInterfaceLayoutDirection property of the stack view. For a left to right language, a new view appears at the right side of the gravity area.

  • Vertical: A newly added view appears at the bottom of the specified gravity area.

Calling this method updates the stack view’s layout, which can change the stack view size. As a result, views could detach or clip according to the clipping resistance of the stack view and the visibility priorities of its views.

A view in a detached state is not present in the stack view’s view hierarchy, but it still consumes memory. To respond to detachment and reattachment of views, implement an NSStackViewDelegate object and assign it to the delegate property.

See Also

Managing Views in Gravity Areas

func insertView(NSView, at: Int, in: NSStackView.Gravity)

Adds a view to a stack view gravity area at a specified index position.

func setViews([NSView], in: NSStackView.Gravity)

Specifies an array of views for a specified gravity area in the stack view, replacing any previous views in that area.

func removeView(NSView)

Removes a specified view from the stack view.

enum NSStackView.Gravity

The gravity areas available in a stack view.