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

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

Разработчик

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

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

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

NSToolbarDelegate

NSToolbarDelegate протокол определяет дополнительные методы, реализованные делегатами NSToolbar объекты.

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


Не применимый

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


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


Swift

import AppKit

Objective C

@import AppKit;

Доступность


Доступный в OS X v10.6 и позже.
  • Отправленный для запроса нового элемента панели инструментов; возвращает элемент панели инструментов идентифицированного вида для указанной панели инструментов.

    Объявление

    Swift

    optional func toolbar(_ toolbar: NSToolbar, itemForItemIdentifier itemIdentifier: String, willBeInsertedIntoToolbar flag: Bool) -> NSToolbarItem?

    Objective C

    - (NSToolbarItem *)toolbar:(NSToolbar *)toolbar itemForItemIdentifier:(NSString *)itemIdentifier willBeInsertedIntoToolbar:(BOOL)flag

    Параметры

    toolbar

    Панель инструментов, на которую требуют элемент.

    itemIdentifier

    Идентификатор для требуемого элемента.

    flag

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

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

    Элемент панели инструментов для указанной панели инструментов и идентификатора. Возвратиться nil указать, что не поддерживается идентифицированный вид элемента панели инструментов. Когда элемент требуют снова, можно возвратить то же NSToolbarItem объект возвратился ранее или различный экземпляр.

    Обсуждение

    Реализуйте этот метод для создания новых экземпляров элемента панели инструментов. Этот метод вызывают лениво от имени экземпляра панели инструментов, который должен быть единственным владельцем элемента панели инструментов. Панель инструментов может попросить снова своего рода элемент панели инструментов, уже предоставленный ему, когда этот метод может возвратить тот же элемент панели инструментов, который это возвратило прежде или различное. Если Ваши службы делегата многократные панели инструментов, каждый присоединенный к различному окну, лучше возвращать различный элемент для каждой панели инструментов — NSToolbarItem объект может только быть на одной панели инструментов за один раз.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    Доступный как часть неофициального протокола до OS X v10.6.

  • Отправленный для обнаружения позволенных идентификаторов элемента для панели инструментов.

    Объявление

    Swift

    optional func toolbarAllowedItemIdentifiers(_ toolbar: NSToolbar) -> [AnyObject]

    Objective C

    - (NSArray *)toolbarAllowedItemIdentifiers:(NSToolbar *)toolbar

    Параметры

    toolbar

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

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

    Массив идентификаторов элемента панели инструментов для toolbar, указание содержания и порядка элементов в палитре конфигурации.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    Доступный как часть неофициального протокола до OS X v10.6.

  • Отправленный для обнаружения идентификаторов элемента по умолчанию для панели инструментов.

    Объявление

    Swift

    optional func toolbarDefaultItemIdentifiers(_ toolbar: NSToolbar) -> [AnyObject]

    Objective C

    - (NSArray *)toolbarDefaultItemIdentifiers:(NSToolbar *)toolbar

    Параметры

    toolbar

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

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

    Массив идентификаторов элемента панели инструментов для toolbar, указание содержания и порядка элементов в конфигурации панели инструментов по умолчанию.

    Обсуждение

    Во время инициализации toolbar, этот метод вызывают только если конфигурация панели инструментов для идентификатора toolbar не найден в пользовательских настройках. Этот метод вызывают во время инициализации палитры настройки панели инструментов.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    Доступный как часть неофициального протокола до OS X v10.6.

  • Отправленный для обнаружения выбираемых идентификаторов элемента для панели инструментов.

    Объявление

    Swift

    optional func toolbarSelectableItemIdentifiers(_ toolbar: NSToolbar) -> [AnyObject]

    Objective C

    - (NSArray *)toolbarSelectableItemIdentifiers:(NSToolbar *)toolbar

    Параметры

    toolbar

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

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

    Массив идентификаторов элемента, которые должны указать выбор в указанном toolbar.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    Доступный как часть неофициального протокола до OS X v10.6.

    См. также

    – setSelectedItemIdentifier: (NSToolbar)

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

    Объявление

    Swift

    optional func toolbarWillAddItem(_ notification: NSNotification)

    Objective C

    - (void)toolbarWillAddItem:(NSNotification *)notification

    Параметры

    notification

    Уведомление называют NSToolbarWillAddItemNotification.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    Доступный как часть неофициального протокола до OS X v10.6.

  • Отправленный сразу после того, как элемент был удален из панели инструментов.

    Объявление

    Swift

    optional func toolbarDidRemoveItem(_ notification: NSNotification)

    Objective C

    - (void)toolbarDidRemoveItem:(NSNotification *)notification

    Параметры

    notification

    Уведомление называют NSToolbarDidRemoveItemNotification.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    Доступный как часть неофициального протокола до OS X v10.6.