NSStatusItem

NSStatusItem класс представляет отдельные элементы, выведенные на экран в NSStatusBar объект. Экземпляры создаются NSStatusBar метод statusItemWithLength:, который автоматически добавляет новый элемент состояния к строке состояния. Появление и поведение элемента состояния тогда установлены с помощью различного NSStatusItem методы, такой как setTitle: и setAction:.

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

NSObject
NSStatusItem

NSObject
NSStatusItem

Соответствует

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Получение строки состояния элемента

строка состояния - строка состояния

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

Объявление

Swift

unowned(unsafe) var statusBar: NSStatusBar { get }

Objective C

@property(readonly, assign) NSStatusBar *statusBar

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Конфигурирование появления элемента состояния

setTitle: - setTitle: (OS X v10.10)

Устанавливает строку, выведенную на экран в позиции получателя в строке состояния.

Объявление

Swift

var title: String?

Objective C

@property(copy) NSString *title

Обсуждение

Если изображение также установлено, заголовок появляется направо от изображения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– заголовок
– setAttributedTitle:
– setImage:
заголовок - заголовок (OS X v10.10)

Возвращает строку, выведенную на экран в позиции получателя в строке состояния.

Объявление

Swift

var title: String?

Objective C

@property(copy) NSString *title

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– setAttributedTitle:
– setTitle:
setAttributedTitle: - setAttributedTitle: (OS X v10.10)

Устанавливает приписанную строку, выведенную на экран в позиции получателя в строке состояния.

Объявление

Swift

@NSCopying var attributedTitle: NSAttributedString?

Objective C

@property(copy) NSAttributedString *attributedTitle

Обсуждение

Если изображение также установлено, заголовок появляется направо от изображения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– attributedTitle
– setImage:
– setTitle:
attributedTitle - attributedTitle (OS X v10.10)

Возвращает приписанную строку, выведенную на экран в позиции получателя в строке состояния

Объявление

Swift

@NSCopying var attributedTitle: NSAttributedString?

Objective C

@property(copy) NSAttributedString *attributedTitle

Обсуждение

.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– setAttributedTitle:
– setTitle:
– заголовок
setImage: - setImage: (OS X v10.10)

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

Объявление

Swift

var image: NSImage?

Objective C

@property(strong) NSImage *image

Обсуждение

Если заголовок также установлен, изображение появляется налево от заголовка.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– изображение
– setAlternateImage:
– setAttributedTitle:
– setTitle:
изображение - изображение (OS X v10.10)

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

Объявление

Swift

var image: NSImage?

Objective C

@property(strong) NSImage *image

Обсуждение

Возвраты nil если не было установлено изображение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– setImage:
– alternateImage
setAlternateImage: - setAlternateImage: (OS X v10.10)

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

Объявление

Swift

var alternateImage: NSImage?

Objective C

@property(strong) NSImage *alternateImage

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.3 и позже.
Осуждаемый в OS X v10.10.

См. также

– alternateImage
– setImage:
alternateImage - alternateImage (OS X v10.10)

Возвращает дополнительное изображение, выведенное на экран, когда выделяется элемент строки состояния.

Объявление

Swift

var alternateImage: NSImage?

Objective C

@property(strong) NSImage *alternateImage

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.3 и позже.
Осуждаемый в OS X v10.10.

См. также

– setAlternateImage:
– изображение


    
    setLength:
    - setLength:

Устанавливает сумму пространства в строке состояния, которая должна быть выделена получателю.

Объявление

Swift

var length: CGFloat

Objective C

@property CGFloat length

Параметры

len

Если строка состояния является горизонталью, len горизонтальное пространство для выделения. В дополнение к фиксированной длине, len может быть NSSquareStatusItemLength или NSVariableStatusItemLength позволить строке состояния выделять (и корректироваться) пространство или согласно толщине строки состояния или согласно истинному размеру элемента состояния.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– длина
– statusItemWithLength: (NSStatusBar)

длина - длина

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

Объявление

Swift

var length: CGFloat

Objective C

@property CGFloat length

Обсуждение

Если строка состояния является горизонталью, возвращаемое значение является шириной элемента состояния. Помимо физической длины, возвращаемое значение может быть NSSquareStatusItemLength или NSVariableStatusItemLength (см. Константы NSStatusBar), если размер элемента состояния или определяется толщиной строки состояния или позволяется варьироваться согласно истинному размеру элемента состояния, соответственно.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setLength:
statusItemWithLength: (NSStatusBar)
setHighlightMode: - setHighlightMode: (OS X v10.10)

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

Объявление

Swift

var highlightMode: Bool

Objective C

@property BOOL highlightMode

Обсуждение

Значение по умолчанию NOfalse, что означает, что получатель не выделяется, когда по нему щелкают.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– highlightMode
highlightMode - highlightMode (OS X v10.10)

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

Объявление

Swift

var highlightMode: Bool

Objective C

@property BOOL highlightMode

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– setHighlightMode:
setToolTip: - setToolTip: (OS X v10.10)

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

Объявление

Swift

var toolTip: String?

Objective C

@property(copy) NSString *toolTip

Параметры

toolTip

Строка, функционирующая как заголовок элемента состояния.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– подсказка
подсказка - подсказка (OS X v10.10)

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

Объявление

Swift

var toolTip: String?

Objective C

@property(copy) NSString *toolTip

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– setToolTip:

Управление поведением элемента состояния

setEnabled: - setEnabled: (OS X v10.10)

Наборы, позволяют ли получателю реагировать на щелчки.

Объявление

Swift

var enabled: Bool

Objective C

@property(getter=isEnabled) BOOL enabled

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– isEnabled
isEnabled - isEnabled Доступный в OS X v10.0 через OS X v10.9

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

Объявление

Objective C

- (BOOL)isEnabled

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 через OS X v10.9.

См. также

– setEnabled:
setTarget: - setTarget: (OS X v10.10)

Устанавливает целевой объект, в который отправляется сообщение действия получателя, когда щелкают по получателю.

Объявление

Swift

weak var target: AnyObject?

Objective C

@property(weak) id target

Обсуждение

Если получателю установили меню, действие не отправляется в target когда щелкают по получателю; вместо этого, щелчок заставляет меню появляться.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– цель
– setMenu:
цель - цель (OS X v10.10)

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

Объявление

Swift

weak var target: AnyObject?

Objective C

@property(weak) id target

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– setTarget:
– действие
setAction: - setAction: (OS X v10.10)

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

Объявление

Swift

var action: Selector

Objective C

@property SEL action

Обсуждение

Если получателю установили меню, action когда по получателю щелкают, не отправляется в цель; вместо этого, щелчок заставляет меню появляться.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– действие
– setMenu:
действие - действие (OS X v10.10)

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

Объявление

Swift

var action: Selector

Objective C

@property SEL action

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– setAction:
– цель
setDoubleAction: - setDoubleAction: (OS X v10.10)

Устанавливает селектор, отправляющийся в цель получателя, когда дважды щелкают по получателю.

Объявление

Swift

var doubleAction: Selector

Objective C

@property SEL doubleAction

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.10.

См. также

– doubleAction
doubleAction - doubleAction (OS X v10.10)

Возвращает селектор, отправляющийся в цель получателя, когда пользователь дважды щелкает по получателю.

Объявление

Swift

var doubleAction: Selector

Objective C

@property SEL doubleAction

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.10.

См. также

– setDoubleAction:
– цель


    
    sendActionOn (_:)
    - sendActionOn:

(OS X v10.10)

Устанавливает условия, на которых получатель отправляет сообщения действия в свою цель.

Объявление

Swift

func sendActionOn(_ mask: Int) -> Int

Objective C

- (NSInteger)sendActionOn:(NSInteger)mask

Параметры


      mask

Берет один или больше следующих битовых масок, описанных в разделе Constants NSEvent ссылка класса: NSLeftMouseUpMask, NSLeftMouseDownMask, NSLeftMouseDraggedMask, и NSPeriodicMask. Битовое «ИЛИ» многократные битовые маски.

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

Немного маски, содержащей предыдущие настройки. Эта битовая маска использует те же значения, как указано в mask параметр.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Осуждаемый в OS X v10.10.

setMenu: - setMenu:

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

Объявление

Swift

var menu: NSMenu?

Objective C

@property(strong) NSMenu *menu

Параметры

menu

NSMenu возразите для отображения.

Обсуждение

Когда установлено, единственное поведение действия щелчка получателя не используется. Меню может быть удалено путем установки menu к nil.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– меню
– setAction:
– setTarget:
– popUpStatusItemMenu:
меню - меню

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

Объявление

Swift

var menu: NSMenu?

Objective C

@property(strong) NSMenu *menu

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setMenu:
popUpStatusItemMenu (_:) - popUpStatusItemMenu: (OS X v10.10)

Выводит на экран меню под пользовательским элементом строки состояния.

Объявление

Swift

func popUpStatusItemMenu(_ menu: NSMenu)

Objective C

- (void)popUpStatusItemMenu:(NSMenu *)menu

Параметры

menu

NSMenu возразите для отображения.

Обсуждение

Когда пользователь щелкает по элементу, можно использовать этот метод, чтобы заставить всплывающее меню появляться под пользовательским элементом строки состояния. Обратите внимание на то, что представление получателя должно существовать (т.е. это не должно быть nil).

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.3 и позже.
Осуждаемый в OS X v10.10.

См. также

– setMenu:
– setView:

Управление пользовательским представлением

setView: - setView: (OS X v10.10)

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

Объявление

Swift

var view: NSView?

Objective C

@property(strong) NSView *view

Параметры

view

NSView объект, представляющий пользовательское представление.

Обсуждение

Установка пользовательского представления переопределяет все другие появление и настройки поведения, определенные NSStatusItem. Пользовательское представление ответственно за рисование себя и обеспечение его собственных способов поведения, таково как обработка щелчков мышью и отправка сообщений действия.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– представление
представление - представление (OS X v10.10)

Возвращает пользовательское представление, выведенное на экран в позиции получателя в строке состояния.

Объявление

Swift

var view: NSView?

Objective C

@property(strong) NSView *view

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– setView:

Рисование элемента состояния


    
    drawStatusBarBackgroundInRect (_: withHighlight:)
    - drawStatusBarBackgroundInRect:withHighlight:

(OS X v10.10)

Рисует фоновый образец меню для пользовательского элемента строки состояния в образец выделения или регулярном.

Объявление

Swift

func drawStatusBarBackgroundInRect(_ rect: NSRect, withHighlight highlight: Bool)

Objective C

- (void)drawStatusBarBackgroundInRect:(NSRect)rect withHighlight:(BOOL)highlight

Параметры

`rect`	Прямоугольник, определяющий область пользовательского элемента строки состояния.
`highlight`	`YEStrue` нарисовать фоновый образец в стандартном образце выделения, НЕТ не выделить образец..

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Осуждаемый в OS X v10.10.

См. также

– setView: