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

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

Разработчик

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

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

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

NSPopUpButtonCell

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

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

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

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Инициализация
  • init (textCell:pullsDown:) - initTextCell:pullsDown:

    Возвраты NSPopUpButtonCell объект инициализируется с указанным заголовком.

    Объявление

    Swift

    init(textCell stringValue: String, pullsDown pullDown: Bool)

    Objective C

    - (instancetype)initTextCell:(NSString *)stringValue pullsDown:(BOOL)pullDown

    Параметры

    stringValue

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

    pullDown

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

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

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

    Обсуждение

    Этот пункт меню присваивается действие кнопки всплывающего меню по умолчанию, выводящее на экран меню. Для установки действия и цели используйте setAction: и setTarget: методы соответствия элемента NSMenuItem объект.

    Этот метод является определяемым инициализатором класса.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setAction: (NSMenuItem)
    – setTarget: (NSMenuItem)

Доступ к атрибутам меню
  • меню меню Свойство

    Связанное меню кнопки всплывающего меню.

    Объявление

    Swift

    var menu: NSMenu?

    Objective C

    @property(strong) NSMenu *menu

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • pullsDown pullsDown Свойство

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

    Объявление

    Swift

    var pullsDown: Bool

    Objective C

    @property BOOL pullsDown

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – synchronizeTitleAndSelectedItem

  • autoenablesItems autoenablesItems Свойство

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

    Объявление

    Swift

    var autoenablesItems: Bool

    Objective C

    @property BOOL autoenablesItems

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • preferredEdge preferredEdge Свойство

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

    Объявление

    Swift

    var preferredEdge: NSRectEdge

    Objective C

    @property NSRectEdge preferredEdge

    Обсуждение

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

    Точное расположение стрелки определяется путем исследования значения этого свойства и arrowPosition.

    • Если позиция стрелки NSPopUpArrowAtCenter, стрелка остается в центре кнопки, и значение этого свойства определяет, которые ограничивают точки стрелки к: NSMinXEdge точки налево, NSMaxYEdge точки к вершине, NSMaxXEdge точки вправо, и NSMinYEdge точки к нижней части.

    • Если позиция стрелки NSPopUpArrowAtBottom, значение этого свойства определяет, какой край, в который размещается стрелка: NSMinXEdge размещает стрелку в центре левой стороны, указывая налево, NSMinYEdge размещает стрелку в основе правый угол, подчеркивание, NSMaxXEdge размещает стрелку в центре правой стороны, указывая вправо, и NSMaxYEdge размещает стрелку в правом нижнем углу, указывая вниз.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • usesItemFromMenu usesItemFromMenu Свойство

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

    Объявление

    Swift

    var usesItemFromMenu: Bool

    Objective C

    @property BOOL usesItemFromMenu

    Обсуждение

    Когда значение этого свойства YEStrue, выпадающее меню использует заголовок первого пункта меню, и всплывающее меню использует заголовок в настоящее время выбираемого меню (если никакой пункт меню не выбран, кнопка всплывающего меню не выводит на экран элемента и нарисована пустая). Когда значение NOfalse, набор пункта меню с setMenuItem: (NSMenuItem) всегда выводится на экран. Значение по умолчанию YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • altersStateOfSelectedItem altersStateOfSelectedItem Свойство

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

    Объявление

    Swift

    var altersStateOfSelectedItem: Bool

    Objective C

    @property BOOL altersStateOfSelectedItem

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – selectItemAtIndex:
    – selectItemWithTitle:
    selectedItem
    – selectItem:
    – setState: (NSMenuItem)

  • arrowPosition arrowPosition Свойство

    Позиция стрелки выведена на экран на кнопке.

    Объявление

    Swift

    var arrowPosition: NSPopUpArrowPosition

    Objective C

    @property NSPopUpArrowPosition arrowPosition

    Обсуждение

    Когда значение этого свойства NSPopUpNoArrow, управление не выводит на экран стрелки. NSPopUpArrowAtCenter выводит на экран стрелку, центрируемую горизонтально в ячейке и NSPopUpArrowAtBottom выводит на экран стрелку в краю ячейки. Это свойство используется с preferredEdge определить точное расположение и ориентацию стрелки.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Добавление и удаление элементов
  • addItemWithTitle (_:) - addItemWithTitle:

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

    Объявление

    Swift

    func addItemWithTitle(_ title: String)

    Objective C

    - (void)addItemWithTitle:(NSString *)title

    Параметры

    title

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

    Обсуждение

    Пункт меню использует действие и цель кнопки всплывающего меню по умолчанию, но можно изменить их с помощью setAction: и setTarget: методы соответствия NSMenuItem объект.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – addItemsWithTitles:
    – setAction: (NSMenuItem)
    – setTarget: (NSMenuItem)

  • addItemsWithTitles (_:) - addItemsWithTitles:

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

    Объявление

    Swift

    func addItemsWithTitles(_ itemTitles: [AnyObject])

    Objective C

    - (void)addItemsWithTitles:(NSArray *)itemTitles

    Параметры

    itemTitles

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

    Обсуждение

    Новые пункты меню используют действие и цель кнопки всплывающего меню по умолчанию, но можно изменить их с помощью setAction: и setTarget: методы соответствия NSMenuItem объект.

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – addItemWithTitle:
    – setAction: (NSMenuItem)
    – setTarget: (NSMenuItem)

  • insertItemWithTitle (_: atIndex:) - insertItemWithTitle:atIndex:

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    title

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

    index

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

    Обсуждение

    Значение в index должен представлять допустимую позицию в массиве. Пункт меню в index и все те, которые следуют за ним, смещаются вниз один слот для создания места для нового пункта меню.

    Этот метод присваивает действие кнопки всплывающего меню по умолчанию и цель к новому пункту меню. Используйте пункт меню setAction: и setTarget: методы для присвоения нового действия и цели.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    insertObject:atIndex: (NSMutableArray)
    – setAction: (NSMenuItem)
    – setTarget: (NSMenuItem)

  • removeItemWithTitle (_:) - removeItemWithTitle:

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

    Объявление

    Swift

    func removeItemWithTitle(_ title: String)

    Objective C

    - (void)removeItemWithTitle:(NSString *)title

    Параметры

    title

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – removeAllItems
    – removeItemAtIndex:
    – insertItemWithTitle:atIndex:

  • removeItemAtIndex (_:) - removeItemAtIndex:

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

    Объявление

    Swift

    func removeItemAtIndex(_ index: Int)

    Objective C

    - (void)removeItemAtIndex:(NSInteger)index

    Параметры

    index

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – removeAllItems
    – removeItemWithTitle:
    – insertItemWithTitle:atIndex:

  • removeAllItems () - removeAllItems

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

    Объявление

    Swift

    func removeAllItems()

    Objective C

    - (void)removeAllItems

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – removeItemAtIndex:
    – removeItemWithTitle:
    – insertItemWithTitle:atIndex:

