UIPopoverController

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

NSObject
UIPopoverController

NSObject
UIPopoverController

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

Для отображения легкой сдобы создайте экземпляр этого класса и представьте его с помощью одного из надлежащих методов. При инициализации экземпляра этого класса необходимо указать контроллер представления, обеспечивающий содержание для легкой сдобы. Легкая сдоба обычно получает свой размер из контроллера представления, который они представляют. Однако можно изменить размер легкой сдобы путем изменения значения в popoverContentSize свойство или путем вызова setPopoverContentSize:animated: метод. Если необходимо анимировать изменения в размере легкой сдобы, последний подход является особенно эффективным. Размер, который Вы указываете, является просто предпочтительным размером для представления легкой сдобы. Фактический размер может быть изменен, чтобы гарантировать, что адаптации легкой сдобы на экране и не сталкиваются с клавиатурой.

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

Если пользователь поворачивает устройство, в то время как легкая сдоба видима, контроллер легкой сдобы скрывает легкую сдобу и затем показывает его снова в конце вращения. Контроллер легкой сдобы пытается расположить легкую сдобу соответственно для Вас, но можно также реализовать popoverController:willRepositionPopoverToRect:inView: метод в легкой сдобе делегирует для указания новой позиции.

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

Инициализация легкой сдобы


    
    init (contentViewController:)
    - initWithContentViewController:

Возвращает инициализированный объект контроллера легкой сдобы.

Объявление

Swift

init(contentViewController viewController: UIViewController)

Objective C

- (instancetype)initWithContentViewController:(UIViewController *)viewController

Параметры


      viewController

Контроллер представления для управления содержанием легкой сдобы. Этот параметр не должен быть nil.

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

Инициализированный объект контроллера легкой сдобы.

Обсуждение

При инициализации контроллера легкой сдобы необходимо указать объект контроллера представления, содержание которого должно быть выведено на экран в легкой сдобе. Можно изменить этот контроллер представления позже путем изменения contentViewController свойство.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Представление и отклонение легкой сдобы


    
    presentPopoverFromRect (_: inView:permittedArrowDirections:animated:)
    - presentPopoverFromRect:inView:permittedArrowDirections:animated:

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

Объявление

Swift

func presentPopoverFromRect(_ rect: CGRect, inView view: UIView, permittedArrowDirections arrowDirections: UIPopoverArrowDirection, animated animated: Bool)

Objective C

- (void)presentPopoverFromRect:(CGRect)rect inView:(UIView *)view permittedArrowDirections:(UIPopoverArrowDirection)arrowDirections animated:(BOOL)animated

Параметры

`rect`	Прямоугольник в поле зрения, в котором можно привязать окно легкой сдобы.
`view`	Представление, содержащее прямоугольник привязки для легкой сдобы.
`arrowDirections`	Направлениям стрелки легкая сдоба разрешают использовать. Можно использовать это значение, чтобы вынудить легкую сдобу быть расположенной на определенную сторону прямоугольника. Однако обычно лучше указать `UIPopoverArrowDirectionAny` и позвольте легкой сдобе решить лучшее размещение. Вы не должны указывать `UIPopoverArrowDirectionUnknown` для этого параметра.
`animated`	Указать `YEStrue` анимировать представление легкой сдобы или `NOfalse` вывести на экран его сразу.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    presentPopoverFromBarButtonItem (_: permittedArrowDirections:animated:)
    - presentPopoverFromBarButtonItem:permittedArrowDirections:animated:

Выводит на экран легкую сдобу и привязывает его к указанному элементу кнопки панели.

Объявление

Swift

func presentPopoverFromBarButtonItem(_ item: UIBarButtonItem, permittedArrowDirections arrowDirections: UIPopoverArrowDirection, animated animated: Bool)

Objective C

- (void)presentPopoverFromBarButtonItem:(UIBarButtonItem *)item permittedArrowDirections:(UIPopoverArrowDirection)arrowDirections animated:(BOOL)animated

