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

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

Разработчик

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

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

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

NSMenuItem

NSMenuItem класс определяет объекты, использующиеся в качестве элементов команды в меню. Кроме того, NSMenuItem класс также включает некоторую частную функциональность, должен был поддержать совместимость на уровне двоичных кодов с другими компонентами Какао. Из-за этого факта Вы не можете заменить NSMenuItem класс с различным классом. Можно, однако, разделить на подклассы NSMenuItem при необходимости.

До OS X v10.5, NSMenuItem приспособленный следующим протоколам: NSCopying (см. ссылку на протокол NSCopying), NSCoding (см. ссылку на протокол NSCoding), и NSValidatedUserInterfaceItem (см. ссылку на протокол NSValidatedUserInterfaceItem).

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Создание пункта меню
  • init (title:action:keyEquivalent:) - initWithTitle:action:keyEquivalent:

    Возвращает инициализированный экземпляр NSMenuItem.

    Объявление

    Swift

    init(title itemName: String, action anAction: Selector, keyEquivalent charCode: String)

    Objective C

    - (instancetype)initWithTitle:(NSString *)itemName action:(SEL)anAction keyEquivalent:(NSString *)charCode

    Параметры

    itemName

    Заголовок пункта меню. Это значение не должно быть nil (если нет никакого заголовка, укажите пустое NSString).

    anAction

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

    charCode

    Строка, представляющая клавишу на клавиатуре, которая будет использоваться в качестве ключевого эквивалента. Это значение не должно быть nil (если нет никакого ключевого эквивалента, укажите пустое NSString).

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

    Экземпляр NSMenuItem, или nil если не мог бы быть создан объект.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Включение пункта меню
  • setEnabled: - setEnabled:

    Наборы, включен ли получатель

    Объявление

    Swift

    var enabled: Bool

    Objective C

    @property(getter=isEnabled) BOOL enabled

    Параметры

    flag

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

    Обсуждение

    Этот метод не имеет никакого эффекта, если не было отправлено меню, в котором элемент будет добавлен или уже является частью, setAutoenablesItems:NO. Если пункт меню отключен, его эквивалент клавиатуры также отключен. Посмотрите NSMenuValidation неофициальная спецификация протокола для предостережений относительно этого метода.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – isEnabled

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

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

    Объявление

    Objective C

    - (BOOL)isEnabled

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

    YEStrue если получатель включен, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Доступность

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

    См. также

    – setEnabled:

Управление скрытым состоянием
  • setHidden: - setHidden:

    Наборы, скрыт ли получатель.

    Объявление

    Swift

    var hidden: Bool

    Objective C

    @property(getter=isHidden) BOOL hidden

    Параметры

    hidden

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

    Обсуждение

    Скрытые пункты меню (или элементы со скрытым суперэлементом) не появляются в меню и не участвуют в соответствии командной клавиши.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – isHidden
    – isHiddenOrHasHiddenAncestor

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

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

    Объявление

    Objective C

    - (BOOL)isHidden

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

    YEStrue если получатель скрыт, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Доступность

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

    См. также

    – setHidden:
    – isHiddenOrHasHiddenAncestor

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

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

    Объявление

    Objective C

    - (BOOL)isHiddenOrHasHiddenAncestor

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

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

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

    Objective C

    @import AppKit;

    Доступность

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

    См. также

    – setHidden:
    – isHidden

Управление Target и действием
  • setTarget: - setTarget:

    Ставит цель получателя.

    Объявление

    Swift

    weak var target: AnyObject?

    Objective C

    @property(weak) id target

    Параметры

    anObject

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setAction:
    – цель

  • цель - цель

    Возвращает цель получателя.

    Объявление

    Swift

    weak var target: AnyObject?

    Objective C

    @property(weak) id target

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

    Цель получателя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – действие
    – setTarget:

  • setAction: - setAction:

    Устанавливает селектор метода действия получателя.

    Объявление

    Swift

    var action: Selector

    Objective C

    @property SEL action

    Параметры

    aSelector

    Селектор, идентифицирующий метод действия.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setTarget:
    – действие

  • действие - действие

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

    Объявление

    Swift

    var action: Selector

    Objective C

    @property SEL action

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

    Селектор метода действия получателя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – цель
    – setAction:

