NSTokenFieldDelegate
NSTokenFieldDelegate
протокол определяет дополнительные методы, реализованные делегатами NSTokenField
объекты.
Наследование
Не применимый
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.6 и позже.
-
Позволяет делегату обеспечивать строку, которая будет выведена на экран как прокси для данного представленного объекта.
Объявление
Swift
optional func tokenField(_
tokenField
: NSTokenField, displayStringForRepresentedObjectrepresentedObject
: AnyObject) -> String?Objective C
- (NSString *)tokenField:(NSTokenField *)
tokenField
displayStringForRepresentedObject:(id)representedObject
Параметры
tokenField
Маркерное поле, отправившее сообщение.
representedObject
Представленный объект маркерного поля.
Возвращаемое значение
Строка, которая будет использоваться в качестве прокси для
representedObject
. Если Вы возвращаетесьnil
или не реализуйте этот метод, тогдаrepresentedObject
выведен на экран как строка.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
Доступный как часть неофициального протокола до OS X v10.6.
-
Позволяет делегату возвращать маркерный стиль для редактирования указанного представленного объекта.
Объявление
Swift
optional func tokenField(_
tokenField
: NSTokenField, styleForRepresentedObjectrepresentedObject
: AnyObject) -> NSTokenStyleObjective C
- (NSTokenStyle)tokenField:(NSTokenField *)
tokenField
styleForRepresentedObject:(id)representedObject
Параметры
tokenField
Маркерное поле, отправившее сообщение.
representedObject
Представленный объект маркерного поля.
Возвращаемое значение
Стиль, который должен использоваться для отображения representedObject. Возможные значения показаны в
NSTokenStyle Values
.Обсуждение
Если делегат реализует этот метод и возвращается
NSTokenStyle
это отличается от стиля, установленногоsetTokenStyle:
, значение, которое возвращает делегат, предпочтено.Если делегат не реализует этот метод, маркерное поле
tokenStyle
используется.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
Доступный как часть неофициального протокола до OS X v10.6.
-
tokenField (_: completionsForSubstring:indexOfToken:indexOfSelectedItem:) - tokenField:completionsForSubstring:indexOfToken:indexOfSelectedItem:
Позволяет делегату обеспечивать массив надлежащих завершений для содержания получателя.
Объявление
Swift
optional func tokenField(_
tokenField
: NSTokenField, completionsForSubstringsubstring
: String, indexOfTokentokenIndex
: Int, indexOfSelectedItemselectedIndex
: UnsafeMutablePointer<Int>) -> [AnyObject]?Objective C
- (NSArray *)tokenField:(NSTokenField *)
tokenField
completionsForSubstring:(NSString *)substring
indexOfToken:(NSInteger)tokenIndex
indexOfSelectedItem:(NSInteger *)selectedIndex
Параметры
tokenField
Маркерное поле, где происходит редактирование.
substring
Частичная строка, которая должна быть завершена.
tokenIndex
Индекс отредактированного маркера.
selectedIndex
Дополнительно, можно возвратить ссылкой индекс в возвращенный массив, указывающий, какое из завершений должно быть первоначально выбрано. Если ни один не должен быть выбран, возвратитесь ссылкой
-1
.Возвращаемое значение
Массив строк, которые являются возможными завершениями.
Обсуждение
Если делегат не реализует этот метод, никакие завершения не предоставлены.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
Доступный как часть неофициального протокола до OS X v10.6.
-
Позволяет делегату обеспечивать строку, которая будет отредактирована как прокси для представленного объекта.
Объявление
Swift
optional func tokenField(_
tokenField
: NSTokenField, editingStringForRepresentedObjectrepresentedObject
: AnyObject) -> String?Objective C
- (NSString *)tokenField:(NSTokenField *)
tokenField
editingStringForRepresentedObject:(id)representedObject
Параметры
tokenField
Маркерное поле, отправившее сообщение.
representedObject
Представленный объект маркерного поля.
Возвращаемое значение
Строка это - доступный для редактирования прокси представленного объекта, или
nil
если маркер не должен быть доступным для редактирования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
Доступный как часть неофициального протокола до OS X v10.6.
-
Позволяет делегату обеспечивать представленный объект для данного редактирования строки.
Объявление
Swift
optional func tokenField(_
tokenField
: NSTokenField, representedObjectForEditingStringeditingString
: String) -> AnyObjectObjective C
- (id)tokenField:(NSTokenField *)
tokenField
representedObjectForEditingString:(NSString *)editingString
Параметры
tokenField
Маркерное поле, отправившее сообщение.
editingString
Отредактированное строковое представление представленного объекта.
Возвращаемое значение
Представленный объект, выведенный на экран, а не строка редактирования.
Обсуждение
Если Ваше приложение использует некоторый объект кроме
NSString
для их представленных объектов необходимо возвратить новый, автовыпущенный экземпляр того объекта от этого метода.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
Доступный как часть неофициального протокола до OS X v10.6.
-
Позволяет делегату проверять маркеры, которые будут добавлены к получателю в определенном расположении.
Объявление
Swift
optional func tokenField(_
tokenField
: NSTokenField, shouldAddObjectstokens
: [AnyObject], atIndexindex
: Int) -> [AnyObject]Objective C
- (NSArray *)tokenField:(NSTokenField *)
tokenField
shouldAddObjects:(NSArray *)tokens
atIndex:(NSUInteger)index
Параметры
tokenField
Маркерное поле, отправившее сообщение.
tokens
Массив маркеров, которые будут вставлены в получатель в
index
.index
Индекс тот, получателя, в который массив маркеров, которые будут проверены (
tokens
) будет вставлен.Возвращаемое значение
Массив проверенных маркеров.
Обсуждение
Делегат может возвратить неизменный массив или возвратить измененный массив маркеров. Для отклонения добавления полностью возвратите пустой массив. Возврат
nil
вызывает ошибку.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
Доступный как часть неофициального протокола до OS X v10.6.
-
Позволяет делегату возвращать массив объектов, представляющих данные, считанные из указанной области монтажа.
Объявление
Swift
optional func tokenField(_
tokenField
: NSTokenField, readFromPasteboardpboard
: NSPasteboard) -> [AnyObject]?Objective C
- (NSArray *)tokenField:(NSTokenField *)
tokenField
readFromPasteboard:(NSPasteboard *)pboard
Параметры
tokenField
Маркерное поле, отправившее сообщение.
pboard
Область монтажа, из которой можно считать представленные объекты.
Возвращаемое значение
Массив представленных объектов создается из данных области монтажа.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
Доступный как часть неофициального протокола до OS X v10.6.
-
tokenField (_: writeRepresentedObjects:toPasteboard:) - tokenField:writeRepresentedObjects:toPasteboard:
Отправленный, таким образом, делегат может записать представленные объекты в область монтажа, соответствующую данному массиву строк дисплея.
Объявление
Swift
optional func tokenField(_
tokenField
: NSTokenField, writeRepresentedObjectsobjects
: [AnyObject], toPasteboardpboard
: NSPasteboard) -> BoolObjective C
- (BOOL)tokenField:(NSTokenField *)
tokenField
writeRepresentedObjects:(NSArray *)objects
toPasteboard:(NSPasteboard *)pboard
Параметры
tokenField
Маркерное поле, отправившее сообщение.
objects
Массив представленных объектов связался с маркерным полем.
pboard
Область монтажа, в которую можно записать представленные объекты.
Возвращаемое значение
YES
true
если делегат пишет представленные объекты в область монтажа,NO
false
иначе. ЕслиNO
false
, маркерное поле пишет строки дисплея вNSStringPboardType
область монтажа.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
Доступный как часть неофициального протокола до OS X v10.6.
См. также
-
Позволяет делегату указывать, обеспечивает ли данный представленный объект меню.
Объявление
Swift
optional func tokenField(_
tokenField
: NSTokenField, hasMenuForRepresentedObjectrepresentedObject
: AnyObject) -> BoolObjective C
- (BOOL)tokenField:(NSTokenField *)
tokenField
hasMenuForRepresentedObject:(id)representedObject
Параметры
tokenField
Маркерное поле, отправившее сообщение.
representedObject
Представленный объект маркерного поля.
Возвращаемое значение
YES
true
если представленный объект имеет меню,NO
false
иначе.Обсуждение
Маркерами по умолчанию в маркерном поле не имеют никаких меню.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
Доступный как часть неофициального протокола до OS X v10.6.
См. также
-
Позволяет делегату обеспечивать меню для указанного представленного объекта.
Объявление
Swift
optional func tokenField(_
tokenField
: NSTokenField, menuForRepresentedObjectrepresentedObject
: AnyObject) -> NSMenu?Objective C
- (NSMenu *)tokenField:(NSTokenField *)
tokenField
menuForRepresentedObject:(id)representedObject
Параметры
tokenField
Маркерное поле, отправившее сообщение.
representedObject
Представленный объект маркерного поля.
Возвращаемое значение
Меню связалось с представленным объектом.
Обсуждение
Возвращенное меню должно быть автовыпущено. Маркерами по умолчанию в маркерном поле не возвращают меню.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
Доступный как часть неофициального протокола до OS X v10.6.