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

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

Разработчик

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

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

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

UISlider

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

Настройка появления ползунка

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

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

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

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

Доступ к значению ползунка
  • value Свойство

    Содержит текущую стоимость получателя.

    Объявление

    Swift

    var value: Float

    Objective C

    @property(nonatomic) float value

    Обсуждение

    Установка этого свойства заставляет получатель перерисовывать себя с помощью нового значения. Для рендеринга анимированного перехода от текущей стоимости до нового значения необходимо использовать setValue:animated: метод вместо этого.

    При попытке установить значение, которое является ниже минимума или выше максимального значения, минимальное или максимальное значение установлено вместо этого. Значение по умолчанию этого свойства 0.0.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setValue:animated:

  • setValue (_: анимированный:) - setValue:animated:

    Устанавливает текущую стоимость получателя, позволяя Вам анимировать изменение визуально.

    Объявление

    Swift

    func setValue(_ value: Float, animated animated: Bool)

    Objective C

    - (void)setValue:(float)value animated:(BOOL)animated

    Параметры

    value

    Новое значение для присвоения к value свойство

    animated

    Указать YEStrue анимировать изменение в значении, когда перерисовывается получатель; иначе, указать NOfalse нарисовать получатель с новым значением только. Анимации выполняются асинхронно и не блокируют вызывающий поток.

    Обсуждение

    При попытке установить значение, которое является ниже минимума или выше максимального значения, минимальное или максимальное значение установлено вместо этого. Значение по умолчанию этого свойства 0.0.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    значение

Доступ к пределам значения ползунка
  • minimumValue Свойство

    Содержит минимальное значение получателя.

    Объявление

    Swift

    var minimumValue: Float

    Objective C

    @property(nonatomic) float minimumValue

    Обсуждение

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

    Значение по умолчанию этого свойства 0.0.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • maximumValue Свойство

    Содержит максимальное значение получателя.

    Объявление

    Swift

    var maximumValue: Float

    Objective C

    @property(nonatomic) float maximumValue

    Обсуждение

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

    Значение по умолчанию этого свойства 1.0.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Изменение поведения ползунка
  • continuous Свойство

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

    Объявление

    Swift

    var continuous: Bool

    Objective C

    @property(nonatomic, getter=isContinuous) BOOL continuous

    Обсуждение

    Если YEStrue, ползунок отправляет события обновления постоянно в метод действия связанной цели. Если NOfalse, ползунок только отправляет событие действия когда разъединения абонентом управление ползунком ползунка для установки окончательного значения.

    Значение по умолчанию этого свойства YEStrue.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Изменение появления ползунка
  • minimumValueImage Свойство

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

    Объявление

    Swift

    var minimumValueImage: UIImage?

    Objective C

    @property(nonatomic, retain) UIImage *minimumValueImage

    Обсуждение

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

    Это значение по умолчанию этого свойства nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • maximumValueImage Свойство

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

    Объявление

    Swift

    var maximumValueImage: UIImage?

    Objective C

    @property(nonatomic, retain) UIImage *maximumValueImage

    Обсуждение

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

    Это значение по умолчанию этого свойства nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • minimumTrackTintColor Свойство

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

    Объявление

    Swift

    var minimumTrackTintColor: UIColor?

    Objective C

    @property(nonatomic, retain) UIColor *minimumTrackTintColor

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • currentMinimumTrackImage Свойство

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

    Объявление

    Swift

    var currentMinimumTrackImage: UIImage! { get }

    Objective C

    @property(nonatomic, readonly) UIImage *currentMinimumTrackImage

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – minimumTrackImageForState:
    – setMinimumTrackImage:forState:

  • minimumTrackImageForState (_:) - minimumTrackImageForState:

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

    Объявление

    Swift

    func minimumTrackImageForState(_ state: UIControlState) -> UIImage?

    Objective C

    - (UIImage *)minimumTrackImageForState:(UIControlState)state

    Параметры

    state

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

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

    Минимальное изображение дорожки связалось с указанным состоянием, или nil если не было установлено никакое изображение. Этот метод мог бы также возвратиться nil если Вы указываете, что многократное управление утверждает в state параметр. Для описания изображений дорожки посмотрите Настройку Появления Ползунка.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setMinimumTrackImage:forState:

  • setMinimumTrackImage (_: forState:) - setMinimumTrackImage:forState:

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

    Объявление

    Swift

    func setMinimumTrackImage(_ image: UIImage?, forState state: UIControlState)

    Objective C

    - (void)setMinimumTrackImage:(UIImage *)image forState:(UIControlState)state

    Параметры

    image

    Минимальная дорожка отображает для соединения с указанными состояниями.

    state

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

    Обсуждение

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • maximumTrackTintColor Свойство

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

    Объявление

    Swift

    var maximumTrackTintColor: UIColor?

    Objective C

    @property(nonatomic, retain) UIColor *maximumTrackTintColor

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • currentMaximumTrackImage Свойство

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

    Объявление

    Swift

    var currentMaximumTrackImage: UIImage! { get }

    Objective C

    @property(nonatomic, readonly) UIImage *currentMaximumTrackImage

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – maximumTrackImageForState:
    – setMaximumTrackImage:forState:

  • maximumTrackImageForState (_:) - maximumTrackImageForState:

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

    Объявление

    Swift

    func maximumTrackImageForState(_ state: UIControlState) -> UIImage?

    Objective C

    - (UIImage *)maximumTrackImageForState:(UIControlState)state

    Параметры

    state

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

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

    Максимальное изображение дорожки связалось с указанным состоянием, или nil если не могло бы быть получено надлежащее изображение. Этот метод мог бы возвратиться nil если Вы указываете, что многократное управление утверждает в state параметр. Для описания изображений дорожки посмотрите Настройку Появления Ползунка.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setMaximumTrackImage:forState:

  • setMaximumTrackImage (_: forState:) - setMaximumTrackImage:forState:

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

    Объявление

    Swift

    func setMaximumTrackImage(_ image: UIImage?, forState state: UIControlState)

    Objective C

    - (void)setMaximumTrackImage:(UIImage *)image forState:(UIControlState)state

    Параметры

    image

    Максимальная дорожка отображает для соединения с указанными состояниями.

    state

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

    Обсуждение

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – maximumTrackImageForState:

  • thumbTintColor Свойство

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

    Объявление

    Swift

    var thumbTintColor: UIColor?

    Objective C

    @property(nonatomic, retain) UIColor *thumbTintColor

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • currentThumbImage Свойство

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

    Объявление

    Swift

    var currentThumbImage: UIImage? { get }

    Objective C

    @property(nonatomic, readonly) UIImage *currentThumbImage

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – thumbImageForState:
    – setThumbImage:forState:

  • thumbImageForState (_:) - thumbImageForState:

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

    Объявление

    Swift

    func thumbImageForState(_ state: UIControlState) -> UIImage?

    Objective C

    - (UIImage *)thumbImageForState:(UIControlState)state

    Параметры

    state

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

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

    Изображение ползунка связалось с указанным состоянием, или nil если не могло бы быть получено надлежащее изображение. Этот метод мог бы возвратиться nil если Вы указываете, что многократное управление утверждает в state параметр. Для описания дорожки и изображений ползунка, посмотрите Настройку Появления Ползунка.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setThumbImage:forState:

  • setThumbImage (_: forState:) - setThumbImage:forState:

    Присваивает изображение ползунка указанным состояниям управления.

    Объявление

    Swift

    func setThumbImage(_ image: UIImage?, forState state: UIControlState)

    Objective C

    - (void)setThumbImage:(UIImage *)image forState:(UIControlState)state

    Параметры

    image

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

    state

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – thumbImageForState:

Переопределения для подклассов
  • maximumValueImageRectForBounds (_:) - maximumValueImageRectForBounds:

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

    Объявление

    Swift

    func maximumValueImageRectForBounds(_ bounds: CGRect) -> CGRect

    Objective C

    - (CGRect)maximumValueImageRectForBounds:(CGRect)bounds

    Параметры

    bounds

    Ограничительный прямоугольник получателя.

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • minimumValueImageRectForBounds (_:) - minimumValueImageRectForBounds:

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

    Объявление

    Swift

    func minimumValueImageRectForBounds(_ bounds: CGRect) -> CGRect

    Objective C

    - (CGRect)minimumValueImageRectForBounds:(CGRect)bounds

    Параметры

    bounds

    Ограничительный прямоугольник получателя.

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • trackRectForBounds (_:) - trackRectForBounds:

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

    Объявление

    Swift

    func trackRectForBounds(_ bounds: CGRect) -> CGRect

    Objective C

    - (CGRect)trackRectForBounds:(CGRect)bounds

    Параметры

    bounds

    Ограничительный прямоугольник получателя.

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • thumbRectForBounds (_: trackRect:value:) - thumbRectForBounds:trackRect:value:

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

    Объявление

    Swift

    func thumbRectForBounds(_ bounds: CGRect, trackRect rect: CGRect, value value: Float) -> CGRect

    Objective C

    - (CGRect)thumbRectForBounds:(CGRect)bounds trackRect:(CGRect)rect value:(float)value

    Параметры

    bounds

    Ограничительный прямоугольник получателя.

    rect

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

    value

    Текущая стоимость ползунка.

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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