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

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

Разработчик

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

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

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

UIToolbar

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

Для создания элементов панели инструментов используйте UIBarButtonItem класс. Для добавления элементов панели инструментов к панели инструментов используйте setItems:animated: метод.

Изображения панели инструментов, представляющие нормальные и выделенные состояния элемента, происходят из изображения, Вы устанавливаете использование наследованного image свойство от UIBarItem класс. В iOS 7.0 изображение окрашено с панелью инструментов tintColor.

При необходимости в средствах управления стилем переключателя используйте UITabBar класс вместо UIToolbar.

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

Вы используете методы, перечисленные в Настройке Появления для настройки появления панелей инструментов. Вы отправляете сообщения метода set в прокси появления ([UIToolbar appearance]) настроить все панели инструментов, или к определенному UIToolbar экземпляр. Когда свойство зависит от метрик панели (на iPhone, в альбомной ориентации, панели имеют различную высоту от стандарта), необходимо обычно указывать значение для UIBarMetricsDefault а также дляUIBarMetricsLandscapePhone.

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

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

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

    Объявление

    Swift

    var items: [AnyObject]?

    Objective C

    @property(nonatomic, copy) NSArray *items

    Обсуждение

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

    Значение по умолчанию 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 и позже.

    См. также

    элементы

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

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

    Объявление

    Swift

    var barStyle: UIBarStyle

    Objective C

    @property(nonatomic) UIBarStyle barStyle

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.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 и позже.

  • tintColor Свойство

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

    Объявление

    Swift

    var tintColor: UIColor!

    Objective C

    @property(nonatomic, retain) UIColor *tintColor

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • translucent Свойство

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

    Объявление

    Swift

    var translucent: Bool

    Objective C

    @property(nonatomic, assign, getter=isTranslucent) BOOL translucent

    Обсуждение

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • backgroundImageForToolbarPosition (_: barMetrics:) - backgroundImageForToolbarPosition:barMetrics:

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

    Объявление

    Swift

    func backgroundImageForToolbarPosition(_ topOrBottom: UIBarPosition, barMetrics barMetrics: UIBarMetrics) -> UIImage?

    Objective C

    - (UIImage *)backgroundImageForToolbarPosition:(UIBarPosition)topOrBottom barMetrics:(UIBarMetrics)barMetrics

    Параметры

    topOrBottom

    Расположение панель рисуется в.

    barMetrics

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

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

    Изображение для использования для фона панели инструментов в позиции, указанной topOrBottom и с метриками, указанными barMetrics.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setBackgroundImage:forToolbarPosition:barMetrics:

  • setBackgroundImage (_: forToolbarPosition:barMetrics:) - setBackgroundImage:forToolbarPosition:barMetrics:

    Устанавливает изображение для использования для фона в данной позиции и с данными метриками.

    Объявление

    Swift

    func setBackgroundImage(_ backgroundImage: UIImage?, forToolbarPosition topOrBottom: UIBarPosition, barMetrics barMetrics: UIBarMetrics)

    Objective C

    - (void)setBackgroundImage:(UIImage *)backgroundImage forToolbarPosition:(UIBarPosition)topOrBottom barMetrics:(UIBarMetrics)barMetrics

    Параметры

    backgroundImage

    Изображение для использования для фона панели инструментов в позиции, указанной topOrBottom и с метриками, указанными barMetrics.

    topOrBottom

    Постоянная позиция панели инструментов.

    barMetrics

    Панель постоянные метрики.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – backgroundImageForToolbarPosition:barMetrics:

  • shadowImageForToolbarPosition (_:) - shadowImageForToolbarPosition:

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

    Объявление

    Swift

    func shadowImageForToolbarPosition(_ topOrBottom: UIBarPosition) -> UIImage?

    Objective C

    - (UIImage *)shadowImageForToolbarPosition:(UIBarPosition)topOrBottom

    Параметры

    topOrBottom

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

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

    Изображение для использования для тени панели инструментов в позиции, указанной topOrBottom.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – setShadowImage:forToolbarPosition:

  • setShadowImage (_: forToolbarPosition:) - setShadowImage:forToolbarPosition:

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

    Объявление

    Swift

    func setShadowImage(_ shadowImage: UIImage?, forToolbarPosition topOrBottom: UIBarPosition)

    Objective C

    - (void)setShadowImage:(UIImage *)shadowImage forToolbarPosition:(UIBarPosition)topOrBottom

    Параметры

    shadowImage

    Изображение для использования для тени панели инструментов в позиции, указанной topOrBottom.

    topOrBottom

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

    Обсуждение

    Когда shadowImage параметр nil, тень по умолчанию будет использоваться. Когда не -nil, shadowImage свойство является пользовательским теневым изображением для показа вместо значения по умолчанию. Используя topOrBottom параметр, можно установить различную тень для панелей инструментов вверху и внизу представления. Для пользовательского теневого изображения, которое будет показано, пользовательское фоновое изображение должно также быть установлено с setBackgroundImage:forToolbarPosition:barMetrics: метод. Если фоновое изображение по умолчанию будет использоваться, то теневое изображение по умолчанию будет использоваться независимо от значения shadowImage параметр.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – shadowImageForToolbarPosition:

Управление делегатом
  • delegate Свойство

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

    Объявление

    Swift

    unowned(unsafe) var delegate: UIToolbarDelegate?

    Objective C

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

    Обсуждение

    Делегат должен соответствовать UIToolbarDelegate протокол. Когда панелью инструментов управляет контроллер навигации, Вы не можете установить делегата. Значение по умолчанию nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Константы
  • UIToolbarPosition

    Константы для идентификации позиции панели инструментов для настройки появления (см. setBackgroundImage:forToolbarPosition:barMetrics:).

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

    Объявление

    Objective C

    typedef enum { UIToolbarPositionAny = 0, UIToolbarPositionBottom = 1, UIToolbarPositionTop = 2, } UIToolbarPosition;

    Константы

    • UIToolbarPositionAny

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

      Доступный в iOS 5.0 через iOS 6.1.

    • UIToolbarPositionBottom

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

      Доступный в iOS 5.0 через iOS 6.1.

    • UIToolbarPositionTop

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

      Доступный в iOS 5.0 через iOS 6.1.

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

    Objective C

    @import UIKit;

    Доступность

    Доступный в iOS 5.0 через iOS 6.1.