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

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

Разработчик

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

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

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

NSComboBox

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

Обычно экземпляр NSComboBox похож на это:

image: Art/combobox.gif is missing from your submission.

При щелчке по указывающей вниз стрелке по правой стороне текстового поля раскрывающийся список появляется, как это:

image: Art/comboboxlist.gif is missing from your submission.

NSComboBox использование класса NSComboBoxCell реализовать его пользовательский интерфейс.

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

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

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

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

    Объявление

    Swift

    var hasVerticalScroller: Bool

    Objective C

    @property BOOL hasVerticalScroller

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    numberOfItems
    numberOfVisibleItems
    – scrollItemAtIndexToTop:
    – scrollItemAtIndexToVisible:

  • 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

  • buttonBordered buttonBordered Свойство

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

    Объявление

    Swift

    var buttonBordered: Bool

    Objective C

    @property(getter=isButtonBordered) BOOL buttonBordered

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • 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
    – setItemHeight:
    intercellSpacing
    hasVerticalScroller

Установка источника данных
  • источник данных источник данных Свойство

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

    Объявление

    Swift

    unowned(unsafe) var dataSource: NSComboBoxDataSource?

    Objective C

    @property(assign) id< NSComboBoxDataSource > dataSource

    Обсуждение

    Присвоение объекта к этому свойству автоматически не устанавливает usesDataSource свойство к YEStrue. Если usesDataSource свойство NOfalse, доступ к этому свойству регистрирует предупреждение. Значение по умолчанию этого свойства nil.

    Для получения информации о том, как реализовать источник данных поля комбинированного списка, посмотрите Ссылку на протокол NSComboBoxDataSource.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    usesDataSource

  • usesDataSource usesDataSource Свойство

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

    Объявление

    Swift

    var usesDataSource: Bool

    Objective C

    @property BOOL usesDataSource

    Обсуждение

    Когда значение этого свойства YEStrue, поле комбинированного списка получает свои элементы от объекта в dataSource свойство. Когда значение 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
    – numberOfItemsInComboBox: (NSComboBoxDataSource протокол)

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

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

    Объявление

    Swift

    func indexOfItemWithObjectValue(_ anObject: AnyObject) -> Int

    Objective C

    - (NSInteger)indexOfItemWithObjectValue:(id)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

    Обсуждение

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

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

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

    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
    – comboBox:objectValueForItemAtIndex: (Протокол NSComboBoxDataSource)

  • 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 к центру уведомления по умолчанию, если действительно фактически изменяется выбор. Обратите внимание на то, что этот метод не изменяется, содержание текстового поля поля комбинированного списка — видит Установку Значения Поля комбинированного списка для получения дополнительной информации.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setObjectValue: (NSControl)

Завершение текстового поля
  • завершается завершается Свойство

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

    Объявление

    Swift

    var completes: Bool

    Objective C

    @property BOOL completes

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Доступ к делегату
  • делегат () - делегат

    Возвращает делегата получателя.

    Объявление

    Swift

    func delegate() -> NSComboBoxDelegate?

    Objective C

    - (id<NSComboBoxDelegate>)delegate

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

    Делегат получателя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setDelegate:

  • setDelegate (_:) - setDelegate:

    Устанавливает делегата получателя.

    Объявление

    Swift

    func setDelegate(_ anObject: NSComboBoxDelegate?)

    Objective C

    - (void)setDelegate:(id<NSComboBoxDelegate>)anObject

    Параметры

    anObject

    Делегат к получателю. Делегат должен соответствовать NSComboBoxDelegate Protocol протокол.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – делегат

Уведомления
  • NSComboBoxSelectionDidChangeNotification NSComboBoxSelectionDidChangeNotification

    Отправленный после раскрывающегося выбора списка NSComboBox изменения.

    Объект уведомления NSComboBox чей выбор изменился. Это уведомление не содержит a userInfo словарь.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • NSComboBoxSelectionIsChangingNotification NSComboBoxSelectionIsChangingNotification

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

    Объект уведомления NSComboBox чей выбор изменяется. Это уведомление не содержит a userInfo словарь.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • NSComboBoxWillDismissNotification NSComboBoxWillDismissNotification

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

    Объект уведомления NSComboBox чей раскрывающийся список будет отклонен. Это уведомление не содержит a userInfo словарь.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • NSComboBoxWillPopUpNotification NSComboBoxWillPopUpNotification

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

    Объект уведомления NSComboBox чье всплывающее окно будет выведено на экран. Это уведомление не содержит a userInfo словарь.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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