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

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

Разработчик

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

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

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

UINavigationItem

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

A UINavigationItem объект управляет кнопками и представлениями, которые будут выведены на экран в a UINavigationBar объект. При создании интерфейса навигации каждый контроллер представления, продвинутый на штабель навигации, должен иметь a UINavigationItem объект, содержащий кнопки и представления, которые он хочет выведенный на экран в панели навигации. Управление UINavigationController возразите использует элементы навигации самых верхних двух контроллеров представления для заполнения панели навигации с содержанием.

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

backBarButtonItem свойство элемента навигации отражает кнопку «Назад», которую Вы хотите выведенный на экран, когда контроллер текущего представления чуть ниже самого верхнего контроллера представления. Другими словами, когда контроллер текущего представления самый верхний, кнопка «Назад» не используется.

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

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

Инициализация элемента
  • init (заголовок:) - initWithTitle:

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

    Объявление

    Swift

    init(title title: String?)

    Objective C

    - (instancetype)initWithTitle:(NSString *)title

    Параметры

    title

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

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

    Новое UINavigationItem объект инициализируется с указанным заголовком.

    Обсуждение

    Это - определяемый инициализатор для этого класса.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    заголовок

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

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

    Объявление

    Swift

    var title: String?

    Objective C

    @property(nonatomic, copy) NSString *title

    Обсуждение

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

    Когда получатель находится на штабеле элемента навигации и является вторым от вершины — другими словами, ее контроллер представления управляет представлениями, что пользователь перешел бы назад к — значение в этом свойстве используется для кнопки «Назад» на самой верхней панели навигации. Если значение этого свойства nil, система использует строку «Назад» в качестве текста кнопки «Назад».

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – initWithTitle:
    UINavigationItem
    titleView

  • prompt Свойство

    Одна строка текста выведена на экран наверху панели навигации.

    Объявление

    Swift

    var prompt: String?

    Objective C

    @property(nonatomic, copy) NSString *prompt

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • backBarButtonItem Свойство

    Элемент кнопки панели для использования, когда кнопка «Назад» необходима на панели навигации.

    Объявление

    Swift

    var backBarButtonItem: UIBarButtonItem?

    Objective C

    @property(nonatomic, retain) UIBarButtonItem *backBarButtonItem

    Обсуждение

    Когда этот элемент навигации сразу ниже главного элемента в штабеле, контроллер навигации получает кнопку «Назад» для панели навигации от этого элемента навигации. Когда это свойство nil, элемент навигации использует значение в title свойство для создания надлежащей кнопки «Назад». Если Вы хотите указать пользовательское изображение или заголовок для кнопки «Назад», можно присвоить пользовательский элемент кнопки панели (с пользовательским заголовком или изображением) к этому свойству вместо этого. При конфигурировании элемента кнопки панели не присваивайте пользовательское представление ему; элемент навигации игнорирует пользовательские представления в задней кнопке панели так или иначе.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    backItem
    hidesBackButton
    – setHidesBackButton:animated:

  • hidesBackButton Свойство

    Булево значение, определяющее, скрыта ли кнопка «Назад».

    Объявление

    Swift

    var hidesBackButton: Bool

    Objective C

    @property(nonatomic, assign) BOOL hidesBackButton

    Обсуждение

    Когда установлено в YEStrue, когда этот элемент навигации является главным элементом, кнопка «Назад» скрыта. Это - истина независимо от значения в leftItemsSupplementBackButton свойство. Когда установлено в NOfalse, кнопка «Назад» показана, если она все еще присутствует. (Это может быть заменено значениями в любом leftBarButtonItem или leftBarButtonItems свойства.) Значение по умолчанию NOfalse.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    backItem
    backBarButtonItem
    – setHidesBackButton:animated:

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

    Наборы, скрыта ли кнопка «Назад», дополнительно анимируя переход.

    Объявление

    Swift

    func setHidesBackButton(_ hidesBackButton: Bool, animated animated: Bool)

    Objective C

    - (void)setHidesBackButton:(BOOL)hidesBackButton animated:(BOOL)animated

    Параметры

    hidesBackButton

    Указать YEStrue когда этот элемент навигации является главным элементом, если должна быть скрыта кнопка «Назад». Указать NOfalse если кнопка «Назад» должна быть видима, предположив, что она не была заменена пользовательским элементом.

    animated

    YEStrue анимировать переход; иначе, NOfalse.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    backItem
    backBarButtonItem
    hidesBackButton

  • leftItemsSupplementBackButton Свойство

    Булево значение, указывающее, выведены ли левые элементы на экран в дополнение к кнопке «Назад».

    Объявление

    Swift

    var leftItemsSupplementBackButton: Bool

    Objective C

    @property(nonatomic) BOOL leftItemsSupplementBackButton

    Обсуждение

    Обычно, присутствие пользовательских левых элементов кнопки панели заставляет кнопку «Назад» быть удаленной в пользу пользовательских элементов. Установка этого свойства к YEStrue вызывает элементы в leftBarButtonItems или leftBarButtonItem свойство, которое будет выведено на экран направо от кнопки «Назад» — т.е. они выведены на экран в дополнение к, а не вместо, кнопка «Назад». Когда установлено в NOfalse, элементы в тех свойствах выведены на экран вместо кнопки «Назад». Значение по умолчанию этого свойства NOfalse.

    Значение в hidesBackButton свойство все еще определяет, выведена ли кнопка «Назад» фактически на экран.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

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

    Объявление

    Swift

    var titleView: UIView?

    Objective C

    @property(nonatomic, retain) UIView *titleView

    Обсуждение

    Если это значение свойства nil, когда получатель является главным элементом, заголовок элемента навигации выведен на экран в центре панели навигации. При установке этого свойства в пользовательский заголовок оно выведено на экран вместо заголовка. Это свойство проигнорировано если leftBarButtonItem не nil.

    Пользовательские представления могут содержать кнопки. Используйте buttonWithType: метод в UIButton класс для добавления кнопок к пользовательскому представлению в стиле панели навигации. Пользовательские представления заголовка центрируются на панели навигации и могут быть изменены для адаптации.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • leftBarButtonItems Свойство

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

    Объявление

    Swift

    var leftBarButtonItems: [AnyObject]?

    Objective C

    @property(nonatomic, copy) NSArray *leftBarButtonItems

    Обсуждение

    Этот массив может содержать 0 или больше элементов панели для отображения на левой стороне панели навигации. Элементы могут включать пробелы фиксированной ширины и гибкой ширины. Если leftItemsSupplementBackButton свойство YEStrue, элементы выведены на экран направо от кнопки «Назад», иначе элементы заменяют кнопку «Назад» и запускаются в левом краю панели. Элементы выведены на экран слева направо в том же порядке, как они появляются в массиве.

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

    Первый элемент в массиве может также быть установлен с помощью leftBarButtonItem свойство.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • leftBarButtonItem Свойство

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

    Объявление

    Swift

    var leftBarButtonItem: UIBarButtonItem?

    Objective C

    @property(nonatomic, retain) UIBarButtonItem *leftBarButtonItem

    Обсуждение

    В iOS 5.0 и позже, содержание этого свойства всегда относится к первому элементу кнопки панели в leftBarButtonItems массив. Присвоение нового значения к этому свойству заменяет первый элемент в leftBarButtonItems массив с новым значением. Установка этого свойства к nil удаляет первый элемент в массиве. Если элемент кнопки панели уже находится в массиве, он перемещен от его текущего расположения до передней стороны массива.

    До iOS 5.0 это свойство содержало единственный элемент панели для отображения на левой стороне панели навигации вместо кнопки «Назад».

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    rightBarButtonItem
    – setLeftBarButtonItem:animated:
    – setRightBarButtonItem:animated:

  • rightBarButtonItems Свойство

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

    Объявление

    Swift

    var rightBarButtonItems: [AnyObject]?

    Objective C

    @property(nonatomic, copy) NSArray *rightBarButtonItems

    Обсуждение

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

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

    Первый элемент в массиве может также быть установлен с помощью rightBarButtonItem свойство.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • rightBarButtonItem Свойство

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

    Объявление

    Swift

    var rightBarButtonItem: UIBarButtonItem?

    Objective C

    @property(nonatomic, retain) UIBarButtonItem *rightBarButtonItem

    Обсуждение

    В iOS 5.0 и позже, содержание этого свойства всегда относится к первому элементу кнопки панели в rightBarButtonItems массив. Присвоение нового значения к этому свойству заменяет первый элемент в rightBarButtonItems массив с новым значением. Установка этого свойства к nil удаляет первый элемент в массиве. Если элемент кнопки панели уже находится в массиве, он перемещен от его текущего расположения до передней стороны массива.

    До iOS 5.0 это свойство содержало единственный элемент панели для отображения на правой стороне панели навигации.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    leftBarButtonItem
    – setLeftBarButtonItem:animated:
    – setRightBarButtonItem:animated:

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    items

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

    animated

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

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

    Объявление

    Swift

    func setLeftBarButtonItem(_ item: UIBarButtonItem?, animated animated: Bool)

    Objective C

    - (void)setLeftBarButtonItem:(UIBarButtonItem *)item animated:(BOOL)animated

    Параметры

    item

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

    animated

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    leftBarButtonItem
    rightBarButtonItem
    – setRightBarButtonItem:animated:

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    items

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

    animated

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

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

    Объявление

    Swift

    func setRightBarButtonItem(_ item: UIBarButtonItem?, animated animated: Bool)

    Objective C

    - (void)setRightBarButtonItem:(UIBarButtonItem *)item animated:(BOOL)animated

    Параметры

    item

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

    animated

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    leftBarButtonItem
    rightBarButtonItem
    – setLeftBarButtonItem:animated: