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

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

Разработчик

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

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

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

NSComboBoxCell

NSComboBoxCell подкласс NSTextFieldCell используемый для реализации пользовательского интерфейса «полей комбинированного списка» (см. NSComboBox для получения информации, на как взгляд полей комбинированного списка и работа). NSComboBox подкласс NSTextField использует сингл NSComboBoxCell, и по существу весь из NSComboBox методы класса просто вызывают соответствие NSComboBoxCell метод.

Также посмотрите NSComboBoxCellDataSource Protocol протокол, объявляющий методы что NSComboBoxCell возразите использованию для доступа к содержанию его объекта источника данных.

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Установка атрибутов дисплея
  • hasVerticalScroller hasVerticalScroller Свойство

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

    Объявление

    Swift

    var hasVerticalScroller: Bool

    Objective C

    @property BOOL hasVerticalScroller

    Обсуждение

    Когда значение этого свойства YEStrue, поле комбинированного списка выводит на экран вертикальный скроллер; когда значение NOfalse, это не делает. Значение по умолчанию этого свойства YEStrue. Обратите внимание на то, что скроллер выведен на экран, даже если раскрывающийся список содержит меньше элементов, чем поместится в область, указанную для дисплея.

    Если Вы устанавливаете это свойство в NOfalse и ячейка поля комбинированного списка имеет больше элементов списка (или в его внутреннем списке элемента или от его источника данных), чем позволяют numberOfVisibleItems, только подмножество выведено на экран. NSComboBoxCell scroll... методы могут использоваться для расположения этого подмножества в раскрывающемся списке.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    numberOfItems
    numberOfVisibleItems
    – scrollItemAtIndexToTop:
    – scrollItemAtIndexToVisible:

  • buttonBordered buttonBordered Свойство

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

    Объявление

    Swift

    var buttonBordered: Bool

    Objective C

    @property(getter=isButtonBordered) BOOL buttonBordered

    Обсуждение

    Когда значение этого свойства YEStrue, кнопка имеет границу; когда это NOfalse, кнопка является безграничной. Например, это часто полезно при использовании поля комбинированного списка в NSTableView вывести на экран кнопку без границы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • intercellSpacing intercellSpacing Свойство

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

    Объявление

    Swift

    var intercellSpacing: NSSize

    Objective C

    @property NSSize intercellSpacing

    Обсуждение

    Значение этого свойства является пространством по горизонтали и пространством по вертикали между ячейками в раскрывающемся списке поля комбинированного списка. Интервал по умолчанию (3.0, 2.0).

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    itemHeight
    numberOfVisibleItems

  • itemHeight itemHeight Свойство

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

    Объявление

    Swift

    var itemHeight: CGFloat

    Objective C

    @property CGFloat itemHeight

    Обсуждение

    Высота элемента по умолчанию 16.0.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    intercellSpacing
    numberOfVisibleItems

  • numberOfVisibleItems numberOfVisibleItems Свойство

    Максимальное количество элементов, видимых в раскрывающемся списке в любой момент.

    Объявление

    Swift

    var numberOfVisibleItems: Int

    Objective C

    @property NSInteger numberOfVisibleItems

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    numberOfItems
    intercellSpacing
    itemHeight

Доступ к источнику данных
  • источник данных источник данных Свойство

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

    Объявление

    Swift

    unowned(unsafe) var dataSource: NSComboBoxCellDataSource?

    Objective C

    @property(assign) id< NSComboBoxCellDataSource > dataSource

    Обсуждение

    Значение этого свойства должно быть объектом, реализующим надлежащие методы NSComboBoxCellDataSource неофициальный протокол. Обратите внимание на то, что установка этого свойства автоматически не устанавливает usesDataSource к NOfalse и фактически регистрирует предупреждение если usesDataSource NOfalse. Если Вы устанавливаете это свойство в объект, не реагирующий также numberOfItemsInComboBoxCell: или comboBoxCell:objectValueForItemAtIndex:, предупреждение регистрируется если usesDataSource NOfalse. См. описание класса и NSComboBoxCellDataSource неофициальная спецификация протокола для получения дополнительной информации об объектах источника данных ячейки поля комбинированного списка.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • usesDataSource usesDataSource Свойство

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

    Объявление

    Swift

    var usesDataSource: Bool

    Objective C

    @property BOOL usesDataSource

    Обсуждение

    Когда значение этого свойства YEStrue, поле комбинированного списка использует внешний источник данных для заполнения его раскрывающегося списка; когда это NOfalse, поле комбинированного списка использует внутренний список элемента.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    источник данных

Работа с внутренним списком
  • addItemsWithObjectValues (_:) - addItemsWithObjectValues:

    Добавляют многократные объекты к внутреннему списку элемента.

    Объявление

    Swift

    func addItemsWithObjectValues(_ objects: [AnyObject])

    Objective C

    - (void)addItemsWithObjectValues:(NSArray *)objects

    Параметры

    objects

    Объект добавить до конца внутреннего списка элемента поля комбинированного списка.

    Обсуждение

    Этот метод регистрирует предупреждение если usesDataSource YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • addItemWithObjectValue (_:) - addItemWithObjectValue:

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

    Объявление

    Swift

    func addItemWithObjectValue(_ anObject: AnyObject)

    Objective C

    - (void)addItemWithObjectValue:(id)anObject

    Параметры

    anObject

    Объект добавить до конца внутреннего списка элемента поля комбинированного списка.

    Обсуждение

    Этот метод регистрирует предупреждение если usesDataSource YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • insertItemWithObjectValue (_: atIndex:) - insertItemWithObjectValue:atIndex:

    Вставляет объект в указанном расположении во внутреннем списке элемента.

    Объявление

    Swift

    func insertItemWithObjectValue(_ anObject: AnyObject, atIndex index: Int)

    Objective C

    - (void)insertItemWithObjectValue:(id)anObject atIndex:(NSInteger)index

    Параметры

    anObject

    Объект добавить к внутреннему списку элемента поля комбинированного списка.

    index

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

    Обсуждение

    Этот метод регистрирует предупреждение если usesDataSource YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – addItemWithObjectValue:
    numberOfItems

  • objectValues objectValues Свойство

    Внутренний элемент поля комбинированного списка перечисляет в массиве. (только для чтения)

    Объявление

    Swift

    var objectValues: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *objectValues

    Обсуждение

    Доступ к этому свойству регистрирует предупреждение если usesDataSource YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • removeAllItems () - removeAllItems

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

    Объявление

    Swift

    func removeAllItems()

    Objective C

    - (void)removeAllItems

    Обсуждение

    Этот метод регистрирует предупреждение если usesDataSource YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    objectValues

  • removeItemAtIndex (_:) - removeItemAtIndex:

    Удаляет объект в указанном расположении из внутреннего списка элемента поля комбинированного списка.

    Объявление

    Swift

    func removeItemAtIndex(_ index: Int)

    Objective C

    - (void)removeItemAtIndex:(NSInteger)index

    Параметры

    index

    Индекс объекта удалить из внутреннего списка элемента поля комбинированного списка. Все элементы вне index повышены один слот для устранения разрыва.

    Обсуждение

    Удаленный объект получает a release сообщение. Этот метод повышает NSRangeException если index вне конца списка и регистрирует предупреждение если usesDataSource YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • removeItemWithObjectValue (_:) - removeItemWithObjectValue:

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

    Объявление

    Swift

    func removeItemWithObjectValue(_ anObject: AnyObject)

    Objective C

    - (void)removeItemWithObjectValue:(id)anObject

    Параметры

    anObject

    Объект удалить из внутреннего списка элемента поля комбинированного списка. Объекты считают равными, если у них есть тот же ID или если isEqual: возвраты YEStrue.

    Обсуждение

    Этот метод регистрирует предупреждение если usesDataSource YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – indexOfItemWithObjectValue:

  • numberOfItems numberOfItems Свойство

    Общее количество элементов в раскрывающемся списке. (только для чтения)

    Объявление

    Swift

    var numberOfItems: Int { get }

    Objective C

    @property(readonly) NSInteger numberOfItems

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    numberOfVisibleItems
    – numberOfItemsInComboBoxCell: (Протокол NSComboBoxCellDataSource)

Управление выведенным на экран списком
  • indexOfItemWithObjectValue (_:) - indexOfItemWithObjectValue:

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

    Объявление

    Swift

    func indexOfItemWithObjectValue(_ anObject: AnyObject) -> Int

    Objective C

    - (NSInteger)indexOfItemWithObjectValue:(id)anObject

    Параметры

    anObject

    Объект, для которого можно возвратить индекс.

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

    Самый низкий индекс, соответствующее значение которого равно anObject. Объекты считают равными, если у них есть тот же ID или если isEqual: возвраты YEStrue. Если ни один из объектов во внутреннем списке элемента поля комбинированного списка не равен anObject, indexOfItemWithObjectValue: возвраты NSNotFound.

    Обсуждение

    Этот метод регистрирует предупреждение если usesDataSource YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – selectItemWithObjectValue:

  • itemObjectValueAtIndex (_:) - itemObjectValueAtIndex:

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

    Объявление

    Swift

    func itemObjectValueAtIndex(_ index: Int) -> AnyObject

    Objective C

    - (id)itemObjectValueAtIndex:(NSInteger)index

    Параметры

    index

    Индекс объекта возвратиться. Если index вне конца списка, NSRangeException повышен.

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

    Объект в данном расположении во внутреннем списке элемента поля комбинированного списка.

    Обсуждение

    Этот метод регистрирует предупреждение если usesDataSource YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    objectValueOfSelectedItem

  • noteNumberOfItemsChanged () - noteNumberOfItemsChanged

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

    Объявление

    Swift

    func noteNumberOfItemsChanged()

    Objective C

    - (void)noteNumberOfItemsChanged

    Обсуждение

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

    Посмотрите NSComboBoxCellDataSource неофициальная спецификация протокола для получения информации о сообщениях NSComboBoxCell отправляет к его источнику данных.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – reloadData

  • reloadData () - reloadData

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

    Объявление

    Swift

    func reloadData()

    Objective C

    - (void)reloadData

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – noteNumberOfItemsChanged

  • scrollItemAtIndexToTop (_:) - scrollItemAtIndexToTop:

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

    Объявление

    Swift

    func scrollItemAtIndexToTop(_ index: Int)

    Objective C

    - (void)scrollItemAtIndexToTop:(NSInteger)index

    Параметры

    index

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • scrollItemAtIndexToVisible (_:) - scrollItemAtIndexToVisible:

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

    Объявление

    Swift

    func scrollItemAtIndexToVisible(_ index: Int)

    Objective C

    - (void)scrollItemAtIndexToVisible:(NSInteger)index

    Параметры

    index

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Управление выбором
  • deselectItemAtIndex (_:) - deselectItemAtIndex:

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

    Объявление

    Swift

    func deselectItemAtIndex(_ index: Int)

    Objective C

    - (void)deselectItemAtIndex:(NSInteger)index

    Параметры

    index

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    indexOfSelectedItem
    numberOfItems
    – selectItemAtIndex:

  • indexOfSelectedItem indexOfSelectedItem Свойство

    Индекс последнего элемента, выбранного из раскрывающегося списка. (только для чтения)

    Объявление

    Swift

    var indexOfSelectedItem: Int { get }

    Objective C

    @property(readonly) NSInteger indexOfSelectedItem

    Обсуждение

    Если никакой элемент не выбран, индекс последнего элемента выбрал из раскрывающегося списка поля комбинированного списка или –1. Обратите внимание на то, что ничто первоначально не выбрано в недавно инициализированной ячейке поля комбинированного списка.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    objectValueOfSelectedItem

  • objectValueOfSelectedItem objectValueOfSelectedItem Свойство

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

    Объявление

    Swift

    var objectValueOfSelectedItem: AnyObject? { get }

    Objective C

    @property(readonly, strong) id objectValueOfSelectedItem

    Обсуждение

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

    Обратите внимание на то, что ничто первоначально не выбрано в недавно инициализированной ячейке поля комбинированного списка. Доступ к этому свойству регистрирует предупреждение если usesDataSource YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    indexOfSelectedItem
    – comboBoxCell:objectValueForItemAtIndex: (NSComboBoxCellDataSource протокол)

  • selectItemAtIndex (_:) - selectItemAtIndex:

    Выбирает раскрывающуюся строку списка в данном индексе.

    Объявление

    Swift

    func selectItemAtIndex(_ index: Int)

    Objective C

    - (void)selectItemAtIndex:(NSInteger)index

    Параметры

    index

    Индекс строки для выбора.

    Обсуждение

    Сообщения NSComboBoxSelectionDidChangeNotification к центру уведомления по умолчанию, если действительно фактически изменяется выбор. Обратите внимание на то, что этот метод не изменяется, содержание текстового поля ячейки поля комбинированного списка — видит, что Поле комбинированного списка Программирует Темы для получения дополнительной информации.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setObjectValue: (NSControl)

  • selectItemWithObjectValue (_:) - selectItemWithObjectValue:

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

    Объявление

    Swift

    func selectItemWithObjectValue(_ anObject: AnyObject?)

    Objective C

    - (void)selectItemWithObjectValue:(id)anObject

    Параметры

    anObject

    Объект, для которого можно выбрать соответствующий раскрывающийся элемент списка. Объекты считают равными, если у них есть тот же ID или если isEqual: возвраты YEStrue.

    Обсуждение

    Этот метод регистрирует предупреждение если usesDataSource YEStrue. Сообщения NSComboBoxSelectionDidChangeNotification к центру уведомления по умолчанию, если действительно фактически изменяется выбор. Обратите внимание на то, что этот метод не изменяется, содержание текстового поля ячейки поля комбинированного списка — видит Установку Комбинации Box⠀™ s Значение для получения дополнительной информации.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setObjectValue: (NSControl)

