Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы UIKit ссылка класса UIPageViewController

Опции
Развертывание Target:

На этой странице
Язык:

UIPageViewController

Наследование

Соответствует

Оператор импорта

Swift

import UIKit

Objective C

@import UIKit;

Доступность

Доступный в iOS 5.0 и позже.

Контроллер просмотра позволяет пользователю перейти между страницами содержания, где каждой страницей управляет ее собственный объект контроллера представления. Навигацией может управлять программно Ваше приложение или непосредственно пользователем, использующим жесты. При навигации от страницы до страницы контроллер просмотра использует переход, который Вы указываете для анимации изменения.

При определении интерфейса контроллера просмотра можно обеспечить довольное контроллеры представления по одному (или два за один раз, в зависимости от позиции позвоночника и двустороннего состояния) или по мере необходимости использование источника данных. Когда обеспечение содержания просматривает контроллеры по одному, Вы используете setViewControllers:direction:animated:completion: метод для установки тока, довольного контроллеры представления. Для поддержки основанной на жесте навигации необходимо обеспечить контроллеры представления с помощью объекта источника данных.

Источник данных для контроллера просмотра ответственен за обеспечение довольного контроллеры представления по требованию и должен соответствовать UIPageViewControllerDataSource протокол. Объект делегата — объект, соответствующий UIPageViewControllerDelegate протокол — предоставляет некоторую связанную с появлением информацию и получает уведомления об инициируемых в жест переходах.

Этот класс обычно используется как есть, но может быть разделен на подклассы в iOS 6 и позже.

Создание контроллеров просмотра
  • init (transitionStyle:navigationOrientation:options:) - initWithTransitionStyle:navigationOrientation:options:

    Инициализирует недавно создаваемый контроллер просмотра.

    Объявление

    Swift

    init(transitionStyle style: UIPageViewControllerTransitionStyle, navigationOrientation navigationOrientation: UIPageViewControllerNavigationOrientation, options options: [NSObject : AnyObject]?)

    Objective C

    - (instancetype)initWithTransitionStyle:(UIPageViewControllerTransitionStyle)style navigationOrientation:(UIPageViewControllerNavigationOrientation)navigationOrientation options:(NSDictionary *)options

    Параметры

    style

    Стиль для переходов между страницами.

    navigationOrientation

    Ориентация постранично навигации.

    options

    Словарь опций. Для ключей посмотрите Ключи Опций.

    Возвращаемое значение

    Инициализированный контроллер просмотра.

    Обсуждение

    После инициализации используйте setViewControllers:direction:animated:completion: метод для установки начальных контроллеров представления.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

  • dataSource Свойство

    Объект, обеспечивающий контроллеры представления.

    Объявление

    Swift

    unowned(unsafe) var dataSource: UIPageViewControllerDataSource?

    Objective C

    @property(nonatomic, assign) id< UIPageViewControllerDataSource > dataSource

    Обсуждение

    Методы источника данных вызывают в ответ на основанную на жесте навигацию. Если значение этого свойства nil, тогда основанная на жесте навигация отключена.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

  • delegate Свойство

    Объект делегата.

    Объявление

    Swift

    unowned(unsafe) var delegate: UIPageViewControllerDelegate?

    Objective C

    @property(nonatomic, assign) id< UIPageViewControllerDelegate > delegate

    Обсуждение

    Методы делегата вызывают в ответ на основанные на жесте изменения навигации и ориентации.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