Параметры

`item`	Элемент кнопки панели, на котором можно привязать легкую сдобу.
`arrowDirections`	Направлениям стрелки легкая сдоба разрешают использовать. Можно использовать это значение, чтобы вынудить легкую сдобу быть расположенной на определенную сторону элемента кнопки панели. Однако обычно лучше указать `UIPopoverArrowDirectionAny` и позвольте легкой сдобе решить лучшее размещение. Вы не должны указывать `UIPopoverArrowDirectionUnknown` для этого параметра.
`animated`	Указать `YEStrue` анимировать представление легкой сдобы или `NOfalse` вывести на экран его сразу.

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    dismissPopoverAnimated (_:)
    - dismissPopoverAnimated:

Отклоняет легкую сдобу программно.

Объявление

Swift

func dismissPopoverAnimated(_ animated: Bool)

Objective C

- (void)dismissPopoverAnimated:(BOOL)animated

Параметры


      animated

Указать YEStrue анимировать увольнение легкой сдобы или NOfalse отклонить его сразу.

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Конфигурирование содержания легкой сдобы

contentViewController Свойство

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

Объявление

Swift

var contentViewController: UIViewController

Objective C

@property(nonatomic, retain) UIViewController *contentViewController

Обсуждение

Это свойство первоначально установлено в контроллер представления, переданный initWithContentViewController: метод. Можно изменить значение этого свойства позже для отражения нового набора содержания. Изменение значения этого свойства загружает новый контроллер представления для старого сразу и не инициировало анимацию. Если Вы хотите анимировать изменение, используйте setContentViewController:animated: метод вместо этого.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

– setContentViewController:animated:


    
    setContentViewController (_: анимированный:)
    - setContentViewController:animated:

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

Объявление

Swift

func setContentViewController(_ viewController: UIViewController, animated animated: Bool)

Objective C

- (void)setContentViewController:(UIViewController *)viewController animated:(BOOL)animated

Параметры

`viewController`	Новый контроллер представления, содержание которого должно быть выведено на экран легкой сдобой.
`animated`	Указать `YEStrue` если изменение контроллеров представления должно быть анимировано или `NOfalse` если изменение должно сразу произойти.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

popoverContentSize Свойство

Размер представления содержания легкой сдобы.

Объявление

Swift

var popoverContentSize: CGSize

Objective C

@property(nonatomic) CGSize popoverContentSize

Обсуждение

Это свойство представляет размер довольного представление, которым управляет контроллер представления в contentViewController свойство. Начальное значение этого свойства установлено оценить в контроллере представления contentSizeForViewInPopover свойство. Изменение значения этого свойства переопределяет значение по умолчанию контроллера текущего представления. Переопределенное значение сохраняется, пока Вы не присваиваете новое довольное контроллер представления получателю. Таким образом, если Вы хотите сохранить свое переопределенное значение, необходимо повторно присвоить его после изменения довольного контроллер представления.

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    setPopoverContentSize (_: анимированный:)
    - setPopoverContentSize:animated:

Изменяет размер представления содержания легкой сдобы.

Объявление

Swift

func setPopoverContentSize(_ size: CGSize, animated animated: Bool)

Objective C

- (void)setPopoverContentSize:(CGSize)size animated:(BOOL)animated

Параметры

`size`	Новый размер для применения к довольному представление.
`animated`	Указать `YEStrue` если Вы хотите, чтобы изменение в размере было анимировано или `NOfalse` если Вы хотите, чтобы изменение сразу появилось.

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

passthroughViews Свойство

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

Объявление

Swift

var passthroughViews: [AnyObject]?

Objective C

@property(nonatomic, copy) NSArray *passthroughViews

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Получение атрибутов легкой сдобы

popoverVisible Свойство

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

Объявление

Swift

var popoverVisible: Bool { get }

Objective C

@property(nonatomic, readonly, getter=isPopoverVisible) BOOL popoverVisible

Обсуждение

Необходимо представить легкую сдобу для создания его видимым.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Направление стрелки легкой сдобы. (только для чтения)

Объявление

Swift

var popoverArrowDirection: UIPopoverArrowDirection { get }

Objective C

@property(nonatomic, readonly) UIPopoverArrowDirection popoverArrowDirection

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Доступ к делегату

delegate Свойство

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

Объявление

Swift

unowned(unsafe) var delegate: UIPopoverControllerDelegate?

Objective C

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Настройка появления легкой сдобы

popoverLayoutMargins Свойство

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

Объявление

Swift

var popoverLayoutMargins: UIEdgeInsets

Objective C

@property(nonatomic, readwrite) UIEdgeInsets popoverLayoutMargins

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Класс для использования для отображения фонового содержания легкой сдобы.

Объявление

Swift

var popoverBackgroundViewClass: AnyClass?

Objective C

@property(nonatomic, readwrite, retain) Class popoverBackgroundViewClass

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Цвет представления фона легкой сдобы.

Объявление

Swift

@NSCopying var backgroundColor: UIColor?

Objective C

@property(nonatomic, copy) UIColor *backgroundColor

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Константы

UIPopoverArrowDirection
Константы для указания направления стрелки легкой сдобы.

Объявление

Swift

struct UIPopoverArrowDirection : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var Up: UIPopoverArrowDirection { get } static var Down: UIPopoverArrowDirection { get } static var Left: UIPopoverArrowDirection { get } static var Right: UIPopoverArrowDirection { get } static var Any: UIPopoverArrowDirection { get } static var Unknown: UIPopoverArrowDirection { get } }

Objective C

enum { UIPopoverArrowDirectionUp = 1UL << 0, UIPopoverArrowDirectionDown = 1UL << 1, UIPopoverArrowDirectionLeft = 1UL << 2, UIPopoverArrowDirectionRight = 1UL << 3, UIPopoverArrowDirectionAny = UIPopoverArrowDirectionUp | UIPopoverArrowDirectionDown | UIPopoverArrowDirectionLeft | UIPopoverArrowDirectionRight, UIPopoverArrowDirectionUnknown = NSUIntegerMax }; typedef NSUInteger UIPopoverArrowDirection;

Константы
- Up
  
  UIPopoverArrowDirectionUp
  
  Стрелка, указывающая вверх.
  
  Доступный в iOS 3.2 и позже.
- Down
  
  UIPopoverArrowDirectionDown
  
  Стрелка, указывающая вниз.
  
  Доступный в iOS 3.2 и позже.
- Left
  
  UIPopoverArrowDirectionLeft
  
  Стрелка, указывающая на левых.
  
  Доступный в iOS 3.2 и позже.
- Right
  
  UIPopoverArrowDirectionRight
  
  Стрелка, указывающая на право.
  
  Доступный в iOS 3.2 и позже.
- Any
  
  UIPopoverArrowDirectionAny
  
  Стрелка, указывающая в любом направлении.
  
  Доступный в iOS 3.2 и позже.
- Unknown
  
  UIPopoverArrowDirectionUnknown
  
  Состояние стрелки в настоящее время неизвестно.
  
  Доступный в iOS 3.2 и позже.
Оператор импорта

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

UIPopoverController

Инициализация легкой сдобы

Объявление

Параметры

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

Обсуждение

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

Доступность

Представление и отклонение легкой сдобы

Объявление

Параметры

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

Доступность

Объявление

Параметры

Обсуждение

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

Доступность

Объявление

Параметры

Обсуждение

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

Доступность

Конфигурирование содержания легкой сдобы

Объявление

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Доступность

Объявление

Обсуждение

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

Доступность

Объявление

Параметры

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Получение атрибутов легкой сдобы

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Доступ к делегату

Объявление

Обсуждение

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

Доступность

Настройка появления легкой сдобы

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Константы

Объявление

Константы

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

Доступность