Class

UIPageControl

You use the UIPageControl class to create and manage page controls. A page control displays a horizontal series of dots, each of which corresponds to a page in the application’s document (or other data-model entity). The currently viewed page is indicated by a white dot.

Overview

For an example of a page control, see the Weather application (with a number of locations configured) or Safari (with a number of tab views set).

When a user taps a page control to move to the next or previous page, the control sends the valueChanged event for handling by the delegate. The delegate can then evaluate the currentPage property to determine the page to display. The page control advances only one page in either direction.

For more information about appearance and behavior configuration, see Page Controls.

Symbols

Managing the Page Navigation

var currentPage: Int

The current page, shown by the receiver as a white dot.

var numberOfPages: Int

The number of pages the receiver shows (as dots).

var hidesForSinglePage: Bool

A Boolean value that controls whether the page control is hidden when there is only one page.

Updating the Page Display

var pageIndicatorTintColor: UIColor?

The tint color to be used for the page indicator.

var currentPageIndicatorTintColor: UIColor?

The tint color to be used for the current page indicator.

var defersCurrentPageDisplay: Bool

A Boolean value that controls when the current page is displayed.

func updateCurrentPageDisplay()

Updates the page indicator to the current page.

Resizing the Control

func size(forNumberOfPages: Int)

Returns the size the receiver’s bounds should be to accommodate the given number of pages.

Relationships

Inherits From