Обеспечение содержания
  • setViewControllers (_: direction:animated:completion:) - setViewControllers:direction:animated:completion:

    Устанавливает контроллеры представления, которые будут выведены на экран.

    Объявление

    Swift

    func setViewControllers(_ viewControllers: [AnyObject]!, direction direction: UIPageViewControllerNavigationDirection, animated animated: Bool, completion completion: ((Bool) -> Void)!)

    Objective C

    - (void)setViewControllers:(NSArray *)viewControllers direction:(UIPageViewControllerNavigationDirection)direction animated:(BOOL)animated completion:(void (^)(BOOL finished))completion

    Параметры

    viewControllers

    Контроллер представления или контроллеры представления, которые будут выведены на экран.

    direction

    Направление навигации.

    animated

    Булево значение, указывающее, должен ли быть анимирован переход.

    completion

    Блок, который вызовут, когда завершается анимация поворота страницы.

    Блок берет следующие параметры:

    finished

    YEStrue если закончилась анимация; NOfalse если это было пропущено.

    Обсуждение

    Контроллеры представления, переданные этому методу, являются теми, которые будут видимы после того, как завершилась анимация. Используйте источник данных для обеспечения дополнительных контроллеров представления, к которым перешли пользователи.

    Если стиль перехода UIPageViewControllerTransitionStylePageCurl, контроллеры представления для передачи в viewControllers параметр зависит от расположения позвоночника и значения doubleSided свойство:

    Расположение позвоночника

    Двухсторонний

    Что передать

    UIPageViewControllerSpineLocationMid

    YEStrue

    Передайте страницу, которая будет выведена на экран слева и страница, которая будет выведена на экран справа.

    UIPageViewControllerSpineLocationMin или UIPageViewControllerSpineLocationMax

    YEStrue

    Передайте переднюю сторону страницы, которая будет выведена на экран и спина ранее выведенной на экран страницы. Спина используется для анимации превращения страницы.

    UIPageViewControllerSpineLocationMin или UIPageViewControllerSpineLocationMax

    NOfalse

    Передайте переднюю сторону страницы, которая будет выведена на экран.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

    См. также

    viewControllers

  • viewControllers Свойство

    Контроллеры представления выведены на экран контроллером просмотра. (только для чтения)

    Объявление

    Swift

    var viewControllers: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *viewControllers

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

    См. также

    – setViewControllers:direction:animated:completion:

  • gestureRecognizers Свойство

    Массив UIGestureRecognizer объекты, сконфигурированные для обработки взаимодействия с пользователем. (только для чтения)

    Объявление

    Swift

    var gestureRecognizers: [AnyObject] { get }

    Objective C

    @property(nonatomic, readonly) NSArray *gestureRecognizers

    Обсуждение

    Эти устройства распознавания жеста первоначально присоединены к представлению в иерархии контроллера просмотра. Для изменения области экрана, на котором пользователь может переместиться по жестам использования они могут быть размещены в другое представление.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

Параметры экрана
  • navigationOrientation Свойство

    Направление, вдоль которого происходит навигация. (только для чтения)

    Объявление

    Swift

    var navigationOrientation: UIPageViewControllerNavigationOrientation { get }

    Objective C

    @property(nonatomic, readonly) UIPageViewControllerNavigationOrientation navigationOrientation

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

  • spineLocation Свойство

    Расположение позвоночника. (только для чтения)

    Объявление

    Swift

    var spineLocation: UIPageViewControllerSpineLocation { get }

    Objective C

    @property(nonatomic, readonly) UIPageViewControllerSpineLocation spineLocation

    Обсуждение

    Значение этого свойства установлено с UIPageViewControllerOptionSpineLocationKey ключ, когда контроллер просмотра инициализируется и может быть изменен путем возврата нового значения из pageViewController:spineLocationForInterfaceOrientation: метод делегата.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

  • transitionStyle Свойство

    Стиль раньше переходил между контроллерами представления. (только для чтения)

    Объявление

    Swift

    var transitionStyle: UIPageViewControllerTransitionStyle { get }

    Objective C

    @property(nonatomic, readonly) UIPageViewControllerTransitionStyle transitionStyle

    Обсуждение

    Когда контроллер просмотра инициализируется и не может быть изменен, значение этого свойства установлено.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

  • doubleSided Свойство

    Булево значение, указывающее, появляется ли содержание в конце страниц.

    Объявление

    Swift

    var doubleSided: Bool

    Objective C

    @property(nonatomic, getter=isDoubleSided) BOOL doubleSided

    Обсуждение

    Значение по умолчанию для этого свойства NOfalse.

    Если спина страниц не имеет никакого содержания (значение NOfalse), тогда содержание на передней стороне страницы частично покажет через спине при превращении страниц.

    Если позвоночник расположен в середине, значение должно быть YEStrue. Установка его к NOfalse с позвоночником, расположенным в середине, повышает исключение.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

