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

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

Разработчик

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

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

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

NSPopUpButton

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

NSPopUpButton возразите использует NSPopUpButtonCell возразите для реализации его пользовательского интерфейса.

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

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


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


Swift

import AppKit

Objective C

@import AppKit;

Доступность


Доступный в OS X v10.0 и позже.
  • Возвраты NSPopUpButton объект, инициализированный к указанным размерностям.

    Объявление

    Swift

    init(frame frameRect: NSRect, pullsDown flag: Bool)

    Objective C

    - (instancetype)initWithFrame:(NSRect)frameRect pullsDown:(BOOL)flag

    Параметры

    frameRect

    Прямоугольник кадра для кнопки, указанной в системе координат родительского представления.

    flag

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

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

    Инициализированный NSPopUpButton объект, или nil если не мог бы быть инициализирован объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    pullsDown

  • pullsDown pullsDown Свойство

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

    Объявление

    Swift

    var pullsDown: Bool

    Objective C

    @property BOOL pullsDown

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    var autoenablesItems: Bool

    Objective C

    @property BOOL autoenablesItems

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Добавляет элемент с указанным заголовком до конца меню.

    Объявление

    Swift

    func addItemWithTitle(_ title: String)

    Objective C

    - (void)addItemWithTitle:(NSString *)title

    Параметры

    title

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

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Добавляют многократные элементы до конца меню.

    Объявление

    Swift

    func addItemsWithTitles(_ itemTitles: [AnyObject])

    Objective C

    - (void)addItemsWithTitles:(NSArray *)itemTitles

    Параметры

    itemTitles

    Массив NSString объекты, содержащие заголовки элементов, Вы хотите добавить. Каждая строка в массиве должна быть уникальной. Если элемент с тем же заголовком уже существует в меню, существующий элемент удален, и новый добавляется.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Вставляет элемент в указанной позиции в меню.

    Объявление

    Swift

    func insertItemWithTitle(_ title: String, atIndex index: Int)

    Objective C

    - (void)insertItemWithTitle:(NSString *)title atIndex:(NSInteger)index

    Параметры

    title

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

    index

    Основанный на нуле индекс, в котором можно вставить элемент. Указание 0 вставляет элемент наверху меню.

    Обсуждение

    Если Вы хотите переместить элемент, лучше вызвать removeItemWithTitle: явно и затем отправьте этот метод. После добавления элемента этот метод использует synchronizeTitleAndSelectedItem метод для проверки элемента выводил на экран соответствия в настоящее время выбранный пункт.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Удаляет все элементы в меню элемента получателя.

    Объявление

    Swift

    func removeAllItems()

    Objective C

    - (void)removeAllItems

    Обсуждение

    После удаления элементов этот метод использует synchronizeTitleAndSelectedItem метод для обновления меню.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func removeItemWithTitle(_ title: String)

    Objective C

    - (void)removeItemWithTitle:(NSString *)title

    Параметры

    title

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Удаляет элемент в указанном индексе.

    Объявление

    Swift

    func removeItemAtIndex(_ index: Int)

    Objective C

    - (void)removeItemAtIndex:(NSInteger)index

    Параметры

    index

    Основанный на нуле индекс, указывающий, который элемент удалить. Указание 0 удаляет элемент наверху меню.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • selectedItem selectedItem Свойство

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

    Объявление

    Swift

    var selectedItem: NSMenuItem? { get }

    Objective C

    @property(readonly, strong) NSMenuItem *selectedItem

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    var titleOfSelectedItem: String? { get }

    Objective C

    @property(readonly, copy) NSString *titleOfSelectedItem

    Обсуждение

    Если никакой элемент не выбран, значение в этом свойстве nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    selectedItem

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

    Объявление

    Swift

    var indexOfSelectedItem: Int { get }

    Objective C

    @property(readonly) NSInteger indexOfSelectedItem

    Обсуждение

    Если никакой элемент не выбран, значение в этом свойстве -1.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает индекс выбранного пункта.

    Объявление

    Objective C

    - (id)objectValue

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

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

    См. также

    – setObjectValue:

  • selectedTag selectedTag Свойство

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

    Объявление

    Objective C

    @property(readonly) NSInteger selectedTag

    Обсуждение

    Теги являются целыми числами, которые Вы присваиваете элементам для идентификации их в коде. Теги не используются AppKit.

    Если никакой пункт меню не выбран, значение в этом свойстве -1.

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

    Objective C

    @import AppKit;

    Доступность

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

  • Выбирает указанный пункт меню.

    Объявление

    Swift

    func selectItem(_ anObject: NSMenuItem?)

    Objective C

    - (void)selectItem:(NSMenuItem *)anObject

    Параметры

    anObject

    Пункт меню для выбора, или nil если Вы хотите отменить выбор всех пунктов меню.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Выбирает элемент в меню в указанном индексе.

    Объявление

    Swift

    func selectItemAtIndex(_ index: Int)

    Objective C

    - (void)selectItemAtIndex:(NSInteger)index

    Параметры

    index

    Индекс элемента Вы хотите выбрать, или -1 Вы хотите отменить выбор всех пунктов меню.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    indexOfSelectedItem

  • Выбирает пункт меню с указанным тегом.

    Объявление

    Swift

    func selectItemWithTag(_ tag: Int) -> Bool

    Objective C

    - (BOOL)selectItemWithTag:(NSInteger)tag

    Параметры

    tag

    Тег элемента Вы хотите выбрать.

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

    YEStrue если был успешно выбран элемент; иначе, NOfalse.

    Обсуждение

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

    Вы обычно присваиваете теги пунктам меню от Интерфейсного Разработчика, но можно также присвоить их программно использование setTag: метод NSMenuItem.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – indexOfItemWithTag:

  • Выбирает элемент с указанным заголовком.

    Объявление

    Swift

    func selectItemWithTitle(_ title: String)

    Objective C

    - (void)selectItemWithTitle:(NSString *)title

    Параметры

    title

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Выбирает элемент в определенном индексе с помощью объектного значения.

    Объявление

    Objective C

    - (void)setObjectValue:(id)object

    Параметры

    object

    NSNumber объект, содержащий индекс (целое число) элемента, Вы хотите выбрать. Укажите индекс-1 для отмены выбора всех элементов. Можно также использовать объект кроме NSNumber объект. В этом случае объект должен ответить на intValue метод и возврат надлежащее индексное значение.

    Обсуждение

    См. также

    – objectValue

  • меню меню Свойство

    Меню связалось с кнопкой всплывающего меню.

    Объявление

    Swift

    var menu: NSMenu?

    Objective C

    @property(strong) NSMenu *menu

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • numberOfItems numberOfItems Свойство

    Число элементов в меню. (только для чтения)

    Объявление

    Swift

    var numberOfItems: Int { get }

    Objective C

    @property(readonly) NSInteger numberOfItems

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    меню
    lastItem

  • itemArray itemArray Свойство

    Массив объектов пункта меню связался с кнопкой. (только для чтения)

    Объявление

    Swift

    var itemArray: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *itemArray

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает пункт меню в указанном индексе.

    Объявление

    Swift

    func itemAtIndex(_ index: Int) -> NSMenuItem?

    Objective C

    - (NSMenuItem *)itemAtIndex:(NSInteger)index

    Параметры

    index

    Индекс элемента Вы хотите.

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

    Пункт меню, или nil если никакой элемент не существует в указанном индексе.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – itemWithTitle:
    lastItem

  • Возвращает заголовок элемента в указанном индексе.

    Объявление

    Swift

    func itemTitleAtIndex(_ index: Int) -> String

    Objective C

    - (NSString *)itemTitleAtIndex:(NSInteger)index

    Параметры

    index

    Индекс элемента Вы хотите.

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    itemTitles

  • itemTitles itemTitles Свойство

    Массив строк, соответствующих заголовкам элементов в меню. (только для чтения)

    Объявление

    Swift

    var itemTitles: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *itemTitles

    Обсуждение

    Это свойство содержит массив NSString объекты, каждый из которых содержит заголовок элемента в меню. Порядок заголовков в этом массиве соответствует порядок элементов в меню. Если меню содержит элементы разделителя, массив содержит пустую строку для каждого элемента разделителя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает пункт меню с указанным заголовком.

    Объявление

    Swift

    func itemWithTitle(_ title: String) -> NSMenuItem?

    Objective C

    - (NSMenuItem *)itemWithTitle:(NSString *)title

    Параметры

    title

    Заголовок пункта меню Вы хотите.

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

    Пункт меню, или nil если никакой элемент с указанным заголовком не существует в меню.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • lastItem lastItem Свойство

    Последний элемент в меню. (только для чтения)

    Объявление

    Swift

    var lastItem: NSMenuItem? { get }

    Objective C

    @property(readonly, strong) NSMenuItem *lastItem

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – itemAtIndex:

  • Возвращает индекс указанного пункта меню.

    Объявление

    Swift

    func indexOfItem(_ anObject: NSMenuItem) -> Int

    Objective C

    - (NSInteger)indexOfItem:(NSMenuItem *)anObject

    Параметры

    anObject

    Пункт меню, индекс которого Вы хотите.

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

    Индекс элемента или -1 если не был найден никакой такой элемент.

    Обсуждение

    Этот метод вызывает метод того же имени NSPopUpButtonCell объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает индекс пункта меню с указанным тегом.

    Объявление

    Swift

    func indexOfItemWithTag(_ tag: Int) -> Int

    Objective C

    - (NSInteger)indexOfItemWithTag:(NSInteger)tag

    Параметры

    tag

    Тег пункта меню Вы хотите.

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

    Индекс элемента или -1 если не был найден никакой элемент с указанным тегом.

    Обсуждение

    Этот метод вызывает метод того же имени NSPopUpButtonCell объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает индекс элемента с указанным заголовком.

    Объявление

    Swift

    func indexOfItemWithTitle(_ title: String) -> Int

    Objective C

    - (NSInteger)indexOfItemWithTitle:(NSString *)title

    Параметры

    title

    Заголовок элемента Вы хотите.

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

    Индекс элемента или -1 если не был найден никакой элемент с указанным заголовком.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func indexOfItemWithRepresentedObject(_ anObject: AnyObject?) -> Int

    Objective C

    - (NSInteger)indexOfItemWithRepresentedObject:(id)anObject

    Параметры

    anObject

    Представленный объект связался с пунктом меню.

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

    Индекс пункта меню, которому принадлежит указанный объект, или -1 если не был найден никакой такой пункт меню.

    Обсуждение

    Представленные объекты переносят некоторое прямое отношение к заголовку или изображению пункта меню; например, элемент назвал «100», мог бы иметь NSNumber объект, инкапсулирующий то значение как его представленный объект. Этот метод вызывает метод того же имени NSPopUpButtonCell объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает индекс пункта меню с указанной целью и действием.

    Объявление

    Swift

    func indexOfItemWithTarget(_ target: AnyObject?, andAction actionSelector: Selector) -> Int

    Objective C

    - (NSInteger)indexOfItemWithTarget:(id)target andAction:(SEL)actionSelector

    Параметры

    target

    Целевой объект связался с пунктом меню.

    actionSelector

    Метод действия связался с пунктом меню.

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

    Индекс пункта меню, или -1 если никакой пункт меню не содержит указанную цель и действие.

    Обсуждение

    Если Вы указываете NULL для actionSelector параметр, индекс первого пункта меню с указанной целью возвращается. Этот метод вызывает метод того же имени NSPopUpButtonCell объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • preferredEdge preferredEdge Свойство

    Край кнопки, на которой можно вывести на экран меню, когда ограничивается экранное пространство.

    Объявление

    Swift

    var preferredEdge: NSRectEdge

    Objective C

    @property NSRectEdge preferredEdge

    Обсуждение

    Возможные значения включают NSMinXEdge, NSMinYEdge, NSMaxXEdge, или NSMaxYEdge. Для выпадающих меню поведение по умолчанию состоит в том, чтобы расположить меню под кнопкой. Базовый край соответствует значению NSMaxYEdge для зеркально отраженных представлений или NSMinYEdge для незеркально отраженных представлений. Для большинства всплывающих меню, NSPopUpButton возразите пытается показать выбранный пункт непосредственно по кнопке.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func setTitle(_ aString: String)

    Objective C

    - (void)setTitle:(NSString *)aString

    Параметры

    aString

    Строка для отображения.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Этот метод не имеет никакого эффекта.

    Объявление

    Objective C

    - (void)setImage:(NSImage *)anImage

    Параметры

    anImage

    Изображение для отображения.

    Обсуждение

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

  • Гарантирует, что элемент, выводимый на экран получателем, соглашается с выбранным пунктом.

    Объявление

    Swift

    func synchronizeTitleAndSelectedItem()

    Objective C

    - (void)synchronizeTitleAndSelectedItem

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    itemArray
    indexOfSelectedItem

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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