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

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

Разработчик

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

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

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

UIImagePickerControllerDelegate

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

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

Когда работа завершается, методы делегата ответственны за отклонение средства выбора. Для отклонения средства выбора вызовите dismissModalViewControllerAnimated: метод родительского контроллера, ответственного за отображение UIImagePickerController объект.

Для сохранения неподвижного образа к альбому Рулона Камеры пользователя вызовите UIImageWriteToSavedPhotosAlbum функция из организации imagePickerController:didFinishPickingMediaWithInfo: метод. Для сохранения фильма к альбому Рулона Камеры пользователя вместо этого вызовите UISaveVideoAtPathToSavedPhotosAlbum функция. Эти функции, описанные в Ссылке на функцию UIKit, сохраняют образ или фильм только; они не сохраняют метаданные.

Запускаясь в iOS 4.0, можно сохранить метаданные неподвижного изображения, вместе с неподвижным изображением, к Рулону Камеры. Чтобы сделать это, используйте writeImageToSavedPhotosAlbum:metadata:completionBlock: метод платформы Библиотеки Активов. См. описание для UIImagePickerControllerMediaMetadata ключ.

Закрытие средства выбора
  • imagePickerController (_: didFinishPickingMediaWithInfo:) - imagePickerController:didFinishPickingMediaWithInfo:

    Говорит делегату, что пользователь выбрал неподвижное изображение или фильм.

    Объявление

    Swift

    optional func imagePickerController(_ picker: UIImagePickerController, didFinishPickingMediaWithInfo info: [NSObject : AnyObject])

    Objective C

    - (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info

    Параметры

    picker

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

    info

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

    Обсуждение

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

    Когда редактирование включено, представление средства выбора изображения дарит пользователю предварительный просмотр в настоящее время выбираемого изображения или фильма вместе со средствами управления для изменения его. (Этим поведением управляет представление средства выбора до вызова этого метода.), Если пользователь изменяет изображение или фильм, информация о редактировании доступна в info параметр. Исходное изображение также возвращается в info параметр.

    Если Вы устанавливаете средство выбора изображения showsCameraControls свойство к NOfalse и обеспечьте свои собственные средства управления, можно сделать многократные снимки прежде, чем отклонить интерфейс средства выбора изображения. Однако, если Вы устанавливаете то свойство в YEStrue, Ваш делегат должен отклонить интерфейс средства выбора изображения после того, как пользователь сделает один снимок или отменит работу.

    Реализация этого метода является дополнительной, но ожидаемая.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • - imagePickerController:didFinishPickingImage:editingInfo: (iOS 3.0)

    Говорит делегату, что пользователь выбрал изображение.

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

    Использовать imagePickerController:didFinishPickingMediaWithInfo: вместо этого.

    Объявление

    Objective C

    - (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingImage:(UIImage *)image editingInfo:(NSDictionary *)editingInfo

    Параметры

    picker

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

    image

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

    editingInfo

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

    Обсуждение

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

    Когда пользователю, редактирующему, включают, представление средства выбора дарит пользователю предварительный просмотр в настоящее время выбираемого изображения вместе со средствами управления для изменения его. (Этим поведением управляет представление средства выбора до вызова этого метода.), Если пользователь изменяет изображение, информация о редактировании доступна в editingInfo параметр. Если Вам не нужна информация о редактировании, просто используйте изображение в image параметр, как.

    Специальные замечания

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

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

    Objective C

    @import UIKit;

    Доступность

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

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

  • imagePickerControllerDidCancel (_:) - imagePickerControllerDidCancel:

    Говорит делегату, что пользователь отменил работу выбора.

    Объявление

    Swift

    optional func imagePickerControllerDidCancel(_ picker: UIImagePickerController)

    Objective C

    - (void)imagePickerControllerDidCancel:(UIImagePickerController *)picker

    Параметры

    picker

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

    Обсуждение

    Реализация Вашим делегатом этого метода должна отклонить представление средства выбора путем вызова dismissModalViewControllerAnimated: метод родительского контроллера представления.

    Реализация этого метода является дополнительной, но ожидаемая.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Константы
  • Редактирование информационных ключей

    Ключи для словаря информации о редактировании передали делегату.

    Объявление

    Swift

    let UIImagePickerControllerMediaType: String let UIImagePickerControllerOriginalImage: String let UIImagePickerControllerEditedImage: String let UIImagePickerControllerCropRect: String let UIImagePickerControllerMediaURL: String let UIImagePickerControllerReferenceURL: String let UIImagePickerControllerMediaMetadata: String

    Objective C

    NSString *const UIImagePickerControllerMediaType; NSString *const UIImagePickerControllerOriginalImage; NSString *const UIImagePickerControllerEditedImage; NSString *const UIImagePickerControllerCropRect; NSString *const UIImagePickerControllerMediaURL; NSString *const UIImagePickerControllerReferenceURL; NSString *const UIImagePickerControllerMediaMetadata;

    Константы

    • UIImagePickerControllerMediaType

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

      Значение для этого ключа NSString объект, содержащий код типа такой как kUTTypeImage или kUTTypeMovie.

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

    • UIImagePickerControllerOriginalImage

      Указывает исходное, необрезанное изображение, выбранное пользователем.

      Значение для этого ключа является a UIImage объект.

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

    • UIImagePickerControllerEditedImage

      Указывает изображение, отредактированное пользователем.

      Значение для этого ключа является a UIImage объект.

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

    • UIImagePickerControllerCropRect

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

      Значение для этого ключа NSValue объект, содержащий a CGRect непрозрачный тип.

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

    • UIImagePickerControllerMediaURL

      Указывает файловую систему URL для фильма.

      Значение для этого ключа NSURL объект.

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

    • UIImagePickerControllerReferenceURL

      Библиотека Активов URL для исходной версии выбранного элемента.

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

      Значение для этого ключа NSURL объект.

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

    • UIImagePickerControllerMediaMetadata

      Метаданные для недавно полученной фотографии.

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

      Значение для этого ключа NSDictionary объект, содержащий метаданные просто полученной фотографии. Для хранения метаданных вместе с изображением в Рулоне Камеры используйте writeImageToSavedPhotosAlbum:metadata:completionBlock: метод платформы Библиотеки Активов.

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