UIDocumentInteractionControllerDelegate

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

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

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

NSObjectProtocol
NSObject

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

UIDocumentInteractionControllerDelegate протокол включает методы, которые можно реализовать для ответа на сообщения от контроллера взаимодействия документа. Используйте этот протокол для участия, когда предварительные просмотры документа выведены на экран и когда документ собирается быть открытым другим приложением. Можно также использовать этот протокол для ответа на команды (такие как «копия» и «печать») из меню параметров контроллера взаимодействия документа.

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

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

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


    
    documentInteractionControllerViewControllerForPreview (_:)
    - documentInteractionControllerViewControllerForPreview:

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

Объявление

Swift

optional func documentInteractionControllerViewControllerForPreview(_ controller: UIDocumentInteractionController) -> UIViewController

Objective C

- (UIViewController *)documentInteractionControllerViewControllerForPreview:(UIDocumentInteractionController *)controller

Параметры


      controller

Контроллер взаимодействия документа, запрашивающий родительский контроллер представления.

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

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

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    documentInteractionControllerViewForPreview (_:)
    - documentInteractionControllerViewForPreview:

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

Объявление

Swift

optional func documentInteractionControllerViewForPreview(_ controller: UIDocumentInteractionController) -> UIView?

Objective C

- (UIView *)documentInteractionControllerViewForPreview:(UIDocumentInteractionController *)controller

Параметры


      controller

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

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

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    documentInteractionControllerRectForPreview (_:)
    - documentInteractionControllerRectForPreview:

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

Объявление

Swift

optional func documentInteractionControllerRectForPreview(_ controller: UIDocumentInteractionController) -> CGRect

Objective C

- (CGRect)documentInteractionControllerRectForPreview:(UIDocumentInteractionController *)controller

Параметры


      controller

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

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

Прямоугольник в системе координат представления, возвращенного documentInteractionControllerViewForPreview: метод.

Обсуждение

Если Вы не реализуете documentInteractionControllerViewForPreview: метод, или если Вы действительно реализуете его, но возвращаете a nil значение, этот метод не вызывают. Если Вы не реализуете этот метод, стартовый прямоугольник, как предполагается, является границами представления, возвращенного documentInteractionControllerViewForPreview: метод.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Представление пользовательского интерфейса


    
    documentInteractionControllerWillBeginPreview (_:)
    - documentInteractionControllerWillBeginPreview:

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

Объявление

Swift

optional func documentInteractionControllerWillBeginPreview(_ controller: UIDocumentInteractionController)

Objective C

- (void)documentInteractionControllerWillBeginPreview:(UIDocumentInteractionController *)controller

Параметры


      controller

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    documentInteractionControllerDidEndPreview (_:)
    - documentInteractionControllerDidEndPreview:

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

Объявление

Swift

optional func documentInteractionControllerDidEndPreview(_ controller: UIDocumentInteractionController)

Objective C

- (void)documentInteractionControllerDidEndPreview:(UIDocumentInteractionController *)controller

Параметры


      controller

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    documentInteractionControllerWillPresentOptionsMenu (_:)
    - documentInteractionControllerWillPresentOptionsMenu:

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

Объявление

Swift

optional func documentInteractionControllerWillPresentOptionsMenu(_ controller: UIDocumentInteractionController)

Objective C

- (void)documentInteractionControllerWillPresentOptionsMenu:(UIDocumentInteractionController *)controller

Параметры


      controller

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    documentInteractionControllerDidDismissOptionsMenu (_:)
    - documentInteractionControllerDidDismissOptionsMenu:

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

Объявление

Swift

optional func documentInteractionControllerDidDismissOptionsMenu(_ controller: UIDocumentInteractionController)

Objective C

- (void)documentInteractionControllerDidDismissOptionsMenu:(UIDocumentInteractionController *)controller

Параметры


      controller

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

Обсуждение

Можно использовать этот метод для удаления любых дополнительных представлений или содержания, которое Вы поместили под меню параметров в Ваш documentInteractionControllerWillPresentOptionsMenu: метод.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    documentInteractionControllerWillPresentOpenInMenu (_:)
    - documentInteractionControllerWillPresentOpenInMenu:

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

Объявление

Swift

optional func documentInteractionControllerWillPresentOpenInMenu(_ controller: UIDocumentInteractionController)

Objective C

- (void)documentInteractionControllerWillPresentOpenInMenu:(UIDocumentInteractionController *)controller

Параметры


      controller

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

documentInteractionControllerDidDismissOpenInMenu (_:) - documentInteractionControllerDidDismissOpenInMenu:

Вызванный, когда контроллер взаимодействия документа отклонил свое меню Open In.

Объявление

Swift

optional func documentInteractionControllerDidDismissOpenInMenu(_ controller: UIDocumentInteractionController)

Objective C

- (void)documentInteractionControllerDidDismissOpenInMenu:(UIDocumentInteractionController *)controller

Параметры

controller

Контроллер взаимодействия документа, отклонивший его меню.

Обсуждение

Можно использовать этот метод для удаления любых дополнительных представлений или содержания, которое Вы поместили под меню Open In в Ваш documentInteractionControllerWillPresentOpenInMenu: метод.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Вводные файлы


    
    documentInteractionController (_: willBeginSendingToApplication:)
    - documentInteractionController:willBeginSendingToApplication:

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

Объявление

Swift

optional func documentInteractionController(_ controller: UIDocumentInteractionController, willBeginSendingToApplication application: String)

Objective C

- (void)documentInteractionController:(UIDocumentInteractionController *)controller willBeginSendingToApplication:(NSString *)application

Параметры

`controller`	Контроллер взаимодействия документа, документ которого собирается быть открытым.
`application`	Идентификатор пакета приложения, собирающегося открыть документ. Это значение соответствует значению в `CFBundleIdentifier` ключ приложения `Info.plist` файл.

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    documentInteractionController (_: didEndSendingToApplication:)
    - documentInteractionController:didEndSendingToApplication:

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

Объявление

Swift

optional func documentInteractionController(_ controller: UIDocumentInteractionController, didEndSendingToApplication application: String)

Objective C

- (void)documentInteractionController:(UIDocumentInteractionController *)controller didEndSendingToApplication:(NSString *)application

Параметры

`controller`	Контроллер взаимодействия документа, документ которого собирается быть открытым.
`application`	Идентификатор пакета приложения, собирающегося открыть документ. Это значение соответствует значению в `CFBundleIdentifier` ключ приложения `Info.plist` файл.

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Управление действиями


    
    - documentInteractionController:canPerformAction:

(iOS 6.0)

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

Оператор осуждения

Приложения должны использовать UIActivityViewController для действий.

Объявление

Objective C

- (BOOL)documentInteractionController:(UIDocumentInteractionController *)controller canPerformAction:(SEL)action

Параметры

`controller`	Контроллер взаимодействия документа, управляющий ассоциированным документом.
`action`	Селектор, представляющий рассматриваемое действие.

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

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

Обсуждение

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

Поддерживаемый action селекторы для этого метода copy: и print:. ( print: селектор доступен в iOS 4.2 и позже. Печать поддерживается только на устройствах та многозадачность поддержки.)

Для каждого действия, которое Вы реализуете в documentInteractionController:performAction: метод делегата, возвратиться YEStrue от этого метода, если то действие доступно для документа.

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

Objective C

@import UIKit;

Доступность

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

Осуждаемый в iOS 6.0.


    
    - documentInteractionController:performAction:

(iOS 6.0)

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

Оператор осуждения

Приложения должны использовать UIActivityViewController для действий.

Объявление

Objective C

- (BOOL)documentInteractionController:(UIDocumentInteractionController *)controller performAction:(SEL)action

Параметры

`controller`	Контроллер взаимодействия документа, управляющий ассоциированным документом.
`action`	Селектор, представляющий действие для выполнения. Можно вызвать этот селектор непосредственно на объект, ответственный за выполнение действия, или использовать его для вызова надлежащего метода.

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

YEStrue если действие выполнялось успешно или NOfalse если это не было.

Обсуждение

Реализовать a copy: действие, запишите содержание документа — непосредственно, или измененный согласно намерению Вашего приложения — к области монтажа.

Реализовать a print: действие, используйте совместно используемый объект контроллера взаимодействия печати. Присвойтесь URL свойство контроллера взаимодействия документа к контроллеру взаимодействия печати printingItem свойство. Тогда представьте пользовательский интерфейс печати. Для получения дополнительной информации обратитесь к Ссылке класса UIPrintInteractionController и к Печати в Рисовании и Печати Руководства для iOS.

Вместо того, чтобы реализовать код печати в этом методе, можно полагаться на встроенную поддержку печати платформы Беглого взгляда. Для типов документов, которые могут быть предварительно просмотрены, меню параметров контроллера взаимодействия документа всегда содержит элемент Беглого взгляда. Если пользователь выбирает тот элемент, получающееся представление Quick Look включает кнопку действий в панель навигации, когда коснулись, предлагающую Кнопку печати. В этом случае система автоматически обрабатывает печать. Для получения дополнительной информации обратитесь к Ссылке класса QLPreviewController и к Использованию Платформы Беглого взгляда в Темах Программирования Взаимодействия Документа для iOS.

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

Objective C

@import UIKit;

Доступность

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

Осуждаемый в iOS 6.0.