Доступ к элементам
  • itemArray itemArray Свойство

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

    Объявление

    Swift

    var itemArray: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *itemArray

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – itemArray (NSMenu)

  • numberOfItems numberOfItems Свойство

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

    Объявление

    Swift

    var numberOfItems: Int { get }

    Objective C

    @property(readonly) NSInteger numberOfItems

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    count (NSArray)

  • indexOfItem (_:) - indexOfItem:

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

    Объявление

    Swift

    func indexOfItem(_ item: NSMenuItem) -> Int

    Objective C

    - (NSInteger)indexOfItem:(NSMenuItem *)item

    Параметры

    item

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

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – indexOfItemWithRepresentedObject:
    – indexOfItemWithTag:
    – indexOfItemWithTarget:andAction:
    – indexOfItemWithTitle:
    indexOfSelectedItem

  • indexOfItemWithTitle (_:) - indexOfItemWithTitle:

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

    Объявление

    Swift

    func indexOfItemWithTitle(_ title: String) -> Int

    Objective C

    - (NSInteger)indexOfItemWithTitle:(NSString *)title

    Параметры

    title

    Заголовок элемента Вы хотите. Вы не должны передавать nil для этого параметра.

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – indexOfItem:
    – indexOfItemWithRepresentedObject:
    – indexOfItemWithTag:
    – indexOfItemWithTarget:andAction:
    – indexOfItemWithTitle:
    indexOfSelectedItem

  • indexOfItemWithTag (_:) - indexOfItemWithTag:

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

    Объявление

    Swift

    func indexOfItemWithTag(_ tag: Int) -> Int

    Objective C

    - (NSInteger)indexOfItemWithTag:(NSInteger)tag

    Параметры

    tag

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

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

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

    Обсуждение

    Теги являются значениями, которые Ваше приложение присваивает объекту идентифицировать его. Можно присвоить теги пунктам меню с помощью setTag: метод NSMenuItem.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – indexOfItem:
    – indexOfItemWithRepresentedObject:
    – indexOfItemWithTarget:andAction:
    – indexOfItemWithTitle:
    indexOfSelectedItem
    – setTag: (NSMenuItem)

  • indexOfItemWithRepresentedObject (_:) - indexOfItemWithRepresentedObject:

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

    Объявление

    Swift

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

    Objective C

    - (NSInteger)indexOfItemWithRepresentedObject:(id)obj

    Параметры

    obj

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

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – indexOfItem:
    – indexOfItemWithTag:
    – indexOfItemWithTarget:andAction:
    – indexOfItemWithTitle:
    indexOfSelectedItem
    – representedObject (NSMenuItem)
    – setRepresentedObject: (NSMenuItem)

  • indexOfItemWithTarget (_: andAction:) - indexOfItemWithTarget:andAction:

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    target

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

    actionSelector

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

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

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

    Обсуждение

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

    NSPopUpButtonCell класс присваивает действие по умолчанию и цель к каждому пункту меню, но можно изменить эти значения с помощью setAction: и setTarget: методы NSMenuItem.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – indexOfItem:
    – indexOfItemWithRepresentedObject:
    – indexOfItemWithTag:
    – indexOfItemWithTarget:andAction:
    – indexOfItemWithTitle:
    indexOfSelectedItem
    – setAction: (NSMenuItem)
    – setTarget: (NSMenuItem)

  • itemAtIndex (_:) - itemAtIndex:

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

    Объявление

    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 и позже.

    См. также

    – itemTitleAtIndex:
    – itemAtIndex: (NSMenu)

  • itemWithTitle (_:) - itemWithTitle:

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

    Объявление

    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 и позже.

    См. также

    – itemTitleAtIndex:
    – itemAtIndex:

  • 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 и позже.

  • setObjectValue: - setObjectValue: Доступный в OS X v10.3 через OS X v10.9

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

    Объявление

    Objective C

    - (void)setObjectValue:(id)object

    Параметры

    object

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

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

    Objective C

    @import AppKit;

    Доступность

    Доступный в OS X v10.3 через OS X v10.9.

    См. также

    – objectValue

  • objectValue - objectValue Доступный в OS X v10.3 через OS X v10.9

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

    Объявление

    Objective C

    - (id)objectValue

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

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

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

    Objective C

    @import AppKit;

    Доступность

    Доступный в OS X v10.3 через OS X v10.9.

    См. также

    – setObjectValue:

Контакт с выбором
  • selectItem (_:) - selectItem:

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

    Объявление

    Swift

    func selectItem(_ item: NSMenuItem?)

    Objective C

    - (void)selectItem:(NSMenuItem *)item

    Параметры

    item

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

    Обсуждение

    По умолчанию выбор или отмена выбора пункта меню от всплывающего меню изменяют свое состояние. Выбор пункта меню из выпадающего меню автоматически не изменяет состояние элемента. Для разъединения текущего выбора с состоянием пунктов меню установите altersStateOfSelectedItem свойство к NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    selectedItem
    – selectItemAtIndex:
    – selectItemWithTitle:
    altersStateOfSelectedItem
    – setState: (NSMenuItem)

  • selectItemAtIndex (_:) - selectItemAtIndex:

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

    Объявление

    Swift

    func selectItemAtIndex(_ index: Int)

    Objective C

    - (void)selectItemAtIndex:(NSInteger)index

    Параметры

    index

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

    Обсуждение

    По умолчанию выбор или отмена выбора пункта меню от всплывающего меню изменяют свое состояние. Выбор пункта меню из выпадающего меню автоматически не изменяет состояние элемента. Для разъединения текущего выбора с состоянием пунктов меню установите altersStateOfSelectedItem свойство к NOfalse.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    selectedItem
    – selectItem:
    – selectItemWithTitle:
    altersStateOfSelectedItem
    – setState: (NSMenuItem)

  • selectItemWithTag (_:) - selectItemWithTag:

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

    Объявление

    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 и позже.

  • selectItemWithTitle (_:) - selectItemWithTitle:

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

    Объявление

    Swift

    func selectItemWithTitle(_ title: String)

    Objective C

    - (void)selectItemWithTitle:(NSString *)title

    Параметры

    title

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

    Обсуждение

    По умолчанию выбор или отмена выбора пункта меню изменяют свое состояние. Для разъединения текущего выбора с состоянием пунктов меню установите altersStateOfSelectedItem свойство к NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    selectedItem
    – selectItem:
    – selectItemAtIndex:
    altersStateOfSelectedItem
    – setState: (NSMenuItem)

  • setTitle (_:) - setTitle:

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

    Объявление

    Swift

    func setTitle(_ aString: String)

    Objective C

    - (void)setTitle:(NSString *)aString

    Параметры

    aString

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – initTextCell:pullsDown:

  • 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 и позже.

    См. также

    – selectItem:
    – selectItemAtIndex:
    – selectItemWithTitle:

  • 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 и позже.

    См. также

    – indexOfItem:
    – indexOfItemWithRepresentedObject:
    – indexOfItemWithTag:
    – indexOfItemWithTarget:andAction:
    – indexOfItemWithTitle:

  • synchronizeTitleAndSelectedItem () - synchronizeTitleAndSelectedItem

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

    Объявление

    Swift

    func synchronizeTitleAndSelectedItem()

    Objective C

    - (void)synchronizeTitleAndSelectedItem

    Обсуждение

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

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Удобства заголовка
  • itemTitleAtIndex (_:) - itemTitleAtIndex:

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

    Объявление

    Swift

    func itemTitleAtIndex(_ index: Int) -> String

    Objective C

    - (NSString *)itemTitleAtIndex:(NSInteger)index

    Параметры

    index

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

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – itemAtIndex:

  • itemTitles itemTitles Свойство

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

    Объявление

    Swift

    var itemTitles: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *itemTitles

    Обсуждение

    Заголовки появляются в порядке, в котором элементы появляются в меню. Если меню содержит элементы разделителя, массив содержит пустую строку (@"") для каждого элемента разделителя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – itemTitleAtIndex:

  • titleOfSelectedItem titleOfSelectedItem Свойство

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

    Объявление

    Swift

    var titleOfSelectedItem: String? { get }

    Objective C

    @property(readonly, copy) NSString *titleOfSelectedItem

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – selectItemWithTitle:

Установка изображения
  • setImage: - setImage:

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

    Объявление

    Objective C

    - (void)setImage:(NSImage *)anImage

    Параметры

    anImage

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

    Обсуждение

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

Обработка событий и сообщений действия
  • attachPopUpWithFrame (_: inView:) - attachPopUpWithFrame:inView:

    Устанавливает получатель для отображения меню.

    Объявление

    Swift

    func attachPopUpWithFrame(_ cellFrame: NSRect, inView controlView: NSView)

    Objective C

    - (void)attachPopUpWithFrame:(NSRect)cellFrame inView:(NSView *)controlView

    Параметры

    cellFrame

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

    controlView

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

    Обсуждение

    Этот вызов устанавливает ячейку кнопки всплывающего меню для отображения меню, происходящего в performClickWithFrame:inView:. Этот метод устанавливает представление управления ячейки и затем выделяет и перерисовывает ячейку. Это не показывает меню.

    Этот метод также отправляет NSPopUpButtonCellWillPopUpNotification. ( NSPopUpButton объект отправляет соответствие NSPopUpButtonWillPopUpNotification.)

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – dismissPopUp

  • dismissPopUp () - dismissPopUp

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

    Объявление

    Swift

    func dismissPopUp()

    Objective C

    - (void)dismissPopUp

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – attachPopUpWithFrame:inView:
    – orderOut: (NSWindow)

  • performClickWithFrame (_: inView:) - performClickWithFrame:inView:

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

    Объявление

    Swift

    func performClickWithFrame(_ frame: NSRect, inView controlView: NSView)

    Objective C

    - (void)performClickWithFrame:(NSRect)frame inView:(NSView *)controlView

    Параметры

    frame

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

    controlView

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – attachPopUpWithFrame:inView:

Типы данных

  • NSPopUpArrowPosition NSPopUpArrowPosition

    Эти константы определяются для использования с arrowPosition свойство.

    Объявление

    Swift

    enum NSPopUpArrowPosition : UInt { case NoArrow case ArrowAtCenter case ArrowAtBottom }

    Objective C

    typedef enum { NSPopUpNoArrow = 0, NSPopUpArrowAtCenter = 1, NSPopUpArrowAtBottom = 2 } NSPopUpArrowPosition;

    Константы

    • NoArrow

      NSPopUpNoArrow

      Не выводит на экран стрелки в управлении.

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

    • ArrowAtCenter

      NSPopUpArrowAtCenter

      Стрелка центрируется вертикально, указывая на preferredEdge.

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

    • ArrowAtBottom

      NSPopUpArrowAtBottom

      Стрелка привлечена в краю кнопки, указывающей на preferredEdge.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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