Константы
  • Ориентации навигации

    Ориентации для переходов поворота страницы.

    Объявление

    Swift

    enum UIPageViewControllerNavigationOrientation : Int { case Horizontal case Vertical }

    Objective C

    enum { UIPageViewControllerNavigationOrientationHorizontal = 0, UIPageViewControllerNavigationOrientationVertical = 1 }; typedef NSInteger UIPageViewControllerNavigationOrientation;

    Константы

    • Horizontal

      UIPageViewControllerNavigationOrientationHorizontal

      Горизонтальная ориентация, со страницами, становящимися левыми и правыми.

      Доступный в iOS 5.0 и позже.

    • Vertical

      UIPageViewControllerNavigationOrientationVertical

      Вертикальная ориентация, со страницами, поворачивающимися вверх и вниз.

      Доступный в iOS 5.0 и позже.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

  • Направления навигации

    Направления для переходов поворота страницы.

    Объявление

    Swift

    enum UIPageViewControllerNavigationDirection : Int { case Forward case Reverse }

    Objective C

    enum { UIPageViewControllerNavigationDirectionForward, UIPageViewControllerNavigationDirectionReverse }; typedef NSInteger UIPageViewControllerNavigationDirection;

    Константы

    • Forward

      UIPageViewControllerNavigationDirectionForward

      Навигация к следующей странице.

      Доступный в iOS 5.0 и позже.

    • Reverse

      UIPageViewControllerNavigationDirectionReverse

      Навигация к предыдущей странице.

      Доступный в iOS 5.0 и позже.

    Обсуждение

    Для горизонтальной навигации страницы поворачиваются от правой стороны экрана налево, поскольку Вы перешли вперед.

    Для вертикальной навигации страницы поворачиваются от нижней части экрана до вершины, поскольку Вы перешли вперед.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

  • Стили перехода

    Стили для перехода поворота страницы.

    Объявление

    Swift

    enum UIPageViewControllerTransitionStyle : Int { case PageCurl case Scroll }

    Objective C

    enum { UIPageViewControllerTransitionStylePageCurl = 0 UIPageViewControllerTransitionStyleScroll = 1 }; typedef NSInteger UIPageViewControllerTransitionStyle;

    Константы

    • PageCurl

      UIPageViewControllerTransitionStylePageCurl

      Стиль перехода завихрения страницы.

      Когда стиль перехода завихрения страницы указан, контроллер просмотра выводит на экран поворачивающую страницу анимацию при переходе между контроллерами представления. Если источник данных указан, анимация следует за пальцем пользователя во время жеста навигации.

      Доступный в iOS 5.0 и позже.

    • Scroll

      UIPageViewControllerTransitionStyleScroll

      Прокрутка стиля перехода.

      Когда стиль прокрутки страницы указан, контроллер просмотра выводит на экран прокручивающую страницу анимацию при переходе между контроллерами представления. Если источник данных указан, анимация следует за пальцем пользователя во время жеста навигации.

      Доступный в iOS 6.0 и позже.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.

  • Ключи опций

    Ключи для словаря опций.

    Объявление

    Swift

    let UIPageViewControllerOptionSpineLocationKey: String let UIPageViewControllerOptionInterPageSpacingKey: String

    Objective C

    NSString * const UIPageViewControllerOptionSpineLocationKey; NSString * const UIPageViewControllerOptionInterPageSpacingKey;

    Константы

    • UIPageViewControllerOptionSpineLocationKey

      Расположение позвоночника.

      Для возможных значений посмотрите Расположения Позвоночника. Если стиль перехода, расположение позвоночника только допустимо UIPageViewControllerTransitionStylePageCurl.

      Если стиль перехода UIPageViewControllerTransitionStylePageCurl, значение по умолчанию для этого свойства UIPageViewControllerSpineLocationMin; иначе, значение по умолчанию UIPageViewControllerSpineLocationNone.

      Доступный в iOS 5.0 и позже.

    • UIPageViewControllerOptionInterPageSpacingKey

      Пространство между страницами, в точках.

      Значение должно быть a CGFloat обернутый в экземпляр NSNumber. Значение по умолчанию является нулем. Если стиль перехода, интервал межстраницы только допустим UIPageViewControllerTransitionStyleScroll.

      Доступный в iOS 6.0 и позже.

    Обсуждение

    См. также initWithTransitionStyle:navigationOrientation:options:.

  • Расположения позвоночника

    Расположения для позвоночника.

    Объявление

    Swift

    enum UIPageViewControllerSpineLocation : Int { case None case Min case Mid case Max }

    Objective C

    enum { UIPageViewControllerSpineLocationNone = 0, UIPageViewControllerSpineLocationMin = 1, UIPageViewControllerSpineLocationMid = 2, UIPageViewControllerSpineLocationMax = 3 }; typedef NSInteger UIPageViewControllerSpineLocation;

    Константы

    • None

      UIPageViewControllerSpineLocationNone

      Никакой позвоночник.

      Если стиль перехода, это расположение позвоночника не допустимо UIPageViewControllerTransitionStylePageCurl.

      Доступный в iOS 5.0 и позже.

    • Min

      UIPageViewControllerSpineLocationMin

      Позвоночник в левых или главном краю экрана.

      Один контроллер представления выведен на экран за один раз.

      Доступный в iOS 5.0 и позже.

    • Mid

      UIPageViewControllerSpineLocationMid

      Позвоночник в середине или экране.

      Два контроллера представления выведены на экран за один раз.

      Доступный в iOS 5.0 и позже.

    • Max

      UIPageViewControllerSpineLocationMax

      Позвоночник в правом или базовом краю экрана.

      Один контроллер представления выведен на экран за один раз.

      Доступный в iOS 5.0 и позже.

    Обсуждение

    Для установки расположения позвоночника оберните одну из этих констант в NSNumber объект и набор это как значение для UIPageViewControllerOptionSpineLocationKey введите словарь опций, переданный initWithTransitionStyle:navigationOrientation:options: метод.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 5.0 и позже.