Instance Method

setViews:inGravity:

Specifies an array of views for a specified gravity area in the stack view, replacing any views previously assigned to the gravity area.

Declaration

- (void)setViews:(NSArray<NSView *> *)views inGravity:(NSStackViewGravity)gravity;

Parameters

views

The array of views you are specifying for the gravity area.

gravity

The gravity area that you’re specifying the array of views for. Valid values are those in the NSStackViewGravity enumeration, according to the stack view’s layout direction.

Discussion

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

Adding and Removing Views

- addView:inGravity:

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

- insertView:atIndex:inGravity:

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

- removeView:

Removes a specified view from the stack view.