NSMenu
NSMenu класс определяет объект, управляющий меню приложения.
Соответствует
-
AnyObject -
CVarArgType -
Сопоставимый -
Hashable -
NSCoding -
NSCopying -
NSObjectProtocol -
Печатаемый -
NSCoding -
NSCopying -
NSObject
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает булево значение, указывающее, видима ли строка меню.
Объявление
Swift
class func menuBarVisible() -> BoolObjective C
+ (BOOL)menuBarVisibleВозвращаемое значение
YEStrueесли строка меню видима, иначеNOfalse.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.2 и позже.
См. также
-
Наборы, видима ли строка меню и можно выбрать пользователем.
Объявление
Swift
class func setMenuBarVisible(_visible: Bool)Objective C
+ (void)setMenuBarVisible:(BOOL)visibleПараметры
visibleYEStrueесли строка меню должна быть видима, иначеNOfalse.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.2 и позже.
См. также
-
Возвращает высоту строки меню для главного меню текущего приложения.
Объявление
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(titleaTitle: String)Objective C
- (instancetype)initWithTitle:(NSString *)aTitleПараметры
aTitleЗаголовок для присвоения к получателю.
Возвращаемое значение
Инициализированный
NSMenuобъект илиnilесли не мог бы быть инициализирован объект.Специальные замечания
Этот метод является определяемым инициализатором для класса.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Вставляет пункт меню в получатель в определенном расположении.
Объявление
Swift
func insertItem(_newItem: NSMenuItem, atIndexindex: Int)Objective C
- (void)insertItem:(NSMenuItem *)newItematIndex:(NSInteger)indexПараметры
newItemОбъект, соответствующий
NSMenuItemпротокол, представляющий пункт меню.indexЦелочисленный индекс, идентифицирующий расположение пункта меню в меню.
Обсуждение
Этот метод отправляет
NSMenuDidAddItemNotification, разрешение заинтересованным наблюдателям обновить как надлежащий. Этот метод является примитивным методом. Все методы дополнения элемента заканчивают тем, что вызвали этот метод, таким образом, это - то, где необходимо реализовать пользовательское поведение при добавлении новых элементов к меню в пользовательском подклассе. Если пункт меню уже существует в другом меню, он не вставляется, и метод повышает исключение типаNSInternalInconsistencyException.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
insertItemWithTitle (_: action:keyEquivalent:atIndex:) - insertItemWithTitle:action:keyEquivalent:atIndex:Создает и добавляет пункт меню в указанном расположении в получателе.
Объявление
Swift
func insertItemWithTitle(_aString: String, actionaSelector: Selector, keyEquivalentkeyEquiv: String, atIndexindex: Int) -> NSMenuItem?Objective C
- (NSMenuItem *)insertItemWithTitle:(NSString *)aStringaction:(SEL)aSelectorkeyEquivalent:(NSString *)keyEquivatIndex:(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, actionaSelector: Selector, keyEquivalentkeyEquiv: String) -> NSMenuItem?Objective C
- (NSMenuItem *)addItemWithTitle:(NSString *)aStringaction:(SEL)aSelectorkeyEquivalent:(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 и позже.
См. также
-
Возвращает массив, содержащий пункты меню получателя.
Объявление
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) -> IntObjective C
- (NSInteger)indexOfItem:(NSMenuItem *)anObjectПараметры
anObjectПункт меню — который является объектом, соответствующим
NSMenuItemпротокол.Возвращаемое значение
Целочисленный индекс пункта меню или, если никакой такой пункт меню не находится в меню, –1.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает индекс первого пункта меню в получателе, имеющем указанный заголовок.
Объявление
Параметры
aTitleЗаголовок пункта меню в получателе.
Возвращаемое значение
Целочисленный индекс пункта меню или, если никакой такой пункт меню не находится в меню, –1.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает индекс первого пункта меню в получателе, идентифицированном тегом.
Объявление
Параметры
aTagЦелочисленный тег связался с пунктом меню получателя.
Возвращаемое значение
Целочисленный индекс пункта меню или, если никакой такой пункт меню не находится в меню, –1.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает индекс первого пункта меню в получателе, имеющем указанное действие и цель.
Объявление
Swift
func indexOfItemWithTarget(_anObject: AnyObject?, andActionactionSelector: Selector) -> IntObjective C
- (NSInteger)indexOfItemWithTarget:(id)anObjectandAction:(SEL)actionSelectorПараметры
anObjectОбъект, установленный как цель пункта меню получателя.
actionSelectorСелектор, идентифицирующий метод действия. Если
actionSelectorNULL, первый пункт меню в получателе, имеющем цельanObjectвозвращаетсяВозвращаемое значение
Целочисленный индекс пункта меню или, если никакой такой пункт меню не находится в меню, –1.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает индекс первого пункта меню в получателе, имеющем данный представленный объект.
Объявление
Swift
func indexOfItemWithRepresentedObject(_anObject: AnyObject) -> IntObjective C
- (NSInteger)indexOfItemWithRepresentedObject:(id)anObjectПараметры
anObjectПредставленный объект получателя.
Возвращаемое значение
Целочисленный индекс пункта меню или, если никакой такой пункт меню не находится в меню, –1.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает индекс пункта меню в получателе с данным подменю.
Объявление
Objective C
- (NSInteger)indexOfItemWithSubmenu:(NSMenu *)anObjectПараметры
anObjectОбъект меню, который является пунктом меню получателя (т.е. подменю).
Возвращаемое значение
Целочисленный индекс пункта меню или, если никакой такой пункт меню не находится в меню, –1.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Присваивает меню, чтобы быть подменю получателя, которым управляет данный пункт меню.
Объявление
Swift
func setSubmenu(_aMenu: NSMenu?, forItemanItem: NSMenuItem)Objective C
- (void)setSubmenu:(NSMenu *)aMenuforItem:(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 и позже.
-
attachedMenu - attachedMenu(OS X v10.2)Возвращает меню, в настоящее время присоединяемое к получателю.
Объявление
Objective C
- (NSMenu *)attachedMenuВозвращаемое значение
Меню, в настоящее время присоединяемое к получателю или
nilесли нет такого объекта.Оператор импорта
Objective C
@import AppKit;Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.2.
См. также
-
isAttached - isAttached(OS X v10.2)Возвращает булево значение, указывающее, присоединен ли получатель в настоящее время к другому меню.
Объявление
Objective C
- (BOOL)isAttachedВозвращаемое значение
YEStrueесли получатель в настоящее время присоединен к другому меню, иначеNOfalse.Оператор импорта
Objective C
@import AppKit;Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.2.
См. также
-
locationForSubmenu: - locationForSubmenu:(OS X v10.2)Возвращает расположение в координатах экрана, где данное подменю выведено на экран, когда открыто как подменю получателя.
Объявление
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 и позже.
См. также
-
Устанавливает суперменю получателя.
Объявление
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: BoolObjective C
@property BOOL autoenablesItemsВозвращаемое значение
YEStrueесли получатель автоматически включает и отключает свои пункты меню (на основеNSMenuValidationнеофициальный протокол), иначеNOfalse.Обсуждение
По умолчанию,
NSMenuобъекты автовключают свои пункты меню. См. спецификацию протокола для получения дополнительной информации.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Средства управления, разрешает ли получатель автоматически и отключает свои пункты меню на основе делегатов, реализующих
NSMenuValidationнеофициальный протокол.Объявление
Swift
var autoenablesItems: BoolObjective C
@property BOOL autoenablesItemsПараметры
flagЕсли
flagYEStrue, пункты меню автоматически включены и отключены. ЕслиflagNOfalse, пункты меню автоматически не включены или отключены.Обсуждение
Посмотрите
NSMenuValidationспецификация протокола для получения дополнительной информации.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Включает или отключает пункты меню получателя на основе
NSMenuValidationнеофициальный протокол и размеры меню для адаптации его текущим пунктам меню при необходимости.Объявление
Swift
func update()Objective C
- (void)updateОбсуждение
Посмотрите
NSMenuValidationспецификация протокола для получения дополнительной информации.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращается шрифт раньше выводил на экран меню и его подменю.
Возвращаемое значение
Объект шрифта, используемый для отображения меню.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
См. также
-
Устанавливает шрифт, используемый для отображения меню и его подменю.
Параметры
fontОбъект шрифта использовать.
Обсуждение
Этот шрифт будет использоваться для отображения меню и любых подменю, не имевших их набора шрифтов явно.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
См. также
-
Выполняет действие для пункта меню, соответствующего данному ключевому эквиваленту.
Объявление
Swift
func performKeyEquivalent(_theEvent: NSEvent) -> BoolObjective C
- (BOOL)performKeyEquivalent:(NSEvent *)theEventПараметры
theEventNSEventобъект, представляющий ключевое эквивалентное событие.Возвращаемое значение
YEStrueеслиtheEventключевой эквивалент, который получатель обработал,NOfalseесли это не ключевой эквивалент, который это должно обработать.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
– performActionForItemAtIndex:menuHasKeyEquivalent:forEvent:target:action:(NSMenuDelegate)
-
Заставляет приложение отправлять сообщение действия указанного пункта меню к его цели.
Объявление
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 и позже.
См. также
-
Устанавливает заголовок получателя.
Параметры
aStringСтрока для присвоения как новый заголовок получателя.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает заголовок получателя.
Возвращаемое значение
Заголовок получателя.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает минимальную ширину меню.
Объявление
Swift
var minimumWidth: CGFloatObjective C
@property CGFloat minimumWidthВозвращаемое значение
Минимальная ширина меню в координатах экрана.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
-
Установите минимальную ширину меню.
Объявление
Swift
var minimumWidth: CGFloatObjective C
@property CGFloat minimumWidthПараметры
widthМинимальная ширина меню в координатах экрана.
Обсуждение
Меню не нарисует меньший, чем его минимальная ширина, но может нарисовать больше, если будет требоваться больше пространства. Значение по умолчанию 0.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
См. также
-
Возвращает размер меню.
Возвращаемое значение
Размер меню в координатах экрана.
Обсуждение
Меню может нарисовать в меньшем размере, когда показано, в зависимости от его расположения и отображать конфигурацию.
Оператор импорта
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: BoolObjective C
@property BOOL menuChangedMessagesEnabledВозвращаемое значение
YEStrueесли сообщения отправляются в окна приложения на каждое изменение в получателе, иначеNOfalse.Специальные замечания
На OS X v10.6 и позже этот метод не имеет никакого эффекта. Этот метод может быть осужден в будущем выпуске.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Средства управления, отправляет ли получатель сообщения в окна приложения на каждое изменение меню.
Объявление
Swift
var menuChangedMessagesEnabled: BoolObjective C
@property BOOL menuChangedMessagesEnabledПараметры
flagYEStrueесли получатель должен отправить сообщение в каждом изменении меню,NOfalseиначе.Обсуждение
Для предотвращения «мерцающего» эффекта многих последовательных изменений меню вызовите этот метод с
flagнабор кNOfalse, внесите изменения в меню и вызовите метод снова сflagнабор кYEStrue. Этот подход имеет эффект пакетной обработки изменений и применения их одновременно.Специальные замечания
На OS X v10.6 и позже этот метод не имеет никакого эффекта. Этот метод может быть осужден в будущем выпуске.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвраты, позволяет ли всплывающее меню добавлять элементов плагина контекстного меню.
Объявление
Swift
var allowsContextMenuPlugIns: BoolObjective C
@property BOOL allowsContextMenuPlugInsВозвращаемое значение
YEStrueесли всплывающее меню позволяет добавлять элементов плагина контекстного меню, иначеNOfalse.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
См. также
-
Наборы, позволяет ли всплывающее меню добавлять элементов плагина контекстного меню.
Объявление
Swift
var allowsContextMenuPlugIns: BoolObjective C
@property BOOL allowsContextMenuPlugInsПараметры
allowsYEStrueесли всплывающее меню должно позволить элементам плагина контекстного меню добавлять, иначеNOfalse.Обсуждение
Плагины контекстного меню являются услугами в масштабе всей системы, предоставленными другими приложениями. Например, плагин контекстного меню мог бы предоставить услугу «Open URL...». Путем включения плагинам контекстного меню контекстное меню приложения выведет на экран надлежащие элементы для в настоящее время выбранного типа данных.
См. Руководство по внедрению Служб для получения дополнительной информации о плагинах контекстного меню.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
-
Выводит на экран контекстное меню по представлению для события.
Объявление
Параметры
menuОбъект меню для использования для контекстного меню.
eventNSEventобъект, представляющий событие.viewОбъект представления, по которому можно вывести на экран контекстное меню.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Выводит на экран контекстное меню по представлению для события с помощью указанного шрифта.
Объявление
Параметры
menuОбъект меню для использования для контекстного меню.
eventNSEventобъект, представляющий событие.viewОбъект представления, по которому можно вывести на экран контекстное меню.
fontNSFontобъект, представляющий шрифт для контекстного меню. Если Вы передаете в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Параметры
eventNSEventобъект, представляющий событие, связался с запросом справочной информации.Обсуждение
Подклассы в их реализации этого метода должны вызвать менеджера по Справке (
NSHelpManager) вывести на экран справку связалось с получателем. Никогда не вызывайте этот метод непосредственно.Специальные замечания
На OS X v10.6 и позже этот метод не имеет никакого эффекта. Этот метод может быть осужден в будущем выпуске.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
showContextHelpForObject:locationHint:(NSHelpManager) -
Раскрывается меню в указанном расположении.
Объявление
Swift
func popUpMenuPositioningItem(_item: NSMenuItem?, atLocationlocation: NSPoint, inViewview: NSView?) -> BoolObjective C
- (BOOL)popUpMenuPositioningItem:(NSMenuItem *)itematLocation:(NSPoint)locationinView:(NSView *)viewПараметры
itemПункт меню, который будет расположен в указанное расположение в представлении.
locationРасположение в
viewсистема координат для отображения пункта меню.viewПредставление для отображения пункта меню.
Возвращаемое значение
YEStrueесли отслеживание меню закончилось, потому что элемент был выбран, иNOfalseесли отслеживание меню было отменено по какой-либо причине.Обсуждение
Раскрывается получатель как всплывающее меню. Верхний левый угол указанного элемента (если указано,
itemдолжен присутствовать в получателе), расположен в указанное расположение в указанном представлении, интерпретируемом в собственной системе координат представления.Если
itemnil, меню расположено таким образом, что верхний левый из кадра содержимого меню в данном расположении.Если
viewnil, расположение интерпретируется в системе координаты экрана. Это позволяет Вам раскрываться меню, разъединенное от любого окна.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
-
Наборы, выводит ли получатель на экран столбец состояния.
Объявление
Swift
var showsStateColumn: BoolObjective C
@property BOOL showsStateColumnПараметры
showsStateYEStrueвывести на экран столбец состояния, иначеNOfalse.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.5 и позже.
См. также
-
Возвращает булево значение, указывающее, выводит ли получатель на экран столбец состояния.
Объявление
Swift
var showsStateColumn: BoolObjective C
@property BOOL showsStateColumnВозвращаемое значение
YEStrueесли получатель выводит на экран столбец состояния, иначеNOfalse.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.5 и позже.
См. также
-
Возвращает зону из который
NSMenuобъекты должны быть выделены.Возвращаемое значение
Зона та, от который
NSMenuобъекты должны быть выделены.Специальные замечания
Это оставлено внутри для совместимости и всегда возвращается
NSDefaultMallocZone. Не необходимо использовать это.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
setMenuZone: + setMenuZone:(OS X v10.2)Устанавливает зону от который
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 и позже.
См. также
-
Отклоняет меню и заканчивает все отслеживание меню.
Объявление
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 и позже.
См. также
-
contextMenuRepresentation - contextMenuRepresentation(OS X v10.2)Осуждаемый.
Оператор осуждения
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.
-
tearOffMenuRepresentation - tearOffMenuRepresentation(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.
-
setMenuRepresentation: - setMenuRepresentation:(OS X v10.2)Осуждаемый.
Оператор осуждения
OS X не использует представления меню для рисования меню.
Объявление
Objective C
- (void)setMenuRepresentation:(id)menuRepОператор импорта
Objective C
@import AppKit;Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.2.
-
menuRepresentation - menuRepresentation(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(rawValuerawValue: 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;Константы
-
PropertyItemTitleNSMenuPropertyItemTitleЗаголовок пункта меню.
Доступный в OS X v10.6 и позже.
-
PropertyItemAttributedTitleNSMenuPropertyItemAttributedTitleПриписанный строковый заголовок пункта меню.
Доступный в OS X v10.6 и позже.
-
PropertyItemKeyEquivalentNSMenuPropertyItemKeyEquivalentКлючевой эквивалент пункта меню.
Доступный в OS X v10.6 и позже.
-
PropertyItemImageNSMenuPropertyItemImageИзображение меню.
Доступный в OS X v10.6 и позже.
-
PropertyItemEnabledNSMenuPropertyItemEnabledВключен ли пункт меню или отключен.
Доступный в OS X v10.6 и позже.
-
PropertyItemAccessibilityDescriptionNSMenuPropertyItemAccessibilityDescriptionОписание доступности пункта меню.
Доступный в 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]) или главное меню кнопки всплывающего меню. Это уведомление не содержит auserInfoсловарь.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.5 и позже.
-
Отправленный, когда меню, отслеживающее концы, даже если не отправляется никакое действие. Объект уведомления является строкой главного меню (
[NSApp mainMenu]) или главное меню кнопки всплывающего меню. Это уведомление не содержит auserInfoсловарь.Оператор импорта
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 и позже.
