Class

NSCollectionViewGridLayout

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

Overview

The NSCollectionViewGridLayout object provides the same layout behavior offered by the NSCollectionView 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 NSCollectionViewGridLayout object programmatically and assign it to the collection view’s collectionViewLayout 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 maximumNumberOfRows: Int

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

var maximumNumberOfColumns: Int

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

var minimumItemSize: NSSize

The smallest allowable size for an item’s view.

var maximumItemSize: NSSize

The largest allowable size for an item’s view.

Specifying the Grid Layout Attributes

var minimumInteritemSpacing: CGFloat

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

var minimumLineSpacing: CGFloat

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

var margins: EdgeInsets

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

Specifying the Grid Background Color

var backgroundColors: [NSColor]!

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

Relationships

Conforms To