UIDocumentPickerViewController

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

NSObject
UIResponder
UIViewController
UIDocumentPickerViewController

NSObject
UIResponder
UIViewController
UIDocumentPickerViewController

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

A UIDocumentPickerViewController объект позволяет пользователю выбрать документы или места назначения вне песочницы Вашего приложения. Необходимо включить поддержку документа iCloud, прежде чем можно будет использовать средство выбора документа. Для получения дополнительной информации см. Руководство по проектированию iCloud.

Режимы средства выбора документа

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

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

Работа с внешними документами

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

Операции открытия и операции пересылки обеспечивают ограниченный по объему безопасностью URLs для всех внешних документов. Вызовите startAccessingSecurityScopedResource метод для доступа к этим документам и stopAccessingSecurityScopedResource метод для выпуска их. При использовании подкласса UIDocument для управления документом, это автоматически управляет ограниченным по объему безопасностью URL для Вас.
Всегда используйте координаторов файла, чтобы читать и записать во внешние документы.
Всегда используйте предъявителя файла при отображении содержания внешнего документа.
Не сохраняйте URLs, предоставленный операциями открытия и операциями пересылки. Можно, однако, сохранить закладку к этому URLs. Вызовите bookmarkDataWithOptions:includingResourceValuesForKeys:relativeToURL:error: метод и передача в NSURLBookmarkCreationWithSecurityScope опция. Это создает закладку, содержащую ограниченный по объему безопасностью URL.

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

Создание средства выбора документа


    
    init (documentTypes:inMode:)
    - initWithDocumentTypes:inMode:

Определяемый инициализатор

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

Объявление

Swift

init(documentTypes allowedUTIs: [AnyObject], inMode mode: UIDocumentPickerMode)

Objective C

- (instancetype)initWithDocumentTypes:(NSArray *)allowedUTIs inMode:(UIDocumentPickerMode)mode

Параметры

`allowedUTIs`	Массив универсальных идентификаторов типов. UTIs являются строками, однозначно определяющими тип файла. Для получения дополнительной информации см. Универсальный Обзор Идентификаторов типов.
`mode`	Тип работы передачи файлов, которую выполняет средство выбора документа. Этот параметр принимает только `UIDocumentPickerModeImport` или `UIDocumentPickerModeOpen` режим.

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

Возвращает инициализированный UIDocumentPickerViewController объект, или nil если не мог бы быть успешно инициализирован объект.

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    init (URL:inMode:)
    - initWithURL:inMode:

Определяемый инициализатор

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

Объявление

Swift

init(URL url: NSURL, inMode mode: UIDocumentPickerMode)

Objective C

- (instancetype)initWithURL:(NSURL *)url inMode:(UIDocumentPickerMode)mode

Параметры

`url`	Документ, который будет экспортирован или перемещен.
`mode`	Тип работы передачи файлов, которую выполняет средство выбора документа. Этот параметр принимает только `UIDocumentPickerModeExportToService` или `UIDocumentPickerModeMoveToService` режим.

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

Обсуждение

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Конфигурирование средства выбора документа

delegate Свойство

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

Объявление

Swift

weak var delegate: UIDocumentPickerDelegate?

Objective C

@property(nonatomic, weak) id< UIDocumentPickerDelegate > delegate

Обсуждение

Делегат должен принять UIDocumentPickerDelegate протокол.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

var documentPickerMode: UIDocumentPickerMode { get }

Objective C

@property(nonatomic, assign, readonly) UIDocumentPickerMode documentPickerMode

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Константы

UIDocumentPickerMode
Режимы, определяющие тип работы передачи файлов, используемой средством выбора документа.

Объявление

Swift

enum UIDocumentPickerMode : UInt { case Import case Open case ExportToService case MoveToService }

Objective C

typedef NS_ENUM (NSUInteger, UIDocumentPickerMode ) { UIDocumentPickerModeImport, UIDocumentPickerModeOpen, UIDocumentPickerModeExportToService, UIDocumentPickerModeMoveToService }

Константы
- Import
  
  UIDocumentPickerModeImport
  
  Средство выбора документа импортирует файл извне песочницы приложения.
  
  Доступный в iOS 8.0 и позже.
- Open
  
  UIDocumentPickerModeOpen
  
  Средство выбора документа открывает внешний файл, расположенный вне песочницы приложения.
  
  Доступный в iOS 8.0 и позже.
- ExportToService
  
  UIDocumentPickerModeExportToService
  
  Средство выбора документа экспортирует локальный файл в место назначения вне песочницы приложения.
  
  Доступный в iOS 8.0 и позже.
- MoveToService
  
  UIDocumentPickerModeMoveToService
  
  Средство выбора документа перемещает локальный файл вне песочницы приложения и обеспечивает доступ к нему как внешний файл.
  
  Доступный в iOS 8.0 и позже.
Оператор импорта

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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