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

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

Разработчик

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

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

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

UITabBar

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

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

Используйте UITabBarItem класс для создания элементов и setItems:animated: метод для добавления их к панели вкладок. Все методы с animated: параметр позволяет Вам дополнительно анимировать изменения в дисплее. Используйте selectedItem свойство для доступа к текущему элементу.

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

Можно настроить появление панелей вкладок с помощью методов, перечисленных в Настройке Появления Панели вкладок. Можно настроить появление всех панелей вкладок в приложении при помощи прокси появления (например, [UITabBar appearance]), или просто единственной панели вкладок.

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

Установка делегата
  • delegate Свойство

    Объект делегата панели вкладок.

    Объявление

    Swift

    unowned(unsafe) var delegate: UITabBarDelegate?

    Objective C

    @property(nonatomic, assign) id< UITabBarDelegate > delegate

    Обсуждение

    Делегат должен соответствовать UITabBarDelegate протокол. Установите это свойство для дальнейшего изменения поведения настройки. Значение по умолчанию nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

    Элементы выведены на экран на панели вкладок.

    Объявление

    Swift

    var items: [AnyObject]?

    Objective C

    @property(nonatomic, copy) NSArray *items

    Обсуждение

    Элементы, экземпляры UITabBarItem, это видимо на панели вкладок в порядке, они появляются в этом массиве. Любые изменения в этом свойстве не анимированы. Используйте setItems:animated: метод для анимации изменений.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    selectedItem
    – setItems:animated:

  • selectedItem Свойство

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

    Объявление

    Swift

    unowned(unsafe) var selectedItem: UITabBarItem?

    Objective C

    @property(nonatomic, assign) UITabBarItem *selectedItem

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    элементы
    – setItems:animated:

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

    Устанавливает элементы на панели вкладок, с или без анимации.

    Объявление

    Swift

    func setItems(_ items: [AnyObject]?, animated animated: Bool)

    Objective C

    - (void)setItems:(NSArray *)items animated:(BOOL)animated

    Параметры

    items

    Элементы для отображения на панели вкладок.

    animated

    Если YEStrue, анимирует переход к элементам; иначе, не делает.

    Обсуждение

    Если animated YEStrue, изменения растворены, или переупорядочение анимировано — например, удаленные элементы постепенно исчезают, и новые элементы постепенно появляются. Этот метод также корректирует интервал между элементами.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    элементы
    selectedItem

Поддержка пользовательской настройки панелей вкладок
  • beginCustomizingItems (_:) - beginCustomizingItems:

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

    Объявление

    Swift

    func beginCustomizingItems(_ items: [AnyObject])

    Objective C

    - (void)beginCustomizingItems:(NSArray *)items

    Параметры

    items

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

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

    Обсуждение

    Используйте этот метод, чтобы начать настраивать панель вкладок. Например, создайте кнопку Edit, вызывающую этот метод, когда коснулись. Модальное представление кажется выводящим на экран все элементы в items с кнопкой Done наверху. Ответвление кнопки Done отклоняет модальное представление. Если выбранный пункт удален из панели вкладок, selectedItem свойство установлено в nil. Установите delegate свойство к объекту, соответствующему UITabBarDelegate протокол для дальнейшего изменения этого поведения.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – endCustomizingAnimated:
    – isCustomizing

  • endCustomizingAnimated (_:) - endCustomizingAnimated:

    Отклоняет модальное представление, используемое для изменения элементов на панели вкладок.

    Объявление

    Swift

    func endCustomizingAnimated(_ animated: Bool) -> Bool

    Objective C

    - (BOOL)endCustomizingAnimated:(BOOL)animated

    Параметры

    animated

    Если YEStrue, анимирует переход; иначе, не делает.

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

    YEStrue если изменились элементы на панели вкладок; иначе, NOfalse.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – beginCustomizingItems:
    – isCustomizing

  • isCustomizing () - isCustomizing

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

    Объявление

    Swift

    func isCustomizing() -> Bool

    Objective C

    - (BOOL)isCustomizing

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

    YEStrue если пользователь в настоящее время настраивает элементы на панели вкладок; иначе, NOfalse. Например, путем ответвления кнопки Edit, модальное представление появляется, позволяя пользователям изменить элементы на панели вкладок. Этот метод возвраты YEStrue если это модальное представление видимо.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – beginCustomizingItems:
    – endCustomizingAnimated:

Настройка появления панели вкладок
  • barStyle Свойство

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

    Объявление

    Swift

    var barStyle: UIBarStyle

    Objective C

    @property(nonatomic) UIBarStyle barStyle

    Обсуждение

    Посмотрите UIBarStyle для возможных значений. Значение по умолчанию UIBarStyleDefault.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • barTintColor Свойство

    Цвет оттенка для применения к фону панели вкладок.

    Объявление

    Swift

    var barTintColor: UIColor?

    Objective C

    @property(nonatomic, retain) UIColor *barTintColor

    Обсуждение

    Этот цвет сделан полупрозрачным по умолчанию, если Вы не устанавливаете translucent свойство к NOfalse.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • itemPositioning Свойство

    Схема расположения элементов панели вкладок в панели вкладок.

    Объявление

    Swift

    var itemPositioning: UITabBarItemPositioning

    Objective C

    @property(nonatomic) UITabBarItemPositioning itemPositioning

    Обсуждение

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

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

    • Для элемента интерфейса пользователя iPad элементы панели вкладок расположены близко смежные друг с другом с шириной по умолчанию и интервалом межэлемента (настраиваемый с itemWidth и itemSpacing свойства), потенциально оставляя пространство в панели вкладок в ее левых и правых краях

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    itemSpacing
    itemWidth

  • itemSpacing Свойство

    Пользовательский интервал межэлемента для элементов панели вкладок, в точках, при использовании расположения стиля в центре.

    Объявление

    Swift

    var itemSpacing: CGFloat

    Objective C

    @property(nonatomic) CGFloat itemSpacing

    Обсуждение

    Указать пользовательский интервал между элементами панели вкладок при использовании UITabBarItemPositioningCentered расположение опции, набор это свойство к положительному значению, которое панель вкладок тогда использует непосредственно. Для указания определенного с помощью системы интервала используйте a 0 значение, которое является значением по умолчанию для этого свойства. (При указании отрицательной величины панель вкладок интерпретирует ее как 0 и использует определенный с помощью системы интервал.)

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    itemPositioning
    itemWidth

  • itemWidth Свойство

    Пользовательская ширина элемента для элементов панели вкладок, в точках, при использовании расположения стиля в центре.

    Объявление

    Swift

    var itemWidth: CGFloat

    Objective C

    @property(nonatomic) CGFloat itemWidth

    Обсуждение

    Указать пользовательскую ширину для элементов панели вкладок при использовании UITabBarItemPositioningCentered расположение опции, набор это свойство к положительному значению, которое панель вкладок тогда использует непосредственно. Для указания определенной с помощью системы ширины элемента панели вкладок используйте a 0 значение, которое является значением по умолчанию для этого свойства. (При указании отрицательной величины панель вкладок интерпретирует ее как 0 и использует определенную с помощью системы ширину.)

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    itemPositioning
    itemSpacing

  • tintColor Свойство

    Цвет оттенка для применения к элементам панели вкладок панели вкладок.

    Объявление

    Swift

    var tintColor: UIColor!

    Objective C

    @property(nonatomic, retain) UIColor *tintColor

    Обсуждение

    Запускаясь в iOS 7.0, цвет оттенка, применяющийся к элементам панели вкладок панели вкладок, является первым оттенком не по умолчанию, раскрашивают иерархию представления, начиная с самой панели вкладок. См. описание tintColor в Ссылке класса UIView для получения дополнительной информации.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • selectedImageTintColor (iOS 8.0) Свойство

    Цвет оттенка применился к выбранному элементу панели вкладок.

    Объявление

    Swift

    var selectedImageTintColor: UIColor?

    Objective C

    @property(nonatomic, retain) UIColor *selectedImageTintColor

    Обсуждение

    Значение по умолчанию nil, который приводит к использованию панели вкладок tintColor свойство.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

  • translucent Свойство

    Булево значение, указывающее, полупрозрачна ли панель вкладок (YEStrue) или не (NOfalse).

    Объявление

    Swift

    var translucent: Bool

    Objective C

    @property(nonatomic, getter=isTranslucent) BOOL translucent

    Обсуждение

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

    Если панель вкладок действительно имеет пользовательское фоновое изображение, для которого любой пиксель имеет альфа-значение меньше чем 1,0, значение по умолчанию также YEStrue. Значение по умолчанию NOfalse если пользовательское фоновое изображение полностью непрозрачно.

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

    Если Вы устанавливаете это свойство в NOfalse на панели вкладок с полупрозрачным пользовательским фоновым изображением панель вкладок обеспечивает непрозрачный фон для Вашего изображения и применяет размывающийся фон. Если панель вкладок имеет, предоставленный непрозрачный фон является черным UIBarStyleBlack стиль, белый, если панель вкладок имеет UIBarStyleDefault, или цвет оттенка панели вкладок (barTintColor) если Вы определили тот. Ситуация идентична при установке этого свойства в NOfalse для панели вкладок без пользовательского фонового изображения, кроме панели вкладок не применяет размывающийся фон.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • backgroundImage Свойство

    Фоновое изображение для панели вкладок.

    Объявление

    Swift

    var backgroundImage: UIImage?

    Objective C

    @property(nonatomic, retain) UIImage *backgroundImage

    Обсуждение

    Расширяется поддающееся растягиванию фоновое изображение; неподдающееся растягиванию фоновое изображение размещается рядом (обратитесь к UIImageResizingMode перечисление в Ссылке класса UIImage).

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • shadowImage Свойство

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

    Объявление

    Swift

    var shadowImage: UIImage?

    Objective C

    @property(nonatomic, retain) UIImage *shadowImage

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • selectionIndicatorImage Свойство

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

    Объявление

    Swift

    var selectionIndicatorImage: UIImage?

    Objective C

    @property(nonatomic, retain) UIImage *selectionIndicatorImage

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Константы
  • UITabBarItemPositioning

    Константы, указывающие расположение элемента панели вкладок.

    Объявление

    Swift

    enum UITabBarItemPositioning : Int { case Automatic case Fill case Centered }

    Objective C

    typedef enum : NSInteger { UITabBarItemPositioningAutomatic, UITabBarItemPositioningFill, UITabBarItemPositioningCentered, } UITabBarItemPositioning;

    Константы

    • Automatic

      UITabBarItemPositioningAutomatic

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

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

      • Для элемента интерфейса пользователя iPad элементы панели вкладок расположены близко смежные друг с другом с шириной по умолчанию и интервалом межэлемента (настраиваемый с itemWidth и itemSpacing свойства), потенциально оставляя пространство в панели вкладок в ее левых и правых краях

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

    • Fill

      UITabBarItemPositioningFill

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

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

    • Centered

      UITabBarItemPositioningCentered

      Расположение элемента панели вкладок по умолчанию на iPad. Указывает, что элементы панели вкладок должны быть расположены близко смежные друг с другом с шириной по умолчанию и интервалом межэлемента (настраиваемый с itemWidth и itemSpacing свойства). Группа элементов панели вкладок центрируется в панели вкладок, потенциально оставляя пространство в панели вкладок в ее левых и правых краях.

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

    Обсуждение

    Запускаясь в iOS 7, можно использовать эти константы для указания стиля позиционирования элемента панели вкладок с itemPositioning свойство.

    При работе любого устройства на iOS можно настроить расположение с itemWidth и itemSpacing свойства при использовании UITabBarItemPositioningCentered опция. На iPad можно также настроить расположение с теми свойствами при использовании UITabBarItemPositioningAutomatic опция.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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