Управление заголовком
  • setTitle: - setTitle:

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

    Объявление

    Swift

    var title: String

    Objective C

    @property(copy) NSString *title

    Параметры

    aString

    Новый заголовок пункта меню. Если Вы не хотите заголовок, используйте пустую строку (@""), нет nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – заголовок
    – setAttributedTitle:

  • заголовок - заголовок

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

    Объявление

    Swift

    var title: String

    Objective C

    @property(copy) NSString *title

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setTitle:

  • setAttributedTitle: - setAttributedTitle:

    Указывает пользовательскую строку для пункта меню.

    Объявление

    Swift

    @NSCopying var attributedTitle: NSAttributedString?

    Objective C

    @property(copy) NSAttributedString *attributedTitle

    Параметры

    string

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

    Обсуждение

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

    Когда Вы вызываете этот метод для установки заголовка меню в приписанную строку, setTitle: метод также вызывают для установки заголовка меню с простой строкой. При очистке приписанного заголовка простой заголовок остается неизменным. Для очистки приписанного заголовка установите приписанную строку в также nil или пустая приписанная строка ([attrStr length] == 0).

    Приписанная строка не архивируется в старом формате пера.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – attributedTitle
    – setTitle:

  • attributedTitle - attributedTitle

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

    Объявление

    Swift

    @NSCopying var attributedTitle: NSAttributedString?

    Objective C

    @property(copy) NSAttributedString *attributedTitle

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setAttributedTitle:
    – заголовок

Управление тегом
  • setTag: - setTag:

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

    Объявление

    Swift

    var tag: Int

    Objective C

    @property NSInteger tag

    Параметры

    anInt

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setRepresentedObject:
    – тег

  • тег - тег

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

    Объявление

    Swift

    var tag: Int

    Objective C

    @property NSInteger tag

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – representedObject
    – setTag:

Управление состоянием
  • setState: - setState:

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

    Объявление

    Swift

    var state: Int

    Objective C

    @property NSInteger state

    Параметры

    itemState

    Целочисленное постоянное представление состояния; это должен быть один из NSOffState, NSOnState, или NSMixedState.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – состояние
    – setMixedStateImage:
    – setOffStateImage:
    – setOnStateImage:

  • состояние - состояние

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

    Объявление

    Swift

    var state: Int

    Objective C

    @property NSInteger state

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

    Состояние получателя — один из NSOffState (значение по умолчанию), NSOnState, или NSMixedState.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setState:

Управление изображением
  • setImage: - setImage:

    Устанавливает изображение получателя.

    Объявление

    Swift

    var image: NSImage?

    Objective C

    @property(strong) NSImage *image

    Параметры

    menuImage

    NSImage объект, представляющий изображение, которое будет выведено на экран в пункте меню. Если menuImage nil, текущее изображение (если таковые имеются) удалено.

    Обсуждение

    Изображение пункта меню не затронуто изменениями в его состоянии.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – изображение

  • изображение - изображение

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

    Объявление

    Swift

    var image: NSImage?

    Objective C

    @property(strong) NSImage *image

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setImage:

  • setOnStateImage: - setOnStateImage:

    Устанавливает изображение получателя, указывающего «на» состоянии.

    Объявление

    Swift

    var onStateImage: NSImage!

    Objective C

    @property(strong) NSImage *onStateImage

    Параметры

    itemImage

    NSImage возразите для использования для «на» состоянии пункта меню. Если itemImage nil, любое текущее изображение на состоянии удалено.

    Обсуждение

    Изменение изображений состояния в настоящее время не поддерживается в OS X.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – onStateImage
    – setMixedStateImage:
    – setOffStateImage:
    – setState:

  • onStateImage - onStateImage

    Возвращается изображение раньше изображало получатель «на» состоянии.

    Объявление

    Swift

    var onStateImage: NSImage!

    Objective C

    @property(strong) NSImage *onStateImage

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

    Изображение раньше изображало получатель «на» состоянии, или nil если не было установлено изображение.

    Обсуждение

    По умолчанию это изображение является галочкой.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setOnStateImage:

  • setOffStateImage: - setOffStateImage:

    Устанавливает изображение получателя, указывающего «от» состояния.

    Объявление

    Swift

    var offStateImage: NSImage!

    Objective C

    @property(strong) NSImage *offStateImage

    Параметры

    itemImage

    NSImage возразите для использования для «от» состояния пункта меню. Если itemImage nil, любое текущее изображение несостояния удалено.

    Обсуждение

    Изменение изображений состояния в настоящее время не поддерживается в OS X.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – offStateImage
    – setMixedStateImage:
    – setOffStateImage:
    – setState:

  • offStateImage - offStateImage

    Возвращается изображение раньше изображало получатель «от» состояния.

    Объявление

    Swift

    var offStateImage: NSImage!

    Objective C

    @property(strong) NSImage *offStateImage

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

    Изображение раньше изображало получатель «от» состояния, или nil если не было установлено изображение.

    Обсуждение

    По умолчанию нет никакого изображения несостояния.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setOffStateImage:

  • setMixedStateImage: - setMixedStateImage:

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

    Объявление

    Swift

    var mixedStateImage: NSImage!

    Objective C

    @property(strong) NSImage *mixedStateImage

    Параметры

    itemImage

    NSImage возразите для использования для «смешанного» состояния пункта меню. Если itemImage nil, любое текущее изображение смешанное состояния удалено.

    Обсуждение

    Изменение изображений состояния в настоящее время не поддерживается в OS X.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – mixedStateImage
    – setOffStateImage:
    – setOnStateImage:
    – setState:

  • mixedStateImage - mixedStateImage

    Возвращается изображение раньше изображало “смешанное состояние”.

    Объявление

    Swift

    var mixedStateImage: NSImage!

    Objective C

    @property(strong) NSImage *mixedStateImage

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

    Изображение раньше изображало “смешанное состояние”.

    Обсуждение

    Смешанное состояние полезно для указания соединения «прочь» и «на» значениях атрибута в группе выбранных объектов, таково как выбор текста, содержащего полужирные и простые (неполужирные) слова. По умолчанию это - горизонтальная строка.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setMixedStateImage:

Управление подменю
  • setSubmenu: - setSubmenu:

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

    Объявление

    Swift

    var submenu: NSMenu?

    Objective C

    @property(strong) NSMenu *submenu

    Параметры

    aSubmenu

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

    Обсуждение

    Реализация по умолчанию NSMenuItem класс повышает исключение если aSubmenu уже имеет суперменю.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – подменю
    – hasSubmenu

  • подменю - подменю

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

    Объявление

    Swift

    var submenu: NSMenu?

    Objective C

    @property(strong) NSMenu *submenu

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

    Подменю связалось с пунктом меню получения, или nil если никакое подменю не связано с ним.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – hasSubmenu
    – setSubmenu:

  • hasSubmenu - hasSubmenu

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

    Объявление

    Swift

    var hasSubmenu: Bool { get }

    Objective C

    @property(readonly) BOOL hasSubmenu

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

    YEStrue если получатель имеет подменю, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    setSubmenu:forItem: (NSMenu)

  • parentItem - parentItem

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

    Объявление

    Swift

    unowned(unsafe) var parentItem: NSMenuItem? { get }

    Objective C

    @property(readonly, assign) NSMenuItem *parentItem

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

    Элемент родительского меню, или nil если получатель не имеет родительского элемента.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Получение элемента разделителя
  • separatorItem () + separatorItem

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

    Объявление

    Swift

    class func separatorItem() -> NSMenuItem

    Objective C

    + (NSMenuItem *)separatorItem

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

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – isSeparatorItem
    – setEnabled:

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

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

    Объявление

    Objective C

    - (BOOL)isSeparatorItem

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

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

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

    Objective C

    @import AppKit;

    Доступность

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

Управление меню владения
  • setMenu: - setMenu:

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

    Объявление

    Swift

    unowned(unsafe) var menu: NSMenu?

    Objective C

    @property(assign) NSMenu *menu

    Параметры

    aMenu

    Объект меню, которому «принадлежит» получатель.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – меню

  • меню - меню

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

    Объявление

    Swift

    unowned(unsafe) var menu: NSMenu?

    Objective C

    @property(assign) NSMenu *menu

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setMenu:

