NSPopUpButton
NSPopUpButton класс определяет объекты, реализующие раскрывающееся и выпадающие меню графического интерфейса пользователя.
NSPopUpButton возразите использует NSPopUpButtonCell возразите для реализации его пользовательского интерфейса.
Обратите внимание на то, что, в то время как меню отслеживает ввод данных пользователем, программируемые изменения в меню, такие как добавление, удаление, или изменение элементов в меню не отражается.
Наследование
-
NSObject -
NSResponder -
NSView -
NSControl -
NSButton -
NSPopUpButton
-
NSObject -
NSResponder -
NSView -
NSControl -
NSButton -
NSPopUpButton
Соответствует
-
AnyObject -
CVarArgType -
Сопоставимый -
Hashable -
NSAccessibility -
NSAccessibilityButton -
NSAccessibilityElementProtocol -
NSAnimatablePropertyContainer -
NSAppearanceCustomization -
NSCoding -
NSDraggingDestination -
NSObjectProtocol -
NSUserInterfaceItemIdentification -
NSUserInterfaceValidations -
Печатаемый -
Reflectable -
NSAccessibility -
NSAccessibilityButton -
NSAccessibilityElement -
NSAnimatablePropertyContainer -
NSAppearanceCustomization -
NSCoding -
NSDraggingDestination -
NSObject -
NSUserInterfaceItemIdentification -
NSUserInterfaceValidations
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
-
Возвраты
NSPopUpButtonобъект, инициализированный к указанным размерностям.Объявление
Swift
init(frameframeRect: NSRect, pullsDownflag: Bool)Objective C
- (instancetype)initWithFrame:(NSRect)frameRectpullsDown:(BOOL)flagПараметры
frameRectПрямоугольник кадра для кнопки, указанной в системе координат родительского представления.
flagYEStrueесли Вы хотите, чтобы получатель вывел на экран выпадающее меню; иначе,NOfalseесли Вы хотите, чтобы он вывел на экран всплывающее меню.Возвращаемое значение
Инициализированный
NSPopUpButtonобъект, илиnilесли не мог бы быть инициализирован объект.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Булево значение, указывающее, выводит ли кнопка на экран выпадающее или всплывающее меню.
Объявление
Swift
var pullsDown: BoolObjective C
@property BOOL pullsDownОбсуждение
Когда значение этого свойства
YEStrue, кнопка выводит на экран выпадающее меню; иначе, это выводит на экран всплывающее меню. Это свойство не влияет на содержание меню; это влияет только на стиль меню.Когда изменение типа меню к выпадающему меню, если меню было всплывающим меню и ячейкой, изменяет состояние своих выбранных пунктов, этот метод устанавливает состояние в настоящее время выбранный пункт к
NSStateOffпрежде, чем изменить тип меню.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
autoenablesItems autoenablesItemsСвойствоПроисходит булево значение, указывающее, разрешает ли кнопка и отключает свои элементы каждый раз пользовательское событие.
Объявление
Swift
var autoenablesItems: BoolObjective C
@property BOOL autoenablesItemsОбсуждение
Когда значение этого свойства
YEStrue, пользовательские события заставляют кнопку включать и отключать свои элементы автоматически согласноNSMenuValidationспецификация протокола.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Добавляет элемент с указанным заголовком до конца меню.
Объявление
Swift
func addItemWithTitle(_title: String)Objective C
- (void)addItemWithTitle:(NSString *)titleПараметры
titleЗаголовок записи пункта меню. Если элемент с тем же заголовком уже существует в меню, существующий элемент удален, и новый добавляется.
Обсуждение
Если Вы хотите переместить элемент, лучше вызвать
removeItemWithTitle:явно и затем отправьте этот метод. После добавления элемента, это вызовы методаsynchronizeTitleAndSelectedItemметод для проверки элемента, выводимого на экран соответствия в настоящее время выбранный пункт.Так как этот метод ищет двойные элементы, он не должен использоваться, если Вы добавляете элемент к уже заполненному меню больше чем с несколькими сотнями элементов. Добавьте элементы непосредственно к меню получателя вместо этого.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Добавляют многократные элементы до конца меню.
Объявление
Swift
func addItemsWithTitles(_itemTitles: [AnyObject])Objective C
- (void)addItemsWithTitles:(NSArray *)itemTitlesПараметры
itemTitlesМассив
NSStringобъекты, содержащие заголовки элементов, Вы хотите добавить. Каждая строка в массиве должна быть уникальной. Если элемент с тем же заголовком уже существует в меню, существующий элемент удален, и новый добавляется.Обсуждение
Если Вы хотите переместить элемент, лучше вызвать
removeItemWithTitle:явно и затем отправьте этот метод. После добавления элементов этот метод используетsynchronizeTitleAndSelectedItemметод для проверки элемента, выводимого на экран соответствия в настоящее время выбранный пункт.Так как этот метод ищет двойные элементы, он не должен использоваться, если Вы добавляете элементы к уже заполненному меню больше чем с несколькими сотнями элементов. Добавьте элементы непосредственно к меню получателя вместо этого.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Вставляет элемент в указанной позиции в меню.
Объявление
Параметры
titleЗаголовок нового элемента. Если элемент с тем же заголовком уже существует в меню, существующий элемент удален, и новый добавляется
indexОснованный на нуле индекс, в котором можно вставить элемент. Указание 0 вставляет элемент наверху меню.
Обсуждение
Если Вы хотите переместить элемент, лучше вызвать
removeItemWithTitle:явно и затем отправьте этот метод. После добавления элемента этот метод используетsynchronizeTitleAndSelectedItemметод для проверки элемента выводил на экран соответствия в настоящее время выбранный пункт.Так как этот метод ищет двойные элементы, он не должен использоваться, если Вы добавляете элемент к уже заполненному меню больше чем с несколькими сотнями элементов. Добавьте элементы непосредственно к меню получателя вместо этого.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Удаляет все элементы в меню элемента получателя.
Объявление
Swift
func removeAllItems()Objective C
- (void)removeAllItemsОбсуждение
После удаления элементов этот метод использует
synchronizeTitleAndSelectedItemметод для обновления меню.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Удаляет элемент с указанным заголовком из меню.
Объявление
Swift
func removeItemWithTitle(_title: String)Objective C
- (void)removeItemWithTitle:(NSString *)titleПараметры
titleЗаголовок элемента Вы хотите удалить. Если никакой пункт меню не существует с указанным заголовком, этот метод инициировал утверждение.
Обсуждение
Этот метод удаляет первый элемент, который он находит с указанным именем. Этот метод тогда использует
synchronizeTitleAndSelectedItemобновить меню.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Удаляет элемент в указанном индексе.
Объявление
Swift
func removeItemAtIndex(_index: Int)Objective C
- (void)removeItemAtIndex:(NSInteger)indexПараметры
indexОснованный на нуле индекс, указывающий, который элемент удалить. Указание 0 удаляет элемент наверху меню.
Обсуждение
После удаления элемента этот метод использует
synchronizeTitleAndSelectedItemметод для проверки заголовка выводил на экран соответствия в настоящее время выбранный пункт.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
selectedItem selectedItemСвойствоПункт меню, в последний раз выбранный пользователем. (только для чтения)
Объявление
Swift
var selectedItem: NSMenuItem? { get }Objective C
@property(readonly, strong) NSMenuItem *selectedItemОбсуждение
Последний выбранный пункт меню является тем, выделенным, когда пользователь отпустил кнопку мыши. Для выбранного пункта выпадающего меню возможно быть своим первым элементом. Если никакой элемент не выбран, значение в этом свойстве
nil.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
titleOfSelectedItem titleOfSelectedItemСвойствоЗаголовок элемента, в последний раз выбранного пользователем. (только для чтения)
Объявление
Swift
var titleOfSelectedItem: String? { get }Objective C
@property(readonly, copy) NSString *titleOfSelectedItemОбсуждение
Если никакой элемент не выбран, значение в этом свойстве
nil.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
indexOfSelectedItem indexOfSelectedItemСвойствоИндекс элемента, в последний раз выбранного пользователем. (только для чтения)
Объявление
Swift
var indexOfSelectedItem: Int { get }Objective C
@property(readonly) NSInteger indexOfSelectedItemОбсуждение
Если никакой элемент не выбран, значение в этом свойстве
-1.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает индекс выбранного пункта.
Объявление
Objective C
- (id)objectValueВозвращаемое значение
Объект (обычно
NSNumberобъект), который отвечает наintValueобменивайтесь сообщениями и содержит индекс выбранного пункта.См. также
-
selectedTag selectedTagСвойствоТег пункта меню, в последний раз выбранного пользователем. (только для чтения)
Объявление
Objective C
@property(readonly) NSInteger selectedTagОбсуждение
Теги являются целыми числами, которые Вы присваиваете элементам для идентификации их в коде. Теги не используются AppKit.
Если никакой пункт меню не выбран, значение в этом свойстве
-1.Оператор импорта
Objective C
@import AppKit;Доступность
Доступный в OS X v10.10 и позже.
-
Выбирает указанный пункт меню.
Объявление
Swift
func selectItem(_anObject: NSMenuItem?)Objective C
- (void)selectItem:(NSMenuItem *)anObjectПараметры
anObjectПункт меню для выбора, или
nilесли Вы хотите отменить выбор всех пунктов меню.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Выбирает элемент в меню в указанном индексе.
Объявление
Swift
func selectItemAtIndex(_index: Int)Objective C
- (void)selectItemAtIndex:(NSInteger)indexПараметры
indexИндекс элемента Вы хотите выбрать, или
-1Вы хотите отменить выбор всех пунктов меню.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Выбирает пункт меню с указанным тегом.
Объявление
Swift
func selectItemWithTag(_tag: Int) -> BoolObjective C
- (BOOL)selectItemWithTag:(NSInteger)tagПараметры
tagТег элемента Вы хотите выбрать.
Возвращаемое значение
YEStrueесли был успешно выбран элемент; иначе,NOfalse.Обсуждение
Если никакой элемент с указанным тегом не найден, этот метод возвраты
NOfalseи оставляет состояние меню без изменений.Вы обычно присваиваете теги пунктам меню от Интерфейсного Разработчика, но можно также присвоить их программно использование
setTag:методNSMenuItem.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.4 и позже.
См. также
-
Выбирает элемент с указанным заголовком.
Объявление
Swift
func selectItemWithTitle(_title: String)Objective C
- (void)selectItemWithTitle:(NSString *)titleПараметры
titleЗаголовок элемента для выбора. Если Вы указываете
nil, пустая строка или строка, не соответствующая заголовок пункта меню, этот метод, отменяет выбор в настоящее время выбранный пункт.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Выбирает элемент в определенном индексе с помощью объектного значения.
Объявление
Objective C
- (void)setObjectValue:(id)objectПараметры
objectNSNumberобъект, содержащий индекс (целое число) элемента, Вы хотите выбрать. Укажите индекс-1 для отмены выбора всех элементов. Можно также использовать объект кромеNSNumberобъект. В этом случае объект должен ответить наintValueметод и возврат надлежащее индексное значение.Обсуждение
См. также
-
Меню связалось с кнопкой всплывающего меню.
Обсуждение
Если другое меню было уже связано с кнопкой всплывающего меню, этот метод выпускает свою ссылку на старое меню.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
numberOfItems numberOfItemsСвойство -
Массив объектов пункта меню связался с кнопкой. (только для чтения)
Объявление
Swift
var itemArray: [AnyObject] { get }Objective C
@property(readonly, copy) NSArray *itemArrayОбсуждение
Это свойство содержит массив
NSMenuItemобъекты, представляющие элементы в меню. Обычно, Вы получаете доступ к пунктам меню с помощью методов и свойств этого класса вместо того, чтобы получить доступ к элементам непосредственно.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает пункт меню в указанном индексе.
Объявление
Swift
func itemAtIndex(_index: Int) -> NSMenuItem?Objective C
- (NSMenuItem *)itemAtIndex:(NSInteger)indexПараметры
indexИндекс элемента Вы хотите.
Возвращаемое значение
Пункт меню, или
nilесли никакой элемент не существует в указанном индексе.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает заголовок элемента в указанном индексе.
Объявление
Параметры
indexИндекс элемента Вы хотите.
Возвращаемое значение
Заголовок элемента или пустая строка, если никакой элемент не существует в указанном индексе.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
itemTitles itemTitlesСвойствоМассив строк, соответствующих заголовкам элементов в меню. (только для чтения)
Объявление
Swift
var itemTitles: [AnyObject] { get }Objective C
@property(readonly, copy) NSArray *itemTitlesОбсуждение
Это свойство содержит массив
NSStringобъекты, каждый из которых содержит заголовок элемента в меню. Порядок заголовков в этом массиве соответствует порядок элементов в меню. Если меню содержит элементы разделителя, массив содержит пустую строку для каждого элемента разделителя.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает пункт меню с указанным заголовком.
Объявление
Swift
func itemWithTitle(_title: String) -> NSMenuItem?Objective C
- (NSMenuItem *)itemWithTitle:(NSString *)titleПараметры
titleЗаголовок пункта меню Вы хотите.
Возвращаемое значение
Пункт меню, или
nilесли никакой элемент с указанным заголовком не существует в меню.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Последний элемент в меню. (только для чтения)
Объявление
Swift
var lastItem: NSMenuItem? { get }Objective C
@property(readonly, strong) NSMenuItem *lastItemОператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает индекс указанного пункта меню.
Объявление
Swift
func indexOfItem(_anObject: NSMenuItem) -> IntObjective C
- (NSInteger)indexOfItem:(NSMenuItem *)anObjectПараметры
anObjectПункт меню, индекс которого Вы хотите.
Возвращаемое значение
Индекс элемента или
-1если не был найден никакой такой элемент.Обсуждение
Этот метод вызывает метод того же имени
NSPopUpButtonCellобъект.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает индекс пункта меню с указанным тегом.
Объявление
Параметры
tagТег пункта меню Вы хотите.
Возвращаемое значение
Индекс элемента или
-1если не был найден никакой элемент с указанным тегом.Обсуждение
Этот метод вызывает метод того же имени
NSPopUpButtonCellобъект.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает индекс элемента с указанным заголовком.
Объявление
Параметры
titleЗаголовок элемента Вы хотите.
Возвращаемое значение
Индекс элемента или
-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если не был найден никакой такой пункт меню.Обсуждение
Представленные объекты переносят некоторое прямое отношение к заголовку или изображению пункта меню; например, элемент назвал «100», мог бы иметь
NSNumberобъект, инкапсулирующий то значение как его представленный объект. Этот метод вызывает метод того же имениNSPopUpButtonCellобъект.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает индекс пункта меню с указанной целью и действием.
Объявление
Swift
func indexOfItemWithTarget(_target: AnyObject?, andActionactionSelector: Selector) -> IntObjective C
- (NSInteger)indexOfItemWithTarget:(id)targetandAction:(SEL)actionSelectorПараметры
targetЦелевой объект связался с пунктом меню.
actionSelectorМетод действия связался с пунктом меню.
Возвращаемое значение
Индекс пункта меню, или
-1если никакой пункт меню не содержит указанную цель и действие.Обсуждение
Если Вы указываете
NULLдляactionSelectorпараметр, индекс первого пункта меню с указанной целью возвращается. Этот метод вызывает метод того же имениNSPopUpButtonCellобъект.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
preferredEdge preferredEdgeСвойствоКрай кнопки, на которой можно вывести на экран меню, когда ограничивается экранное пространство.
Объявление
Swift
var preferredEdge: NSRectEdgeObjective C
@property NSRectEdge preferredEdgeОбсуждение
Возможные значения включают
NSMinXEdge,NSMinYEdge,NSMaxXEdge, илиNSMaxYEdge. Для выпадающих меню поведение по умолчанию состоит в том, чтобы расположить меню под кнопкой. Базовый край соответствует значениюNSMaxYEdgeдля зеркально отраженных представлений илиNSMinYEdgeдля незеркально отраженных представлений. Для большинства всплывающих меню,NSPopUpButtonвозразите пытается показать выбранный пункт непосредственно по кнопке.Оператор импорта
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
- (void)setImage:(NSImage *)anImageПараметры
anImageИзображение для отображения.
Обсуждение
Изображение, выведенное на экран в раскрывающейся ячейке кнопки, взято от выбранного пункта меню (в случае всплывающего меню) или от первого пункта меню (в случае выпадающего меню).
-
Гарантирует, что элемент, выводимый на экран получателем, соглашается с выбранным пунктом.
Объявление
Swift
func synchronizeTitleAndSelectedItem()Objective C
- (void)synchronizeTitleAndSelectedItemОбсуждение
Если нет никакого выбранного пункта, этот метод выбирает первый элемент в меню элемента и устанавливает элемент получателя для соответствия. Для выпадающих меню этот метод удостоверяется, что первый элемент выводится на экран (
NSPopUpButtonCellобъект должен быть установлен использовать выбранный пункт меню, происходящий по умолчанию).Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Отправленный, когда
NSPopUpButtonкогда пользователь собирается выбрать элемент из меню т.е. объект получает событие mouseDown —.Объект уведомления является выбранным
NSPopUpButtonобъект. Это уведомление не содержит auserInfoсловарь.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
