Ссылка класса UIDocumentInteractionController

Создание контроллера взаимодействия документа


    
    init (URL:)
    + interactionControllerWithURL:

Создает и возвращает новое UIDocumentationInteractionController объект инициализируется с указанным URL.

Объявление

Swift

init(URL url: NSURL) -> UIDocumentInteractionController

Objective C

+ (UIDocumentInteractionController *)interactionControllerWithURL:(NSURL *)url

Параметры

url

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

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

Новый объект контроллера взаимодействия документа.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Представление и отклонение предварительного просмотра документа


    
    presentPreviewAnimated (_:)
    - presentPreviewAnimated:

Выводит на экран полноэкранный предварительный просмотр целевого документа.

Объявление

Swift

func presentPreviewAnimated(_ animated: Bool) -> Bool

Objective C

- (BOOL)presentPreviewAnimated:(BOOL)animated

Параметры


      animated

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

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

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

Обсуждение

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

Если Ваш делегат реализует documentInteractionControllerViewForPreview: и documentInteractionControllerRectForPreview: методы, представление и прямоугольник, возвращенный теми методами, используются в качестве начальной точки для анимации, используемой для отображения предварительного просмотра документа. Если анимированный параметр YEStrue но Ваш делегат не реализует documentInteractionControllerViewForPreview: метод (или тот метод возвраты nil), предварительный просмотр документа анимирован в место с помощью плавно накладывать перехода.

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    dismissPreviewAnimated (_:)
    - dismissPreviewAnimated:

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

Объявление

Swift

func dismissPreviewAnimated(_ animated: Bool)

Objective C

- (void)dismissPreviewAnimated:(BOOL)animated

Параметры


      animated

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Представление и отклонение меню


    
    presentOptionsMenuFromRect (_: inView:animated:)
    - presentOptionsMenuFromRect:inView:animated:

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

Объявление

Swift

func presentOptionsMenuFromRect(_ rect: CGRect, inView view: UIView, animated animated: Bool) -> Bool

Objective C

- (BOOL)presentOptionsMenuFromRect:(CGRect)rect inView:(UIView *)view animated:(BOOL)animated

Параметры

`rect`	Расположение (в системе координат `view`) в котором можно привязать меню.
`view`	Представление, от которого можно вывести на экран меню параметров.
`animated`	Указать `YEStrue` анимировать появление меню или `NOfalse` вывести на экран его сразу.

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

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

Обсуждение

Содержание меню параметров создается динамично на основе трех вещей:

Тип документа (как указано UTI свойство)
Набор установленных приложений, зарегистрировавших поддержку вводных документов
Действия, которые Вы указали, как поддерживается в делегате контроллера взаимодействия документа documentInteractionController:canPerformAction: метод

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

Этот метод выводит на экран меню параметров асинхронно. Когда пользователь выбирает один из доступных параметров, меню отклонено автоматически. Можно также отклонить его программно использование dismissMenuAnimated: метод.

Вместо этого представить меню, содержащее только список приложений, способных к открытию текущего документа, presentOpenInMenuFromRect:inView:animated: метод вместо этого.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

– presentOptionsMenuFromBarButtonItem:animated:


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

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

Объявление

Swift

func presentOptionsMenuFromBarButtonItem(_ item: UIBarButtonItem, animated animated: Bool) -> Bool

Objective C

- (BOOL)presentOptionsMenuFromBarButtonItem:(UIBarButtonItem *)item animated:(BOOL)animated

Параметры

`item`	Элемент кнопки панели, к которому можно привязать меню.
`animated`	Указать `YEStrue` анимировать появление меню или `NOfalse` вывести на экран его сразу.

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

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

Обсуждение

Содержание меню параметров создается динамично на основе трех вещей:

Тип документа (как указано UTI свойство)
Набор установленных приложений, зарегистрировавших поддержку вводных документов
Действия, которые Вы указали, как поддерживается в делегате контроллера взаимодействия документа documentInteractionController:canPerformAction: метод

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

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

Вместо этого представить меню, содержащее только список приложений, способных к открытию текущего документа, presentOpenInMenuFromBarButtonItem:animated: метод вместо этого.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

– presentOptionsMenuFromRect:inView:animated:


    
    presentOpenInMenuFromRect (_: inView:animated:)
    - presentOpenInMenuFromRect:inView:animated:

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

Объявление

Swift

func presentOpenInMenuFromRect(_ rect: CGRect, inView view: UIView, animated animated: Bool) -> Bool

Objective C

- (BOOL)presentOpenInMenuFromRect:(CGRect)rect inView:(UIView *)view animated:(BOOL)animated

Параметры

`rect`	Расположение (в системе координат `view`) в котором можно привязать меню.
`view`	Представление, от которого можно вывести на экран меню.
`animated`	Указать `YEStrue` анимировать появление меню или `NOfalse` вывести на экран его сразу.

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

YEStrue если этот метод смог вывести на экран меню или NOfalse если это не было.

Обсуждение

Этот метод подобен presentOptionsMenuFromRect:inView:animated: метод, но подарки меню, ограниченное списком приложений, способных к открытию текущего документа. Это определение сделано на основе типа документа (как обозначено UTI свойство), и на типах документов поддерживается установленными приложениями. Для поддержки одних или более типов документов приложение должно зарегистрироваться, те вводят Info.plist файл с помощью CFBundleDocumentTypes ключ.

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

– presentOpenInMenuFromBarButtonItem:animated:


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

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

Объявление

Swift

func presentOpenInMenuFromBarButtonItem(_ item: UIBarButtonItem, animated animated: Bool) -> Bool

Objective C

- (BOOL)presentOpenInMenuFromBarButtonItem:(UIBarButtonItem *)item animated:(BOOL)animated

Параметры

`item`	Элемент кнопки панели, к которому можно привязать меню.
`animated`	Указать `YEStrue` анимировать появление меню или `NOfalse` вывести на экран его сразу.

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

YEStrue если этот метод смог вывести на экран меню или NOfalse если это не было.

Обсуждение

Этот метод подобен presentOptionsMenuFromBarButtonItem:animated: метод, но подарки меню, ограниченное списком приложений, способных к открытию текущего документа. Это определение сделано на основе типа документа (как обозначено UTI свойство), и на типах документов поддерживается установленными приложениями. Для поддержки одних или более типов документов приложение должно зарегистрироваться, те вводят Info.plist файл с помощью CFBundleDocumentTypes ключ.

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

– presentOpenInMenuFromRect:inView:animated:


    
    dismissMenuAnimated (_:)
    - dismissMenuAnimated:

Отклоняет в настоящее время активное меню.

Объявление

Swift

func dismissMenuAnimated(_ animated: Bool)

Objective C

- (void)dismissMenuAnimated:(BOOL)animated

Параметры


      animated

Указать YEStrue анимировать увольнение в настоящее время активного меню или NOfalse отклонить его сразу.

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Доступ к атрибутам документа Target

URL Свойство

URL, идентифицирующий конечный файл в локальной файловой системе.

Объявление

Swift

var URL: NSURL

Objective C

@property(retain) NSURL *URL

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Тип конечного файла.

Объявление

Swift

var UTI: String?

Objective C

@property(nonatomic, copy) NSString *UTI

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Имя конечного файла.

Объявление

Swift

var name: String!

Objective C

@property(copy) NSString *name

Обсуждение

Это свойство содержит имя файла без любой предыдущей информации о пути. Значение по умолчанию этого свойства получено на информацию о пути в URL свойство. Если Вы хотите связать другое имя с файлом, можно изменить значение этого свойства по мере необходимости.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Изображения связались с конечным файлом. (только для чтения)

Объявление

Swift

var icons: [AnyObject] { get }

Objective C

@property(nonatomic, readonly) NSArray *icons

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

var annotation: AnyObject?

Objective C

@property(nonatomic, retain) id annotation

Обсуждение

Используйте это свойство для передачи информации о типе документа к приложению, ответственному за открытие его. Тип этого объекта должен быть тем, используемым для содержания информации о списке свойств, а именно, NSDictionary, NSArray, NSData, NSString, NSNumber, или NSDate.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Доступ к атрибутам контроллера

gestureRecognizers Свойство
Предоставленные систему устройства распознавания жеста для представления контроллера взаимодействия документа. (только для чтения)

Объявление

Swift

var gestureRecognizers: [AnyObject] { get }

Objective C

@property(nonatomic, readonly) NSArray *gestureRecognizers
Обсуждение

Объекты в gestureRecognizers выстройте каждое убывание от UIGestureRecognizer класс. Можно присоединить эти устройства распознавания жеста к представлению, которое Вы используете для представления документа. Например, при представлении документа по имени или значка в ячейке табличного представления можно присоединить взаимодействие документа устройства распознавания жеста контроллера с помощью кода как это:
Swift

cell.contentView.gestureRecognizers = docInteractionController.gestureRecognizers

Objective C

cell.contentView.gestureRecognizers = self.docInteractionController.gestureRecognizers;
(В этом операторе, cell объект является экземпляром UITableViewCell класс и docInteractionController переменная экземпляра указывает на контроллер взаимодействия документа для документа, названного в ячейке.)

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

UIDocumentInteractionController класс поддерживает только касание (UITapGestureRecognizer) и длинное нажатие (UILongPressGestureRecognizer) устройства распознавания жеста.
Оператор импорта

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

unowned(unsafe) var delegate: UIDocumentInteractionControllerDelegate?

Objective C

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

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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