Instance Method

beginCustomizingItems:

Presents a standard interface that lets the user customize the contents of the tab bar.

Declaration

- (void)beginCustomizingItems:(NSArray<UITabBarItem *> *)items;

Parameters

items

An array of UITabBarItem objects representing all of the items that can possibly be displayed on the tab bar. Always include at least one visible item in the tab bar. This parameter must not be nil or contain an empty array.

Discussion

This method presents a custom interface that lets the user replace existing tab bar items with items in the specified array. The interface also lets the user rearrange items on the tab bar, but it does not let the user change the total number of items. The interface includes a Done button that automatically dismisses the interface. You can also dismiss the interface programmatically using the endCustomizingAnimated: method.

The items parameter should include all items currently visible in the tab bar that you allow to be replaced. Any currently visible items that are not included in this array remain fixed in place on the tab bar and cannot be repositioned or replaced by the user. If the user removes the currently selected item from the tab bar, the selectedItem property is set to nil.

The tab bar notifies its delegate about the pending customizations at various points during the presentation and dismissal of the interface. If you want to track when customizations begin and end, provide a delegate and assign it to the tab bar’s delegate property. For more information about the methods you can implement, see UITabBarDelegate.

See Also

Supporting User Customization of Tab Bars

- endCustomizingAnimated:

Dismisses the standard interface used to customize the tab bar.

customizing

A Boolean value indicating whether the user is currently customizing the tab bar.