Class

NSCollection​View​Grid​Layout

An object that displays a single section of items in a row and column grid layout.

Overview

The NSCollection​View​Grid​Layout object provides the same layout behavior offered by the NSCollection​View class prior to macOS 10.11, and you can use it in cases where you want to maintain the old appearance while still taking advantage of newer collection view features.

Configuring a Collection View to Use a Grid Layout

You can configure a collection view to use a grid layout object programmatically or at design time:

  • At design time, set the Layout attribute of your collection view to Grid.

  • Create an NSCollection​View​Grid​Layout object programmatically and assign it to the collection view’s collection​View​Layout property.

A grid layout displays only items and does not display supplementary views or decoration views. Use the properties of this class to configure the number of rows and columns in the grid. You can also use these properties to configure the spacing between items and the minimum sizes.

Symbols

Specifying the Grid Parameters

var maximum​Number​Of​Rows:​ Int

The maximum number of rows to display in the collection view’s visible area.

var maximum​Number​Of​Columns:​ Int

The maximum number of columns to display in the collection view’s visible area.

var minimum​Item​Size:​ NSSize

The smallest allowable size for an item’s view.

var maximum​Item​Size:​ NSSize

The largest allowable size for an item’s view.

Specifying the Grid Layout Attributes

var minimum​Interitem​Spacing:​ CGFloat

The minimum spacing (in points) to use between items in the same row or column.

var minimum​Line​Spacing:​ CGFloat

The minimum spacing (in points) to use between rows or columns.

var margins:​ Edge​Insets

The amount of empty space (in points) around the grid’s content.

Specifying the Grid Background Color

var background​Colors:​ [NSColor]!

The array of background colors to use when drawing the grid.

Relationships