QLPreviewControllerDelegate

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

Не применимый

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

NSObjectProtocol
NSObject

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

Swift

import QuickLook

Objective C

@import QuickLook;

Доступность

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

Реализуйте методы этого протокола в делегате a QLPreviewController (Контроллер предварительного просмотра беглого взгляда), возражают против:

Обеспечьте анимацию изменения масштаба для предварительных просмотров Беглого взгляда.
Укажите, открывает ли Ваше приложение URL, которого пользователь касается в предварительном просмотре
Реагируйте на открытие или закрытие предварительного просмотра

Делегат a QLPreviewController объект должен принять этот протокол. Методы, описанные здесь, являются дополнительными, но ожидаются.

Ответ на запросы предварительного просмотра


    
    previewController (_: frameForPreviewItem:inSourceView:)
    - previewController:frameForPreviewItem:inSourceView:

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

Объявление

Swift

optional func previewController(_ controller: QLPreviewController!, frameForPreviewItem item: QLPreviewItem!, inSourceView view: AutoreleasingUnsafeMutablePointer<UIView?>) -> CGRect

Objective C

- (CGRect)previewController:(QLPreviewController *)controller frameForPreviewItem:(id<QLPreviewItem>)item inSourceView:(UIView **)view

Параметры

`controller`	Контроллер предварительного просмотра Беглого взгляда, запрашивающий кадр на элемент предварительного просмотра.
`item`	Элемент, который будет предварительно просмотрен или отклонен.
`view`	`UIView` объект, содержащий элемент предварительного просмотра, поскольку Вы выводите на экран его в своем приложении. Путем обеспечения представления возражают против `view` параметр, Вы указываете к контроллеру предварительного просмотра Беглого взгляда указание возвращенного `CGRect` источник объекта указывает относительно того представления. Обеспечить `nil` в этом параметре, чтобы указать, что Вы указываете `CGRect` точка источника в координатах экрана.

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

A CGRect объект, определяющий прямоугольник кадра для элемента предварительного просмотра, как это появляется в Вашем приложении.

Обсуждение

Используйте этот метод делегата сконфигурировать анимацию изменения масштаба для представления и отклонения предварительного просмотра Беглого взгляда. Изменение масштаба продолжается между Вашим собственным представлением элемента и полным экраном.

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

      [parentController presentModaViewController: myPreviewController animated: YES];
 // ...
[parentController dismissModalViewControllerAnimated: YES];

Если Вы вместо этого используете булевскую переменную NOfalse в этих операторах контроллер предварительного просмотра Беглого взгляда выводит на экран предварительный просмотр, полноэкранный сразу без эффекта перехода.

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

Для создания анимации изменения масштаба возвратите a CGRect объект, представляющий кадр для элемента предварительного просмотра, как это появляется в Вашем приложении. Используйте координаты относительно UIView объект, содержащий элемент и указывающий то представление в view параметр.

Также можно использовать координаты экрана для возвращенного CGRect объект. В этом случае необходимо указать nil в view параметр.

Для создания полноэкранного исчезают анимация, а не изменение масштаба, возвращают значение CGRectZero, или оставьте этот метод нереализованным.

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

Objective C

@import QuickLook;

Swift

import QuickLook

Доступность

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


    
    previewController (_: transitionImageForPreviewItem:contentRect:)
    - previewController:transitionImageForPreviewItem:contentRect:

Требуемый

Вызванный, когда контроллер предварительного просмотра Беглого взгляда собирается быть представленным полным экраном или отклоненный; используемый для обеспечения плавного перехода при изменении масштаба. (требуемый)

Объявление

Swift

optional func previewController(_ controller: QLPreviewController!, transitionImageForPreviewItem item: QLPreviewItem!, contentRect contentRect: UnsafeMutablePointer<CGRect>) -> UIImage!

Objective C

- (UIImage *)previewController:(QLPreviewController *)controller transitionImageForPreviewItem:(id<QLPreviewItem>)item contentRect:(CGRect *)contentRect

Параметры

`controller`	Контроллер предварительного просмотра Беглого взгляда, запрашивающий кадр на элемент предварительного просмотра.
`item`	Элемент, который будет предварительно просмотрен или отклонен.
`contentRect`	Прямоугольник в изображении, представляющем содержание документа. Для значков, например, прямоугольник содержания документа обычно меньше, чем сам прямоугольник значка.

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

A UIImage возразите, что контроллер предварительного просмотра выгорает с при изменении масштаба.

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

Objective C

@import QuickLook;

Swift

import QuickLook

Доступность

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


    
    previewControllerWillDismiss (_:)
    - previewControllerWillDismiss:

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

Объявление

Swift

optional func previewControllerWillDismiss(_ controller: QLPreviewController!)

Objective C

- (void)previewControllerWillDismiss:(QLPreviewController *)controller

Параметры


      controller

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

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

Objective C

@import QuickLook;

Swift

import QuickLook

Доступность

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


    
    previewControllerDidDismiss (_:)
    - previewControllerDidDismiss:

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

Объявление

Swift

optional func previewControllerDidDismiss(_ controller: QLPreviewController!)

Objective C

- (void)previewControllerDidDismiss:(QLPreviewController *)controller

Параметры


      controller

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

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

Objective C

@import QuickLook;

Swift

import QuickLook

Доступность

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

Ответ на пользовательские действия


    
    previewController (_: shouldOpenURL:forPreviewItem:)
    - previewController:shouldOpenURL:forPreviewItem:

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

Объявление

Swift

optional func previewController(_ controller: QLPreviewController!, shouldOpenURL url: NSURL!, forPreviewItem item: QLPreviewItem!) -> Bool

Objective C

- (BOOL)previewController:(QLPreviewController *)controller shouldOpenURL:(NSURL *)url forPreviewItem:(id<QLPreviewItem>)item

Параметры

`controller`	Контроллер предварительного просмотра Беглого взгляда, просящий, чтобы делегат обработал пользовательское касание на URL.
`url`	URL, от выведенного на экран предварительного просмотра, что коснулся пользователь.
`item`	Элемент, выводимый на экран в предварительном просмотре.

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

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

Обсуждение

Когда пользователь касается ссылки URL в предварительном просмотре, этот метод играет роль. Если Вы возвращаетесь YEStrue, контроллер предварительного просмотра Беглого взгляда вызывает openURL: метод на UIApplication объект, отправляя ему значение url параметр. Если Вы возвращаетесь NOfalse, openURL: метод не вызывается.

Если Вы не реализуете этот метод, он принимает значение по умолчанию к возврату YEStrue.

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

Objective C

@import QuickLook;

Swift

import QuickLook

Доступность

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