Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы AppKit ссылка класса NSToolbarItem

Опции
Развертывание Target:

На этой странице
Язык:

NSToolbarItem

NSToolbarItem класс определяет каждый элемент, содержавший в окне NSToolbar экземпляр.

В OS X v10.7, если NSToolbarItem имеет экземпляр NSSearchField как его представление, то поле поиска автоматически имеет свой минимальный и максимальный размер, скорректированный к указанным системой стандартным значениям (в настоящее время 140 и 240 точек).

Наследование


Оператор импорта


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 и позже.

    См. также

    – initWithItemIdentifier:

  • Возвращает панель инструментов, использующую получатель.

    Объявление

    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 и позже.

  • Возвращает метку получателя.

    Объявление

    Swift

    var label: String

    Objective C

    @property(copy) NSString *label

    Возвращаемое значение

    Метка получателя, обычно появляющаяся на панели инструментов и на меню переполнения.

    Обсуждение

    Для обсуждения меток посмотрите Установку Представления Элемента Панели инструментов.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

  • Устанавливает метку получателя, появляющуюся на панели инструментов.

    Объявление

    Swift

    var label: String

    Objective C

    @property(copy) NSString *label

    Параметры

    label

    Метка получателя, появляющаяся на панели инструментов. Длина метки должна быть надлежащей и не слишком долго. Метка может быть пустой.

    Обсуждение

    Импликация - то, что панель инструментов нарисует метку для получателя, и перерисовка инициирована этим методом. Панель инструментов отвечает за область меток. Для обсуждения меток посмотрите Установку Представления Элемента Панели инструментов.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

  • Возвращает метку, появляющуюся, когда получатель находится в палитре настройки.

    Объявление

    Swift

    var paletteLabel: String

    Objective C

    @property(copy) NSString *paletteLabel

    Возвращаемое значение

    Метка, появляющаяся, когда получатель находится в палитре настройки.

    Обсуждение

    Элемент должен иметь метку палитры, если палитра настройки должна использоваться, и для большинства элементов разумно установить paletteLabel быть тем же значением как label. Одна причина paletteLabel отличаться от label был бы то, если это является более дескриптивным; то, если существует нет, другой мог бы быть label.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setPaletteLabel:

  • Устанавливает метку получателя, появляющуюся, когда это находится в палитре настройки.

    Объявление

    Swift

    var paletteLabel: String

    Objective C

    @property(copy) NSString *paletteLabel

    Параметры

    paletteLabel

    Метка, появляющаяся, когда получатель находится в палитре настройки.

    Обсуждение

    Элемент должен иметь метку палитры, если палитра настройки должна использоваться, и для большинства элементов разумно установить paletteLabel быть тем же значением как label. Одна причина paletteLabel отличаться от label был бы то, если это является более дескриптивным; то, если существует нет, другой мог бы быть label.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

  • Когда получатель выведен на экран на панели инструментов, возвращает подсказку, используемую.

    Объявление

    Swift

    var toolTip: String?

    Objective C

    @property(copy) NSString *toolTip

    Возвращаемое значение

    Когда получатель выведен на экран на панели инструментов, подсказка использовала.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setToolTip:

  • Устанавливает подсказку, которая будет использоваться, когда получатель выведен на экран на панели инструментов.

    Объявление

    Swift

    var toolTip: String?

    Objective C

    @property(copy) NSString *toolTip

    Параметры

    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 и позже.

    См. также

    – menuFormRepresentation

  • Возвращает тег получателя.

    Объявление

    Swift

    var tag: Int

    Objective C

    @property NSInteger tag

    Возвращаемое значение

    Тег получателя.

    Обсуждение

    Можно использовать тег в собственной цели.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setTag:

  • Устанавливает тег получателя.

    Объявление

    Swift

    var tag: Int

    Objective C

    @property NSInteger tag

    Параметры

    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 и позже.

    См. также

    – setTarget:

  • Устанавливает объект, который получит действие, когда будет выбран элемент панели инструментов.

    Объявление

    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 и позже.

    См. также

    – setAction:

  • Устанавливает действие получателя.

    Объявление

    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

    Возвращаемое значение

    YEStrue если получатель включен, иначе NOfalse.

    Обсуждение

    Для элемента представления, это вызовы метода 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

    YEStrue включить получатель, иначе NOfalse.

    Обсуждение

    Для пользовательского элемента представления, это вызовы метода setEnabled: на представлении, если это отвечает.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – isEnabled

  • Возвращает изображение получателя.

    Объявление

    Swift

    var image: NSImage?

    Objective C

    @property(strong) NSImage *image

    Возвращаемое значение

    Изображение получателя.

    Обсуждение

    Для элемента изображения этот метод возвращает результат нового setImage:. Для элементов представления, это вызовы метода image на представлении, если это отвечает и возвращает результат.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setImage:

  • Устанавливает изображение для получателя или представления.

    Объявление

    Swift

    var image: NSImage?

    Objective C

    @property(strong) NSImage *image

    Параметры

    image

    Изображение для получателя, или представления, если это было уже установлено для получателя.

    Обсуждение

    Для пользовательского элемента представления (тот, представление которого было уже установлено), это вызовы метода setImage: на представлении, если это отвечает. Если image содержит многократные представления, NSToolbarItem выбирает наиболее соответственно размерное представление при отображении.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

  • Возвращает представление получателя.

    Объявление

    Swift

    var view: NSView?

    Objective C

    @property(strong) NSView *view

    Возвращаемое значение

    Представление получателя.

    Обсуждение

    Обратите внимание на то, что многие установить/получить методы реализованы вызовами, переведенными к NSView объект, на который ссылается этот атрибут, если объект реагирует на него.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setView:

  • Используйте этот метод для превращения получателя в элемент представления.

    Объявление

    Swift

    var view: NSView?

    Objective C

    @property(strong) NSView *view

    Параметры

    view

    Представление для получателя.

    Обсуждение

    Обратите внимание на то, что многие установить/получить методы реализованы вызовами, переведенными к view, если это реагирует на него.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

  • Возвращает минимальный размер получателя.

    Объявление

    Swift

    var minSize: NSSize

    Objective C

    @property NSSize minSize

    Возвращаемое значение

    Минимальный размер получателя.

    Обсуждение

    Посмотрите Установку Размера Элемента Панели инструментов для обсуждения размеров элемента.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setMinSize:

  • Устанавливает минимальный размер получателя в данный размер.

    Объявление

    Swift

    var minSize: NSSize

    Objective C

    @property NSSize minSize

    Параметры

    size

    Минимальный размер для получателя.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – minSize

  • Возвращает максимальный размер получателя.

    Объявление

    Swift

    var maxSize: NSSize

    Objective C

    @property NSSize maxSize

    Возвращаемое значение

    Максимальный размер получателя.

    Обсуждение

    Посмотрите Установку Размера Элемента Панели инструментов для обсуждения размеров элемента.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setMaxSize:

  • Устанавливает максимальный размер получателя в данный размер.

    Объявление

    Swift

    var maxSize: NSSize

    Objective C

    @property NSSize maxSize

    Параметры

    size

    Максимальный размер для получателя.

    Обсуждение

    Посмотрите Установку Размера Элемента Панели инструментов для обсуждения размеров элемента.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – maxSize

  • Возвращает приоритет видимости получателя.

    Объявление

    Swift

    var visibilityPriority: Int

    Objective C

    @property NSInteger visibilityPriority

    Возвращаемое значение

    Приоритет видимости получателя. Возможные значения описаны в “Item Priority”.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    – setVisibilityPriority:

  • Устанавливает приоритет видимости получателя.

    Объявление

    Swift

    var visibilityPriority: Int

    Objective C

    @property NSInteger visibilityPriority

    Параметры

    visibilityPriority

    Приоритет видимости для получателя. Значения для visibilityPriority описаны в “Item Priority”.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    – visibilityPriority

  • Этот метод вызывает панель инструментов получателя во время проверки.

    Объявление

    Swift

    func validate()

    Objective C

    - (void)validate

    Обсуждение

    Можно вызвать этот метод непосредственно при отключении автоматической проверки для элемента — обычно Вы делаете это по причинам производительности, если Ваш код доступа является медленным. Для дальнейшего обсуждения посмотрите Элементы Панели инструментов Проверки.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – setEnabled:

  • Возвращает булево значение, указывающее, проверен ли получатель автоматически панелью инструментов.

    Объявление

    Swift

    var autovalidates: Bool

    Objective C

    @property BOOL autovalidates

    Возвращаемое значение

    YEStrue если получатель автоматически проверен панелью инструментов, иначе NOfalse.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    – setAutovalidates:

  • Устанавливает автоматический флаг проверки получателя.

    Объявление

    Swift

    var autovalidates: Bool

    Objective C

    @property BOOL autovalidates

    Параметры

    resistance

    YEStrue установить получатель, который автоматически будет проверен панелью инструментов; иначе 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;

    Константы

    • 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 методы: