Contents

searchBarPlacementAllowsExternalIntegration

A Boolean value that indicates whether an alternate object may integrate the search bar somewhere other than the navigation bar or toolbar.

Declaration

var searchBarPlacementAllowsExternalIntegration: Bool { get set }

Overview

Set this value to indicate whether an object at a higher scope may take the search bar and integrate it somewhere other than the navigation bar (or toolbar) directly associated with this navigation item. UISplitViewController uses this to allow Mac-like placement of the search bar on iPad. Defaults to false.

Set to true to allow the containing UISplitViewController to place the search bar in the navigation bar for the trailingmost column independent of the column used for this view controller. Ignored when searchController is nil, when searchBarPlacement is UINavigationItem.SearchBarPlacement.stacked, or when not contained in a UISplitViewController.

When the top view controller’s navigation item has this property set to true in more than one column at the same time, only one will be respected; the columns are checked in order of UISplitViewController.Column.inspector, UISplitViewController.Column.secondary, UISplitViewController.Column.supplementary, UISplitViewController.Column.primary. If the search bar has a scope bar, the scope bar will not be moved into a different column.

See Also

Integrating search into your interface