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

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

Разработчик

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

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

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

NSMenu

NSMenu класс определяет объект, управляющий меню приложения.

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


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


Swift

import AppKit

Objective C

@import AppKit;

Доступность


Доступный в OS X v10.0 и позже.
  • Возвращает булево значение, указывающее, видима ли строка меню.

    Объявление

    Swift

    class func menuBarVisible() -> Bool

    Objective C

    + (BOOL)menuBarVisible

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

    YEStrue если строка меню видима, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    + setMenuBarVisible:

  • Наборы, видима ли строка меню и можно выбрать пользователем.

    Объявление

    Swift

    class func setMenuBarVisible(_ visible: Bool)

    Objective C

    + (void)setMenuBarVisible:(BOOL)visible

    Параметры

    visible

    YEStrue если строка меню должна быть видима, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    + menuBarVisible

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

    Объявление

    Swift

    var menuBarHeight: CGFloat { get }

    Objective C

    @property(readonly) CGFloat menuBarHeight

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

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

    Обсуждение

    Этот метод заменяет menuBarHeight метод класса NSMenuView класс.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Инициализирует и возвращает меню, имеющее указанный заголовок и с автовключением включенных пунктов меню.

    Объявление

    Swift

    init(title aTitle: String)

    Objective C

    - (instancetype)initWithTitle:(NSString *)aTitle

    Параметры

    aTitle

    Заголовок для присвоения к получателю.

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

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

    Специальные замечания

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setAutoenablesItems:

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

    Объявление

    Swift

    func insertItem(_ newItem: NSMenuItem, atIndex index: Int)

    Objective C

    - (void)insertItem:(NSMenuItem *)newItem atIndex:(NSInteger)index

    Параметры

    newItem

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

    index

    Целочисленный индекс, идентифицирующий расположение пункта меню в меню.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Создает и добавляет пункт меню в указанном расположении в получателе.

    Объявление

    Swift

    func insertItemWithTitle(_ aString: String, action aSelector: Selector, keyEquivalent keyEquiv: String, atIndex index: Int) -> NSMenuItem?

    Objective C

    - (NSMenuItem *)insertItemWithTitle:(NSString *)aString action:(SEL)aSelector keyEquivalent:(NSString *)keyEquiv atIndex:(NSInteger)index

    Параметры

    aString

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

    aSelector

    Селектор сообщения действия для присвоения к пункту меню.

    keyEquiv

    Строка, идентифицирующая ключ для использования в качестве ключевого эквивалента для пункта меню. Если Вы не хотите, чтобы пункт меню имел ключевой эквивалент, keyEquiv должна быть пустая строка (@"") и нет nil.

    index

    Целочисленный индекс, идентифицирующий расположение пункта меню в меню.

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Добавляет пункт меню до конца получателя.

    Объявление

    Swift

    func addItem(_ newItem: NSMenuItem)

    Objective C

    - (void)addItem:(NSMenuItem *)newItem

    Параметры

    newItem

    Пункт меню (объект, соответствующий NSMenuItem протокол) для добавления к меню.

    Обсуждение

    Этот метод вызывает insertItem:atIndex:. Таким образом получатель не принимает пункт меню, если это уже принадлежит другому меню. После добавления пункта меню получатель обновляет себя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Создает новый пункт меню и добавляет его до конца получателя.

    Объявление

    Swift

    func addItemWithTitle(_ aString: String, action aSelector: Selector, keyEquivalent keyEquiv: String) -> NSMenuItem?

    Objective C

    - (NSMenuItem *)addItemWithTitle:(NSString *)aString action:(SEL)aSelector keyEquivalent:(NSString *)keyEquiv

    Параметры

    aString

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

    aSelector

    Селектор сообщения действия для присвоения к пункту меню.

    keyEquiv

    Строка, идентифицирующая ключ для использования в качестве ключевого эквивалента для пункта меню. Если Вы не хотите, чтобы пункт меню имел ключевой эквивалент, keyEquiv должна быть пустая строка (@"") и нет nil.

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Удаляет пункт меню из получателя.

    Объявление

    Swift

    func removeItem(_ anItem: NSMenuItem)

    Objective C

    - (void)removeItem:(NSMenuItem *)anItem

    Параметры

    anItem

    Пункт меню для удаления.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func removeItemAtIndex(_ index: Int)

    Objective C

    - (void)removeItemAtIndex:(NSInteger)index

    Параметры

    index

    Целочисленный индекс, идентифицирующий пункт меню.

    Обсуждение

    После того, как это удалит пункт меню, этот метод отправляет NSMenuDidRemoveItemNotification.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func itemChanged(_ anObject: NSMenuItem)

    Objective C

    - (void)itemChanged:(NSMenuItem *)anObject

    Параметры

    anObject

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func removeAllItems()

    Objective C

    - (void)removeAllItems

    Обсуждение

    Этот метод более эффективен, чем удаление пунктов меню индивидуально.

    В отличие от другого удалять методы, этот метод не отправляет NSMenuDidChangeItemNotification уведомления.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func itemWithTag(_ aTag: Int) -> NSMenuItem?

    Objective C

    - (NSMenuItem *)itemWithTag:(NSInteger)aTag

    Параметры

    aTag

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

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

    Найденный пункт меню (объект, соответствующий NSMenuItem протокол) или nil если не мог бы быть найден объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    aString

    Заголовок пункта меню.

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

    Найденный пункт меню (объект, соответствующий NSMenuItem протокол) или nil если не мог бы быть найден объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

    - (NSMenuItem *)itemAtIndex:(NSInteger)index

    Параметры

    index

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

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

    Найденный пункт меню (объект, соответствующий NSMenuItem протокол) или nil если не мог бы быть найден объект.

    Обсуждение

    Этот метод повышает исключение если index выходит за пределы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    var numberOfItems: Int { get }

    Objective C

    @property(readonly) NSInteger numberOfItems

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – itemArray

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

    Объявление

    Swift

    var itemArray: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *itemArray

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func indexOfItem(_ anObject: NSMenuItem) -> Int

    Objective C

    - (NSInteger)indexOfItem:(NSMenuItem *)anObject

    Параметры

    anObject

    Пункт меню — который является объектом, соответствующим NSMenuItem протокол.

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

    Целочисленный индекс пункта меню или, если никакой такой пункт меню не находится в меню, –1.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func indexOfItemWithTitle(_ aTitle: String) -> Int

    Objective C

    - (NSInteger)indexOfItemWithTitle:(NSString *)aTitle

    Параметры

    aTitle

    Заголовок пункта меню в получателе.

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

    Целочисленный индекс пункта меню или, если никакой такой пункт меню не находится в меню, –1.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func indexOfItemWithTag(_ aTag: Int) -> Int

    Objective C

    - (NSInteger)indexOfItemWithTag:(NSInteger)aTag

    Параметры

    aTag

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

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

    Целочисленный индекс пункта меню или, если никакой такой пункт меню не находится в меню, –1.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    anObject

    Объект, установленный как цель пункта меню получателя.

    actionSelector

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

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

    Целочисленный индекс пункта меню или, если никакой такой пункт меню не находится в меню, –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.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func indexOfItemWithSubmenu(_ anObject: NSMenu?) -> Int

    Objective C

    - (NSInteger)indexOfItemWithSubmenu:(NSMenu *)anObject

    Параметры

    anObject

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

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

    Целочисленный индекс пункта меню или, если никакой такой пункт меню не находится в меню, –1.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func setSubmenu(_ aMenu: NSMenu?, forItem anItem: NSMenuItem)

    Objective C

    - (void)setSubmenu:(NSMenu *)aMenu forItem:(NSMenuItem *)anItem

    Параметры

    aMenu

    Объект меню, который должен быть подменю получателя.

    anItem

    Пункт меню (т.е. объект, соответствующий NSMenuItem протокол), который управляет aMenu. Метод устанавливает действие anItem к submenuAction:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Метод действия присвоился к пунктам меню, это открывает подменю.

    Объявление

    Swift

    func submenuAction(_ sender: AnyObject?)

    Objective C

    - (void)submenuAction:(id)sender

    Обсуждение

    Можно переопределить этот метод для реализации различного поведения. Никогда не вызывайте этот метод непосредственно.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Objective C

    - (NSMenu *)attachedMenu

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

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

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.2.

    См. также

    – isAttached

  • isAttached - isAttached (OS X v10.2)

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

    Объявление

    Objective C

    - (BOOL)isAttached

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

    YEStrue если получатель в настоящее время присоединен к другому меню, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.2.

    См. также

    – attachedMenu

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

    Объявление

    Objective C

    - (NSPoint)locationForSubmenu:(NSMenu *)aSubmenu

    Параметры

    aSubmenu

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

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

    NSPoint структура, описывающая расположение или (0.0, 0.0), если подменю не существует в получателе.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.2.

  • Возвращает суперменю получателя.

    Объявление

    Swift

    unowned(unsafe) var supermenu: NSMenu?

    Objective C

    @property(assign) NSMenu *supermenu

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

    Суперменю получателя или nil если это не имеет ни одного.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setSupermenu:

  • Устанавливает суперменю получателя.

    Объявление

    Swift

    unowned(unsafe) var supermenu: NSMenu?

    Objective C

    @property(assign) NSMenu *supermenu

    Параметры

    supermenu

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – суперменю

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

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

    Объявление

    Objective C

    - (BOOL)isTornOff

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

    NOfalse если получатель является внеэкранным или присоединяется к другому меню (или если это - главное меню), иначе YEStrue.

    Специальные замечания

    На OS X v10.6 и позже этот метод не имеет никакого эффекта.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    Объявление

    Swift

    var autoenablesItems: Bool

    Objective C

    @property BOOL autoenablesItems

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

    YEStrue если получатель автоматически включает и отключает свои пункты меню (на основе NSMenuValidation неофициальный протокол), иначе NOfalse.

    Обсуждение

    По умолчанию, NSMenu объекты автовключают свои пункты меню. См. спецификацию протокола для получения дополнительной информации.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setAutoenablesItems:

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

    Объявление

    Swift

    var autoenablesItems: Bool

    Objective C

    @property BOOL autoenablesItems

    Параметры

    flag

    Если flag YEStrue, пункты меню автоматически включены и отключены. Если flag NOfalse, пункты меню автоматически не включены или отключены.

    Обсуждение

    Посмотрите NSMenuValidation спецификация протокола для получения дополнительной информации.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – autoenablesItems

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

    Объявление

    Swift

    func update()

    Objective C

    - (void)update

    Обсуждение

    Посмотрите NSMenuValidation спецификация протокола для получения дополнительной информации.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    var font: NSFont!

    Objective C

    @property(strong) NSFont *font

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

    Объект шрифта, используемый для отображения меню.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setFont:

  • Устанавливает шрифт, используемый для отображения меню и его подменю.

    Объявление

    Swift

    var font: NSFont!

    Objective C

    @property(strong) NSFont *font

    Параметры

    font

    Объект шрифта использовать.

    Обсуждение

    Этот шрифт будет использоваться для отображения меню и любых подменю, не имевших их набора шрифтов явно.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – шрифт

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

    Объявление

    Swift

    func performKeyEquivalent(_ theEvent: NSEvent) -> Bool

    Objective C

    - (BOOL)performKeyEquivalent:(NSEvent *)theEvent

    Параметры

    theEvent

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

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

    YEStrue если theEvent ключевой эквивалент, который получатель обработал, NOfalse если это не ключевой эквивалент, который это должно обработать.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Заставляет приложение отправлять сообщение действия указанного пункта меню к его цели.

    Объявление

    Swift

    func performActionForItemAtIndex(_ index: Int)

    Objective C

    - (void)performActionForItemAtIndex:(NSInteger)index

    Параметры

    index

    Целочисленный индекс пункта меню.

    Обсуждение

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

    В OS X v10.6 и позже performActionForItemAtIndex: больше триггерная проверка меню. Это вызвано тем, что проверка обычно делается во время отслеживания меню или ключевого эквивалентного соответствия, таким образом, последующее performActionForItemAtIndex: проверка была избыточна. Для инициирования проверки явно использование вызывает update метод.

    В OS X v10.6 performActionForItemAtIndex:, когда вызвано, теперь триггерное выделение в строке меню. Это также отсылает надлежащие уведомления доступности, указывающие, что был выбран элемент.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – performKeyEquivalent:

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

    Объявление

    Swift

    var title: String

    Objective C

    @property(copy) NSString *title

    Параметры

    aString

    Строка для присвоения как новый заголовок получателя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – заголовок

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

    Объявление

    Swift

    var title: String

    Objective C

    @property(copy) NSString *title

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

    Заголовок получателя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setTitle:

  • Возвращает минимальную ширину меню.

    Объявление

    Swift

    var minimumWidth: CGFloat

    Objective C

    @property CGFloat minimumWidth

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

    Минимальная ширина меню в координатах экрана.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Установите минимальную ширину меню.

    Объявление

    Swift

    var minimumWidth: CGFloat

    Objective C

    @property CGFloat minimumWidth

    Параметры

    width

    Минимальная ширина меню в координатах экрана.

    Обсуждение

    Меню не нарисует меньший, чем его минимальная ширина, но может нарисовать больше, если будет требоваться больше пространства. Значение по умолчанию 0.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – minimumWidth

  • Возвращает размер меню.

    Объявление

    Swift

    var size: NSSize { get }

    Objective C

    @property(readonly) NSSize size

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

    Размер меню в координатах экрана.

    Обсуждение

    Меню может нарисовать в меньшем размере, когда показано, в зависимости от его расположения и отображать конфигурацию.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • sizeToFit - sizeToFit (OS X v10.2)

    Изменяет размеры получателя для точной адаптации его элементам.

    Объявление

    Objective C

    - (void)sizeToFit

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.2.

  • Возвращает доступные свойства для меню.

    Объявление

    Swift

    var propertiesToUpdate: NSMenuProperties { get }

    Objective C

    @property(readonly) NSMenuProperties propertiesToUpdate

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

    Поразрядное-C OR из значений в NSMenuProperties, которые применимы к этому меню.

    Обсуждение

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

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

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

    Можно вызвать это от методов делегата меню menuNeedsUpdate:, или методы проверки меню -validateMenuItem: или validateUserInterfaceItem:. Вызов этого в других случаях повысит исключение.

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

    Вызов этого является дополнительным; всегда приемлемо полностью обновить все свойства меню.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    var menuChangedMessagesEnabled: Bool

    Objective C

    @property BOOL menuChangedMessagesEnabled

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

    YEStrue если сообщения отправляются в окна приложения на каждое изменение в получателе, иначе NOfalse.

    Специальные замечания

    На OS X v10.6 и позже этот метод не имеет никакого эффекта. Этот метод может быть осужден в будущем выпуске.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Средства управления, отправляет ли получатель сообщения в окна приложения на каждое изменение меню.

    Объявление

    Swift

    var menuChangedMessagesEnabled: Bool

    Objective C

    @property BOOL menuChangedMessagesEnabled

    Параметры

    flag

    YEStrue если получатель должен отправить сообщение в каждом изменении меню, NOfalse иначе.

    Обсуждение

    Для предотвращения «мерцающего» эффекта многих последовательных изменений меню вызовите этот метод с flag набор к NOfalse, внесите изменения в меню и вызовите метод снова с flag набор к YEStrue. Этот подход имеет эффект пакетной обработки изменений и применения их одновременно.

    Специальные замечания

    На OS X v10.6 и позже этот метод не имеет никакого эффекта. Этот метод может быть осужден в будущем выпуске.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    var allowsContextMenuPlugIns: Bool

    Objective C

    @property BOOL allowsContextMenuPlugIns

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    var allowsContextMenuPlugIns: Bool

    Objective C

    @property BOOL allowsContextMenuPlugIns

    Параметры

    allows

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

    Обсуждение

    Плагины контекстного меню являются услугами в масштабе всей системы, предоставленными другими приложениями. Например, плагин контекстного меню мог бы предоставить услугу «Open URL...». Путем включения плагинам контекстного меню контекстное меню приложения выведет на экран надлежащие элементы для в настоящее время выбранного типа данных.

    См. Руководство по внедрению Служб для получения дополнительной информации о плагинах контекстного меню.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    class func popUpContextMenu(_ menu: NSMenu, withEvent event: NSEvent, forView view: NSView)

    Objective C

    + (void)popUpContextMenu:(NSMenu *)menu withEvent:(NSEvent *)event forView:(NSView *)view

    Параметры

    menu

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

    event

    NSEvent объект, представляющий событие.

    view

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    class func popUpContextMenu(_ menu: NSMenu, withEvent event: NSEvent, forView view: NSView, withFont font: NSFont?)

    Objective C

    + (void)popUpContextMenu:(NSMenu *)menu withEvent:(NSEvent *)event forView:(NSView *)view withFont:(NSFont *)font

    Параметры

    menu

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

    event

    NSEvent объект, представляющий событие.

    view

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

    font

    NSFont объект, представляющий шрифт для контекстного меню. Если Вы передаете в nil для шрифта метод использует стандартный шрифт для menu.

    Обсуждение

    Указанию шрифта с помощью параметра шрифта обескураживают. Вместо этого установите шрифт меню с помощью setFont: метод и передача nil для font параметр.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Переопределенный подклассами для реализации специализированного контекстно-зависимого поведения справки.

    Объявление

    Swift

    func helpRequested(_ event: NSEvent)

    Objective C

    - (void)helpRequested:(NSEvent *)event

    Параметры

    event

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

    Обсуждение

    Подклассы в их реализации этого метода должны вызвать менеджера по Справке (NSHelpManager) вывести на экран справку связалось с получателем. Никогда не вызывайте этот метод непосредственно.

    Специальные замечания

    На OS X v10.6 и позже этот метод не имеет никакого эффекта. Этот метод может быть осужден в будущем выпуске.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    showContextHelpForObject:locationHint: (NSHelpManager)

  • Раскрывается меню в указанном расположении.

    Объявление

    Swift

    func popUpMenuPositioningItem(_ item: NSMenuItem?, atLocation location: NSPoint, inView view: NSView?) -> Bool

    Objective C

    - (BOOL)popUpMenuPositioningItem:(NSMenuItem *)item atLocation:(NSPoint)location inView:(NSView *)view

    Параметры

    item

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

    location

    Расположение в view система координат для отображения пункта меню.

    view

    Представление для отображения пункта меню.

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

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

    Обсуждение

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

    Если item nil, меню расположено таким образом, что верхний левый из кадра содержимого меню в данном расположении.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Наборы, выводит ли получатель на экран столбец состояния.

    Объявление

    Swift

    var showsStateColumn: Bool

    Objective C

    @property BOOL showsStateColumn

    Параметры

    showsState

    YEStrue вывести на экран столбец состояния, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – showsStateColumn

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

    Объявление

    Swift

    var showsStateColumn: Bool

    Objective C

    @property BOOL showsStateColumn

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

    YEStrue если получатель выводит на экран столбец состояния, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setShowsStateColumn:

  • Возвращает зону из который NSMenu объекты должны быть выделены.

    Объявление

    Swift

    class func menuZone() -> NSZone

    Objective C

    + (NSZone *)menuZone

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

    Зона та, от который NSMenu объекты должны быть выделены.

    Специальные замечания

    Это оставлено внутри для совместимости и всегда возвращается NSDefaultMallocZone. Не необходимо использовать это.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Устанавливает зону от который NSMenu объекты должны быть выделены

    Объявление

    Objective C

    + (void)setMenuZone:(NSZone *)zone

    Параметры

    zone

    Зона памяти для установки.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.2.

  • Возвращает выделенный элемент в получателе.

    Объявление

    Swift

    var highlightedItem: NSMenuItem? { get }

    Objective C

    @property(readonly, strong) NSMenuItem *highlightedItem

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    unowned(unsafe) var delegate: NSMenuDelegate?

    Objective C

    @property(assign) id<NSMenuDelegate> delegate

    Параметры

    anObject

    Объект установить как делегат.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – делегат

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

    Объявление

    Swift

    unowned(unsafe) var delegate: NSMenuDelegate?

    Objective C

    @property(assign) id<NSMenuDelegate> delegate

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setDelegate:

  • Отклоняет меню и заканчивает все отслеживание меню.

    Объявление

    Swift

    func cancelTracking()

    Objective C

    - (void)cancelTracking

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Отклоняет меню и заканчивает все отслеживание меню, не выводя на экран связанную анимацию.

    Объявление

    Swift

    func cancelTrackingWithoutAnimation()

    Objective C

    - (void)cancelTrackingWithoutAnimation

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – cancelTracking

  • Осуждаемый.

    Оператор осуждения

    OS X не использует представления меню для рисования меню.

    Объявление

    Objective C

    - (id)contextMenuRepresentation

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

    nil.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.2.

  • Осуждаемый.

    Оператор осуждения

    OS X не использует представления меню для рисования меню.

    Объявление

    Objective C

    - (void)setContextMenuRepresentation:(id)menuRep

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.2.

  • Осуждаемый.

    Оператор осуждения

    OS X не использует представления меню для рисования меню.

    Объявление

    Objective C

    - (id)tearOffMenuRepresentation

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

    nil.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.2.

  • Осуждаемый.

    Оператор осуждения

    OS X не использует представления меню для рисования меню.

    Объявление

    Objective C

    - (void)setTearOffMenuRepresentation:(id)menuRep

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.2.

  • Осуждаемый.

    Оператор осуждения

    OS X не использует представления меню для рисования меню.

    Объявление

    Objective C

    - (void)setMenuRepresentation:(id)menuRep

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.2.

  • Осуждаемый.

    Оператор осуждения

    OS X не использует представления меню для рисования меню.

    Объявление

    Objective C

    - (id)menuRepresentation

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

    nil.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.2.

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

    Объявление

    Swift

    struct NSMenuProperties : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var PropertyItemTitle: NSMenuProperties { get } static var PropertyItemAttributedTitle: NSMenuProperties { get } static var PropertyItemKeyEquivalent: NSMenuProperties { get } static var PropertyItemImage: NSMenuProperties { get } static var PropertyItemEnabled: NSMenuProperties { get } static var PropertyItemAccessibilityDescription: NSMenuProperties { get } }

    Objective C

    enum { NSMenuPropertyItemTitle = 1 << 0, NSMenuPropertyItemAttributedTitle = 1 << 1 NSMenuPropertyItemKeyEquivalent = 1 << 2, NSMenuPropertyItemImage = 1 << 3, NSMenuPropertyItemEnabled = 1 << 4, NSMenuPropertyItemAccessibilityDescription = 1 << 5 }; typedef NSUInteger NSMenuProperties;

    Константы

    • PropertyItemTitle

      NSMenuPropertyItemTitle

      Заголовок пункта меню.

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

    • PropertyItemAttributedTitle

      NSMenuPropertyItemAttributedTitle

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

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

    • PropertyItemKeyEquivalent

      NSMenuPropertyItemKeyEquivalent

      Ключевой эквивалент пункта меню.

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

    • PropertyItemImage

      NSMenuPropertyItemImage

      Изображение меню.

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

    • PropertyItemEnabled

      NSMenuPropertyItemEnabled

      Включен ли пункт меню или отключен.

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

    • PropertyItemAccessibilityDescription

      NSMenuPropertyItemAccessibilityDescription

      Описание доступности пункта меню.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Отправленный после того, как пункт меню добавляется к меню. Объект уведомления является экземпляром NSMenu это просто добавило новый пункт меню. userInfo словарь содержит следующую информацию:

    Ключ

    Значение

    @"NSMenuItemIndex"

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Отправленный после того, как пункт меню в меню изменяет появление. Изменения включают включение/отключение, изменения в состоянии и изменения в заголовке. Объект уведомления является экземпляром NSMenu с изменившимся пунктом меню. userInfo словарь содержит следующую информацию:

    Ключ

    Значение

    @"NSMenuItemIndex"

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Отправленный, когда начинается отслеживание меню. Объект уведомления является строкой главного меню ([NSApp mainMenu]) или главное меню кнопки всплывающего меню. Это уведомление не содержит a userInfo словарь.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Отправленный, когда меню, отслеживающее концы, даже если не отправляется никакое действие. Объект уведомления является строкой главного меню ([NSApp mainMenu]) или главное меню кнопки всплывающего меню. Это уведомление не содержит a userInfo словарь.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Отправленный после того, как пункт меню удален из меню. Объект уведомления является экземпляром NSMenu это просто удалило пункт меню. userInfo словарь содержит следующую информацию:

    Ключ

    Значение

    @"NSMenuItemIndex"

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Отправленный сразу после того, как приложение диспетчеризирует метод действия пункта меню для цели пункта меню. Объект уведомления является экземпляром NSMenu содержа выбранный пункт меню. userInfo словарь содержит следующую информацию:

    Ключ

    Значение

    @"MenuItem"

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Отправленный непосредственно перед тем, как приложение диспетчеризирует метод действия пункта меню для цели пункта меню. Объект уведомления является экземпляром NSMenu содержа выбранный пункт меню. userInfo словарь содержит следующую информацию:

    Ключ

    Значение

    @"MenuItem"

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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