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() -> Bool
Objective C
+ (BOOL)menuBarVisible
Возвращаемое значение
YES
true
если строка меню видима, иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
См. также
-
Наборы, видима ли строка меню и можно выбрать пользователем.
Объявление
Swift
class func setMenuBarVisible(_
visible
: Bool)Objective C
+ (void)setMenuBarVisible:(BOOL)
visible
Параметры
visible
YES
true
если строка меню должна быть видима, иначеNO
false
.Оператор импорта
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(title
aTitle
: 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 *)
newItem
atIndex:(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 *)
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, actionaSelector
: Selector, keyEquivalentkeyEquiv
: 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 и позже.
См. также
-
Возвращает массив, содержащий пункты меню получателя.
Объявление
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)
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) -> 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 *)
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 и позже.
-
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
Возвращаемое значение
YES
true
если получатель в настоящее время присоединен к другому меню, иначеNO
false
.Оператор импорта
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
Возвращаемое значение
NO
false
если получатель является внеэкранным или присоединяется к другому меню (или если это - главное меню), иначеYES
true
.Специальные замечания
На 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
Возвращаемое значение
YES
true
если получатель автоматически включает и отключает свои пункты меню (на основеNSMenuValidation
неофициальный протокол), иначеNO
false
.Обсуждение
По умолчанию,
NSMenu
объекты автовключают свои пункты меню. См. спецификацию протокола для получения дополнительной информации.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Средства управления, разрешает ли получатель автоматически и отключает свои пункты меню на основе делегатов, реализующих
NSMenuValidation
неофициальный протокол.Объявление
Swift
var autoenablesItems: Bool
Objective C
@property BOOL autoenablesItems
Параметры
flag
Если
flag
YES
true
, пункты меню автоматически включены и отключены. Еслиflag
NO
false
, пункты меню автоматически не включены или отключены.Обсуждение
Посмотрите
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
Параметры
theEvent
NSEvent
объект, представляющий ключевое эквивалентное событие.Возвращаемое значение
YES
true
еслиtheEvent
ключевой эквивалент, который получатель обработал,NO
false
если это не ключевой эквивалент, который это должно обработать.Оператор импорта
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: 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 и позже.
См. также
-
Возвращает размер меню.
Возвращаемое значение
Размер меню в координатах экрана.
Обсуждение
Меню может нарисовать в меньшем размере, когда показано, в зависимости от его расположения и отображать конфигурацию.
Оператор импорта
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
Возвращаемое значение
YES
true
если сообщения отправляются в окна приложения на каждое изменение в получателе, иначеNO
false
.Специальные замечания
На 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
YES
true
если получатель должен отправить сообщение в каждом изменении меню,NO
false
иначе.Обсуждение
Для предотвращения «мерцающего» эффекта многих последовательных изменений меню вызовите этот метод с
flag
набор кNO
false
, внесите изменения в меню и вызовите метод снова сflag
набор кYES
true
. Этот подход имеет эффект пакетной обработки изменений и применения их одновременно.Специальные замечания
На OS X v10.6 и позже этот метод не имеет никакого эффекта. Этот метод может быть осужден в будущем выпуске.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвраты, позволяет ли всплывающее меню добавлять элементов плагина контекстного меню.
Объявление
Swift
var allowsContextMenuPlugIns: Bool
Objective C
@property BOOL allowsContextMenuPlugIns
Возвращаемое значение
YES
true
если всплывающее меню позволяет добавлять элементов плагина контекстного меню, иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
См. также
-
Наборы, позволяет ли всплывающее меню добавлять элементов плагина контекстного меню.
Объявление
Swift
var allowsContextMenuPlugIns: Bool
Objective C
@property BOOL allowsContextMenuPlugIns
Параметры
allows
YES
true
если всплывающее меню должно позволить элементам плагина контекстного меню добавлять, иначеNO
false
.Обсуждение
Плагины контекстного меню являются услугами в масштабе всей системы, предоставленными другими приложениями. Например, плагин контекстного меню мог бы предоставить услугу «Open URL...». Путем включения плагинам контекстного меню контекстное меню приложения выведет на экран надлежащие элементы для в настоящее время выбранного типа данных.
См. Руководство по внедрению Служб для получения дополнительной информации о плагинах контекстного меню.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Выводит на экран контекстное меню по представлению для события.
Объявление
Параметры
menu
Объект меню для использования для контекстного меню.
event
NSEvent
объект, представляющий событие.view
Объект представления, по которому можно вывести на экран контекстное меню.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Выводит на экран контекстное меню по представлению для события с помощью указанного шрифта.
Объявление
Параметры
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?, atLocationlocation
: NSPoint, inViewview
: NSView?) -> BoolObjective C
- (BOOL)popUpMenuPositioningItem:(NSMenuItem *)
item
atLocation:(NSPoint)location
inView:(NSView *)view
Параметры
item
Пункт меню, который будет расположен в указанное расположение в представлении.
location
Расположение в
view
система координат для отображения пункта меню.view
Представление для отображения пункта меню.
Возвращаемое значение
YES
true
если отслеживание меню закончилось, потому что элемент был выбран, иNO
false
если отслеживание меню было отменено по какой-либо причине.Обсуждение
Раскрывается получатель как всплывающее меню. Верхний левый угол указанного элемента (если указано,
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
YES
true
вывести на экран столбец состояния, иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Возвращает булево значение, указывающее, выводит ли получатель на экран столбец состояния.
Объявление
Swift
var showsStateColumn: Bool
Objective C
@property BOOL showsStateColumn
Возвращаемое значение
YES
true
если получатель выводит на экран столбец состояния, иначеNO
false
.Оператор импорта
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;
Константы
-
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]
) или главное меню кнопки всплывающего меню. Это уведомление не содержит 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 и позже.