NSButtonCell
NSButtonCell
класс является подклассом NSActionCell
используемый для реализации пользовательских интерфейсов кнопок, флажки (переключатели) и переключатели. Это может также использоваться для любой другой области представления, которое это разработано для отправки сообщения в цель, когда щелкнувшийся. NSButton
подкласс NSControl
использует сингл NSButtonCell
.
NSButtonCell
класс реализует пользовательский интерфейс NSButton
.
Установка целого числа, плавания, дважды, или объектного значения NSButtonCell
возразите результатам в вызове к setState:
со значением, преобразованным в целое число. В случае setObjectValue:
, nil
эквивалентно 0, и не -nil
объект, не отвечающий на intValue
устанавливает состояние в 1. Иначе, состояние установлено в объект intValue
. Точно так же запрашивая целое число, плавание, дважды, или объектное значение NSButtonCell
возвращает текущее состояние в требуемом представлении. В случае objectValue
, это NSNumber
содержа YES
true
поскольку на, NO
false
поскольку прочь, и целочисленное значение-1 для смешанного состояния.
Для получения дополнительной информации о поведении NSButtonCell
, посмотрите NSButton
и NSMatrix
спецификации класса и Темы Программирования Кнопки.
Исключения
В его реализации compare:
метод (объявленный в NSCell
), NSButtonCell
повышения NSBadComparisonException
если otherCell
параметр не имеет NSButtonCell
класс.
Наследование
-
NSObject
-
NSCell
-
NSActionCell
-
NSButtonCell
-
NSMenuItemCell
-
NSObject
-
NSCell
-
NSActionCell
-
NSButtonCell
-
NSMenuItemCell
Соответствует
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
-
alternateMnemonic - alternateMnemonic
(OS X v10.8)Возвращает символ в альтернативном заголовке, это отмечено как “мнемосхема клавиатуры”.
Объявление
Objective C
- (NSString *)alternateMnemonic
Возвращаемое значение
Символ в альтернативном заголовке (заголовок вывел на экран на получателе, когда это находится в своем альтернативном состоянии), отмеченный как «мнемосхема клавиатуры».
Обсуждение
Мнемоника не поддерживается в OS X.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
См. также
– alternateMnemonicLocation
– setAlternateTitleWithMnemonic:
mnemonic
(NSCell
) -
alternateMnemonicLocation - alternateMnemonicLocation
(OS X v10.8)Возвращает целое без знака, указывающее символ в альтернативном заголовке, это отмечено как “мнемосхема клавиатуры”.
Объявление
Objective C
- (NSUInteger)alternateMnemonicLocation
Возвращаемое значение
Целое без знака, указывающее символ в альтернативном заголовке (заголовок вывел на экран на получателе, когда это находится в своем альтернативном состоянии), это отмечено как “мнемосхема клавиатуры”. Если альтернативный заголовок не имеет мнемосхемы клавиатуры, возвратов
NSNotFound
.Обсуждение
Мнемоника не поддерживается в OS X.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
-
Возвращает строку, выведенную на экран кнопкой, когда это находится в своем альтернативном состоянии.
Возвращаемое значение
Строка, появляющаяся на кнопке, когда это находится в своем альтернативном состоянии или пустой строке, если получатель не выводит на экран альтернативный заголовок.
Обсуждение
Обратите внимание на то, что некоторые типы кнопки не выводят на экран альтернативный заголовок. По умолчанию альтернативным заголовком кнопки является «Кнопка».
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает заголовок, выведенный на экран кнопкой, когда это находится в своем альтернативном состоянии как приписанная строка.
Объявление
Swift
@NSCopying var attributedAlternateTitle: NSAttributedString
Objective C
@property(copy) NSAttributedString *attributedAlternateTitle
Возвращаемое значение
Приписанная строка, появляющаяся на кнопке, когда это находится в своем альтернативном состоянии или пустой строке, если получатель не выводит на экран альтернативный заголовок.
Обсуждение
Обратите внимание на то, что некоторые типы кнопки не выводят на экран альтернативный заголовок. По умолчанию альтернативным заголовком кнопки является «Кнопка».
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает заголовок, выведенный на экран кнопкой, когда это находится в своем нормальном состоянии как приписанная строка.
Объявление
Swift
@NSCopying var attributedTitle: NSAttributedString
Objective C
@property(copy) NSAttributedString *attributedTitle
Возвращаемое значение
Строка атрибутов, появляющаяся на кнопке, когда это находится в своем нормальном состоянии или пустой приписанной строке, если получатель не выводит на экран заголовок.
Обсуждение
Если кнопка не использует свое альтернативное содержание для выделения или отображения альтернативного состояния, заголовок кнопки всегда выводится на экран. По умолчанию заголовком кнопки является «Кнопка».
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– setAttributedTitle:
– attributedAlternateTitle
– setButtonType:
mnemonic
(NSCell
) -
Устанавливает символ в альтернативном заголовке, который должен быть “мнемосхемой клавиатуры”.
Объявление
Objective C
- (void)setAlternateMnemonicLocation:(NSUInteger)
location
Параметры
location
Целое без знака, указывающее символ в альтернативном заголовке, который должен быть отмечен как «мнемосхема клавиатуры». Если Вы не хотите, чтобы альтернативный заголовок имел мнемосхему клавиатуры, укажите расположение
NSNotFound
.Обсуждение
Мнемоника не поддерживается в OS X.
setAlternateMnemonicLocation:
метод не заставляет ячейку кнопки быть восстановленной.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
-
Устанавливает заголовок дисплеи кнопки, когда это находится в своем альтернативном состоянии.
Параметры
aString
Строка для установки как заголовок кнопки, когда это находится в своем альтернативном состоянии.
Обсуждение
Обратите внимание на то, что некоторые типы кнопки не выводят на экран альтернативный заголовок.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает заголовок дисплеи кнопки, когда это находится в своем альтернативном состоянии к данной строке со встроенной мнемосхемой.
Объявление
Objective C
- (void)setAlternateTitleWithMnemonic:(NSString *)
aString
Параметры
aString
Строка для установки как альтернативный заголовок кнопки, принимая во внимание факт, что встроенное “&\” символ не является литералом, но вместо этого отмечает “мнемосхему клавиатуры альтернативного состояния”.
Обсуждение
Мнемоника не поддерживается в OS X.
Если необходимо,
setAlternateTitleWithMnemonic:
перерисовывает ячейку кнопки. Обратите внимание на то, что некоторые типы кнопки не выводят на экран альтернативный заголовок.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
-
Устанавливает строку дисплеи кнопки, когда это находится в своем альтернативном состоянии к данной приписанной строке.
Объявление
Swift
@NSCopying var attributedAlternateTitle: NSAttributedString
Objective C
@property(copy) NSAttributedString *attributedAlternateTitle
Параметры
aString
Приписанная строка для установки как альтернативный заголовок кнопки.
Обсуждение
Обратите внимание на то, что некоторые типы кнопки не выводят на экран альтернативный заголовок.
Графические атрибуты, установленные на ячейке (
backgroundColor
,alignment
,font
, и т.д.), переопределяются, когда соответствующие свойства установлены для приписанной строки.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает строку дисплеи кнопки, когда это находится в своем нормальном состоянии к данной приписанной строке и перерисовывает кнопку.
Объявление
Swift
@NSCopying var attributedTitle: NSAttributedString
Objective C
@property(copy) NSAttributedString *attributedTitle
Параметры
aString
Приписанная строка для установки как заголовок кнопки.
Обсуждение
Заголовок всегда показывается на кнопках, не использующих их альтернативное содержание при выделении или отображении их альтернативного состояния.
Графические атрибуты, сконфигурированные для ячейки (
backgroundColor
,alignment
,font
, и т.д.), переопределяются, когда соответствующие свойства установлены для приписанной строки.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
setFont: - setFont:
Доступный в OS X v10.0 через OS X v10.9Устанавливает шрифт, используемый для отображения заголовка кнопки и альтернативного заголовка.
Объявление
Objective C
- (void)setFont:(NSFont *)
fontObj
Параметры
fontObj
Объект шрифта указание шрифта для использования.
Обсуждение
Если получатель не имеет никакого заголовка или альтернативного заголовка, этот метод ничего не делает.
Если ячейка кнопки имеет ключевой эквивалент, его шрифт не изменяется, но размер шрифта ключевого эквивалента изменяется для соответствия нового шрифта заголовка.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
– setKeyEquivalentFont:
– setKeyEquivalentFont:size:
font
(NSCell
) -
Когда в ее нормальном состоянии и, при необходимости, перерисовывает содержание получателя, устанавливает заголовок дисплеи кнопки.
Параметры
aString
Строка для установки как заголовок кнопки.
Обсуждение
Заголовок всегда показывается на кнопках, не использующих их альтернативное содержание при выделении или отображении их альтернативного состояния.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
setTitleWithMnemonic: - setTitleWithMnemonic:
(OS X v10.8)Устанавливает заголовок дисплеи кнопки, когда это находится в своем нормальном состоянии к данной строке со встроенной мнемосхемой.
Объявление
Objective C
- (void)setTitleWithMnemonic:(NSString *)
aString
Параметры
aString
Строка для установки как заголовок кнопки, принимая во внимание факт, что встроенное “&\” символ не является литералом, но вместо этого отмечает “мнемосхему клавиатуры альтернативного состояния”. Этот заголовок всегда показывается на кнопках, не использующих их альтернативное содержание при выделении или отображении их альтернативного состояния.
Обсуждение
Если необходимо,
setTitleWithMnemonic:
перерисовывает ячейку кнопки. Мнемоника не поддерживается в OS X.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
См. также
– setAlternateTitleWithMnemonic:
setTitleWithMnemonic:
(NSCell
)setMnemonicLocation:
(NSCell
) -
Возвращает заголовок, выведенный на экран на получателе, когда это находится в своем нормальном состоянии.
Возвращаемое значение
Заголовок, выведенный на экран кнопкой в ее нормальном состоянии или пустой строкой, если кнопка не выводит на экран заголовок.
Обсуждение
Если кнопка не использует свое альтернативное содержание для выделения или отображения альтернативного состояния, этот заголовок всегда выводится на экран. По умолчанию заголовком кнопки является «Кнопка».
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– setTitle:
– alternateTitle
– setButtonType:
mnemonic
(NSCell
)mnemonicLocation
(NSCell
)
-
Возвращает изображение дисплеи кнопки в ее альтернативном состоянии.
Возвращаемое значение
Изображение, выведенное на экран кнопкой, когда это находится в своем альтернативном состоянии, или
nil
если нет никакого дополнительного изображения.Обсуждение
Обратите внимание на то, что некоторые типы кнопки не выводят на экран дополнительное изображение. Кнопки не делают изображений на дисплее по умолчанию.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– setAlternateImage:
– imagePosition
– keyEquivalent
– setButtonType:
image
(NSCell
) -
Возвращает позицию изображения получателя относительно его заголовка.
Объявление
Swift
var imagePosition: NSCellImagePosition
Objective C
@property NSCellImagePosition imagePosition
Возвращаемое значение
Позиция изображения кнопки. Это - одна из позиций изображения, описанных в разделе Constants NSCell.
Обсуждение
Если заголовок выше, ниже, или наложение изображения, или если нет никакого изображения, текст горизонтально центрируется в кнопке.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– setImagePosition:
– setButtonType:
– setTitle:
setImage:
(NSCell
) -
Устанавливает изображение дисплеи кнопки в ее альтернативном состоянии и, при необходимости, перерисовывает его содержание.
Параметры
image
Изображение, выведенное на экран кнопкой, когда это находится в своем альтернативном состоянии.
Обсуждение
Обратите внимание на то, что некоторые типы кнопки не выводят на экран дополнительное изображение.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает позицию изображения получателя относительно его заголовка.
Объявление
Swift
var imagePosition: NSCellImagePosition
Objective C
@property NSCellImagePosition imagePosition
Параметры
aPosition
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает масштабный коэффициент для изображения получателя.
Возвращаемое значение
Масштабный коэффициент для изображения получателя.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Устанавливает масштабный коэффициент для изображения получателя.
Параметры
scaling
Масштабный коэффициент для изображения получателя.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Возвраты ссылкой задержка и периоды интервала для непрерывной кнопки.
Объявление
Swift
func getPeriodicDelay(_
delay
: UnsafeMutablePointer<Float>, intervalinterval
: UnsafeMutablePointer<Float>)Objective C
- (void)getPeriodicDelay:(float *)
delay
interval:(float *)interval
Параметры
delay
По возврату, количество времени (в секундах), который кнопка приостановит прежде, чем начать периодически отправлять сообщения действия в целевой объект. Значения по умолчанию приняты от значений по умолчанию пользователя (максимум 60 секунд); если пользователь не указал значение по умолчанию, это принимает значение по умолчанию к 0,4 секундам.
interval
По возврату, количество времени (в секундах) между каждым сообщением действия. Значения по умолчанию приняты от значений по умолчанию пользователя (максимум 60 секунд); если пользователь не указал значение по умолчанию, это принимает значение по умолчанию к 0,075 секундам.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
isContinuous
isContinuous
(NSCell
) -
Устанавливает задержку сообщения и интервал для получателя.
Объявление
Swift
func setPeriodicDelay(_
delay
: Float, intervalinterval
: Float)Objective C
- (void)setPeriodicDelay:(float)
delay
interval:(float)interval
Параметры
delay
Количество времени (в секундах), который непрерывная кнопка приостановит прежде, чем начать периодически отправлять сообщения действия в целевой объект.
Максимальное значение составляет 60,0 секунды; если большее значение предоставляется, оно проигнорировано, и используются 60,0 секунды.
interval
Количество времени (в секундах) между каждым сообщением действия.
Максимальное значение составляет 60,0 секунды; если большее значение предоставляется, оно проигнорировано, и используются 60,0 секунды.
Обсуждение
Эти значения используются, если получатель сконфигурирован (a
setContinuous:
сообщение) для непрерывной отправки сообщения действия в целевой объект при отслеживании мыши.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
setContinuous:
(NSCell)
-
Возвращает ключевой эквивалентный символ получателя.
Возвращаемое значение
Строка, содержащая ключевой эквивалентный символ кнопки или пустую строку, если Вы не были определены.
Обсуждение
Кнопки не имеют ключевого эквивалента по умолчанию.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращается шрифт раньше рисовал ключевой эквивалент.
Объявление
Swift
var keyEquivalentFont: NSFont?
Objective C
@property(strong) NSFont *keyEquivalentFont
Возвращаемое значение
Объект шрифта описание шрифта раньше рисовал ключевой эквивалент кнопки, или
nil
если получатель не имеет ключевого эквивалента.Обсуждение
Стандартный шрифт совпадает с, который раньше составлял заголовок.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает маску, идентифицирующую модифицирующие клавиши для ключевого эквивалента кнопки.
Объявление
Swift
var keyEquivalentModifierMask: Int
Objective C
@property NSUInteger keyEquivalentModifierMask
Возвращаемое значение
Маска, указывающая модифицирующие клавиши, применяющиеся к ключевому эквиваленту получателя.
Биты маски определяются в
NSEvent.h
. Единственные биты маски, релевантные в кнопке ключевые эквивалентные маски модификатора,NSControlKeyMask
,NSAlternateKeyMask
, иNSCommandKeyMask
биты.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает ключевой эквивалентный символ получателя.
Параметры
aKeyEquivalent
Ключевой эквивалентный символ.
Обсуждение
Этот метод перерисовывает внутреннюю часть получателя, если это выводит на экран ключевой эквивалент вместо изображения. Если позиция изображения установлена в, ключевой эквивалент не выведен на экран
NSNoImage
,NSImageOnly
, илиNSImageOverlaps
; т.е. кнопка должна вывести на экран и свой заголовок и свое «изображение» (ключевой эквивалент в этом случае), и они не должны накладываться.Для отображения ключевого эквивалента на кнопке установите изображение и дополнительное изображение к
nil
, тогда установите эквивалентный ключ, затем установите позицию изображения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает маску, идентифицирующую модифицирующие клавиши для использования с ключевым эквивалентом кнопки.
Объявление
Swift
var keyEquivalentModifierMask: Int
Objective C
@property NSUInteger keyEquivalentModifierMask
Параметры
mask
Маска, указывающая модифицирующие клавиши, которые будут применены к ключевому эквиваленту получателя.
Биты маски определяются в
NSEvent.h
. Единственные биты маски, релевантные в кнопке ключевые эквивалентные маски модификатора,NSControlKeyMask
,NSAlternateKeyMask
, иNSCommandKeyMask
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает шрифт, используемый для рисования ключевого эквивалента, и восстанавливает изображение получателя при необходимости.
Объявление
Swift
var keyEquivalentFont: NSFont?
Objective C
@property(strong) NSFont *keyEquivalentFont
Параметры
fontObj
Объект шрифта указание шрифта для использования для ключевого эквивалента получателя.
Обсуждение
Этот метод ничего не делает, если получатель не имеет ключевого эквивалента связанным с ним.
Стандартный шрифт совпадает с, который раньше составлял заголовок.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Наборы по имени и размер шрифта раньше рисовали ключевой эквивалент.
Объявление
Swift
func setKeyEquivalentFont(_
fontName
: String, sizefontSize
: CGFloat)Параметры
fontName
Имя шрифта для использования для рисования ключевого эквивалента.
fontSize
Размер шрифта для использования для рисования ключевого эквивалента.
Обсуждение
Этот метод восстанавливает изображение получателя при необходимости. Это ничего не делает, если получатель не имеет ключевого эквивалента связанным с ним. Стандартный шрифт совпадает с, который раньше составлял заголовок.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает цвет фона получателя.
Объявление
Swift
@NSCopying var backgroundColor: NSColor?
Objective C
@property(copy) NSColor *backgroundColor
Возвращаемое значение
Цвет фона получателя.
Обсуждение
Цвет фона используется только при рисовании безграничных кнопок.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Выбирает цвет фона получателя.
Объявление
Swift
@NSCopying var backgroundColor: NSColor?
Objective C
@property(copy) NSColor *backgroundColor
Параметры
color
Цвет для использования для фона получателя.
Обсуждение
Цвет фона используется только при рисовании безграничных кнопок.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Возвращает появление границы получателя.
Возвращаемое значение
Постоянное указание стиля внешней панели используется кнопкой. Посмотрите NSBezelStyle для списка возможных значений.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Если получатель имеет тот, устанавливает появление границы.
Параметры
bezelStyle
Постоянное указание внешней панели разрабатывает для использования для кнопки. Это должно быть одним из значений, указанных в NSBezelStyle.
Если получатель не ограничен, стиль внешней панели проигнорирован.
Обсуждение
Кнопка использует штриховку, чтобы быть похожей, что это терпит или продвинутое в. Можно установить штриховку с
setGradientType:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает градиент границы получателя.
Возвращаемое значение
Постоянное указание градиента используется для границы кнопки. Посмотрите NSGradientType для списка возможных значений.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает тип градиента для использования для получателя.
Параметры
gradientType
Постоянное указание градиента для использования для границы кнопки. Это может быть одной из констант, определенных в NSGradientType.
Обсуждение
Если получатель не имеет никакой границы, этот метод не имеет никакого эффекта на свое появление. Вогнутый градиент является самым темным в верхнем левом углу; выпуклый градиент является самым темным в нижнем правом углу. Слабый по сравнению с сильным то, сколько контраста существует между цветами, используемыми в противоположных углах.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает булево значение, указывающее, кажутся ли изображение и текст получателя «тусклыми», когда отключен получатель.
Объявление
Swift
var imageDimsWhenDisabled: Bool
Objective C
@property BOOL imageDimsWhenDisabled
Возвращаемое значение
YES
true
когда кнопка отключена, иначе, если недоступны изображение и текст кнопкиNO
false
.Обсуждение
По умолчанию, все типы кнопки кроме
NSSwitchButton
иNSRadioButton
действительно потускнейте, когда отключено. Когда кнопки типаNSSwitchButton
иNSRadioButton
отключены, только связанный текст потускнел.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Наборы, кажется ли изображение получателя «тусклым», когда отключена ячейка кнопки.
Объявление
Swift
var imageDimsWhenDisabled: Bool
Objective C
@property BOOL imageDimsWhenDisabled
Параметры
flag
YES
true
указать, что изображение кнопки должно потускнеть, когда отключена кнопка.Обсуждение
По умолчанию, все типы кнопки кроме
NSSwitchButton
иNSRadioButton
действительно потускнейте, когда отключено. КогдаNSSwitchButton
s иNSRadioButton
s отключены, только связанный текст потускнел. Настройка по умолчанию для этого условия подтверждена каждый раз, когда Вы вызываетеsetButtonType:
, так обязательно укажите тип ячейки кнопки перед вызовомsetImageDimsWhenDisabled:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
isOpaque - isOpaque
Доступный в OS X v10.0 через OS X v10.9Возвращает булево значение, указывающее, непрозрачен ли получатель.
Объявление
Objective C
- (BOOL)isOpaque
Возвращаемое значение
YES
true
если получатель дистиллирует каждый пиксель в своем кадре, иначеNO
false
.Обсуждение
Ячейка кнопки непрозрачна, только если это не прозрачно и если это имеет границу.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
isTransparent - isTransparent
Доступный в OS X v10.0 через OS X v10.9Возвращает булево значение, указывающее, прозрачен ли получатель.
Объявление
Objective C
- (BOOL)isTransparent
Возвращаемое значение
YES
true
если получатель прозрачен,NO
false
иначе.Обсуждение
Прозрачная кнопка никогда не рисует себя, но она получает события mouseDown и отслеживает мышь должным образом.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Наборы, прозрачен ли получатель.
Объявление
Swift
var transparent: Bool
Objective C
@property(getter=isTransparent) BOOL transparent
Параметры
flag
YES
true
сделать ячейку кнопки прозрачной.Обсуждение
Этот метод перерисовывает получатель при необходимости. Прозрачная кнопка отслеживает мышь и отправляет ее действие, но не рисует. Прозрачная кнопка полезна для повышения чувствительности области на экране так, чтобы действие было отправлено в цель, когда область получает щелчок мышью.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает булево значение, указывающее, выводит ли кнопка на экран свою границу только, когда курсор по ней.
Объявление
Swift
var showsBorderOnlyWhileMouseInside: Bool
Objective C
@property BOOL showsBorderOnlyWhileMouseInside
Возвращаемое значение
YES
true
если граница получателя выведена на экран только, когда курсор по кнопке, и кнопка активна.Обсуждение
По умолчанию, этот метод возвраты
NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Наборы, выведена ли граница получателя на экран только, когда курсор по кнопке.
Объявление
Swift
var showsBorderOnlyWhileMouseInside: Bool
Objective C
@property BOOL showsBorderOnlyWhileMouseInside
Параметры
show
YES
true
вывести на экран границу кнопки только, когда курсор в пределах границы получателя и кнопки, активно.NO
false
продолжать отображать границу, когда курсор является границами внешней кнопки.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвраты отмечают указание, как подсветки кнопки, когда оно получает событие mouseDown.
Объявление
Swift
var highlightsBy: NSCellStyleMask
Objective C
@property NSCellStyleMask highlightsBy
Возвращаемое значение
Логический OR флагов, указывающих путь получатель, выделяется когда это получатели событие mouseDown. Посмотрите раздел Constants NSCell для списка флагов.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает способ, которым получатель выделяется себя, в то время как нажато.
Объявление
Swift
var highlightsBy: NSCellStyleMask
Objective C
@property NSCellStyleMask highlightsBy
Обсуждение
Если оба
NSChangeGrayCellMask
иNSChangeBackgroundCellMask
указаны, оба зарегистрированы, но какое поведение используется, зависит от изображения ячейки кнопки. Если изображение не имеет никакой альфы (прозрачность) данные, если кнопка не имеет никакого изображения, илиNSChangeGrayCellMask
используется. Если изображение действительно имеет альфа-данные,NSChangeBackgroundCellMask
используется; это расположение позволяет цветной подкачке фона показывать через прозрачные пиксели изображения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает способ, которым получатель указывает свое альтернативное состояние.
Объявление
Swift
var showsStateBy: NSCellStyleMask
Objective C
@property NSCellStyleMask showsStateBy
Обсуждение
Если оба
NSChangeGrayCellMask
иNSChangeBackgroundCellMask
указаны, оба зарегистрированы, но фактическое поведение зависит от изображения ячейки кнопки. Если изображение не имеет никакой альфы (прозрачность) данные, если кнопка не имеет никакого изображения, илиNSChangeGrayCellMask
используется. Если изображение существует и имеет альфа-данные,NSChangeBackgroundCellMask
используется; это расположение позволяет цветной подкачке фона показывать через прозрачные пиксели изображения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Наборы, как получатель выделяется, в то время как нажато и как он показывает свое состояние.
Объявление
Swift
func setButtonType(_
aType
: NSButtonType)Objective C
- (void)setButtonType:(NSButtonType)
aType
Параметры
aType
Постоянное указание типа кнопки. Это может быть одной из констант, определенных в NSButtonType.
Обсуждение
setButtonType:
метод восстанавливает изображение получателя перед возвратом.Доступные типы для наиболее распространенных типов кнопки, которые также доступны в Интерфейсном Разработчике; можно сконфигурировать различное поведение с
setHighlightsBy:
иsetShowsStateBy:
методы.Обратите внимание на то, что существует нет
-buttonType
метод. Метод установки устанавливает различные свойства кнопки, вместе устанавливающие поведение типа.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– setAlternateImage:
setImage:
(NSCell
) -
Возвращает флаги, указывающие, как ячейка кнопки показывает свое альтернативное состояние.
Объявление
Swift
var showsStateBy: NSCellStyleMask
Objective C
@property NSCellStyleMask showsStateBy
Возвращаемое значение
Логический OR флагов, указывающих путь получатель, показывает его альтернативное состояние. Посмотрите раздел Constants NSCell для списка флагов.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает звук, это играется, когда пользователь нажимает получатель.
Возвращаемое значение
Когда получатель нажимается, звук играл.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает звук, это играется, когда пользователь нажимает получатель.
Параметры
aSound
Звук для игры, когда нажимается кнопка.
Обсуждение
Звук играется во время события mouseDown, такой как
NSLeftMouseDown
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Рисует границу получателя.
Объявление
Swift
func mouseEntered(_
event
: NSEvent)Objective C
- (void)mouseEntered:(NSEvent *)
event
Параметры
event
Объект-событие сгенерирован движением мыши.
Обсуждение
Этот метод вызывают только, когда курсор переходит на получатель и
showsBorderOnlyWhileMouseInside
возвратыYES
true
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Стирает границу получателя.
Объявление
Swift
func mouseExited(_
event
: NSEvent)Objective C
- (void)mouseExited:(NSEvent *)
event
Параметры
event
Объект-событие сгенерирован движением мыши.
Обсуждение
Этот метод вызывают только, когда курсор отъезжает получатель и
showsBorderOnlyWhileMouseInside
возвратыYES
true
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Моделирует пользователя, щелкающего по получателю с курсором.
Объявление
Swift
func performClick(_
sender
: AnyObject?)Objective C
- (void)performClick:(id)
sender
Параметры
sender
Отправитель сообщения.
Обсуждение
Этот метод по существу выделяет кнопку, отправляет сообщение действия кнопки в целевой объект, и затем не выделяет кнопку.
Если исключение повышено, в то время как целевой объект обрабатывает сообщение действия, кнопка не выделяется, прежде чем исключение распространено из
performClick:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Рисует границу кнопки с помощью текущего стиля внешней панели.
Объявление
Параметры
frame
Ограничительный прямоугольник кнопки.
controlView
Нарисованное управление.
Обсуждение
Когда кнопка перерисовывается, этот метод вызывают автоматически; Вы не должны вызывать его непосредственно.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Рисует изображение, связанное с текущим состоянием кнопки.
Объявление
Параметры
image
Изображение связалось с текущим состоянием кнопки.
frame
Ограничительный прямоугольник кнопки.
controlView
Нарисованное управление.
Обсуждение
Когда кнопка перерисовывается, этот метод вызывают автоматически; Вы не должны вызывать его непосредственно.
Вы указываете основные и дополнительные изображения для Разработчика Интерфейса использования кнопки.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Составляет заголовок кнопки, центрируемый вертикально в указанном прямоугольнике.
Объявление
Swift
func drawTitle(_
title
: NSAttributedString, withFrameframe
: NSRect, inViewcontrolView
: NSView) -> NSRectObjective C
- (NSRect)drawTitle:(NSAttributedString *)
title
withFrame:(NSRect)frame
inView:(NSView *)controlView
Параметры
title
Заголовок кнопки.
frame
Прямоугольник, в котором можно составить заголовок.
controlView
Нарисованное управление.
Возвращаемое значение
Ограничительный прямоугольник для текста заголовка.
Обсуждение
Когда кнопка перерисовывается, этот метод вызывают автоматически; Вы не должны вызывать его непосредственно.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Определите стили внешней панели, используемые
bezelStyle
иsetBezelStyle:
.Объявление
Swift
enum NSBezelStyle : UInt { case RoundedBezelStyle case RegularSquareBezelStyle case ThickSquareBezelStyle case ThickerSquareBezelStyle case DisclosureBezelStyle case ShadowlessSquareBezelStyle case CircularBezelStyle case TexturedSquareBezelStyle case HelpButtonBezelStyle case SmallSquareBezelStyle case TexturedRoundedBezelStyle case RoundRectBezelStyle case RecessedBezelStyle case RoundedDisclosureBezelStyle case InlineBezelStyle }
Objective C
enum { NSRoundedBezelStyle = 1, NSRegularSquareBezelStyle = 2, NSThickSquareBezelStyle = 3, NSThickerSquareBezelStyle = 4, NSDisclosureBezelStyle = 5, NSShadowlessSquareBezelStyle = 6, NSCircularBezelStyle = 7, NSTexturedSquareBezelStyle = 8, NSHelpButtonBezelStyle = 9, NSSmallSquareBezelStyle = 10, NSTexturedRoundedBezelStyle = 11, NSRoundRectBezelStyle = 12, NSRecessedBezelStyle = 13, NSRoundedDisclosureBezelStyle = 14, NSInlineBezelStyle = 15, NSSmallIconButtonBezelStyle = 2 } typedef NSUInteger NSBezelStyle;
Константы
-
RoundedBezelStyle
NSRoundedBezelStyle
Кнопка скругленного прямоугольника, разработанная для текста.
Доступный в OS X v10.0 и позже.
-
RegularSquareBezelStyle
NSRegularSquareBezelStyle
Прямоугольная кнопка с 2 границами точки, разработанными для значков.
Доступный в OS X v10.0 и позже.
-
ThickSquareBezelStyle
NSThickSquareBezelStyle
Прямоугольная кнопка с 3 границами точки, разработанными для значков.
Доступный в OS X v10.0 и позже.
-
ThickerSquareBezelStyle
NSThickerSquareBezelStyle
Прямоугольная кнопка с 4 границами точки, разработанными для значков.
Доступный в OS X v10.0 и позже.
-
DisclosureBezelStyle
NSDisclosureBezelStyle
Стиль внешней панели для использования с треугольником раскрытия.
Для создания треугольника раскрытия установите стиль внешней панели кнопки в
NSDisclosureBezelStyle
и тип кнопки кNSOnOffButton
.Доступный в OS X v10.3 и позже.
-
ShadowlessSquareBezelStyle
NSShadowlessSquareBezelStyle
Подобный
NSRegularSquareBezelStyle
, но не имеет никакой тени, таким образом, можно примкнуть к ячейкам без перекрывающихся теней.Этот стиль использовался бы в палитре инструментов, например.
Доступный в OS X v10.0 и позже.
-
CircularBezelStyle
NSCircularBezelStyle
Круглая кнопка с комнатой для маленького значка или отдельного символа.
Этот стиль имеет и регулярные и маленькие варианты, но большой вариант доступен только в сером в это время.
Доступный в OS X v10.0 и позже.
-
TexturedSquareBezelStyle
NSTexturedSquareBezelStyle
Стиль внешней панели, подходящий для использования с текстурированными (металлическими) окнами.
Доступный в OS X v10.3 и позже.
-
HelpButtonBezelStyle
NSHelpButtonBezelStyle
Круглая кнопка с вопросительным знаком, обеспечивающим стандартный вид кнопки справки.
Доступный в OS X v10.3 и позже.
-
SmallSquareBezelStyle
NSSmallSquareBezelStyle
Стиль внешней панели простого квадрата. Кнопки с помощью этого стиля могут масштабироваться к любому размеру.
Доступный в OS X v10.4 и позже.
-
TexturedRoundedBezelStyle
NSTexturedRoundedBezelStyle
Текстурированный (металлический) стиль внешней панели, подобный по внешности действию Средства поиска (имущество) кнопка.
Высота этой кнопки фиксируется.
Доступный в OS X v10.4 и позже.
-
RoundRectBezelStyle
NSRoundRectBezelStyle
Стиль внешней панели, соответствующий кнопки поиска в Средстве поиска и Почте.
Доступный в OS X v10.4 и позже.
-
RecessedBezelStyle
NSRecessedBezelStyle
Стиль внешней панели, соответствующий расположенные кнопки в Почте, Средстве поиска и Safari.
Доступный в OS X v10.4 и позже.
-
InlineBezelStyle
NSInlineBezelStyle
Встроенный стиль внешней панели содержит существенный раунд - rect, ограничивают фон. Это может использоваться для создания «непрочитанного» индикатора в представлении схемы или другой встроенной кнопки в tableview, таком как кнопка прогресса остановки в панели загрузки. Используйте текст для непрочитанного индикатора и шаблонное изображение для других кнопок.
Доступный в OS X v10.7 и позже.
-
NSSmallIconButtonBezelStyle
NSSmallIconButtonBezelStyle
Этот стиль внешней панели является устаревшим и не должен использоваться.
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.0.
Обсуждение
Для примеров того, как эти стили выведены на экран, посмотрите, что Кнопка Программирует Темы.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
-
Представляйте типы кнопки, которые могут быть указаны с помощью
setButtonType:
.Объявление
Swift
enum NSButtonType : UInt { case MomentaryLightButton case PushOnPushOffButton case ToggleButton case SwitchButton case RadioButton case MomentaryChangeButton case OnOffButton case MomentaryPushInButton }
Objective C
enum { NSMomentaryLightButton = 0, NSPushOnPushOffButton = 1, NSToggleButton = 2, NSSwitchButton = 3, NSRadioButton = 4, NSMomentaryChangeButton = 5, NSOnOffButton = 6, NSMomentaryPushInButton = 7, NSMomentaryPushButton = 0, NSMomentaryLight = 7 }; typedef NSUInteger NSButtonType;
Константы
-
MomentaryLightButton
NSMomentaryLightButton
В то время как кнопка удерживается, показано, как «освещенный», и также “продвинутое в” на экран, если ограничена кнопка.
Этот тип кнопки является лучшим для просто инициирующих действий, поскольку это не показывает свое состояние; это всегда выводит на экран свое нормальное изображение или заголовок. Эту опцию вызывают “Мгновенным Светом” в Инспекторе Кнопки Интерфейсного Разработчика.
Доступный в OS X v10.0 и позже.
-
PushOnPushOffButton
NSPushOnPushOffButton
Если кнопка ограничена, первый щелчок и выделяет и заставляет кнопку быть “продвинутой в”; второй щелчок возвращает его своему нормальному состоянию.
Эту опцию вызывают, “Спешат, Отодвигают” в Инспекторе Кнопки Интерфейсного Разработчика.
Доступный в OS X v10.0 и позже.
-
ToggleButton
NSToggleButton
После первого щелчка кнопка выводит на экран свое дополнительное изображение или заголовок; второй щелчок возвращает кнопку своему нормальному состоянию.
Эту опцию вызывают «Переключателем» в Инспекторе Кнопки Интерфейсного Разработчика.
Доступный в OS X v10.0 и позже.
-
SwitchButton
NSSwitchButton
Этот стиль является вариантом
NSToggleButton
это не имеет никакой границы и используется для представления флажка.Этот тип кнопки доступен как отдельный элемент Библиотеки в Интерфейсном Разработчике.
Доступный в OS X v10.0 и позже.
-
RadioButton
NSRadioButton
Этот стиль подобен
NSSwitchButton
, но это раньше ограничивало выбор к единственному элементу от нескольких.Вы обычно используете этот тип кнопки в группе, сформированной экземпляром
NSMatrix
. В Интерфейсном Разработчике матрица этого типа кнопки доступна как отдельный элемент Библиотеки.Доступный в OS X v10.0 и позже.
-
MomentaryChangeButton
NSMomentaryChangeButton
В то время как кнопка удерживается, дополнительное изображение и альтернативный заголовок выведены на экран.
Когда кнопка не нажимается, нормальное изображение и заголовок выведены на экран. Эту опцию вызывают “Мгновенным Изменением” в Инспекторе Кнопки Интерфейсного Разработчика.
Доступный в OS X v10.0 и позже.
-
OnOffButton
NSOnOffButton
Первый щелчок выделяет кнопку; второй щелчок возвращает его нормальному (невыделенному) состоянию.
Эту опцию вызывают “На Прочь” в Инспекторе Кнопки Интерфейсного Разработчика.
Доступный в OS X v10.0 и позже.
-
MomentaryPushInButton
NSMomentaryPushInButton
В то время как кнопка удерживается, она показана, как «освещенный».
Этот тип кнопки является лучшим для просто инициирующих действий, поскольку это не показывает свое состояние; это всегда выводит на экран свое нормальное изображение или заголовок. Эта опция призвана “Мгновенное Нажатие” в Инспекторе Кнопки Интерфейсного Разработчика.
Этот тип кнопки является значением по умолчанию.
Доступный в OS X v10.0 и позже.
-
NSMomentaryPushButton
NSMomentaryPushButton
В то время как кнопка удерживается, показано, как «освещенный», и также “продвинутое в” на экран, если ограничена кнопка.
Использовать
NSMomentaryLight
вместо этого.Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
-
NSMomentaryLight
NSMomentaryLight
В то время как кнопка удерживается, она показана, как «освещенный».
Использовать
NSMomentaryPushInButton
вместо этого.Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Обсуждение
Для примеров того, как эти типы ведут себя, посмотрите, что Кнопка Программирует Темы.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
-
Укажите градиенты, используемые
gradientType
иsetGradientType:
.Объявление
Swift
enum NSGradientType : UInt { case None case ConcaveWeak case ConcaveStrong case ConvexWeak case ConvexStrong }
Objective C
enum { NSGradientNone = 0, NSGradientConcaveWeak = 1, NSGradientConcaveStrong = 2, NSGradientConvexWeak = 3, NSGradientConvexStrong = 4 }; typedef NSUInteger NSGradientType;
Константы
-
None
NSGradientNone
Нет никакого градиента, таким образом, кнопка выглядит плоской.
Доступный в OS X v10.0 и позже.
-
ConcaveWeak
NSGradientConcaveWeak
Верхний левый угол светло-серый, и нижний правый угол темно-серый, таким образом, кнопка, кажется, нажата в.
Доступный в OS X v10.0 и позже.
-
ConcaveStrong
NSGradientConcaveStrong
Как с
NSGradientConcaveWeak
, верхний левый угол светло-серый, и нижний правый угол темно-серый, но различие между серыми больше, таким образом, появление того, чтобы быть продвинутым в более сильно.Доступный в OS X v10.0 и позже.
-
ConvexWeak
NSGradientConvexWeak
Верхний левый угол темно-серый, и нижний правый угол светло-серый, таким образом, кнопка, кажется, терпит.
Доступный в OS X v10.0 и позже.
-
ConvexStrong
NSGradientConvexStrong
Как с
NSGradientConvexWeak
, верхний левый угол темно-серый, и нижний правый угол светло-серый, но различие между серыми больше, таким образом, появление торчания более сильно.Доступный в OS X v10.0 и позже.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-