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

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

Разработчик

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

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

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

UISplitViewController

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

UISplitViewController класс является контейнерным контроллером представления, представляющим интерфейс основной подробности. В интерфейсе основной подробности изменения в основном контроллере представления (ведущее устройство) ведут к изменениям во вторичном контроллере представления (подробность). Два контроллера представления могут быть расположены так, чтобы они были бок о бок, так, чтобы только по одному было видимо, или так, чтобы одно единственное частично скрыло другой. В iOS 8 и позже, можно использовать UISplitViewController класс на всех устройствах на iOS; в предыдущих версиях iOS класс доступен только на iPad.

При создании пользовательского интерфейса приложения контроллер представления разделения обычно является корневым контроллером представления окна приложения. Контроллер представления разделения не имеет никакого значительного собственного появления. Большая часть его появления определяется дочерними контроллерами представления, которые Вы устанавливаете. Можно сконфигурировать дочернего Разработчика Интерфейса использования контроллеров представления или программно путем присвоения контроллеров представления viewControllers свойство. Дочерние контроллеры представления могут быть пользовательскими контроллерами представления или другим контейнерным контроллером представления, такими как контроллеры навигации.

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

Когда выведено на экран на экране, контроллер представления разделения работает со своим объектом делегата управлять представлением его дочерних контроллеров представления. Делегат является объектом, Вы обеспечиваете, что принимает UISplitViewControllerDelegate протокол. Используйте методы того протокола для настройки поведения интерфейса представления разделения, когда произойдут изменения. Для получения дополнительной информации о методах протокола, посмотрите Ссылку на протокол UISplitViewControllerDelegate.

Конфигурирование появления интерфейса представления разделения

Визуальной конфигурацией контроллера представления разделения управляет его текущий режим отображения. Вы не устанавливаете режим отображения непосредственно; вместо этого, Вы устанавливаете его косвенно использование preferredDisplayMode свойство. Контроллер представления разделения прилагает все усилия для уважения режима отображения, который Вы указываете, но не можете быть в состоянии разместить тот режим визуально из-за пространственных ограничений. Например, контроллер представления разделения не может вывести на экран свои дочерние контроллеры представления бок о бок в горизонтально компактной среде.

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

Режимы Table 1Display для разделения просматривают контроллер

Режим

Описание

Бок о бок

Оба контроллера представления выведены на экран на экране одновременно. Основной контроллер представления выведен на экран на левой стороне и обычно более узкий, чем вторичный контроллер представления. Можно скорректировать основную ширину контроллера представления с помощью preferredPrimaryColumnWidth свойство.

Этот режим отображения не применяется когда collapsed свойство YEStrue. В разрушенном интерфейсе только один контроллер представления за один раз видим.

Этот режим представлен UISplitViewControllerDisplayModeSideBySide постоянный.

Скрытый

Вторичный контроллер представления выведен на экран на экране, и основной контроллер представления от экрана.

Для отображения основного контроллера представления необходимо представить его модально или изменить режим отображения.

Этот режим представлен UISplitViewControllerDisplayModePrimaryHidden постоянный.

Наложение

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

Этот режим представлен UISplitViewControllerDisplayModeOverlay постоянный.

После установки предпочтительного режима отображения контроллер представления разделения обновляет себя и отражает фактический режим отображения в displayMode свойство. В любое время можно изменить предпочтительный режим отображения, и выполнение так заставляет контроллер представления разделения корректировать себя соответственно. Контроллер представления разделения также устанавливает встроенное устройство распознавания жеста, позволяющее пользователю изменить режим отображения с помощью сильно ударения. Можно подавить это устройство распознавания жеста путем установки presentsWithGesture свойство к NOfalse.

displayModeButtonItem метод возвращает специальный элемент кнопки панели для изменения режима отображения, который можно включить в пользовательский интерфейс приложения. Контроллер представления разделения управляет поведением и появлением этого элемента. Все, что необходимо сделать, добавляет это к надлежащей панели навигации или панели инструментов на интерфейсе. Когда коснулись, кнопка отправляет действие в контроллер представления разделения, говоря ему изменить его текущий режим отображения на тот, указанный targetDisplayModeForActionInSplitViewController: метод разделения просматривает делегата контроллера. Указание режима отображения автоматических (или не реализация метода делегата вообще) заставляют контроллер представления разделения реализовывать поведение, которое подходяще для текущего класса размера. Например, на iPad в портретной ориентации, контроллер представления разделения переключается между скрытыми режимами и режимами наложения. Основанные на жесте действия также используют метод делегата определить который режим отображения использовать.

Изменение дочернего элемента просматривает контроллеры в интерфейсе представления разделения

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

В случаях, где действительно необходимо изменить или основной или вторичный контроллер представления, рекомендуется сделать настолько использующий showViewController:sender: и showDetailViewController:sender: методы. Используя эти методы (вместо того, чтобы изменить viewControllers свойство непосредственно), позволяет разделению просмотреть настоящее контроллера указанный контроллер представления в пути, который является самым подходящим для текущего режима отображения и класса размера. Контроллер представления разделения знает, как скорректировать интерфейс более интуитивными способами. Это даже работает с другими контейнерными контроллерами представления (как контроллеры навигации) для представления контроллеров представления. Например, в компактной среде, где основной контроллер представления является контроллером навигации, вызывая showDetailViewController:sender: не заменяет вторичный контроллер представления. Вместо этого основной контроллер навигации продвигает контроллер представления на свой штабель навигации.

Разрушение и расширение интерфейса представления разделения

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

При переходе к разрушенному интерфейсу контроллер представления разделения работает со своим делегатом для управления переходом. В конце перехода краха контроллер представления разделения обычно показывает только содержание от своего основного контроллера представления. Можно изменить это поведение путем реализации primaryViewControllerForCollapsingSplitViewController: метод в Вашем разделении просматривает делегата контроллера. Вы могли бы использовать тот метод для указания вторичного контроллера представления или контроллера полностью другого представления — возможно, один лучше подходящий для дисплея в горизонтально компактной среде. Если Вы хотите выполнить какие-либо дополнительные корректировки контроллеров представления и иерархии представления, можно также реализовать splitViewController:collapseSecondaryViewController:ontoPrimaryViewController: метод в Вашем делегате.

Процесс расширения инвертирует разрушающийся процесс, прося, чтобы делегат определял, какой контроллер представления становится основным контроллером представления и дать делегату шанс выполнить сам переход. При реализации методов делегата для того, чтобы упасть в обморок интерфейс представления разделения необходимо также реализовать primaryViewControllerForExpandingSplitViewController: и splitViewController:separateSecondaryViewControllerFromPrimaryViewController: методы для расширения того интерфейса. Если Вы не реализуете ни одного из методов, контроллер представления разделения обеспечивает поведение по умолчанию обработать разрушение и расширение переходов.

Для получения дополнительной информации о методах Вы используете, чтобы управлять крахом и развернуть переходы, видеть Ссылку на протокол UISplitViewControllerDelegate.

Сообщение, передающее его дочерним контроллерам представления

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

Сохранение состояния

В iOS 6 и позже, если Вы присваиваете значение этому контроллеру представления разделения restorationIdentifier свойство, это сохраняет любые дочерние контроллеры представления, имеющие их собственный допустимый идентификатор восстановления. Во время следующего цикла запуска контроллер представления разделения восстанавливает сохраненные контроллеры представления к их предыдущему состоянию. Дочерние контроллеры представления контроллера представления разделения могут использовать те же идентификаторы восстановления. Контроллер представления разделения автоматически хранит дополнительную информацию, чтобы гарантировать, что тракт восстановления каждого дочернего элемента уникален.

Для получения дополнительной информации, о как сохранение состояния и реставрационные работы, см. Руководство по программированию Приложения для iOS.

Управление дочерними контроллерами представления
  • viewControllers Свойство

    Массив контроллеров представления, которыми управляет получатель.

    Объявление

    Swift

    var viewControllers: [AnyObject]

    Objective C

    @property(nonatomic, copy) NSArray *viewControllers

    Обсуждение

    Когда интерфейс представления разделения расширен, это свойство содержит два контроллера представления; когда это разрушено, это свойство содержит только один контроллер представления. Первый контроллер представления в массиве всегда является основным устройством (или ведущее устройство) контроллер представления. Если второй контроллер представления присутствует, тот контроллер представления является вторичным устройством (или подробность) контроллер представления.

    Когда конфигурирование разделения просматривает контроллер, можно использовать это свойство для присвоения основных и вторичных контроллеров представления, которые Вы хотите выведенный на экран первоначально. После того, как контроллер представления разделения является экранным, можно использовать это свойство для получения контроллеров представления в интерфейсе представления разделения. После того, как контроллер представления разделения является экранным, лучше установить дочерние контроллеры представления с помощью showDetailViewController:sender: или showViewController:sender: методы. Несмотря на то, что можно все еще изменить контроллеры представления в этом свойстве непосредственно, необходимо сделать так, только если Вы вручную управляете переходами контроллера представления своего приложения.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – showDetailViewController:sender:
    – showViewController:sender:

  • presentsWithGesture Свойство

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

    Объявление

    Swift

    var presentsWithGesture: Bool

    Objective C

    @property(nonatomic) BOOL presentsWithGesture

    Обсуждение

    Когда это свойство установлено в YEStrue, контроллер представления разделения устанавливает устройство распознавания жеста для изменения текущего режима отображения. Устройство распознавания жеста применяет режим отображения, возвращенный делегатом targetDisplayModeForActionInSplitViewController: метод. Если тот метод возвращается UISplitViewControllerDisplayModeAutomatic режим, контроллер представления разделения применяет самый надлежащий режим отображения, данный его текущую конфигурацию и класс размера.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Управление режимом отображения
  • preferredDisplayMode Свойство

    Предпочтительное расположение разделения просматривает интерфейс контроллера.

    Объявление

    Swift

    var preferredDisplayMode: UISplitViewControllerDisplayMode

    Objective C

    @property(nonatomic) UISplitViewControllerDisplayMode preferredDisplayMode

    Обсуждение

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

    Установка значения этого свойства к UISplitViewControllerDisplayModeAutomatic заставляет контроллер представления разделения выбирать самый надлежащий режим отображения для в настоящее время свободного места. На iPad это приводит к использованию режима UISplitViewControllerDisplayModeOverlay в портретных ориентациях и UISplitViewControllerDisplayModeSideBySide в альбомных ориентациях. Значение по умолчанию этого свойства UISplitViewControllerDisplayModeAutomatic.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    displayMode

  • displayMode Свойство

    Текущее расположение разделения просматривает содержание контроллера. (только для чтения)

    Объявление

    Swift

    var displayMode: UISplitViewControllerDisplayMode { get }

    Objective C

    @property(nonatomic, readonly) UISplitViewControllerDisplayMode displayMode

    Обсуждение

    Это свойство отражает расположение двух дочерних контроллеров представления в интерфейсе представления разделения. Значение в этом свойстве никогда не устанавливается в UISplitViewControllerDisplayModeAutomatic. Для изменения текущего режима отображения измените значение preferredDisplayMode свойство.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    preferredDisplayMode

  • displayModeButtonItem () - displayModeButtonItem

    Кнопка, изменяющая режим отображения контроллера представления разделения.

    Объявление

    Swift

    func displayModeButtonItem() -> UIBarButtonItem

    Objective C

    - (UIBarButtonItem *)displayModeButtonItem

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

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

    Обсуждение

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

    Не изменяйте конфигурацию возвращенной кнопки. Контроллер представления разделения обновляет конфигурацию и появление кнопки автоматически на основе текущего режима отображения и информации, предоставленной объектом делегата.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Получение конфигурации представления разделения
  • collapsed Свойство

    Булево значение, указывающее, выведен ли только один из дочерних контроллеров представления на экран. (только для чтения)

    Объявление

    Swift

    var collapsed: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isCollapsed) BOOL collapsed

    Обсуждение

    Это свойство установлено в YEStrue когда содержание контроллера представления разделения семантически разрушено в единственный контейнер. Разрушение происходит когда переходы контроллера представления разделения от горизонтально регулярный к горизонтально компактной среде. После того, как это было разрушено, разделение просматривают отчеты контроллера, имеющие только один дочерний контроллер представления в viewControllers свойство. Другой контроллер представления разрушен в другое содержание контроллера представления с помощью объекта делегата или отброшен временно. Когда разрушено, displayMode свойство не оказывает влияния на появление интерфейса контроллера представления разделения.

    Значение этого свойства NOfalse когда контроллер представления разделения способен к отображению обоих из его дочерних контроллеров представления одновременно, даже если это не показывает им обоим в данный момент. В этом расширенном режиме конфигурация контроллера представления разделения его дочерних контроллеров представления определяется displayMode свойство. Кроме того, viewControllers свойство содержит и основные и вторичные контроллеры представления.

    Во время перехода от расширенного до разрушился интерфейс, значение этого свойства NOfalse пока концы перехода краха и все соответствующие методы делегата не вызвали. Точно так же при переходе назад к расширенному интерфейсу, значение YEStrue пока переход не заканчивается.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • preferredPrimaryColumnWidthFraction Свойство

    Относительная ширина основного содержания контроллера представления.

    Объявление

    Swift

    var preferredPrimaryColumnWidthFraction: CGFloat

    Objective C

    @property(nonatomic, assign) CGFloat preferredPrimaryColumnWidthFraction

    Обсуждение

    Используйте это свойство для указания предпочтительной ширины для основного представления контроллера представления. Значение этого свойства является числом с плавающей точкой между 0.0 и 1.0 это представляет процент полной ширины контроллера представления разделения. Например, значение 0.4 представляет 40% текущей ширины. Значение по умолчанию этого свойства UISplitViewControllerAutomaticDimension, который приводит к надлежащей ширине для основного контроллера представления.

    Фактическая ширина основного контроллера представления ограничивается значениями в minimumPrimaryColumnWidth и maximumPrimaryColumnWidth свойства. Контроллер представления разделения предпринимает любую попытку соблюдать ширину, которую Вы указываете, но можете изменить это значение для размещения свободного места. Можно было присвоить фактическую ширину основному представлению контроллера представления от primaryColumnWidth свойство.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    primaryColumnWidth

  • primaryColumnWidth Свойство

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

    Объявление

    Swift

    var primaryColumnWidth: CGFloat { get }

    Objective C

    @property(nonatomic, readonly) CGFloat primaryColumnWidth

    Обсуждение

    Это свойство содержит фактическую ширину, применился к основному представлению контроллера представления.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    preferredPrimaryColumnWidthFraction

  • minimumPrimaryColumnWidth Свойство

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

    Объявление

    Swift

    var minimumPrimaryColumnWidth: CGFloat

    Objective C

    @property(nonatomic, assign) CGFloat minimumPrimaryColumnWidth

    Обсуждение

    Используйте это свойство в сочетании с maximumPrimaryColumnWidth свойство для обеспечения ширины основного содержания контроллера представления установлено в приемлемое значение. Предварительная ширина указана preferredPrimaryColumnWidthFraction свойство, применяющееся к разделению, просматривает ширину контроллера и проверенный по этим границам. Если получающаяся ширина является меньше, чем значение в этом свойстве, это установлено в значение в этом свойстве.

    Значение по умолчанию этого свойства UISplitViewControllerAutomaticDimension, который соответствует минимальной ширине 0 точек.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • maximumPrimaryColumnWidth Свойство

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

    Объявление

    Swift

    var maximumPrimaryColumnWidth: CGFloat

    Objective C

    @property(nonatomic, assign) CGFloat maximumPrimaryColumnWidth

    Обсуждение

    Используйте это свойство в сочетании с minimumPrimaryColumnWidth свойство для обеспечения ширины основного содержания контроллера представления установлено в приемлемое значение. Предварительная ширина указана preferredPrimaryColumnWidthFraction свойство, применяющееся к разделению, просматривает ширину контроллера и проверенный по этим границам. Если получающаяся ширина больше, чем значение в этом свойстве, это установлено в значение в этом свойстве.

    Значение по умолчанию этого свойства UISplitViewControllerAutomaticDimension, который соответствует минимальной ширине 320 точек.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Доступ к объекту делегата
  • delegate Свойство

    Делегат Вы хотите получить сообщения контроллера представления разделения.

    Объявление

    Swift

    unowned(unsafe) var delegate: UISplitViewControllerDelegate?

    Objective C

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

    Обсуждение

    Контроллер представления разделения использует своего делегата для управления показом и сокрытием связанных контроллеров представления. Для получения дополнительной информации о методах можно реализовать в делегате, видеть Ссылку на протокол UISplitViewControllerDelegate.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Методы действия для отображения контроллеров представления
  • showDetailViewController (_: отправитель:) - showDetailViewController:sender:

    Представляет указанный контроллер представления как вторичный контроллер представления интерфейса представления разделения.

    Объявление

    Swift

    func showDetailViewController(_ vc: UIViewController!, sender sender: AnyObject!)

    Objective C

    - (void)showDetailViewController:(UIViewController *)vc sender:(id)sender

    Параметры

    vc

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

    sender

    Контроллер представления или представления, выполнивший запрос.

    Обсуждение

    Каждый раз, когда возможно, используйте этот метод (вместо того, чтобы изменить содержание viewControllersсвойство непосредственно) для замены вторичного контроллера представления разделения просматривают интерфейс. Этот метод выводит на экран указанный контроллер представления лучшим способом, возможным данный текущий класс размера в действительности. Это также использует в своих интересах существующие способы поведения контроллера навигации, когда это возможно, для минимизации изменений в интерфейсе представления разделения.

    Это вызовы метода делегат splitViewController:showDetailViewController:sender: метод, чтобы дать делегату возможность показать контроллер представления. Если делегат не показывает контроллер представления, контроллер представления разделения передает сообщение к контроллеру представления, заменяемому, чтобы видеть, хочет ли это сделать что-нибудь. Например, контроллер навигации отвечает путем продвижения vc на его штабель навигации. Если никакой другой объект не хочет показать контроллер представления, контроллер представления разделения показывает его с помощью следующей эвристики:

    • В горизонтально регулярной среде, установках контроллера представления разделения vc как вторичный контроллер представления.

    • В горизонтально компактной среде, подарках контроллера представления разделения vc модально.

    Все контроллеры представления реализуют этот метод. Если они не показывают контроллер представления сами, они передают сообщение к родительскому контроллеру представления разделения (если таковые имеются) и позволяют ему показать контроллер представления. В результате дочерний контроллер представления может вызвать этот метод на себе для достижения тех же результатов как вызывающий этот метод на объекте контроллера представления разделения.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • showViewController (_: отправитель:) - showViewController:sender:

    Представляет указанный контроллер представления как основной контроллер представления в интерфейсе представления разделения.

    Объявление

    Swift

    func showViewController(_ vc: UIViewController, sender sender: AnyObject!)

    Objective C

    - (void)showViewController:(UIViewController *)vc sender:(id)sender

    Параметры

    vc

    Контроллер представления для отображения в основном устройстве (или ведущее устройство) расположения разделения просматривает интерфейс.

    sender

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

    Обсуждение

    Каждый раз, когда возможно, используйте этот метод (вместо того, чтобы изменить содержание viewControllersсвойство непосредственно) для замены основного контроллера представления разделения просматривают интерфейс. Этот метод выводит на экран указанный контроллер представления лучшим способом, возможным данный текущий класс размера в действительности.

    Когда Вы хотите заменить основной контроллер представления тем, указанным в, Как правило, Вы вызываете этот метод от метода действия vc. Это вызовы метода делегат контроллера представления разделения splitViewController:showViewController:sender: метод, чтобы дать делегату возможность показать контроллер представления. Если делегат не показывает контроллер представления, контроллер представления разделения показывает его с помощью следующей эвристики:

    • В горизонтально регулярной среде, установках контроллера представления разделения vc как основной контроллер представления, если vc уже дочерний элемент основного контроллера представления, когда он устанавливает vc как вторичный контроллер представления.

    • В горизонтально компактной среде, подарках контроллера представления разделения vc модально.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Константы
  • UISplitViewControllerDisplayMode

    Константы, описывающие возможные режимы отображения для разделения, просматривают контроллер.

    Объявление

    Swift

    enum UISplitViewControllerDisplayMode : Int { case Automatic case PrimaryHidden case AllVisible case PrimaryOverlay }

    Objective C

    typedef enum UISplitViewControllerDisplayMode : NSInteger { UISplitViewControllerDisplayModeAutomatic, UISplitViewControllerDisplayModePrimaryHidden, UISplitViewControllerDisplayModeAllVisible, UISplitViewControllerDisplayModePrimaryOverlay, } UISplitViewControllerDisplayMode;

    Константы

    • Automatic

      UISplitViewControllerDisplayModeAutomatic

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

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

    • PrimaryHidden

      UISplitViewControllerDisplayModePrimaryHidden

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

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

    • AllVisible

      UISplitViewControllerDisplayModeAllVisible

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

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

    • PrimaryOverlay

      UISplitViewControllerDisplayModePrimaryOverlay

      Основной контроллер представления разделен на уровни поверх вторичного контроллера представления, оставив вторичный контроллер представления частично видимым.

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

    Обсуждение

    Режимы отображения применяются к контроллеру представления разделения в расширенном расположении. Когда интерфейс представления разделения разрушен, режим отображения проигнорирован.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • Размерности контроллера представления разделения

    Постоянное указание ширины по умолчанию для основного контроллера представления.

    Объявление

    Swift

    let UISplitViewControllerAutomaticDimension: CGFloat

    Objective C

    CGFloat const UISplitViewControllerAutomaticDimension;

    Константы

    • UISplitViewControllerAutomaticDimension

      Значение по умолчанию для применения к данной размерности.

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