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(frame
frameRect
: NSRect, pullsDownflag
: Bool)Objective C
- (instancetype)initWithFrame:(NSRect)
frameRect
pullsDown:(BOOL)flag
Параметры
frameRect
Прямоугольник кадра для кнопки, указанной в системе координат родительского представления.
flag
YES
true
если Вы хотите, чтобы получатель вывел на экран выпадающее меню; иначе,NO
false
если Вы хотите, чтобы он вывел на экран всплывающее меню.Возвращаемое значение
Инициализированный
NSPopUpButton
объект, илиnil
если не мог бы быть инициализирован объект.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Булево значение, указывающее, выводит ли кнопка на экран выпадающее или всплывающее меню.
Объявление
Swift
var pullsDown: Bool
Objective C
@property BOOL pullsDown
Обсуждение
Когда значение этого свойства
YES
true
, кнопка выводит на экран выпадающее меню; иначе, это выводит на экран всплывающее меню. Это свойство не влияет на содержание меню; это влияет только на стиль меню.Когда изменение типа меню к выпадающему меню, если меню было всплывающим меню и ячейкой, изменяет состояние своих выбранных пунктов, этот метод устанавливает состояние в настоящее время выбранный пункт к
NSStateOff
прежде, чем изменить тип меню.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
autoenablesItems autoenablesItems
СвойствоПроисходит булево значение, указывающее, разрешает ли кнопка и отключает свои элементы каждый раз пользовательское событие.
Объявление
Swift
var autoenablesItems: Bool
Objective C
@property BOOL autoenablesItems
Обсуждение
Когда значение этого свойства
YES
true
, пользовательские события заставляют кнопку включать и отключать свои элементы автоматически согласно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
Тег элемента Вы хотите выбрать.
Возвращаемое значение
YES
true
если был успешно выбран элемент; иначе,NO
false
.Обсуждение
Если никакой элемент с указанным тегом не найден, этот метод возвраты
NO
false
и оставляет состояние меню без изменений.Вы обычно присваиваете теги пунктам меню от Интерфейсного Разработчика, но можно также присвоить их программно использование
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
Параметры
object
NSNumber
объект, содержащий индекс (целое число) элемента, Вы хотите выбрать. Укажите индекс-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)
target
andAction:(SEL)actionSelector
Параметры
target
Целевой объект связался с пунктом меню.
actionSelector
Метод действия связался с пунктом меню.
Возвращаемое значение
Индекс пункта меню, или
-1
если никакой пункт меню не содержит указанную цель и действие.Обсуждение
Если Вы указываете
NULL
дляactionSelector
параметр, индекс первого пункта меню с указанной целью возвращается. Этот метод вызывает метод того же имениNSPopUpButtonCell
объект.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
preferredEdge preferredEdge
СвойствоКрай кнопки, на которой можно вывести на экран меню, когда ограничивается экранное пространство.
Объявление
Swift
var preferredEdge: NSRectEdge
Objective 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 и позже.