NSToolbarDelegate

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

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

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

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

NSObjectProtocol
NSObject

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Конфигурирование панели инструментов


    
    панель инструментов (_: itemForItemIdentifier:willBeInsertedIntoToolbar:)
    - toolbar:itemForItemIdentifier:willBeInsertedIntoToolbar:

Отправленный для запроса нового элемента панели инструментов; возвращает элемент панели инструментов идентифицированного вида для указанной панели инструментов.

Объявление

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.


    
    toolbarAllowedItemIdentifiers (_:)
    - toolbarAllowedItemIdentifiers:

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

Объявление

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.


    
    toolbarDefaultItemIdentifiers (_:)
    - toolbarDefaultItemIdentifiers:

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

Объявление

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.


    
    toolbarSelectableItemIdentifiers (_:)
    - toolbarSelectableItemIdentifiers:

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

Объявление

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)

Ответ на дополнения и удаления на панели инструментов

toolbarWillAddItem (_:) - toolbarWillAddItem:

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

Объявление

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.
toolbarDidRemoveItem (_:) - toolbarDidRemoveItem:

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

Объявление

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.