Управление ключевыми эквивалентами
  • setKeyEquivalent: - setKeyEquivalent:

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

    Объявление

    Swift

    var keyEquivalent: String

    Objective C

    @property(copy) NSString *keyEquivalent

    Параметры

    aString

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

    Обсуждение

    Этот метод полагает, что случай буквы передал, чтобы определить, добавили ли этому модификатор Сдвига. Т.е. [item setKeyEquivalent:@"w"] устанавливает ключ, эквивалентный Команде-w, в то время как [item setKeyEquivalent:@"W"] Command-Shift-w. Вы используете setKeyEquivalentModifierMask: установить надлежащую маску для модифицирующих клавиш для ключевого эквивалента.

    Если Вы хотите указать клавишу Backspace как ключевой эквивалент для пункта меню, используйте односимвольную строку с NSBackspaceCharacter (определенный в NSText.h как 0x08) и для Прямой клавиши Delete, использовать NSDeleteCharacter (определенный в NSText.h как 0x7F). Обратите внимание на то, что это не те же символы, которые Вы получаете от NSEvent ключевое вниз событие при нажатии тех клавиш.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setMnemonicLocation:
    – keyEquivalent

  • keyEquivalent - keyEquivalent

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

    Объявление

    Swift

    var keyEquivalent: String

    Objective C

    @property(copy) NSString *keyEquivalent

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

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

    Обсуждение

    Использовать keyEquivalentModifierMask определить маску модификатора для ключевого эквивалента.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – userKeyEquivalent
    – мнемосхема
    – setKeyEquivalent:

  • setKeyEquivalentModifierMask: - setKeyEquivalentModifierMask:

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

    Объявление

    Swift

    var keyEquivalentModifierMask: Int

    Objective C

    @property NSUInteger keyEquivalentModifierMask

    Параметры

    mask

    Ключевые маски указывают модификаторы, такие как Сдвиг или функциональные клавиши. mask целочисленное битовое поле, содержащее любую из этих масок модифицирующей клавиши, объединенное использование оператора битового «ИЛИ» C:

    • NSShiftKeyMask

    • NSAlternateKeyMask

    • NSCommandKeyMask

    • NSControlKeyMask

    Обсуждение

    В целом Вы строго призваны всегда установить NSCommandKeyMask в mask, несмотря на то, что могут быть некоторые соглашения, где это не требуется. Например, в приложении, играющем носители, команда Play может быть отображена на просто “” (пространстве) без командной клавиши. Можно сделать это со следующим кодом:

    • [menuItem setKeyEquivalent:@" "];
    • [menuItem setKeyEquivalentModifierMask:0];

    NSShiftKeyMask допустимый модификатор для любого ключевого эквивалента в mask. Это позволяет Вам указывать ключевые эквиваленты, такие как Command-Shift-1, которые являются непротиворечивыми через все клавиатуры. Однако за немногим исключением (такие как немецкий символ «с»), символ нижнего регистра с NSShiftKeyMask интерпретируется то же как символ верхнего регистра без той маски. Например, Command-Shift-c и Команда-C считаются идентичными ключевыми эквивалентами.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – keyEquivalentModifierMask

  • keyEquivalentModifierMask - keyEquivalentModifierMask

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

    Объявление

    Swift

    var keyEquivalentModifierMask: Int

    Objective C

    @property NSUInteger keyEquivalentModifierMask

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setKeyEquivalentModifierMask:

Управление мнемоникой
  • setMnemonicLocation: - setMnemonicLocation: (OS X v10.6)

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

    Объявление

    Objective C

    - (void)setMnemonicLocation:(NSUInteger)location

    Параметры

    location

    Целочисленный индекс в символьный массив заголовка. location должен быть от 0 до 254.

    Обсуждение

    Этот символ идентифицирует ключ доступа, которым пользователи могут получить доступ к пункту меню.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    – mnemonicLocation

  • mnemonicLocation - mnemonicLocation (OS X v10.6)

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

    Объявление

    Objective C

    - (NSUInteger)mnemonicLocation

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    – setMnemonicLocation:

  • setTitleWithMnemonic (_:) - setTitleWithMnemonic:

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

    Объявление

    Swift

    func setTitleWithMnemonic(_ stringWithAmpersand: String)

    Objective C

    - (void)setTitleWithMnemonic:(NSString *)stringWithAmpersand

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – мнемосхема
    – setMnemonicLocation:

  • мнемосхема - мнемосхема (OS X v10.6)

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

    Объявление

    Objective C

    - (NSString *)mnemonic

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    – setTitleWithMnemonic:

Управление пользовательскими ключевыми эквивалентами
  • setUsesUserKeyEquivalents (_:) + setUsesUserKeyEquivalents:

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

    Объявление

    Swift

    class func setUsesUserKeyEquivalents(_ flag: Bool)

    Objective C

    + (void)setUsesUserKeyEquivalents:(BOOL)flag

    Параметры

    flag

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    + usesUserKeyEquivalents
    – userKeyEquivalent

  • usesUserKeyEquivalents () + usesUserKeyEquivalents

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

    Объявление

    Swift

    class func usesUserKeyEquivalents() -> Bool

    Objective C

    + (BOOL)usesUserKeyEquivalents

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    + setUsesUserKeyEquivalents:
    – userKeyEquivalent

  • userKeyEquivalent - userKeyEquivalent

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

    Объявление

    Swift

    var userKeyEquivalent: String { get }

    Objective C

    @property(readonly, copy) NSString *userKeyEquivalent

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – keyEquivalent

Управление альтернативами
  • setAlternate: - setAlternate:

    Отмечает получатель как альтернатива к предыдущему пункту меню.

    Объявление

    Swift

    var alternate: Bool

    Objective C

    @property(getter=isAlternate) BOOL alternate

    Параметры

    isAlternate

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

    Обсуждение

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

    Рассмотрите следующий пример: menuItem1 и menuItem2 пункты меню в том же меню, с menuItem1 выше menuItem2:

    • [menuItem1 setTitle:@"One"];
    • [menuItem1 setKeyEquivalent:@"t"];
    • [menuItem2 setTitle:@"Two"];
    • [menuItem2 setKeyEquivalent:@"T"];
    • [menuItem2 setAlternate:YES];

    Когда меню выведено на экран, оно показывает только menuItem1 (с заголовком «Один») вместо двух пунктов меню. В то время как меню выведено на экран, если пользователь нажимает клавишу Shift menuItem2 (с заголовком «Два»), заменяет «Тот».

    Если существует два или больше элемента без ключевых эквивалентных, но различных модификаторов, то единственный способ получить доступ к альтернативным элементам с мышью. В следующем примере, «Два» показан, только если пользователь нажимает клавишу Alternate.

    • [menuItem1 setKeyEquivalent:@""];
    • [menuItem1 setTitle:@"One"];
    • [menuItem2 setKeyEquivalent:@""];
    • [menuItem2 setKeyEquivalentModifierMask:NSAlternateKeyMask];
    • [menuItem2 setTitle:@"Two"];

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

    isAlternate значение архивируется.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – isAlternate

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

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

    Объявление

    Objective C

    - (BOOL)isAlternate

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

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

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

    Objective C

    @import AppKit;

    Доступность

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

    См. также

    – setAlternate:

Управление уровнями отступа
  • setIndentationLevel: - setIndentationLevel:

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

    Объявление

    Swift

    var indentationLevel: Int

    Objective C

    @property NSInteger indentationLevel

    Параметры

    indentationLevel

    Значение для indentationLevel может быть от 0 до 15. Если indentationLevel больше, чем 15, значение прикрепляется к максимуму. Если indentationLevel меньше чем 0, исключение повышено. Уровень отступа по умолчанию 0.

    Обсуждение

    indentationLevel значение архивируется.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – indentationLevel

  • indentationLevel - indentationLevel

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

    Объявление

    Swift

    var indentationLevel: Int

    Objective C

    @property NSInteger indentationLevel

    Обсуждение

    Возвращаемое значение от 0 до 15. Уровень отступа по умолчанию 0.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setIndentationLevel:

Управление подсказками
  • setToolTip: - setToolTip:

    Устанавливает тег справки для пункта меню.

    Объявление

    Swift

    var toolTip: String?

    Objective C

    @property(copy) NSString *toolTip

    Параметры

    toolTip

    Короткая строка, описывающая пункт меню.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – подсказка

  • подсказка - подсказка

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

    Объявление

    Swift

    var toolTip: String?

    Objective C

    @property(copy) NSString *toolTip

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setToolTip:

Представление объекта
  • setRepresentedObject: - setRepresentedObject:

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

    Объявление

    Swift

    var representedObject: AnyObject?

    Objective C

    @property(strong) id representedObject

    Параметры

    anObject

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

    Обсуждение

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

    Например, NSView объект мог бы быть связан с пунктом меню — когда пользователь выбирает пункт меню, представленный объект выбран и выведен на экран в панели. Несколько пунктов меню могли бы управлять дисплеем многократных представлений в той же панели.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setTag:
    – representedObject

  • representedObject - representedObject

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

    Объявление

    Swift

    var representedObject: AnyObject?

    Objective C

    @property(strong) id representedObject

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – тег
    – setRepresentedObject:

Управление представлением
  • setView: - setView:

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

    Объявление

    Swift

    var view: NSView?

    Objective C

    @property(strong) NSView *view

    Параметры

    view

    Довольное представление для получателя.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – представление

  • представление - представление

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

    Объявление

    Swift

    var view: NSView?

    Objective C

    @property(strong) NSView *view

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

    Представление для получателя.

    Обсуждение

    По умолчанию пункт меню имеет a nil представление.

    Посмотрите setView: для большего количества подробных данных.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setView:

Получение выделенного состояния
  • isHighlighted - isHighlighted Доступный в OS X v10.5 через OS X v10.9

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

    Объявление

    Objective C

    - (BOOL)isHighlighted

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

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

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

    Objective C

    @import AppKit;

    Доступность

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