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

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

Разработчик

Ссылка платформы AppKit ссылка класса NSToolbar

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

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

NSToolbar

NSToolbar и NSToolbarItem обеспечьте механизм для названного окна для отображения панели инструментов чуть ниже ее строки заголовка, как показано ниже:

image: Art/toolbar.jpg is missing from your submission.

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.

Создание объекта NSToolbar
  • init (идентификатор:) - initWithIdentifier: Определяемый инициализатор

    Инициализирует недавно выделенную панель инструментов с указанным идентификатором.

    Объявление

    Swift

    init(identifier identifier: String)

    Objective C

    - (instancetype)initWithIdentifier:(NSString *)identifier

    Параметры

    identifier

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

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

    Инициализированный объект панели инструментов.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – идентификатор

Атрибуты панели инструментов
  • displayMode - displayMode

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

    Объявление

    Swift

    var displayMode: NSToolbarDisplayMode

    Objective C

    @property NSToolbarDisplayMode displayMode

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

    Режим отображения получателя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setDisplayMode:

  • setDisplayMode: - setDisplayMode:

    Устанавливает режим отображения получателя.

    Объявление

    Swift

    var displayMode: NSToolbarDisplayMode

    Objective C

    @property NSToolbarDisplayMode displayMode

    Параметры

    displayMode

    Новый режим отображения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – displayMode

  • showsBaselineSeparator - showsBaselineSeparator

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

    Объявление

    Swift

    var showsBaselineSeparator: Bool

    Objective C

    @property BOOL showsBaselineSeparator

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    – setShowsBaselineSeparator:

  • setShowsBaselineSeparator: - setShowsBaselineSeparator:

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

    Объявление

    Swift

    var showsBaselineSeparator: Bool

    Objective C

    @property BOOL showsBaselineSeparator

    Параметры

    flag

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    – showsBaselineSeparator

  • allowsUserCustomization - allowsUserCustomization

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

    Объявление

    Swift

    var allowsUserCustomization: Bool

    Objective C

    @property BOOL allowsUserCustomization

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

    YEStrue если пользователям разрешают изменить панель инструментов, NOfalse иначе. Значение по умолчанию NOfalse.

    Обсуждение

    Если значение NOfalse, тогда Настроить Панель инструментов … пункт меню отключена, и другая модификация отключена. Этот атрибут не влияет на возможность пользователя показать или скрыть панель инструментов.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setAllowsUserCustomization:
    – autosavesConfiguration

  • setAllowsUserCustomization: - setAllowsUserCustomization:

    Наборы, разрешают ли пользователям изменить панель инструментов.

    Объявление

    Swift

    var allowsUserCustomization: Bool

    Objective C

    @property BOOL allowsUserCustomization

    Параметры

    allowsCustomization

    YEStrue позволить пользователям изменять панель инструментов, NOfalse иначе.

    Обсуждение

    В любое время может быть изменено это значение. Например, Вы не можете хотеть, чтобы пользователи были в состоянии настроить панель инструментов, в то время как обрабатывается некоторое событие. Этот атрибут не влияет на возможность пользователя показать или скрыть панель инструментов.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – allowsUserCustomization
    – setAutosavesConfiguration:

  • идентификатор - идентификатор

    Возвращает идентификатор получателя.

    Объявление

    Swift

    var identifier: String { get }

    Objective C

    @property(readonly, copy) NSString *identifier

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

    Идентификатор получателя, строка, используемая классом для идентификации вида панели инструментов.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    setAutosavesConfiguration:

  • элементы - элементы

    Возвращает текущие элементы получателя, в порядке.

    Объявление

    Swift

    var items: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *items

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

    Массив элементов на панели инструментов.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – visibleItems

  • visibleItems - visibleItems

    Возвращает в настоящее время видимые элементы получателя.

    Объявление

    Swift

    var visibleItems: [AnyObject]? { get }

    Objective C

    @property(readonly, copy) NSArray *visibleItems

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

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

    Обсуждение

    Элементы в меню переполнения не считают видимыми.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – элементы

  • sizeMode - sizeMode

    Возвращает режим размера получателя.

    Объявление

    Swift

    var sizeMode: NSToolbarSizeMode

    Objective C

    @property NSToolbarSizeMode sizeMode

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

    Режим размера получателя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.2 и позже.

    См. также

    – setSizeMode:

  • setSizeMode: - setSizeMode:

    Устанавливает режим размера получателя.

    Объявление

    Swift

    var sizeMode: NSToolbarSizeMode

    Objective C

    @property NSToolbarSizeMode sizeMode

    Параметры

    sizeMode

    Новый режим размера.

    Обсуждение

    Если нет никакого значка данного размера для элемента панели инструментов, элемент панели инструментов создает один путем масштабирования значка другого размера.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.2 и позже.

    См. также

    – sizeMode

Получение и установка делегата
  • делегат - делегат

    Возвращает делегата получателя.

    Объявление

    Swift

    unowned(unsafe) var delegate: NSToolbarDelegate?

    Objective C

    @property(assign) id<NSToolbarDelegate> delegate

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

    Делегат получателя.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setDelegate:

  • setDelegate: - setDelegate:

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

    Объявление

    Swift

    unowned(unsafe) var delegate: NSToolbarDelegate?

    Objective C

    @property(assign) id<NSToolbarDelegate> delegate

    Параметры

    delegate

    Новый объект делегата.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – делегат

Управление элементами на панели инструментов
  • insertItemWithItemIdentifier (_: atIndex:) - insertItemWithItemIdentifier:atIndex:

    Вставляет указанный элемент в указанном индексе.

    Объявление

    Swift

    func insertItemWithItemIdentifier(_ itemIdentifier: String, atIndex index: Int)

    Objective C

    - (void)insertItemWithItemIdentifier:(NSString *)itemIdentifier atIndex:(NSInteger)index

    Параметры

    itemIdentifier

    Идентификатор элемента для вставки.

    index

    Индекс, в котором можно вставить элемент.

    Обсуждение

    Если панели инструментов будет нужен новый экземпляр, то это получит его от toolbar:itemForItemIdentifier:willBeInsertedIntoToolbar:. Как правило, Вы не должны вызывать этот метод; необходимо позволить пользователю реконфигурировать панель инструментов. Посмотрите identifier для важной информации.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – removeItemAtIndex:

  • removeItemAtIndex (_:) - removeItemAtIndex:

    Удаляет указанный элемент.

    Объявление

    Swift

    func removeItemAtIndex(_ index: Int)

    Objective C

    - (void)removeItemAtIndex:(NSInteger)index

    Параметры

    index

    Индекс элемента для удаления.

    Обсуждение

    Как правило, Вы не должны вызывать этот метод; необходимо позволить пользователю реконфигурировать панель инструментов. Посмотрите identifier для важной информации.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – insertItemWithItemIdentifier:atIndex:

  • setSelectedItemIdentifier: - setSelectedItemIdentifier:

    Устанавливает выбранный пункт получателя в указанный элемент панели инструментов.

    Объявление

    Swift

    var selectedItemIdentifier: String?

    Objective C

    @property(copy) NSString *selectedItemIdentifier

    Параметры

    itemIdentifier

    Идентификатор элемента для выбора. itemIdentifier может быть любой идентификатор, возвращенный toolbarSelectableItemIdentifiers:, даже если это в настоящее время не находится на панели инструментов.

    Обсуждение

    Как правило, панель инструментов будет управлять выбором элементов автоматически. Этот метод может использоваться, чтобы выбрать идентификаторы пользовательских элементов представления или вызвать изменение выбора. Посмотрите toolbarSelectableItemIdentifiers: для большего количества подробных данных. Если itemIdentifier не распознан получателем, текущий идентификатор выбранного пункта не изменяется.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.3 и позже.

    См. также

    – selectedItemIdentifier
    toolbarSelectableItemIdentifiers: (NSToolbarDelegate)

  • selectedItemIdentifier - selectedItemIdentifier

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

    Объявление

    Swift

    var selectedItemIdentifier: String?

    Objective C

    @property(copy) NSString *selectedItemIdentifier

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

    Идентификатор получателя в настоящее время выбранный пункт, или nil если нет никакого выбора.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.3 и позже.

    См. также

    – setSelectedItemIdentifier:

