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

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

Разработчик

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

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

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

UIDocumentPickerExtensionViewController

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

Расширение Контроллера Представления Средства выбора Документа может выполнить импорт и экспортировать операции самостоятельно. Если Вы хотите поддерживать операции открытия и операции пересылки, необходимо соединить его с расширением Провайдера Файла.

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

Управление пользовательским интерфейсом
  • dismissGrantingAccessToURL (_:) - dismissGrantingAccessToURL:

    Отклоняет средство выбора документа.

    Объявление

    Swift

    func dismissGrantingAccessToURL(_ url: NSURL!)

    Objective C

    - (void)dismissGrantingAccessToURL:(NSURL *)url

    Параметры

    url

    URL, который расширение возвращает приложению узла.

    Обсуждение

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

    URL должен ответить всем следующим условиям:

    • Режим Import Document Picker. Обеспечьте URL для выбранного файла. URL только должен быть доступным расширением Контроллера Представления Средства выбора Документа.

    • Открытый режим Document Picker. Обеспечьте URL для выбранного файла. URL должен указать на расположение в иерархии каталогов, именуемой Вашим documentStorageURL свойство.

    • Режим Export Document Picker. Прежде, чем вызвать этот метод, скопируйте файл в выбранное место назначения. Ваши расширения также должны отследить файл и удостовериться, что он синхронизируется к Вашему серверу.

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

    • Режим Move Document Picker. Прежде, чем вызвать этот метод, скопируйте файл в выбранное место назначения. Ваши расширения также должны отследить файл и удостовериться, что он синхронизируется к Вашему серверу.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    documentPickerMode
    documentStorageURL

  • documentPickerMode Свойство

    Работа передачи файлов средства выбора документа. (только для чтения)

    Объявление

    Swift

    var documentPickerMode: UIDocumentPickerMode { get }

    Objective C

    @property(nonatomic, readonly, assign) UIDocumentPickerMode documentPickerMode

    Обсуждение

    Для списка доступных режимов посмотрите Режимы Средства выбора Документа в Ссылке класса UIDocumentPickerViewController.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • documentStorageURL Свойство

    Корневой URL для документов, предоставленных соответствующим расширением Провайдера Файла. (только для чтения)

    Объявление

    Swift

    @NSCopying var documentStorageURL: NSURL! { get }

    Objective C

    @property(nonatomic, readonly, copy) NSURL *documentStorageURL

    Обсуждение

    Это свойство возвращает подкаталог контейнера группы приложений, совместно использованного расширением Средства выбора Документа и его соответствующим расширением Провайдера Файла. По умолчанию это свойство содержит значение, возвращенное путем вызова расширения Провайдера Файла documentStorageURL метод.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • originalURL Свойство

    URL файла, который будет экспортироваться. (только для чтения)

    Объявление

    Swift

    @NSCopying var originalURL: NSURL? { get }

    Objective C

    @property(nonatomic, readonly, copy) NSURL *originalURL

    Обсуждение

    В то время как в UIDocumentPickerModeExportToService режим, это свойство содержит исходный URL файла, который будет скопирован. Иначе это nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • prepareForPresentationInMode (_:) - prepareForPresentationInMode:

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

    Объявление

    Swift

    func prepareForPresentationInMode(_ mode: UIDocumentPickerMode)

    Objective C

    - (void)prepareForPresentationInMode:(UIDocumentPickerMode)mode

    Параметры

    mode

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

    Обсуждение

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

    Различные режимы могут потребовать различных пользовательских интерфейсов. Например, UIDocumentPickerModeImport и UIDocumentPickerModeOpen режимы должны позволить пользователю исследовать доступные документы, тогда как UIDocumentPickerModeExportToService и UIDocumentPickerModeMoveToService режимы позволяют пользователю выбрать место назначения.

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    documentPickerMode
    validTypes

  • providerIdentifier Свойство

    Идентификатор, совместно использованный этим расширением Средства выбора Документа и его соответствующим расширением Провайдера Файла. (только для чтения)

    Объявление

    Swift

    var providerIdentifier: String { get }

    Objective C

    @property(nonatomic, readonly, copy) NSString *providerIdentifier

    Обсуждение

    И расширение Контроллера Представления Средства выбора Документа и расширение Провайдера Файла должны передать этот идентификатор их координатору файла setPurposeIdentifier: метод. Этот подход помогает скоординировать операции чтения и операции записи между этими двумя расширениями, предотвращая возможные мертвые блокировки.

    Это свойство содержит значение, возвращенное путем вызова расширения Провайдера Файла providerIdentifier метод.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • validTypes Свойство

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

    Объявление

    Swift

    var validTypes: [AnyObject]? { get }

    Objective C

    @property(nonatomic, readonly, copy) NSArray *validTypes

    Обсуждение

    В то время как в UIDocumentPickerModeImport или UIDocumentPickerModeOpen режимы, это свойство содержит массив допустимого UTIs; иначе, это nil.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – prepareForPresentationInMode: