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

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

Разработчик

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

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

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

UIImageView

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

Когда a UIImageView отображения объекта одно из его изображений, фактическое поведение основывается на свойствах изображения и представления. Если любое из изображения leftCapWidth или topCapHeight свойства являются ненулевыми, тогда изображение расширяется согласно значениям в тех свойствах. Иначе, изображение масштабируется, измеряется для адаптации или располагается в представление изображения согласно contentMode свойство представления. Это рекомендуется (но не требуется), что Вы используете изображения, которые являются всеми одинаковыми размер. Если изображения будут различными размерами, то каждый будет скорректирован для адаптации отдельно на основе того режима.

Все изображения связались с a UIImageView объект должен использовать то же scale. Если Ваше приложение использует изображения с различными масштабами, они могут представить неправильно.

Для получения информации об основных способах поведения представления см. Руководство по программированию Представления для iOS.

Сохранение состояния

В iOS 6 и позже, если Вы присваиваете значение этому представлению restorationIdentifier свойство, это пытается сохранить кадр выведенного на экран изображения. В частности класс сохраняет значения bounds, center, и transform свойства представления и anchorPoint свойство нижележащего слоя. Во время восстановления представление изображения восстанавливает эти значения так, чтобы изображение появилось точно как прежде. Для получения дополнительной информации, о как сохранение состояния и реставрационные работы, см. Руководство по программированию Приложения для iOS.

Оптимизация производительности представления изображения

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

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

  • Ограничьте размер изображения. Рассмотрите предварительное масштабирование или мозаичное размещение больших изображений. Проект примера кода MVCNetworking (QImageScrollView.m) демонстрирует, как определить, на какой модели устройства на iOS Ваше программное обеспечение работает. Можно тогда использовать ту информацию, чтобы помочь Вам определить что пороги размера изображения использовать при масштабировании или мозаичном размещении.

  • Отключите альфу, смешивающуюся кроме при необходимости. Если Вы преднамеренно не работаете с изображениями, содержащими прозрачность (получающий элементы UI, например), необходимо обычно отмечать представление как непрозрачное путем проверки флажка Opaque в инспектора атрибутов или установки opaque свойство на самом представлении.

    Для представлений, которые не непрозрачны, устройство должно выполнить большое ненужное вычисление, если альфа-смешивание включено, и изображение содержит альфа-канал. Это влияние производительности далее увеличено при использовании Базовых теней Анимации потому что форма тени тогда на основе содержания представления и должна быть динамично вычислена.

    Чтобы узнать больше, как альфа-смешивание работает, посмотрите Смешивание Прозрачности и Альфы Настройки.

Настройка смешивания прозрачности и альфы

Прозрачность представления изображения определяется свойствами и основного изображения и представления следующим образом:

  • Если флаг Opaque установлен (или программно или через инспектора XCode), изображение является альфой, смешанной с цветом фона представления, и само представление непрозрачно. Установка Alpha представления проигнорирована.

  • Если флаг Opaque не установлен, альфа-канал для каждого пикселя (или 1.0, если изображение не имеет никакого альфа-канала), умножается на установку Alpha представления, и получающееся значение определяет прозрачность для того пикселя.

Разделение на подклассы примечаний

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

Если Вы пишете пользовательский подкласс UIImageView, необходимо знать о следующих способах поведения:

  • UIImageView класс оптимизирован для рисования его изображений к дисплею. UIImageView не вызывает drawRect: метод его подклассов. Если Ваш подкласс должен включать пользовательский код для прорисовки, необходимо разделить на подклассы UIView класс вместо этого.

  • Новые объекты представления изображения сконфигурированы для игнорирования пользовательских событий по умолчанию. Если Вы хотите обработать события в пользовательском подклассе UIImageView, необходимо явно изменить значение userInteractionEnabled свойство к YEStrue после инициализации объекта.

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

Инициализация объекта UIImageView
  • init (изображение:) - initWithImage:

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

    Объявление

    Swift

    init(image image: UIImage!)

    Objective C

    - (instancetype)initWithImage:(UIImage *)image

    Параметры

    image

    Начальное изображение для отображения в представлении изображения.

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

    Инициализированный объект представления изображения.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • init (image:highlightedImage:) - initWithImage:highlightedImage:

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

    Объявление

    Swift

    init(image image: UIImage!, highlightedImage highlightedImage: UIImage?)

    Objective C

    - (instancetype)initWithImage:(UIImage *)image highlightedImage:(UIImage *)highlightedImage

    Параметры

    image

    Начальное изображение для отображения в представлении изображения.

    highlightedImage

    Изображение, чтобы вывести на экран, если выделяется представление изображения.

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

    Инициализированный объект представления изображения.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Данные изображения
  • image Свойство

    Изображение выведено на экран в представлении изображения.

    Объявление

    Swift

    var image: UIImage?

    Objective C

    @property(nonatomic, retain) UIImage *image

    Обсуждение

    Начальное значение этого свойства является изображением, переданным в initWithImage: метод или nil если Вы инициализировали получатель с помощью различного метода.

    Если animationImages свойство содержит значение кроме nil, содержание этого свойства не используется.

    Установка свойства изображения не изменяет размер a UIImageView. Вызвать sizeToFit скорректировать размер представления для соответствия изображения.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    animationImages

  • highlightedImage Свойство

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

    Объявление

    Swift

    var highlightedImage: UIImage?

    Objective C

    @property(nonatomic, retain) UIImage *highlightedImage

    Обсуждение

    Начальное значение этого свойства является изображением, переданным в initWithImage:highlightedImage: метод или nil если Вы инициализировали получатель с помощью различного метода.

    Если highlightedAnimationImages свойство содержит значение кроме nil, содержание этого свойства не используется.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    highlightedAnimationImages

Анимация изображений
  • animationImages Свойство

    Массив UIImage объекты использовать для анимации.

    Объявление

    Swift

    var animationImages: [AnyObject]?

    Objective C

    @property(nonatomic, copy) NSArray *animationImages

    Обсуждение

    Массив должен содержать UIImage объекты. Можно использовать тот же объект изображения несколько раз в массиве. Установка этого свойства к значению кроме nil скрывает изображение, представленное image свойство. Значение этого свойства nil по умолчанию.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    изображение
    contentMode (UIView)

  • highlightedAnimationImages Свойство

    Массив UIImage объекты использовать для анимации, когда выделяется представление.

    Объявление

    Swift

    var highlightedAnimationImages: [AnyObject]?

    Objective C

    @property(nonatomic, copy) NSArray *highlightedAnimationImages

    Обсуждение

    Массив должен содержать UIImage объекты. Можно использовать тот же объект изображения несколько раз в массиве. Установка этого свойства к значению кроме nil скрывает изображение, представленное highlightedImage свойство. Значение этого свойства nil по умолчанию.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    highlightedImage
    contentMode (UIView)

  • animationDuration Свойство

    Количество времени это берет для прохождения через одного цикла изображений.

    Объявление

    Swift

    var animationDuration: NSTimeInterval

    Objective C

    @property(nonatomic) NSTimeInterval animationDuration

    Обсуждение

    В секундах измеряется продолжительность времени. Значение по умолчанию этого свойства равно числу изображений, умноженных на 1/30-ю из секунды. Таким образом, если бы у Вас было 30 изображений, то значение составило бы 1 секунду.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • animationRepeatCount Свойство

    Указывает число раз для повторения анимации.

    Объявление

    Swift

    var animationRepeatCount: Int

    Objective C

    @property(nonatomic) NSInteger animationRepeatCount

    Обсуждение

    Значение по умолчанию 0, который указывает для повторения анимации неопределенно.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • startAnimating () - startAnimating

    Начинает анимировать изображения в получателе.

    Объявление

    Swift

    func startAnimating()

    Objective C

    - (void)startAnimating

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • stopAnimating () - stopAnimating

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

    Объявление

    Swift

    func stopAnimating()

    Objective C

    - (void)stopAnimating

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • isAnimating () - isAnimating

    Возвращает булево значение, указывающее, работает ли анимация.

    Объявление

    Swift

    func isAnimating() -> Bool

    Objective C

    - (BOOL)isAnimating

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

    YEStrue если работает анимация; иначе, NOfalse.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Установка и получение атрибутов
  • userInteractionEnabled Свойство

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

    Объявление

    Swift

    var userInteractionEnabled: Bool

    Objective C

    @property(nonatomic, getter=isUserInteractionEnabled) BOOL userInteractionEnabled

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • highlighted Свойство

    Булево значение, определяющее, выделяется ли изображение.

    Объявление

    Swift

    var highlighted: Bool

    Objective C

    @property(nonatomic, getter=isHighlighted) BOOL highlighted

    Обсуждение

    Это свойство определяет, используются ли регулярные или выделенные изображения. Когда highlighted установлен в YEStrue, неизображение с анимацией будет использовать highlightedImage свойство и изображение с анимацией будут использовать highlightedAnimationImages. Если оба из тех свойств установлены в nil или если highlighted установлен в NOfalse, это будет использовать image и animationImages свойства.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • tintColor Свойство

    Цвет раньше окрашивал шаблонные изображения в иерархии представления.

    Объявление

    Swift

    var tintColor: UIColor!

    Objective C

    @property(nonatomic, retain) UIColor *tintColor

    Обсуждение

    Значение по умолчанию nil. Если не -nil значение указано, цвет применяется к любым шаблонным изображениям, присоединенным к представлению изображения. Для получения дополнительной информации посмотрите renderingMode свойство на UIImage класс.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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