Отображение панели инструментов
  • isVisible - isVisible Доступный в OS X v10.0 через OS X v10.9

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

    Объявление

    Objective C

    - (BOOL)isVisible

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

    YEStrue если получатель видим, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

    См. также

    – setVisible:

  • setVisible: - setVisible:

    Наборы, является ли получатель видимым или скрытым.

    Объявление

    Swift

    var visible: Bool

    Objective C

    @property(getter=isVisible) BOOL visible

    Параметры

    shown

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – isVisible

Настройка панели инструментов
  • runCustomizationPalette (_:) - runCustomizationPalette:

    Выполняет палитру настройки получателя.

    Объявление

    Swift

    func runCustomizationPalette(_ sender: AnyObject?)

    Objective C

    - (void)runCustomizationPalette:(id)sender

    Параметры

    sender

    Управление, отправляющее сообщение.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – customizationPaletteIsRunning

  • customizationPaletteIsRunning - customizationPaletteIsRunning

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

    Объявление

    Swift

    var customizationPaletteIsRunning: Bool { get }

    Objective C

    @property(readonly) BOOL customizationPaletteIsRunning

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

    YEStrue если палитра настройки получателя работает, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – runCustomizationPalette:

Полноэкранный аксессуар просматривает настройки

Автоматическое сохранение конфигурации
  • autosavesConfiguration - autosavesConfiguration

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

    Объявление

    Swift

    var autosavesConfiguration: Bool

    Objective C

    @property BOOL autosavesConfiguration

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

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setAutosavesConfiguration:
    – configurationDictionary

  • setAutosavesConfiguration: - setAutosavesConfiguration:

    Наборы, сохраняет ли получатель свою конфигурацию автоматически.

    Объявление

    Swift

    var autosavesConfiguration: Bool

    Objective C

    @property BOOL autosavesConfiguration

    Параметры

    flag

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – allowsUserCustomization
    – autosavesConfiguration

  • configurationDictionary - configurationDictionary

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

    Объявление

    Swift

    var configurationDictionary: [NSObject : AnyObject] { get }

    Objective C

    @property(readonly, copy) NSDictionary *configurationDictionary

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

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

    Обсуждение

    Содержит displayMode, isVisible, и список идентификаторов элемента в настоящее время на панели инструментов.

    Специальные замечания

    Не зависьте ни от каких подробных данных нормального содержания словаря конфигурации.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setConfigurationFromDictionary:

  • setConfigurationFromDictionary (_:) - setConfigurationFromDictionary:

    Устанавливает использование конфигурации получателя configDict.

    Объявление

    Swift

    func setConfigurationFromDictionary(_ configDict: [NSObject : AnyObject])

    Objective C

    - (void)setConfigurationFromDictionary:(NSDictionary *)configDict

    Параметры

    configDict

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

    Обсуждение

    Этот метод сразу влияет на панели инструментов с тем же идентификатором во всех окнах Вашего приложения.

    Специальные замечания

    Не зависьте ни от каких подробных данных нормального содержания словаря конфигурации.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – configurationDictionary

Проверка видимых элементов
  • validateVisibleItems () - validateVisibleItems

    Обращенный окно обновляет для проверки видимых элементов.

    Объявление

    Swift

    func validateVisibleItems()

    Objective C

    - (void)validateVisibleItems

    Обсуждение

    Вы обычно используете этот метод путем переопределения его в подклассе. Реализация по умолчанию этого метода выполняет итерации через список видимых элементов, отправляя каждый a validate сообщение. Переопределите его и вызов super когда этот метод вызывают, если Вы хотите знать.

    В OS X v 10.6 и более поздних панелях инструментов больше автоматически проверяют для некоторых событий, включая: NSLeftMouseDragged, NSRightMouseDragged, NSOtherMouseDragged, NSMouseEntered, NSMouseExited, NSScrollWheel, NSCursorUpdate, NSKeyDown. Кроме того, проверка для NSKeyUp и NSFlagsChanged события задерживаются с перезапуском таймера для каждого нового допускающего задержку события. Таким образом, последовательность ключевых событий не инициирует проверки вообще, или до паузы.85 секунд или до события кроме NSKeyUp или NSFlagsChanged обрабатывается. Это изменение было внесено как оптимизация.

    Для инициирования проверки для единственной панели инструментов вручную отправьте панель инструментов a validateVisibleItems сообщение. Для инициирования проверки для всех панелей инструментов вызовите NSApplication’s setWindowsNeedUpdate: передача YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

Константы
  • NSToolbarDisplayMode

    Эти константы указывают режимы отображения панели инструментов и используются displayMode и setDisplayMode:.

    Объявление

    Swift

    enum NSToolbarDisplayMode : UInt { case Default case IconAndLabel case IconOnly case LabelOnly }

    Objective C

    enum { NSToolbarDisplayModeDefault, NSToolbarDisplayModeIconAndLabel, NSToolbarDisplayModeIconOnly, NSToolbarDisplayModeLabelOnly }; typedef NSUInteger NSToolbarDisplayMode;

    Константы

    • Default

      NSToolbarDisplayModeDefault

      Режим отображения по умолчанию.

      Доступный в OS X v10.0 и позже.

    • IconAndLabel

      NSToolbarDisplayModeIconAndLabel

      Панель инструментов выведет на экран значки и метки.

      Доступный в OS X v10.0 и позже.

    • IconOnly

      NSToolbarDisplayModeIconOnly

      Панель инструментов выведет на экран только значки.

      Доступный в OS X v10.0 и позже.

    • LabelOnly

      NSToolbarDisplayModeLabelOnly

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

      Доступный в OS X v10.0 и позже.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

  • NSToolbarSizeMode

    Эти константы указывают режимы отображения панели инструментов и используются sizeMode и setSizeMode:.

    Объявление

    Swift

    enum NSToolbarSizeMode : UInt { case Default case Regular case Small }

    Objective C

    enum { NSToolbarSizeModeDefault, NSToolbarSizeModeRegular, NSToolbarSizeModeSmall }; typedef NSUInteger NSToolbarSizeMode;

    Константы

    • Default

      NSToolbarSizeModeDefault

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

      Доступный в OS X v10.2 и позже.

    • Regular

      NSToolbarSizeModeRegular

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

      Доступный в OS X v10.2 и позже.

    • Small

      NSToolbarSizeModeSmall

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

      Доступный в OS X v10.2 и позже.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.2 и позже.

Уведомления
  • NSToolbarDidRemoveItemNotification NSToolbarDidRemoveItemNotification

    Отправленный после того, как элемент удален из панели инструментов. Элемент уведомления NSToolbar возразите, что удалили элемент из него. userInfo словарь содержит следующую информацию:

    Ключ

    Значение

    @"item"

    NSToolbarItem удаленный объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

  • NSToolbarWillAddItemNotification NSToolbarWillAddItemNotification

    Отправленный, прежде чем новый элемент добавляется к панели инструментов. Элемент уведомления NSToolbar объект, добавляющий элемент к нему. userInfo словарь содержит следующую информацию:

    Ключ

    Значение

    @"item"

    NSToolbarItem добавляемый объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.