NSComboBoxDataSource

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

Для получения дополнительной информации посмотрите, что Поле комбинированного списка Программирует Темы.

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

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

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

NSObjectProtocol
NSObject

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Заполнение полей комбинированного списка


    
    поле комбинированного списка (_: objectValueForItemAtIndex:)
    - comboBox:objectValueForItemAtIndex:

Возвращает объект, соответствующий элементу в указанном индексе в поле комбинированного списка.

Объявление

Swift

optional func comboBox(_ aComboBox: NSComboBox, objectValueForItemAtIndex index: Int) -> AnyObject

Objective C

- (id)comboBox:(NSComboBox *)aComboBox objectValueForItemAtIndex:(NSInteger)index

Параметры

`aComboBox`	Поле комбинированного списка.
`index`	Индекс элемента для возврата.

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

Объект, соответствующий указанному индексу.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

numberOfItemsInComboBox (_:) - numberOfItemsInComboBox:

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

Объявление

Swift

optional func numberOfItemsInComboBox(_ aComboBox: NSComboBox) -> Int

Objective C

- (NSInteger)numberOfItemsInComboBox:(NSComboBox *)aComboBox

Параметры

aComboBox

Поле комбинированного списка.

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

Число элементов, которыми объект источника данных управляет для указанного поля комбинированного списка.

Обсуждение

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

Важный

В то время как этот метод отмечен как @optional если Вы не предоставляете данные для поля комбинированного списка с помощью привязки Какао, в протоколе необходимо реализовать этот метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Строковое завершение


    
    поле комбинированного списка (_: completedString:)
    - comboBox:completedString:

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

Объявление

Swift

optional func comboBox(_ aComboBox: NSComboBox, completedString uncompletedString: String) -> String?

Objective C

- (NSString *)comboBox:(NSComboBox *)aComboBox completedString:(NSString *)uncompletedString

Параметры

`aComboBox`	Поле комбинированного списка.
`uncompletedString`	Строка для соответствия против элементов в раскрывающемся списке поля комбинированного списка. Это - текст, который ввел пользователь.

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

Первая полная строка от элементов в раскрывающемся списке поля комбинированного списка, запускающемся со строки в uncompletedString.

Обсуждение

NSComboBox возразите использует этот метод для выполнения инкрементный — или «умный» — поиски, когда пользователь вводит в текстовое поле. Поскольку пользователь вводит в текстовом поле, получатель использует этот метод для поиска элементов из раскрывающегося списка, запускающихся с того, что ввел пользователь. Получатель добавляет новый текст до конца поля и выбирает новый текст, поэтому когда пользователь вводит другой символ, это заменяет новый текст.

Этот метод является дополнительным. Если Вы не реализуете его, получатель не выполняет инкрементные поиски.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    поле комбинированного списка (_: indexOfItemWithStringValue:)
    - comboBox:indexOfItemWithStringValue:

Возвращает индекс элемента поля комбинированного списка, соответствующего указанную строку.

Объявление

Swift

optional func comboBox(_ aComboBox: NSComboBox, indexOfItemWithStringValue aString: String) -> Int

Objective C

- (NSUInteger)comboBox:(NSComboBox *)aComboBox indexOfItemWithStringValue:(NSString *)aString

Параметры

`aComboBox`	Поле комбинированного списка.
`aString`	Строка для соответствия против элементов в поле комбинированного списка. Если источник данных реализует`comboBox:completedString:`, это - строка, возвращенная тем методом. Иначе, это - текст, который ввел пользователь.

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

Индекс для элемента, соответствующего указанную строку, или NSNotFound если не соответствует никакой элемент.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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