UITabBarItem

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

NSObject
UIBarItem
UITabBarItem

NSObject
UIBarItem
UITabBarItem

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

UITabBarItem класс реализует элемент на a UITabBar объект. Панель вкладок работает строго в радио-режиме, где один элемент выбран за один раз — ответвление элемента панели вкладок переключает представление выше панели вкладок. Можно также указать значение значка на элементе панели вкладок для добавления дополнительной визуальной информации — например, приложение сообщений использует значок на элементе для показа числа новых сообщений. Этот класс также обеспечивает много системных значений по умолчанию для создания элементов.

Используйте initWithTabBarSystemItem:tag: метод для создания одного из системных элементов. Используйте initWithTitle:image:tag: метод для создания пользовательского элемента с указанным заголовком и изображением, использующимся в качестве обоих отменявшее и выбранное изображение. Используйте initWithTitle:image:selectedImage: метод для создания пользовательского элемента с указанным заголовком, отменял изображение и выбранное изображение.

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

В iOS v5.0 и позже, можно настроить появление панелей вкладок путем установки атрибутов текста метки элемента с помощью селекторов появления, объявленных UIBarItem. Можно также использовать методы, перечисленные в Настройке Появления. Можно настроить появление всех элементов панели вкладок с помощью прокси появления (например, [UITabBarItem appearance]), или только единственного элемента панели вкладок.

По умолчанию отменявшие и выбранные изображения автоматически создаются из альфа-значений в исходных изображениях. Для предотвращения системной окраски предоставьте изображениям UIImageRenderingModeAlwaysOriginal.

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

Инициализация элемента


    
    init (tabBarSystemItem:tag:)
    - initWithTabBarSystemItem:tag:

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

Объявление

Swift

init(tabBarSystemItem systemItem: UITabBarSystemItem, tag tag: Int)

Objective C

- (instancetype)initWithTabBarSystemItem:(UITabBarSystemItem)systemItem tag:(NSInteger)tag

Параметры

`systemItem`	Системный элемент для использования в качестве первого элемента на панели вкладок. Одна из констант, определенных в `UITabBarSystemItem`.
`tag`	Тег получателя, целое число, которое можно использовать для идентификации объектов элемента панели в приложении.

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

Недавно инициализированный элемент, содержащий указанный системный элемент. Цель элемента nil.

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

– initWithTitle:image:tag:
– initWithTitle:image:selectedImage:


    
    init (title:image:tag:)
    - initWithTitle:image:tag:

Создает и возвращает новый элемент с помощью указанных свойств.

Объявление

Swift

init(title title: String?, image image: UIImage?, tag tag: Int)

Objective C

- (instancetype)initWithTitle:(NSString *)title image:(UIImage *)image tag:(NSInteger)tag

Параметры

`title`	Заголовок элемента. Если `nil`, заголовок не выведен на экран.
`image`	Изображение элемента. Если `nil`, изображение не выведено на экран.
`tag`	Тег получателя, целое число, которое можно использовать для идентификации объектов элемента панели в приложении.

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

Недавно инициализированный элемент с указанными свойствами.

Обсуждение

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

По умолчанию фактические отменявшие и выбранные изображения автоматически создаются из альфа-значений в исходных изображениях. Для предотвращения системной окраски предоставьте изображениям UIImageRenderingModeAlwaysOriginal.

Если изображение является слишком большим для адаптации на панели вкладок, оно отсекается для адаптации. Размер изображения панели вкладок обычно - 60 x 60 пикселей. См. и Инструкции по Созданию изображений Пользовательского значка для получения дополнительной информации о значках панели вкладок.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

– initWithTabBarSystemItem:tag:
– initWithTitle:image:selectedImage:


    
    init (title:image:selectedImage:)
    - initWithTitle:image:selectedImage:

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

Объявление

Swift

init(title title: String?, image image: UIImage?, selectedImage selectedImage: UIImage?)

Objective C

- (instancetype)initWithTitle:(NSString *)title image:(UIImage *)image selectedImage:(UIImage *)selectedImage

Параметры

`title`	Заголовок элемента. Если `nil`, заголовок не выведен на экран.
`image`	Отменявшее изображение элемента. Если `nil`, изображение не выведено на экран.
`selectedImage`	Выбранное изображение элемента. Если `nil`, использует значение `image`.

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

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

Обсуждение

Если нет selectedImage предоставлен, image используется в качестве обоих отменявшее и выбранное изображение.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

– initWithTabBarSystemItem:tag:
– initWithTitle:image:tag:
selectedImage

Получение и установка свойств

badgeValue Свойство

Текст, выведенный на экран в верхнем правом углу элемента с окружающим красным овалом.

Объявление

Swift

var badgeValue: String?

Objective C

@property(nonatomic, copy) NSString *badgeValue

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

selectedImage Свойство

Когда элемент панели вкладок выбран, изображение вывело на экран.

Объявление

Swift

var selectedImage: UIImage!

Objective C

@property(nonatomic, retain) UIImage *selectedImage

Обсуждение

Если nil, значение от image свойство на суперклассе, UIBarItem, используется в качестве обоих отменявшее и выбранное изображение.

По умолчанию фактическое выбранное изображение автоматически создается из альфа-значений в исходном изображении. Для предотвращения системной окраски предоставьте изображениям UIImageRenderingModeAlwaysOriginal.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

func titlePositionAdjustment() -> UIOffset

Objective C

- (UIOffset)titlePositionAdjustment

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

– setTitlePositionAdjustment:
setTitlePositionAdjustment (_:) - setTitlePositionAdjustment:

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

Объявление

Swift

func setTitlePositionAdjustment(_ adjustment: UIOffset)

Objective C

- (void)setTitlePositionAdjustment:(UIOffset)adjustment

Параметры

adjustment

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

– titlePositionAdjustment

Управление законченным выбранным изображением

- finishedSelectedImage (iOS 7.0)

Возвращает законченное выбранное изображение.

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

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

Объявление

Objective C

- (UIImage *)finishedSelectedImage

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

Законченное выбранное изображение.

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 5.0 и позже.
Осуждаемый в iOS 7.0.

См. также

– finishedUnselectedImage
– setFinishedSelectedImage:withFinishedUnselectedImage:
- finishedUnselectedImage (iOS 7.0)

Возвращает законченное отменявшее изображение.

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

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

Объявление

Objective C

- (UIImage *)finishedUnselectedImage

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

Законченное отменявшее изображение.

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 5.0 и позже.
Осуждаемый в iOS 7.0.

См. также

– finishedSelectedImage
– setFinishedSelectedImage:withFinishedUnselectedImage:


    
    - setFinishedSelectedImage:withFinishedUnselectedImage:

(iOS 7.0)

Устанавливает законченные выбранные и отменявшие изображения.

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

Использовать image и selectedImage с UIImageRenderingModeAlwaysOriginal вместо этого.

Объявление

Objective C

- (void)setFinishedSelectedImage:(UIImage *)selectedImage withFinishedUnselectedImage:(UIImage *)unselectedImage

Параметры

`selectedImage`	Законченное выбранное изображение.
`unselectedImage`	Законченное отменявшее изображение.

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

Objective C

@import UIKit;

Доступность

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

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

См. также

– finishedSelectedImage
– finishedUnselectedImage

Типы данных

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

Объявление

Swift

enum UITabBarSystemItem : Int { case More case Favorites case Featured case TopRated case Recents case Contacts case History case Bookmarks case Search case Downloads case MostRecent case MostViewed }

Objective C

typedef enum { UITabBarSystemItemMore, UITabBarSystemItemFavorites, UITabBarSystemItemFeatured, UITabBarSystemItemTopRated, UITabBarSystemItemRecents, UITabBarSystemItemContacts, UITabBarSystemItemHistory, UITabBarSystemItemBookmarks, UITabBarSystemItemSearch, UITabBarSystemItemDownloads, UITabBarSystemItemMostRecent, UITabBarSystemItemMostViewed, } UITabBarSystemItem;

Константы
- More
  
  UITabBarSystemItemMore
  
  Больше системного элемента.
  
  Доступный в iOS 2.0 и позже.
- Favorites
  
  UITabBarSystemItemFavorites
  
  Системный элемент избранного.
  
  Доступный в iOS 2.0 и позже.
- Featured
  
  UITabBarSystemItemFeatured
  
  Известный системный элемент.
  
  Доступный в iOS 2.0 и позже.
- TopRated
  
  UITabBarSystemItemTopRated
  
  Вершина оценила системный элемент.
  
  Доступный в iOS 2.0 и позже.
- Recents
  
  UITabBarSystemItemRecents
  
  recents системный элемент.
  
  Доступный в iOS 2.0 и позже.
- Contacts
  
  UITabBarSystemItemContacts
  
  Системный элемент контактов.
  
  Доступный в iOS 2.0 и позже.
- History
  
  UITabBarSystemItemHistory
  
  Системный элемент истории.
  
  Доступный в iOS 2.0 и позже.
- Bookmarks
  
  UITabBarSystemItemBookmarks
  
  Системный элемент закладок.
  
  Доступный в iOS 2.0 и позже.
- Search
  
  UITabBarSystemItemSearch
  
  Поисковый системный элемент.
  
  Доступный в iOS 2.0 и позже.
- Downloads
  
  UITabBarSystemItemDownloads
  
  Системный элемент загрузок.
  
  Доступный в iOS 2.0 и позже.
- MostRecent
  
  UITabBarSystemItemMostRecent
  
  Новый системный элемент.
  
  Доступный в iOS 2.0 и позже.
- MostViewed
  
  UITabBarSystemItemMostViewed
  
  Наиболее просматриваемый системный элемент.
  
  Доступный в iOS 2.0 и позже.
Обсуждение

Заголовок и изображение системных элементов панели вкладок не могут быть изменены.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

UITabBarItem

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

Инициализация элемента

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Получение и установка свойств

Объявление

Обсуждение

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

Доступность

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

Объявление

Обсуждение

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

Доступность

Объявление

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

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

Доступность

См. также

Объявление

Параметры

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

Доступность

См. также

Управление законченным выбранным изображением

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

Объявление

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

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

Доступность

См. также

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

Объявление

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

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

Доступность

См. также

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

Объявление

Параметры

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

Доступность

См. также

Типы данных

Объявление

Константы

Обсуждение

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

Доступность