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

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

Разработчик

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

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

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

UIButton

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

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

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

Создание кнопок
  • buttonWithType (_:) + buttonWithType:

    Создает и возвращает новую кнопку указанного типа.

    Объявление

    Swift

    class func buttonWithType(_ buttonType: UIButtonType) -> AnyObject

    Objective C

    + (id)buttonWithType:(UIButtonType)buttonType

    Параметры

    buttonType

    Тип кнопки. Посмотрите UIButtonType для возможных значений.

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

    Недавно создаваемая кнопка.

    Обсуждение

    Этот метод является конструктором удобства для создания объектов кнопки с определенными конфигурациями. Если Вы разделяете на подклассы UIButton, этот метод не возвращает экземпляр Вашего подкласса. Если Вы хотите создать экземпляр определенного подкласса, Вы должны alloc/init кнопка непосредственно.

    При создании пользовательской кнопки — который является кнопкой с типом UIButtonTypeCustom— кадр кнопки установлен в (0, 0, 0, 0) первоначально. Прежде, чем добавить кнопку к Вашему интерфейсу, необходимо обновить кадр к более надлежащему значению.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Конфигурирование заголовка кнопки
  • titleLabel Свойство

    Представление, выводящее на экран значение currentTitle свойство для кнопки. (только для чтения)

    Объявление

    Swift

    var titleLabel: UILabel? { get }

    Objective C

    @property(nonatomic, readonly, retain) UILabel *titleLabel

    Обсуждение

    Несмотря на то, что это свойство только для чтения, его собственные свойства являются чтением-записью. Используйте эти свойства прежде всего для конфигурирования текста кнопки. Например:

    Swift

    • let button = UIButton.buttonWithType(.System) as UIButton
    • button.titleLabel.font = UIFont.systemFontOfSize(12)
    • button.titleLabel.lineBreakMode = .ByTruncatingTail

    Objective C

    • UIButton *button = [UIButton buttonWithType: UIButtonTypeSystem];
    • button.titleLabel.font = [UIFont systemFontOfSize: 12];
    • button.titleLabel.lineBreakMode = NSLineBreakByTruncatingTail;

    Не используйте объект метки установить цвет текста или цвет тени. Вместо этого используйте setTitleColor:forState: и setTitleShadowColor:forState: методы этого класса для внесения тех изменений.

    titleLabel даже если кнопка не была выведена на экран еще, свойство возвращает значение. Значение свойства nil для системных кнопок.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    currentTitle

  • titleForState (_:) - titleForState:

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

    Объявление

    Swift

    func titleForState(_ state: UIControlState) -> String?

    Objective C

    - (NSString *)titleForState:(UIControlState)state

    Параметры

    state

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

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

    Заголовок для указанного состояния. Если никакой заголовок не был установлен для определенного состояния, этот метод возвращает заголовок, связанный с UIControlStateNormal состояние.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setTitle:forState:

  • setTitle (_: forState:) - setTitle:forState:

    Устанавливает заголовок для использования для указанного состояния.

    Объявление

    Swift

    func setTitle(_ title: String?, forState state: UIControlState)

    Objective C

    - (void)setTitle:(NSString *)title forState:(UIControlState)state

    Параметры

    title

    Заголовок для использования для указанного состояния.

    state

    Состояние, использующее указанный заголовок. Возможные значения описаны в UIControlState.

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – titleForState:

  • attributedTitleForState (_:) - attributedTitleForState:

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

    Объявление

    Swift

    func attributedTitleForState(_ state: UIControlState) -> NSAttributedString?

    Objective C

    - (NSAttributedString *)attributedTitleForState:(UIControlState)state

    Параметры

    state

    Состояние, использующее стилизованный заголовок. Возможные значения описаны в UIControlState.

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

    Заголовок для указанного состояния. Если никакой приписанный заголовок не был установлен для определенного состояния, этот метод возвращает приписанный заголовок, связанный с UIControlStateNormal состояние. Если никакой приписанный заголовок не был установлен для UIControlStateNormal, возвраты nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • setAttributedTitle (_: forState:) - setAttributedTitle:forState:

    Устанавливает стилизованный заголовок для использования для указанного состояния.

    Объявление

    Swift

    func setAttributedTitle(_ title: NSAttributedString!, forState state: UIControlState)

    Objective C

    - (void)setAttributedTitle:(NSAttributedString *)title forState:(UIControlState)state

    Параметры

    title

    Стилизованная текстовая строка так использует для заголовка.

    state

    Состояние, использующее указанный заголовок. Возможные значения описаны в UIControlState.

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • titleColorForState (_:) - titleColorForState:

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

    Объявление

    Swift

    func titleColorForState(_ state: UIControlState) -> UIColor?

    Objective C

    - (UIColor *)titleColorForState:(UIControlState)state

    Параметры

    state

    Состояние, использующее цвет заголовка. Возможные значения описаны в UIControlState.

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

    Цвет заголовка для указанного состояния.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setTitleColor:forState:

  • setTitleColor (_: forState:) - setTitleColor:forState:

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

    Объявление

    Swift

    func setTitleColor(_ color: UIColor?, forState state: UIControlState)

    Objective C

    - (void)setTitleColor:(UIColor *)color forState:(UIControlState)state

    Параметры

    color

    Цвет заголовка для использования для указанного состояния.

    state

    Состояние, использующее указанный цвет. Возможные значения описаны в UIControlState.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – titleColorForState:

  • titleShadowColorForState (_:) - titleShadowColorForState:

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

    Объявление

    Swift

    func titleShadowColorForState(_ state: UIControlState) -> UIColor?

    Objective C

    - (UIColor *)titleShadowColorForState:(UIControlState)state

    Параметры

    state

    Состояние, использующее цвет тени заголовка. Возможные значения описаны в UIControlState.

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

    Цвет тени заголовка для указанного состояния.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setTitleShadowColor:forState:

  • setTitleShadowColor (_: forState:) - setTitleShadowColor:forState:

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

    Объявление

    Swift

    func setTitleShadowColor(_ color: UIColor?, forState state: UIControlState)

    Objective C

    - (void)setTitleShadowColor:(UIColor *)color forState:(UIControlState)state

    Параметры

    color

    Цвет тени заголовка для использования для указанного состояния.

    state

    Состояние, использующее указанный цвет. Возможные значения описаны в UIControlState.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – titleShadowColorForState:

  • reversesTitleShadowWhenHighlighted Свойство

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

    Объявление

    Swift

    var reversesTitleShadowWhenHighlighted: Bool

    Objective C

    @property(nonatomic) BOOL reversesTitleShadowWhenHighlighted

    Обсуждение

    Если YEStrue, тень изменяется от, гравируют для придания рельефности появлению, когда выделено. Значение по умолчанию NOfalse.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Конфигурирование представления кнопки
  • adjustsImageWhenHighlighted Свойство

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

    Объявление

    Swift

    var adjustsImageWhenHighlighted: Bool

    Objective C

    @property(nonatomic) BOOL adjustsImageWhenHighlighted

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    adjustsImageWhenDisabled

  • adjustsImageWhenDisabled Свойство

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

    Объявление

    Swift

    var adjustsImageWhenDisabled: Bool

    Objective C

    @property(nonatomic) BOOL adjustsImageWhenDisabled

    Обсуждение

    Если YEStrue, когда кнопка отключена, изображение нарисовано более темное. Значение по умолчанию YEStrue.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    adjustsImageWhenHighlighted

  • showsTouchWhenHighlighted Свойство

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

    Объявление

    Swift

    var showsTouchWhenHighlighted: Bool

    Objective C

    @property(nonatomic) BOOL showsTouchWhenHighlighted

    Обсуждение

    Если YEStrue, кнопка светится, когда коснулись; иначе, это не делает. Поведение изображения и кнопки не изменяется свечением. Значение по умолчанию NOfalse.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    adjustsImageWhenHighlighted

  • backgroundImageForState (_:) - backgroundImageForState:

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

    Объявление

    Swift

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

    Objective C

    - (UIImage *)backgroundImageForState:(UIControlState)state

    Параметры

    state

    Состояние, использующее фоновое изображение. Возможные значения описаны в UIControlState.

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setBackgroundImage:forState:

  • imageForState (_:) - imageForState:

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

    Объявление

    Swift

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

    Objective C

    - (UIImage *)imageForState:(UIControlState)state

    Параметры

    state

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setImage:forState:

  • setBackgroundImage (_: forState:) - setBackgroundImage:forState:

    Устанавливает фоновое изображение для использования для указанного состояния кнопки.

    Объявление

    Swift

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

    Objective C

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

    Параметры

    image

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

    state

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – backgroundImageForState:

  • setImage (_: forState:) - setImage:forState:

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    image

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

    state

    Состояние, использующее указанный заголовок. Значения описаны в UIControlState.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – imageForState:

  • tintColor Свойство

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

    Объявление

    Swift

    var tintColor: UIColor?

    Objective C

    @property(nonatomic, retain) UIColor *tintColor

    Обсуждение

    В iOS v7.0, всех подклассах UIView получите их поведение для tintColor от базового класса. Посмотрите обсуждение tintColor в UIView уровень для получения дополнительной информации.

    Это свойство не имеет никакого эффекта по умолчанию для кнопок с типом UIButtonTypeCustom. Для пользовательских кнопок необходимо реализовать любое поведение, связанное с tintColor самостоятельно.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Конфигурирование граничных вставок
  • contentEdgeInsets Свойство

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

    Объявление

    Swift

    var contentEdgeInsets: UIEdgeInsets

    Objective C

    @property(nonatomic) UIEdgeInsets contentEdgeInsets

    Обсуждение

    Используйте это свойство, чтобы изменить размеры и изменить местоположение эффективного прямоугольника получения для содержания кнопки. Содержание включает заголовок кнопки и изображение кнопки. Можно указать различное значение для каждой из четырех вставок (вершина, оставленная, нижняя часть, право). Положительное значение уменьшается, или вставки, тот край — двигание поближе его к центру кнопки. Отрицательная величина расширяется, или начала, тот край. Используйте UIEdgeInsetsMake функционируйте для построения значения для этого свойства. Значение по умолчанию UIEdgeInsetsZero.

    Кнопка использует это свойство для определения intrinsicContentSize и sizeThatFits:.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    imageEdgeInsets
    titleEdgeInsets

  • titleEdgeInsets Свойство

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

    Объявление

    Swift

    var titleEdgeInsets: UIEdgeInsets

    Objective C

    @property(nonatomic) UIEdgeInsets titleEdgeInsets

    Обсуждение

    Используйте это свойство, чтобы изменить размеры и изменить местоположение эффективного прямоугольника получения для заголовка кнопки. Можно указать различное значение для каждой из четырех вставок (вершина, оставленная, нижняя часть, право). Положительное значение уменьшается, или вставки, тот край — двигание поближе его к центру кнопки. Отрицательная величина расширяется, или начала, тот край. Используйте UIEdgeInsetsMake функционируйте для построения значения для этого свойства. Значение по умолчанию UIEdgeInsetsZero.

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

    Это свойство используется только для расположения заголовка во время расположения. Кнопка не использует это свойство для определения intrinsicContentSize и sizeThatFits:.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    contentEdgeInsets
    imageEdgeInsets

  • imageEdgeInsets Свойство

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

    Объявление

    Swift

    var imageEdgeInsets: UIEdgeInsets

    Objective C

    @property(nonatomic) UIEdgeInsets imageEdgeInsets

    Обсуждение

    Используйте это свойство, чтобы изменить размеры и изменить местоположение эффективного прямоугольника получения для изображения кнопки. Можно указать различное значение для каждой из четырех вставок (вершина, оставленная, нижняя часть, право). Положительное значение уменьшается, или вставки, тот край — двигание поближе его к центру кнопки. Отрицательная величина расширяется, или начала, тот край. Используйте UIEdgeInsetsMake функционируйте для построения значения для этого свойства. Значение по умолчанию UIEdgeInsetsZero.

    Это свойство используется только для расположения изображения во время расположения. Кнопка не использует это свойство для определения intrinsicContentSize и sizeThatFits:.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    contentEdgeInsets
    titleEdgeInsets

Получение текущего состояния
  • buttonType Свойство

    Тип кнопки. (только для чтения)

    Объявление

    Swift

    var buttonType: UIButtonType { get }

    Objective C

    @property(nonatomic, readonly) UIButtonType buttonType

    Обсуждение

    Посмотрите UIButtonType для возможных значений.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • currentTitle Свойство

    Текущий заголовок, выведенный на экран на кнопке. (только для чтения)

    Объявление

    Swift

    var currentTitle: String? { get }

    Objective C

    @property(nonatomic, readonly, retain) NSString *currentTitle

    Обсуждение

    Значение для этого свойства установлено автоматически каждый раз, когда изменяется состояние кнопки. Для состояний, не имеющих пользовательской строки заголовка связанной с ними, этот метод возвращает заголовок, в настоящее время выводящийся на экран, который обычно является тем, связанным с UIControlStateNormal состояние. Значение может быть nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setTitle:forState:
    currentTitleColor
    currentTitleShadowColor
    titleLabel

  • currentAttributedTitle Свойство

    Текущий стилизованный заголовок, выведенный на экран на кнопке. (только для чтения)

    Объявление

    Swift

    var currentAttributedTitle: NSAttributedString? { get }

    Objective C

    @property(nonatomic, readonly, retain) NSAttributedString *currentAttributedTitle

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • currentTitleColor Свойство

    Цвет раньше выводил на экран заголовок. (только для чтения)

    Объявление

    Swift

    var currentTitleColor: UIColor! { get }

    Objective C

    @property(nonatomic, readonly, retain) UIColor *currentTitleColor

    Обсуждение

    Это значение, как гарантируют, не будет nil. Значение по умолчанию white.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    currentTitle
    currentTitleShadowColor

  • currentTitleShadowColor Свойство

    Цвет тени заголовка. (только для чтения)

    Объявление

    Swift

    var currentTitleShadowColor: UIColor? { get }

    Objective C

    @property(nonatomic, readonly, retain) UIColor *currentTitleShadowColor

    Обсуждение

    Значение по умолчанию white.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    currentTitle
    currentTitleColor

  • currentImage Свойство

    Текущее изображение выведено на экран на кнопке. (только для чтения)

    Объявление

    Swift

    var currentImage: UIImage? { get }

    Objective C

    @property(nonatomic, readonly, retain) UIImage *currentImage

    Обсуждение

    Это значение может быть nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    currentBackgroundImage

  • currentBackgroundImage Свойство

    Текущее фоновое изображение выведено на экран на кнопке. (только для чтения)

    Объявление

    Swift

    var currentBackgroundImage: UIImage? { get }

    Objective C

    @property(nonatomic, readonly, retain) UIImage *currentBackgroundImage

    Обсуждение

    Это значение может быть nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    currentImage

  • imageView Свойство

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

    Объявление

    Swift

    var imageView: UIImageView? { get }

    Objective C

    @property(nonatomic, readonly, retain) UIImageView *imageView

    Обсуждение

    Несмотря на то, что это свойство только для чтения, его собственные свойства являются чтением-записью. Используйте эти свойства для конфигурирования появления и поведения представления кнопки. Например:

    Swift

    • let button = UIButton.buttonWithType(.System) as UIButton
    • button.imageView.exclusiveTouch = true;

    Objective C

    • UIButton *button = [UIButton buttonWithType: UIButtonTypeSystem];
    • button.imageView.exclusiveTouch = YES;

    imageView даже если кнопка не была выведена на экран еще, свойство возвращает значение. Значение свойства nil для системных кнопок.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Получение размерностей
  • backgroundRectForBounds (_:) - backgroundRectForBounds:

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

    Объявление

    Swift

    func backgroundRectForBounds(_ bounds: CGRect) -> CGRect

    Objective C

    - (CGRect)backgroundRectForBounds:(CGRect)bounds

    Параметры

    bounds

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

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – contentRectForBounds:

  • contentRectForBounds (_:) - contentRectForBounds:

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

    Объявление

    Swift

    func contentRectForBounds(_ bounds: CGRect) -> CGRect

    Objective C

    - (CGRect)contentRectForBounds:(CGRect)bounds

    Параметры

    bounds

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

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    contentEdgeInsets
    – backgroundRectForBounds:

  • titleRectForContentRect (_:) - titleRectForContentRect:

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

    Объявление

    Swift

    func titleRectForContentRect(_ contentRect: CGRect) -> CGRect

    Objective C

    - (CGRect)titleRectForContentRect:(CGRect)contentRect

    Параметры

    contentRect

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – contentRectForBounds:
    – imageRectForContentRect:

  • imageRectForContentRect (_:) - imageRectForContentRect:

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

    Объявление

    Swift

    func imageRectForContentRect(_ contentRect: CGRect) -> CGRect

    Objective C

    - (CGRect)imageRectForContentRect:(CGRect)contentRect

    Параметры

    contentRect

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – contentRectForBounds:
    – titleRectForContentRect:

устаревшие (deprecated) свойства
  • font (iOS 3.0) Свойство

    Шрифт раньше выводил на экран текст на кнопке.

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

    Используйте font свойство titleLabel вместо этого.

    Объявление

    Objective C

    @property(nonatomic, retain) UIFont *font

    Обсуждение

    Если nil, системный шрифт используется. Значение по умолчанию nil.

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

    Objective C

    @import UIKit;

    Доступность

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

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

    См. также

    titleLabel

  • lineBreakMode (iOS 3.0) Свойство

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

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

    Используйте lineBreakMode свойство titleLabel вместо этого.

    Объявление

    Objective C

    @property(nonatomic) NSLineBreakMode lineBreakMode

    Обсуждение

    Это свойство является одной из констант, описанных в UILineBreakMode перечисление в NSString UIKit Дополнительная Ссылка. Значение по умолчанию UILineBreakModeMiddleTruncation.

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

    Objective C

    @import UIKit;

    Доступность

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

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

    См. также

    titleLabel

  • titleShadowOffset (iOS 3.0) Свойство

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

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

    Используйте shadowOffset свойство titleLabel вместо этого.

    Объявление

    Objective C

    @property(nonatomic) CGSize titleShadowOffset

    Обсуждение

    Горизонталь и вертикальные значения смещения, указанное использование width и height поля CGSize тип данных. Положительные значения всегда расширяются и вправо с точки зрения пользователя. Значение по умолчанию CGSizeZero.

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

    Objective C

    @import UIKit;

    Доступность

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

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

    См. также

    titleLabel