Завершение текстового поля
  • completedString (_:) - completedString:

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

    Объявление

    Swift

    func completedString(_ substring: String) -> String?

    Objective C

    - (NSString *)completedString:(NSString *)substring

    Параметры

    substring

    Подстрока для поиска. Это - то, что пользователь ввел в текстовое поле поля комбинированного списка.

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

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

    Обсуждение

    Реализация по умолчанию этого метода сначала проверяет, использует ли поле комбинированного списка источник данных и отвечает ли источник данных на comboBox:completedString: или comboBoxCell:completedString:. Если так, возвраты ячейки поля комбинированного списка, что возвращаемое значение метода. Иначе, этот метод проходит через элементы поля комбинированного списка один за другим и возвращает элемент, запускающийся с substring.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • завершается завершается Свойство

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

    Объявление

    Swift

    var completes: Bool

    Objective C

    @property BOOL completes

    Обсуждение

    Когда значение этого свойства YEStrue, поле комбинированного списка пытается завершить то, что пользователь вводит в текстовом поле и каждый раз, когда пользователь добавляет символы до конца текстового поля, вызовов поля комбинированного списка completedString:; когда это NOfalse, это не делает.

    Если completedString: возвращает строку, это более длинно, чем существующая строка, поле комбинированного списка заменяет существующую строку возвращаемой строкой и выбирает дополнительные символы. Если пользователь удаляет символы или добавляет символы где-нибудь помимо конца строки, поле комбинированного списка не пытается завершить его.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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