NSToolbarItem
NSToolbarItem класс определяет каждый элемент, содержавший в окне NSToolbar экземпляр.
В OS X v10.7, если NSToolbarItem имеет экземпляр NSSearchField как его представление, то поле поиска автоматически имеет свой минимальный и максимальный размер, скорректированный к указанным системой стандартным значениям (в настоящее время 140 и 240 точек).
Соответствует
-
AnyObject -
CVarArgType -
Сопоставимый -
Hashable -
NSCopying -
NSObjectProtocol -
NSValidatedUserInterfaceItem -
Печатаемый -
NSCopying -
NSObject -
NSValidatedUserInterfaceItem
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
-
init (itemIdentifier:) - initWithItemIdentifier:Определяемый инициализаторИнициализируйте получатель с данным идентификатором.
Объявление
Swift
init(itemIdentifieritemIdentifier: String)Objective C
- (instancetype)initWithItemIdentifier:(NSString *)itemIdentifierПараметры
itemIdentifierИдентификатор для получателя.
itemIdentifierникогда не замечается пользователями и не должен быть локализован.Обсуждение
Идентификатор используется панелью инструментов и ее делегатом для идентификации вида элемента панели инструментов.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает идентификатор получателя.
Объявление
Swift
var itemIdentifier: String { get }Objective C
@property(readonly, copy) NSString *itemIdentifierВозвращаемое значение
Идентификатор получателя, который был предоставлен в инициализаторе.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает панель инструментов, использующую получатель.
Объявление
Swift
unowned(unsafe) var toolbar: NSToolbar? { get }Objective C
@property(readonly, assign) NSToolbar *toolbarВозвращаемое значение
Панель инструментов, использующая получатель.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает метку получателя.
Возвращаемое значение
Метка получателя, обычно появляющаяся на панели инструментов и на меню переполнения.
Обсуждение
Для обсуждения меток посмотрите Установку Представления Элемента Панели инструментов.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает метку получателя, появляющуюся на панели инструментов.
Параметры
labelМетка получателя, появляющаяся на панели инструментов. Длина метки должна быть надлежащей и не слишком долго. Метка может быть пустой.
Обсуждение
Импликация - то, что панель инструментов нарисует метку для получателя, и перерисовка инициирована этим методом. Панель инструментов отвечает за область меток. Для обсуждения меток посмотрите Установку Представления Элемента Панели инструментов.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает метку, появляющуюся, когда получатель находится в палитре настройки.
Возвращаемое значение
Метка, появляющаяся, когда получатель находится в палитре настройки.
Обсуждение
Элемент должен иметь метку палитры, если палитра настройки должна использоваться, и для большинства элементов разумно установить
paletteLabelбыть тем же значением какlabel. Одна причинаpaletteLabelотличаться отlabelбыл бы то, если это является более дескриптивным; то, если существует нет, другой мог бы бытьlabel.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает метку получателя, появляющуюся, когда это находится в палитре настройки.
Параметры
paletteLabelМетка, появляющаяся, когда получатель находится в палитре настройки.
Обсуждение
Элемент должен иметь метку палитры, если палитра настройки должна использоваться, и для большинства элементов разумно установить
paletteLabelбыть тем же значением какlabel. Одна причинаpaletteLabelотличаться отlabelбыл бы то, если это является более дескриптивным; то, если существует нет, другой мог бы бытьlabel.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Когда получатель выведен на экран на панели инструментов, возвращает подсказку, используемую.
Возвращаемое значение
Когда получатель выведен на экран на панели инструментов, подсказка использовала.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает подсказку, которая будет использоваться, когда получатель выведен на экран на панели инструментов.
Параметры
toolTipСтрока, представляющая подсказку, которая будет использоваться, когда получатель выведен на экран на панели инструментов.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает представление формы меню получателя.
Объявление
Swift
var menuFormRepresentation: NSMenuItem?Objective C
@property(strong) NSMenuItem *menuFormRepresentationВозвращаемое значение
Меню получателя формирует представление.
Обсуждение
По умолчанию, этот метод возвраты
nil, даже при том, что существует представление формы меню по умолчанию.Для обсуждения форм меню посмотрите Установку Представления Элемента Панели инструментов.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает форму меню получателя.
Объявление
Swift
var menuFormRepresentation: NSMenuItem?Objective C
@property(strong) NSMenuItem *menuFormRepresentationПараметры
menuItemФорма меню для получателя.
Обсуждение
Поскольку обсуждение форм меню видит Установку Представления Элемента Панели инструментов.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает тег получателя.
Возвращаемое значение
Тег получателя.
Обсуждение
Можно использовать тег в собственной цели.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает тег получателя.
Параметры
tagТег для получателя.
Обсуждение
Можно использовать тег в собственной цели.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает цель получателя.
Объявление
Swift
weak var target: AnyObject?Objective C
@property(weak) id targetВозвращаемое значение
Цель получателя.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает объект, который получит действие, когда будет выбран элемент панели инструментов.
Объявление
Swift
weak var target: AnyObject?Objective C
@property(weak) id targetПараметры
targetЦель для получателя.
Обсуждение
Если
targetnil, панель инструментов вызоветactionи попытка вызвать действие с первым респондентом и, приводя это к сбою, передает действие цепочка респондента.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
– цель– setAction:validateToolbarItem:(NSToolbarValidation) -
Возвращает действие получателя.
Объявление
Swift
var action: SelectorObjective C
@property SEL actionВозвращаемое значение
Действие получателя.
Обсуждение
Для пользовательских элементов представления отправляет этот метод
actionк представлению, если это отвечает и возвращает результат.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает действие получателя.
Объявление
Swift
var action: SelectorObjective C
@property SEL actionПараметры
actionДействие для получателя.
Обсуждение
Для пользовательского элемента представления, это вызовы метода
setAction:на представлении, если это отвечает.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
isEnabled - isEnabledДоступный в OS X v10.0 через OS X v10.9Возвращает булево значение, указывающее, включен ли получатель.
Объявление
Objective C
- (BOOL)isEnabledВозвращаемое значение
YEStrueесли получатель включен, иначеNOfalse.Обсуждение
Для элемента представления, это вызовы метода
isEnabledна представлении, если это отвечает и возвращает результат.Оператор импорта
Objective C
@import AppKit;Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Устанавливает включенный флаг получателя.
Объявление
Swift
var enabled: BoolObjective C
@property(getter=isEnabled) BOOL enabledПараметры
enabledYEStrueвключить получатель, иначеNOfalse.Обсуждение
Для пользовательского элемента представления, это вызовы метода
setEnabled:на представлении, если это отвечает.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает изображение получателя.
Возвращаемое значение
Изображение получателя.
Обсуждение
Для элемента изображения этот метод возвращает результат нового
setImage:. Для элементов представления, это вызовы методаimageна представлении, если это отвечает и возвращает результат.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает изображение для получателя или представления.
Параметры
imageИзображение для получателя, или представления, если это было уже установлено для получателя.
Обсуждение
Для пользовательского элемента представления (тот, представление которого было уже установлено), это вызовы метода
setImage:на представлении, если это отвечает. Еслиimageсодержит многократные представления,NSToolbarItemвыбирает наиболее соответственно размерное представление при отображении.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает представление получателя.
Возвращаемое значение
Представление получателя.
Обсуждение
Обратите внимание на то, что многие установить/получить методы реализованы вызовами, переведенными к
NSViewобъект, на который ссылается этот атрибут, если объект реагирует на него.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Используйте этот метод для превращения получателя в элемент представления.
Параметры
viewПредставление для получателя.
Обсуждение
Обратите внимание на то, что многие установить/получить методы реализованы вызовами, переведенными к
view, если это реагирует на него.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает минимальный размер получателя.
Возвращаемое значение
Минимальный размер получателя.
Обсуждение
Посмотрите Установку Размера Элемента Панели инструментов для обсуждения размеров элемента.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает минимальный размер получателя в данный размер.
Параметры
sizeМинимальный размер для получателя.
Обсуждение
Посмотрите Установку Размера Элемента Панели инструментов в Темах Программирования Панели инструментов для Какао для обсуждения размеров элемента.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает максимальный размер получателя.
Возвращаемое значение
Максимальный размер получателя.
Обсуждение
Посмотрите Установку Размера Элемента Панели инструментов для обсуждения размеров элемента.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает максимальный размер получателя в данный размер.
Параметры
sizeМаксимальный размер для получателя.
Обсуждение
Посмотрите Установку Размера Элемента Панели инструментов для обсуждения размеров элемента.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает приоритет видимости получателя.
Возвращаемое значение
Приоритет видимости получателя. Возможные значения описаны в
“Item Priority”.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.4 и позже.
См. также
-
Устанавливает приоритет видимости получателя.
Параметры
visibilityPriorityПриоритет видимости для получателя. Значения для
visibilityPriorityописаны в“Item Priority”.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.4 и позже.
См. также
-
Этот метод вызывает панель инструментов получателя во время проверки.
Объявление
Swift
func validate()Objective C
- (void)validateОбсуждение
Можно вызвать этот метод непосредственно при отключении автоматической проверки для элемента — обычно Вы делаете это по причинам производительности, если Ваш код доступа является медленным. Для дальнейшего обсуждения посмотрите Элементы Панели инструментов Проверки.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает булево значение, указывающее, проверен ли получатель автоматически панелью инструментов.
Объявление
Swift
var autovalidates: BoolObjective C
@property BOOL autovalidatesВозвращаемое значение
YEStrueесли получатель автоматически проверен панелью инструментов, иначеNOfalse.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.4 и позже.
См. также
-
Устанавливает автоматический флаг проверки получателя.
Объявление
Swift
var autovalidates: BoolObjective C
@property BOOL autovalidatesПараметры
resistanceYEStrueустановить получатель, который автоматически будет проверен панелью инструментов; иначеNOfalse.Обсуждение
По умолчанию
NSToolbarавтоматически вызывает получатель, проверяют метод регулярно. Если Ваш проверять метод является трудоемким, можно отключить автоматическую проверку на на основание элемента панели инструментов.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.4 и позже.
См. также
-
Возвращает булево значение, указывающее, может ли получатель быть представлен на панели инструментов больше чем на одной позиции.
Объявление
Swift
var allowsDuplicatesInToolbar: Bool { get }Objective C
@property(readonly) BOOL allowsDuplicatesInToolbarВозвращаемое значение
YEStrueпозволить перетаскивать получатель на панель инструментов больше чем на одной позиции, иначеNOfalse.Обсуждение
Вы используете этот метод путем переопределения его в подклассе, чтобы всегда возвратиться
YEStrue; обычно, Вы не вызвали бы его. По умолчанию, если элемент с тем же идентификатором уже будет на панели инструментов, то позорение его снова эффективно переместит его в новую позицию.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
NSToolbarItemопределяет следующие стандартные идентификаторы элемента панели инструментов.Объявление
Swift
var NSToolbarSeparatorItemIdentifier: NSString! var NSToolbarSpaceItemIdentifier: NSString! var NSToolbarFlexibleSpaceItemIdentifier: NSString! var NSToolbarShowColorsItemIdentifier: NSString! var NSToolbarShowFontsItemIdentifier: NSString! var NSToolbarCustomizeToolbarItemIdentifier: NSString! var NSToolbarPrintItemIdentifier: NSString!Objective C
NSString *NSToolbarSeparatorItemIdentifier; NSString *NSToolbarSpaceItemIdentifier; NSString *NSToolbarFlexibleSpaceItemIdentifier; NSString *NSToolbarShowColorsItemIdentifier; NSString *NSToolbarShowFontsItemIdentifier; NSString *NSToolbarCustomizeToolbarItemIdentifier; NSString *NSToolbarPrintItemIdentifier;Константы
-
NSToolbarSeparatorItemIdentifierNSToolbarSeparatorItemIdentifierЭлемент Разделителя.
В OS X v10.7 и позже значок разделителя был удален из палитр настройки и панели инструментов. Эта константа проигнорирована.
Доступный в OS X v10.0 и позже.
-
NSToolbarSpaceItemIdentifierNSToolbarSpaceItemIdentifierЭлемент Пространства.
Доступный в OS X v10.0 и позже.
-
NSToolbarFlexibleSpaceItemIdentifierNSToolbarFlexibleSpaceItemIdentifierГибкий элемент Пространства.
Доступный в OS X v10.0 и позже.
-
NSToolbarShowColorsItemIdentifierNSToolbarShowColorsItemIdentifierЭлемент Цветов. Показывает цветную панель.
Доступный в OS X v10.0 и позже.
-
NSToolbarShowFontsItemIdentifierNSToolbarShowFontsItemIdentifierЭлемент Шрифтов. Показывает панель шрифта.
Доступный в OS X v10.0 и позже.
-
NSToolbarCustomizeToolbarItemIdentifierNSToolbarCustomizeToolbarItemIdentifierНастроить элемент. Показывает палитру настройки.
В OS X v10.7 и позже значок настройки был удален из палитр настройки и панели инструментов. Эта константа проигнорирована.
Доступный в OS X v10.0 и позже.
-
NSToolbarPrintItemIdentifierNSToolbarPrintItemIdentifierЭлемент Печати. Отправляет
printDocument:кfirstResponder.Доступный в OS X v10.0 и позже.
-
-
Когда панель инструментов не имеет достаточного количества пространства для адаптации всем его элементам, это должно продвинуть некоторые элементы в меню переполнения. Эти значения позволяют Вам предлагать приоритет для элемента панели инструментов.
Объявление
Swift
var NSToolbarItemVisibilityPriorityStandard: Int { get } var NSToolbarItemVisibilityPriorityLow: Int { get } var NSToolbarItemVisibilityPriorityHigh: Int { get } var NSToolbarItemVisibilityPriorityUser: Int { get }Objective C
enum { NSToolbarItemVisibilityPriorityStandard = 0, NSToolbarItemVisibilityPriorityLow = -1000, NSToolbarItemVisibilityPriorityHigh = 1000, NSToolbarItemVisibilityPriorityUser = 2000 };Константы
-
NSToolbarItemVisibilityPriorityStandardNSToolbarItemVisibilityPriorityStandardПриоритет видимости по умолчанию.
Доступный в OS X v10.4 и позже.
-
NSToolbarItemVisibilityPriorityLowNSToolbarItemVisibilityPriorityLowЭлементы с этим приоритетом будут первыми элементами, которые будут продвинуты к меню переполнения.
Доступный в OS X v10.4 и позже.
-
NSToolbarItemVisibilityPriorityHighNSToolbarItemVisibilityPriorityHighЭлементы с этим приоритетом менее склонны быть продвинутыми к меню переполнения.
Доступный в OS X v10.4 и позже.
-
NSToolbarItemVisibilityPriorityUserNSToolbarItemVisibilityPriorityUserЭлементы с этим приоритетом являются последними, чтобы быть продвинутыми к меню переполнения. Только пользователь должен установить элементы в этот приоритет.
Доступный в OS X v10.4 и позже.
Обсуждение
Чтобы предложить, чтобы элемент всегда остался видимым, дайте ему значение, больше, чем
NSToolbarItemVisibilityPriorityStandard, но меньше, чемNSToolbarItemVisibilityPriorityUser. На конфигурируемых панелях инструментов пользователи могут управлять приоритетом элемента, и приоритет сохраняется автоматически NSToolbar. Эти значения используютсяsetVisibilityPriority:иvisibilityPriorityметоды: -