Типы данных

  • UIButtonType

    Указывает стиль кнопки.

    Объявление

    Swift

    enum UIButtonType : Int { case Custom case System case DetailDisclosure case InfoLight case InfoDark case ContactAdd }

    Objective C

    typedef enum { UIButtonTypeCustom = 0, UIButtonTypeSystem, UIButtonTypeDetailDisclosure, UIButtonTypeInfoLight, UIButtonTypeInfoDark, UIButtonTypeContactAdd, UIButtonTypeRoundedRect, } UIButtonType;

    Константы

    • Custom

      UIButtonTypeCustom

      Никакой стиль кнопки.

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

    • System

      UIButtonTypeSystem

      Системная кнопка стиля, такая как показанные в панелях навигации и панелях инструментов.

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

    • DetailDisclosure

      UIButtonTypeDetailDisclosure

      Подробная кнопка раскрытия.

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

    • InfoLight

      UIButtonTypeInfoLight

      Кнопка информации, имеющая светлый фон.

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

    • InfoDark

      UIButtonTypeInfoDark

      Кнопка информации, имеющая темный фон.

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

    • ContactAdd

      UIButtonTypeContactAdd

      Контакт добавляет кнопку.

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

    • UIButtonTypeRoundedRect

      Кнопка стиля скругленного прямоугольника.

      Использовать UIButtonTypeSystem вместо этого.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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