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(itemIdentifier
itemIdentifier
: 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
Цель для получателя.
Обсуждение
Если
target
nil
, панель инструментов вызоветaction
и попытка вызвать действие с первым респондентом и, приводя это к сбою, передает действие цепочка респондента.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– цель
– setAction:
validateToolbarItem:
(NSToolbarValidation
) -
Возвращает действие получателя.
Объявление
Swift
var action: Selector
Objective C
@property SEL action
Возвращаемое значение
Действие получателя.
Обсуждение
Для пользовательских элементов представления отправляет этот метод
action
к представлению, если это отвечает и возвращает результат.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает действие получателя.
Объявление
Swift
var action: Selector
Objective 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
Возвращаемое значение
YES
true
если получатель включен, иначеNO
false
.Обсуждение
Для элемента представления, это вызовы метода
isEnabled
на представлении, если это отвечает и возвращает результат.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Устанавливает включенный флаг получателя.
Объявление
Swift
var enabled: Bool
Objective C
@property(getter=isEnabled) BOOL enabled
Параметры
enabled
YES
true
включить получатель, иначеNO
false
.Обсуждение
Для пользовательского элемента представления, это вызовы метода
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: Bool
Objective C
@property BOOL autovalidates
Возвращаемое значение
YES
true
если получатель автоматически проверен панелью инструментов, иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Устанавливает автоматический флаг проверки получателя.
Объявление
Swift
var autovalidates: Bool
Objective C
@property BOOL autovalidates
Параметры
resistance
YES
true
установить получатель, который автоматически будет проверен панелью инструментов; иначеNO
false
.Обсуждение
По умолчанию
NSToolbar
автоматически вызывает получатель, проверяют метод регулярно. Если Ваш проверять метод является трудоемким, можно отключить автоматическую проверку на на основание элемента панели инструментов.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Возвращает булево значение, указывающее, может ли получатель быть представлен на панели инструментов больше чем на одной позиции.
Объявление
Swift
var allowsDuplicatesInToolbar: Bool { get }
Objective C
@property(readonly) BOOL allowsDuplicatesInToolbar
Возвращаемое значение
YES
true
позволить перетаскивать получатель на панель инструментов больше чем на одной позиции, иначеNO
false
.Обсуждение
Вы используете этот метод путем переопределения его в подклассе, чтобы всегда возвратиться
YES
true
; обычно, Вы не вызвали бы его. По умолчанию, если элемент с тем же идентификатором уже будет на панели инструментов, то позорение его снова эффективно переместит его в новую позицию.Оператор импорта
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;
Константы
-
NSToolbarSeparatorItemIdentifier
NSToolbarSeparatorItemIdentifier
Элемент Разделителя.
В OS X v10.7 и позже значок разделителя был удален из палитр настройки и панели инструментов. Эта константа проигнорирована.
Доступный в OS X v10.0 и позже.
-
NSToolbarSpaceItemIdentifier
NSToolbarSpaceItemIdentifier
Элемент Пространства.
Доступный в OS X v10.0 и позже.
-
NSToolbarFlexibleSpaceItemIdentifier
NSToolbarFlexibleSpaceItemIdentifier
Гибкий элемент Пространства.
Доступный в OS X v10.0 и позже.
-
NSToolbarShowColorsItemIdentifier
NSToolbarShowColorsItemIdentifier
Элемент Цветов. Показывает цветную панель.
Доступный в OS X v10.0 и позже.
-
NSToolbarShowFontsItemIdentifier
NSToolbarShowFontsItemIdentifier
Элемент Шрифтов. Показывает панель шрифта.
Доступный в OS X v10.0 и позже.
-
NSToolbarCustomizeToolbarItemIdentifier
NSToolbarCustomizeToolbarItemIdentifier
Настроить элемент. Показывает палитру настройки.
В OS X v10.7 и позже значок настройки был удален из палитр настройки и панели инструментов. Эта константа проигнорирована.
Доступный в OS X v10.0 и позже.
-
NSToolbarPrintItemIdentifier
NSToolbarPrintItemIdentifier
Элемент Печати. Отправляет
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 };
Константы
-
NSToolbarItemVisibilityPriorityStandard
NSToolbarItemVisibilityPriorityStandard
Приоритет видимости по умолчанию.
Доступный в OS X v10.4 и позже.
-
NSToolbarItemVisibilityPriorityLow
NSToolbarItemVisibilityPriorityLow
Элементы с этим приоритетом будут первыми элементами, которые будут продвинуты к меню переполнения.
Доступный в OS X v10.4 и позже.
-
NSToolbarItemVisibilityPriorityHigh
NSToolbarItemVisibilityPriorityHigh
Элементы с этим приоритетом менее склонны быть продвинутыми к меню переполнения.
Доступный в OS X v10.4 и позже.
-
NSToolbarItemVisibilityPriorityUser
NSToolbarItemVisibilityPriorityUser
Элементы с этим приоритетом являются последними, чтобы быть продвинутыми к меню переполнения. Только пользователь должен установить элементы в этот приоритет.
Доступный в OS X v10.4 и позже.
Обсуждение
Чтобы предложить, чтобы элемент всегда остался видимым, дайте ему значение, больше, чем
NSToolbarItemVisibilityPriorityStandard
, но меньше, чемNSToolbarItemVisibilityPriorityUser
. На конфигурируемых панелях инструментов пользователи могут управлять приоритетом элемента, и приоритет сохраняется автоматически NSToolbar. Эти значения используютсяsetVisibilityPriority:
иvisibilityPriority
методы: -