NSCell
NSCell
класс обеспечивает механизм для отображения текста или отображает в NSView
объект без издержек полного NSView
подкласс. Это используется в большой степени большей частью NSControl
классы для реализации их внутренних работ.
Определяемые инициализаторы
При разделении на подклассы NSCell
необходимо реализовать все определяемые инициализаторы. Те методы включают init
, initWithCoder:
, initTextCell:
, и initImageCell:
.
Наследование
Соответствует
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
-
Возвраты
NSCell
объект, инициализированный с указанным изображением и набором для имения меню ячейки по умолчанию.Объявление
Swift
init(imageCell
anImage
: NSImage?)Objective C
- (instancetype)initImageCell:(NSImage *)
anImage
Параметры
anImage
Изображение для использования для ячейки. Если этот параметр
nil
, никакое изображение не установлено.Возвращаемое значение
Инициализированный
NSCell
объект, илиnil
если не могла бы быть инициализирована ячейка.Обсуждение
Это - один из четырех определяемых инициализаторов, которые необходимо реализовать при разделении на подклассы. Посмотрите Определяемые Инициализаторы для полного списка.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает объект NSCell, инициализированный с указанной строкой и набором для имения меню ячейки по умолчанию.
Объявление
Swift
init(textCell
aString
: String)Objective C
- (instancetype)initTextCell:(NSString *)
aString
Параметры
aString
Начальная строка для использования для ячейки.
Возвращаемое значение
Инициализированный
NSCell
объект, илиnil
если не могла бы быть инициализирована ячейка.Обсуждение
Если никакой полевой редактор (совместно используемое
NSText
объект), был создан для всехNSCell
объекты, каждый создается.Это - один из четырех определяемых инициализаторов, которые необходимо реализовать при разделении на подклассы. Посмотрите Определяемые Инициализаторы для полного списка.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
objectValue objectValue
СвойствоЗначение ячейки как объект Objective C.
Объявление
Swift
@NSCopying var objectValue: AnyObject?
Objective C
@property(copy) id objectValue
Обсуждение
Чтобы быть значением доступного объекта, ячейка должна иметь средство форматирования, способное к преобразованию объекта к и от его текстового представления. Значение этого свойства
nil
если объект не был присвоен ячейке.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
hasValidObjectValue hasValidObjectValue
СвойствоБулево значение, указывающее, имеет ли ячейка значение доступного объекта. (только для чтения)
Объявление
Swift
var hasValidObjectValue: Bool { get }
Objective C
@property(readonly) BOOL hasValidObjectValue
Обсуждение
Значение этого свойства
YES
true
если ячейка имеет значение доступного объекта илиNO
false
если это не делает. Значение доступного объекта является тем, которое может «понять» средство форматирования ячейки. Объекты, как всегда предполагается, допустимы, если они не отклоняются средством форматирования. Недопустимые объекты могут все еще быть приняты делегатом ячейкиNSControl
объект (использованиеcontrol:didFailToFormatString:errorDescription:
метод делегата).Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Значение ячейки как целое число.
Объявление
Swift
var intValue: Int32
Objective C
@property int intValue
Обсуждение
Используйте
integerValue
свойство вместо этого.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
integerValue integerValue
СвойствоЗначение ячейки как
NSInteger
ввести.Обсуждение
Это свойство использует
objectValue
свойство для доступа к фактическому значению. Если ячейка не является ячейкой типа текста, или ее содержание не является поддающимся сканированию, значение в этом свойстве0
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
stringValue stringValue
СвойствоЗначение ячейки как строка.
Обсуждение
Это свойство использует
objectValue
свойство для доступа к фактическому значению. Если никакое средство форматирования не присваивается ячейке или если средство форматирования не может «перевести» новую строку соответственно, ячейка отмечается как наличие недопустимого объекта. Если объект ячейки неNSString
возразите или не может быть преобразован в одного, это свойство содержит пустую строку. Если ячейка не является ячейкой типа текста, этот метод преобразовывает ее в одну прежде, чем установить объектное значение.Если Вы используете класс, имеющий
attributedStringValue
свойство, ячейка получает строку от того свойства вместо этого.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
doubleValue doubleValue
СвойствоЗначение ячейки как двойная точность число с плавающей точкой.
Обсуждение
Это свойство использует
objectValue
свойство для доступа к фактическому значению. Если ячейка не является ячейкой типа текста, или значение ячейки не является поддающимся сканированию, это свойство содержит значение0
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
floatValue floatValue
СвойствоЗначение ячейки как число одинарной точности с плавающей точкой.
Объявление
Swift
var floatValue: Float
Objective C
@property float floatValue
Обсуждение
Это свойство использует
objectValue
свойство для доступа к фактическому значению. Если ячейка не является ячейкой типа текста, или значение ячейки не является поддающимся сканированию, это свойство содержит значение0
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает значение для указанного атрибута ячеек.
Объявление
Swift
func setCellAttribute(_
aParameter
: NSCellAttribute, tovalue
: Int)Objective C
- (void)setCellAttribute:(NSCellAttribute)
aParameter
to:(NSInteger)value
Параметры
aParameter
Атрибут ячеек, значение которого Вы хотите установить. Атрибуты включают текущее состояние получателя и отключено ли оно, доступно для редактирования, или выделяется.
value
Новое значение для атрибута.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает значение для указанного атрибута ячеек.
Объявление
Swift
func cellAttribute(_
aParameter
: NSCellAttribute) -> IntObjective C
- (NSInteger)cellAttribute:(NSCellAttribute)
aParameter
Параметры
aParameter
Атрибут ячеек, значение которого Вы хотите получить. Атрибуты включают текущее состояние получателя и отключено ли оно, доступно для редактирования, или выделяется.
Возвращаемое значение
Значение для атрибута ячеек, указанного
aParameter
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Тип ячейки.
Обсуждение
Когда Вы изменяете тип ячейки на
NSTextCellType
, ячейка преобразовывает, дает себе заголовок по умолчанию и устанавливает шрифт в системный шрифт в размере по умолчанию. Когда Вы изменяете тип ячейки наNSImageCellType
, тип ячейки не изменяется, пока Вы не присваиваете новое не -nil
отобразите к нему.Для списка возможных типов ячейки посмотрите
NSCellType
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
включенный включенный
СвойствоБулево значение, указывающее, включается ли в настоящее время ячейка.
Объявление
Swift
var enabled: Bool
Objective C
@property(getter=isEnabled) BOOL enabled
Обсуждение
Значение этого свойства
YES
true
когда ячейка включена илиNO
false
когда это отключено. Текст отключенных ячеек является серым. Если ячейка отключена, она не может быть выделена, не поддерживает отслеживание мыши (и таким образом не может участвовать в функциональности цели/действия), и не может быть отредактирован. Однако можно все еще изменить много атрибутов отключенной ячейки программно. (state
свойство, например, все еще работает.)Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
-
allowsUndo allowsUndo
СвойствоБулево значение, указывающее, принимает ли ячейка на себя ответственность за операции отмены.
Объявление
Swift
var allowsUndo: Bool
Objective C
@property BOOL allowsUndo
Обсуждение
Значение этого свойства
YES
true
если ячейка обрабатывает операции отмены сама илиNO
false
если пользовательский менеджер по отмене приложения должен обработать поведение отмены. Подклассы ячейки устанавливают значение этого свойства для указания их предпочтения обработки операций отмены. Например,NSTextFieldCell
использование класса устанавливает это свойство, чтобы указать, что оно обрабатывает операции отмены для отредактированного текста, и другие средства управления устанавливают значение, которое подходяще для их реализации. Не изменяйте значение этого свойства иначе.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Булево значение, указывающее, имеет ли ячейка границу bezeled.
Объявление
Swift
var bezeled: Bool
Objective C
@property(getter=isBezeled) BOOL bezeled
Обсуждение
Значение этого свойства
YES
true
если ячейка имеет границу bezeled илиNO
false
если это не делает. Это свойство является взаимоисключающим сbordered
свойство — т.е. граница ячейки может быть простой или bezeled, но не оба. Изменение значения этого свойства автоматически удаляет любую границу, установленную, независимо от значения, которое Вы присваиваете свойству.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
См. также
-
ограниченный ограниченный
СвойствоБулево значение, указывающее, рисует ли ячейка себя обрисованный в общих чертах с простой границей.
Объявление
Swift
var bordered: Bool
Objective C
@property(getter=isBordered) BOOL bordered
Обсуждение
Значение этого свойства
YES
true
если ячейка имеет простую границу илиNO
false
если это не делает. Это свойство является взаимоисключающим сbezeled
свойство — т.е. граница ячейки может быть простой или bezeled, но не оба. Изменение значения этого свойства автоматически удаляет любую внешнюю панель, установленную, независимо от значения, которое Вы присваиваете свойству.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
См. также
-
непрозрачный непрозрачный
СвойствоБулево значение, указывающее, абсолютно непрозрачна ли ячейка. (только для чтения)
Объявление
Swift
var opaque: Bool { get }
Objective C
@property(getter=isOpaque, readonly) BOOL opaque
Обсуждение
Значение этого свойства
YES
true
если ячейка абсолютно непрозрачна илиNO
false
если это содержит некоторую прозрачность.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
-
controlTint controlTint
СвойствоОттенок управления ячейки.
Обсуждение
Значение по умолчанию этого свойства
NSDefaultControlTint
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
backgroundStyle backgroundStyle
СвойствоСтиль фона ячейки.
Объявление
Swift
var backgroundStyle: NSBackgroundStyle
Objective C
@property NSBackgroundStyle backgroundStyle
Обсуждение
Фон описывает поверхность, на которую нарисована ячейка в
drawWithFrame:inView:
метод. Управление обычно устанавливает значение этого свойства, прежде чем это попросит, чтобы ячейка нарисовала. Ячейка может нарисовать по-другому на основе фоновых характеристик. Например, табличное представление, получающее ячейку в выбранной строке, могло бы установить значение вNSBackgroundStyleDark
. Текстовая ячейка могла бы решить представить свой текст, белый в результате. Индикатор уровня стиля оценки мог бы нарисовать свои звезды, белые вместо серого.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Внутренний стиль фона буфера перемещаемого изображения. (только для чтения)
Объявление
Swift
var interiorBackgroundStyle: NSBackgroundStyle { get }
Objective C
@property(readonly) NSBackgroundStyle interiorBackgroundStyle
Обсуждение
Внутренний стиль фона описывает поверхность, нарисованную на в
drawInteriorWithFrame:inView:
метод. Это часто - то же какbackgroundStyle
, но кнопка, рисующая внешнюю панель, использовала бы различное значение для этого свойства.В пользовательской кнопке с пользовательской внешней панелью можно переопределить это свойство и возвратить различное значение для описания той поверхности. Ячейка, имеющая пользовательское внутреннее получение, могла бы использовать значение этого свойства для выбора изображения, выглядящего хорошим на ячейке.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
allowsMixedState allowsMixedState
СвойствоБулево значение, указывающее, поддерживает ли ячейка три состояния вместо два.
Объявление
Swift
var allowsMixedState: Bool
Objective C
@property BOOL allowsMixedState
Обсуждение
Когда значение этого свойства
YES
true
, ячейка поддерживает три состояния: на, прочь, и смешанный. Когда значениеNO
false
, ячейка поддерживает только на и от состояний.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Следующее состояние ячейки. (только для чтения)
Обсуждение
Если ячейка имеет три состояния, она циклически повторяется в этом порядке: на, прочь, смешанный, на, прочь, и т.д. Если ячейка имеет только два состояния, она переключается между ними.
Для списка констант, представляющих возможные состояния ячейки, посмотрите
NSCellStateValue
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Состояние ячейки изменений к следующему значению в последовательности.
Объявление
Swift
func setNextState()
Objective C
- (void)setNextState
Обсуждение
Если ячейка имеет три состояния, она циклически повторяется в этом порядке: на, прочь, смешанный, на, прочь, и т.д. Если ячейка имеет только два состояния, она переключается между ними.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Текущее состояние ячейки.
Обсуждение
NSOffState
состояние указывает нормальное или ненажатое состояние.NSOnState
состояние указывает альтернативное или нажатое состояние.NSMixedState
состояние указывает, что функция, представленная управлением, имеет силу где-нибудь.Несмотря на то, что использование перечислимых констант предпочтено, можно также присвоить целочисленное значение этому свойству. Если ячейка имеет два состояния,
0
обрабатывается какNSOffState
, и ненулевое значение обрабатывается какNSOnState
. Если ячейка имеет три состояния,0
обрабатывается какNSOffState
, отрицательная величина обрабатывается какNSMixedState
, и положительное значение обрабатывается какNSOnState
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Булево значение, указывающее, доступна ли ячейка для редактирования.
Объявление
Swift
var editable: Bool
Objective C
@property(getter=isEditable) BOOL editable
Обсуждение
Когда значение этого свойства
YES
true
, ячейка доступна для редактирования. Когда значениеYES
true
, текст ячейки также сделан можно выбрать. Когда Вы изменяете значение свойства кNO
false
,selectable
свойство восстанавливается значению, которое оно имело, прежде чем ячейка была сделана доступной для редактирования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
-
можно выбрать можно выбрать
СвойствоБулево значение, указывающее, может ли быть выбран текст ячейки.
Объявление
Swift
var selectable: Bool
Objective C
@property(getter=isSelectable) BOOL selectable
Обсуждение
Когда значение этого свойства
YES
true
, текст ячейки можно выбрать. Установка значения этого свойства кNO
false
также наборыeditable
свойство кNO
false
. Если значение этой ячейкиYES
true
, значение вeditable
свойство не затронуто.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
-
Булево значение, указывающее, прокручивает ли избыточный текст мимо границ ячейки.
Объявление
Swift
var scrollable: Bool
Objective C
@property(getter=isScrollable) BOOL scrollable
Обсуждение
Когда значение этого свойства
YES
true
, текст может быть прокручен мимо ячейки, связал. Когда значениеNO
false
, ячейка обертывает свой текст.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
-
выравнивание выравнивание
СвойствоВыравнивание текста ячейки.
Обсуждение
Значение по умолчанию этого свойства
NSNaturalTextAlignment
. Для списка возможных выравниваний текста посмотритеNSTextAlignment
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Шрифт, что использование ячейки для отображения текста.
Обсуждение
Значение этого свойства
nil
если ячейка не является ячейкой типа текста. Присвоение нового объекта шрифта к этому свойству преобразовывает ячейку в ячейку типа текста, если это уже не один.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
lineBreakMode lineBreakMode
СвойствоРежим разрыва строки для использования при рисовании текста в ячейке.
Объявление
Swift
var lineBreakMode: NSLineBreakMode
Objective C
@property NSLineBreakMode lineBreakMode
Обсуждение
Значение в этом свойстве может также быть изменено при изменении значения
wraps
свойство. Для списка поддерживаемых режимов разрыва строки посмотритеNSLineBreakMode
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Булево значение, указывающее, усекает ли ячейка текст, не соответствующий в границах ячейки.
Объявление
Swift
var truncatesLastVisibleLine: Bool
Objective C
@property BOOL truncatesLastVisibleLine
Обсуждение
Когда значение этого свойства
YES
true
, когда текст не соответствует, ячейка усекает текст и добавляет символ замещающего знака к последней видимой строке. Значение вlineBreakMode
свойство должно бытьNSLineBreakByWordWrapping
илиNSLineBreakByCharWrapping
для этой опции иметь любой эффект.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Булево значение, указывающее, обертывает ли ячейка текст, длина которого, превышающая кадр ячейки.
Объявление
Swift
var wraps: Bool
Objective C
@property BOOL wraps
Обсуждение
Когда значение этого свойства
YES
true
, ячейка обертывает текст и делает ячейку без возможности прокрутки. Если текст ячейки является приписанным строковым значением, необходимо явно установить режим разрыва строки стиля абзаца. Установка значения этого свойства кYES
true
эквивалентно установкеlineBreakMode
свойство кNSLineBreakByWordWrapping
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
baseWritingDirection baseWritingDirection
СвойствоНачальное направление записи раньше определяло фактическое направление записи для текста.
Объявление
Swift
var baseWritingDirection: NSWritingDirection
Objective C
@property NSWritingDirection baseWritingDirection
Обсуждение
Значение по умолчанию этого свойства
NSWritingDirectionNatural
. Текстовая система использует это значение в качестве подсказки для вычисления фактического направления для отображения символов Unicode. Если Вы знаете направление записи основы текста, Вы представляете, можно установить значение этого свойства к корректному направлению для помощи текстовой системе.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Значение ячейки как приписанная строка.
Объявление
Swift
@NSCopying var attributedStringValue: NSAttributedString
Objective C
@property(copy) NSAttributedString *attributedStringValue
Обсуждение
Используйте это свойство для получения значения ячейки, интерпретируемой как приписанная строка. Текстовые атрибуты, включенные в строку, являются стилем абзаца по умолчанию, шрифтом ячейки и выравниванием, и включена ли ячейка и с возможностью прокрутки.
При установке значения этого свойства, если ячейка имеет средство форматирования, но средство форматирования не понимает приписанную строку, средство форматирования отмечает объект ячейки как недопустимый. Если получатель не является ячейкой типа текста, он преобразовывается в один, прежде чем будет установлено значение.
Если Вы используете класс, имеющий
attributedStringValue
свойство, ячейка получает строку от того свойства вместо того, чтобы использоватьstringValue
свойство.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Булево значение, указывающее, позволяет ли ячейка редактирование текстовых атрибутов своего содержания пользователем.
Объявление
Swift
var allowsEditingTextAttributes: Bool
Objective C
@property BOOL allowsEditingTextAttributes
Обсуждение
Когда значение этого свойства
YES
true
, пользователь может изменить шрифт и другие текстовые атрибуты ячейки. Когда значениеNO
false
, пользователь не может отредактировать текст или импортировать графику, эффективно означающую, что ячейка не может поддерживать текст RTFD.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
importsGraphics importsGraphics
СвойствоБулево значение, указывающее, поддерживает ли ячейка импорт изображений в его текст.
Объявление
Swift
var importsGraphics: Bool
Objective C
@property BOOL importsGraphics
Обсуждение
Когда значение этого свойства
YES
true
, ячейка может импортировать изображения в свой текст и поддерживать текстовый формат RTFD.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Конфигурирует текстовые и фоновые атрибуты полевого редактора получателя.
Объявление
Параметры
textObj
Полевой редактор для конфигурирования..
Возвращаемое значение
Сконфигурированный полевой редактор.
Обсуждение
Если получатель отключен, этот метод устанавливает цвет текста в темно-серый; иначе метод устанавливает его в цвет по умолчанию. Если получатель имеет границу bezeled, этот метод устанавливает фон в цвет по умолчанию для фонов текста; иначе, метод устанавливает его в цвет получателя
NSControl
объект.Вы не должны использовать этот метод для замены новым полевым редактором.
setUpFieldEditorAttributes:
предназначается для изменения атрибутов текстового объекта (т.е. полевой редактор) передал в него, и возвратите тот текстовый объект. Если Вы хотите заменить своим собственным полевым редактором, используйтеfieldEditor:forObject:
метод илиwindowWillReturnFieldEditor:toObject:
метод делегатаNSWindow
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Текст заголовка ячейки.
Обсуждение
Это свойство содержит строку для отображения в ячейке. Подклассы (такой как
NSButtonCell
) может использовать заголовок в различной цели.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Действие выполняется ячейкой.
Объявление
Swift
var action: Selector
Objective C
@property SEL action
Обсуждение
Значение этого свойства является селектором для обращения к ячейке
target
объект. Установите значение этого свойства кnil
остановить поставку сообщений действия.Значение по умолчанию этого свойства
nil
. Установка значения этого свойства повышает сNSInternalInconsistencyException
. Подклассы, как ожидают, переопределят это свойство как часть их реализации цели/действия.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Объект, получающий сообщения действия ячейки.
Объявление
Swift
weak var target: AnyObject?
Objective C
@property(weak) id target
Обсуждение
Значение этого свойства является объектом, реализующим селектор, указанный
action
свойство. Установите значение этого свойства кnil
остановить поставку сообщений действия.Значение по умолчанию этого свойства
nil
. Установка значения этого свойства повышает сNSInternalInconsistencyException
. Подклассы, как ожидают, переопределят это свойство как часть их реализации цели/действия.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
непрерывный непрерывный
СвойствоБулево значение, указывающее, отправляет ли ячейка свое сообщение действия постоянно во время отслеживания мыши.
Объявление
Swift
var continuous: Bool
Objective C
@property(getter=isContinuous) BOOL continuous
Обсуждение
Когда значение этого свойства ДА, сообщение действия ячейки отправляется постоянно во время отслеживания мыши. На практике непрерывная поставка сообщений действия имеет значение только для
NSActionCell
и его подклассы, реализующие механизм цели/действия. НекоторыеNSControl
подклассы, особенноNSMatrix
, отправьте действие по умолчанию в цель по умолчанию, когда ячейка не обеспечит цель или действие.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
См. также
-
Устанавливает условия, на которых получатель отправляет сообщения действия в свою цель.
Объявление
Параметры
mask
Немного маски, содержащей условия для отправки действия. Фактически проверяющиеся единственные условия связаны с
NSLeftMouseDownMask
,NSLeftMouseUpMask
,NSLeftMouseDraggedMask
, иNSPeriodicMask
биты.Возвращаемое значение
Немного маски, содержащей предыдущие настройки. Эта битовая маска использует те же значения, как указано в
mask
параметр.Обсуждение
Вы используете этот метод во время отслеживания мыши, когда кнопка мыши изменяет состояние, перемещения мыши, или если ячейка отмечена для отправки ее действия постоянно при отслеживании. Из-за этого зарегистрировались в единственных битах
mask
NSLeftMouseDownMask
,NSLeftMouseUpMask
,NSLeftMouseDraggedMask
, иNSPeriodicMask
, которые объявляются вNSEvent
ссылка класса.Можно использовать
continuous
свойство для включения соответствия флагаNSPeriodicMask
илиNSLeftMouseDraggedMask
, какой бы ни является надлежащим данному подклассуNSCell
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
изображение изображение
СвойствоИзображение, выведенное на экран ячейкой, если таковые имеются.
Обсуждение
Установка значения этого свойства преобразовывает ячейку в ячейку типа изображения, если это уже не то. Значение этого свойства
nil
если ячейка не является ячейкой типа изображения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Тег для идентификации ячейки.
Обсуждение
Теги позволяют Вам идентифицировать определенные ячейки. Значения тега не используются внутренне AppKit. Вы обычно устанавливаете значения тега в Интерфейсном Разработчике и используете их во время выполнения в Вашем приложении. При установке тега управления с отдельной ячейкой в Интерфейсном Разработчике он устанавливает теги и управления и ячейки к тому же значению как удобство.
Значение по умолчанию этого свойства
-1
. Установка значения этого свойства повышает сNSInternalInconsistencyException
. Подклассы, как ожидают, переопределят это свойство если они вспомогательные тэги.NSActionCell
класс реализует это свойство и хранит целое число, которое Вы указываете.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Объект средства форматирования ячейки.
Объявление
Swift
var formatter: AnyObject?
Objective C
@property(strong) id formatter
Обсуждение
Средство форматирования обрабатывает перевод содержания получателя между его экранным представлением и его объектным значением. Ячейки используют объект средства форматирования отформатировать текстовое представление их объектного значения и проверить ввод ячейки и преобразовать тот ввод в объектное значение. При присвоении нового средства форматирования ячейке средство форматирования пытается интерпретировать текущую стоимость ячейки. Если это не может сделать так, средство форматирования преобразовывает текущую стоимость в строковый объект.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает меню по умолчанию для экземпляров ячейки.
Возвращаемое значение
Меню по умолчанию.
NSCell
реализация этого метода возвратыnil
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Контекстное меню ячейки.
Обсуждение
Используйте это свойство для указания меню, содержащего контекстные команды, связанные с ячейкой. Если ячейка не имеет меню, установите это свойство в
nil
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает меню, связанное с ячейкой и связанное с указанным событием и кадром.
Объявление
Параметры
anEvent
Событие раньше находило меню.
cellFrame
Прямоугольник ячейки. Этот прямоугольник указывает область, содержащую курсор.
aView
Представление, управляющее ячейкой. Это обычно - объект управления, которому принадлежит ячейка.
Возвращаемое значение
Меню связалось с ячейкой и параметрами события, или
nil
если не установлено никакое меню.Обсуждение
Этот метод обычно вызывается
NSControl
объект (aView
) управление получателем. Реализация по умолчанию получает значениеmenu
свойство и возвратыnil
если не было установлено никакое меню. Подклассы могут переопределить для настройки возвращенного меню согласно полученному событию и область, в которой происходит событие от нажатия мыши.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Сравнивает строковые значения получателя другая ячейка, игнорируя случай.
Объявление
Swift
func compare(_
otherCell
: AnyObject) -> NSComparisonResultObjective C
- (NSComparisonResult)compare:(id)
otherCell
Параметры
otherCell
Ячейка для сравнения с получателем. Этот параметр должен иметь тип
NSCell
; если это не, этот метод повышенияNSBadComparisonException
.Это значение не должно быть
nil
. Если значениеnil
, поведение не определено и может измениться в будущих версиях OS X.Возвращаемое значение
NSOrderedAscending
если строковое значение получателя предшествует строковому значениюotherCell
в лексическом упорядочивании,NSOrderedSame
если строковые значения эквивалентны в лексическом значении, иNSOrderedDescending
строковое значение получателя следует за строковым значениемotherCell
в лексическом упорядочивании.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Булево значение, указывающее, принимает ли ячейка первое состояние респондента. (только для чтения)
Объявление
Swift
var acceptsFirstResponder: Bool { get }
Objective C
@property(readonly) BOOL acceptsFirstResponder
Обсуждение
Когда значение этого свойства
YES
true
, ячейка в состоянии стать первым респондентом. Значение по умолчанию этого свойстваYES
true
когда включена ячейка. Подклассы могут переопределить этот метод для возврата различного значения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
showsFirstResponder showsFirstResponder
СвойствоБулево значение, указывающее, обеспечивает ли ячейка визуальную индикацию, что это - первый респондент.
Объявление
Swift
var showsFirstResponder: Bool
Objective C
@property BOOL showsFirstResponder
Обсуждение
Когда значение этого свойства
YES
true
и ячейка становится первым респондентом, ячейка выполняет дополнительное получение, чтобы указать, что это - первый респондент.NSCell
сам класс не рисует индикатор первого респондента. Подклассы могут использовать значение в этом свойстве, чтобы определить, должны ли они нарисовать тот.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Булево значение, указывающее, отказывается ли ячейка от первого состояния респондента.
Объявление
Swift
var refusesFirstResponder: Bool
Objective C
@property BOOL refusesFirstResponder
Обсуждение
Установите значение этого свойства к
YES
true
препятствовать тому, чтобы ячейка стала первым респондентом. Чтобы определить, может ли ячейка стать первым респондентом прямо сейчас, получите значениеacceptsFirstResponder
свойство.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Моделирует единственный щелчок мышью по получателю.
Объявление
Swift
func performClick(_
sender
: AnyObject?)Objective C
- (void)performClick:(id)
sender
Параметры
sender
Объект использовать в качестве отправителя события (если представление управления получателя не допустимо). Этот объект должен быть подклассом
NSView
.Обсуждение
Этот метод выполняет действие получателя со своей целью. Получателю нужно позволить выполнить действие. Если представление управления получателя допустимо, то представление используется в качестве отправителя; иначе, значение в
sender
используется.Получатель этого сообщения должен быть ячейкой типа
NSActionCell
. Если сообщение действия не может быть успешно отправлено, этот метод повышает исключение.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает значение ячейки получателя к объектному значению, полученному из указанного объекта.
Объявление
Swift
func takeObjectValueFrom(_
sender
: AnyObject?)Objective C
- (void)takeObjectValueFrom:(id)
sender
Параметры
sender
Объект, от которого можно принять значение. Этот объект должен поддерживать
objectValue
свойство.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает значение ячейки получателя к целочисленному значению, полученному из указанного объекта.
Объявление
Swift
func takeIntegerValueFrom(_
sender
: AnyObject?)Objective C
- (void)takeIntegerValueFrom:(id)
sender
Параметры
sender
Объект, от которого можно принять значение. Этот объект должен реализовать
integerValue
свойство.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Устанавливает значение ячейки получателя к целочисленному значению, полученному из указанного объекта.
Объявление
Swift
func takeIntValueFrom(_
sender
: AnyObject?)Objective C
- (void)takeIntValueFrom:(id)
sender
Параметры
sender
Объект, от которого можно принять значение. Этот объект должен реализовать
intValue
свойство.Обсуждение
Используйте
takeIntegerValueFrom:
метод вместо этого.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает значение ячейки получателя к строковому значению, полученному из указанного объекта.
Объявление
Swift
func takeStringValueFrom(_
sender
: AnyObject?)Objective C
- (void)takeStringValueFrom:(id)
sender
Параметры
sender
Объект, от которого можно принять значение. Этот объект должен реализовать
stringValue
свойство.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает значение ячейки получателя к двойной точности значение с плавающей точкой, полученное из указанного объекта.
Объявление
Swift
func takeDoubleValueFrom(_
sender
: AnyObject?)Objective C
- (void)takeDoubleValueFrom:(id)
sender
Параметры
sender
Объект, от которого можно принять значение. Этот объект должен реализовать
doubleValue
свойство.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает значение ячейки получателя к одинарной точности значение с плавающей точкой, полученное из указанного объекта.
Объявление
Swift
func takeFloatValueFrom(_
sender
: AnyObject?)Objective C
- (void)takeFloatValueFrom:(id)
sender
Параметры
sender
Объект, от которого можно принять значение. Этот объект должен реализовать
floatValue
свойство.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
representedObject representedObject
СвойствоОбъект представлен ячейкой.
Объявление
Swift
var representedObject: AnyObject?
Objective C
@property(strong) id representedObject
Обсуждение
Используйте это свойство для соединения ячейки надлежащий объект. Например, в раскрывающемся списке цветных имен, представленный объект каждой ячейки мог быть надлежащим
NSColor
объект.Специальные замечания
Когда Вы копируете
NSCell
объект, значение этого свойства установлено вnil
в копии.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Инициирует поведение отслеживания мыши в ячейке.
Объявление
Параметры
theEvent
Событие, заставившее отслеживание мыши происходить.
cellFrame
Прямоугольник кадра получателя.
controlView
Представление, содержащее получатель. Это обычно
NSControl
объект.untilMouseUp
Если
YES
true
, отслеживание мыши продолжается до разъединений абонентом кнопка мыши. ЕслиNO
false
, отслеживание продолжается, пока курсор не оставляет прямоугольник отслеживания, указанныйcellFrame
параметр, независимо от состояния кнопки мыши. Посмотрите обсуждение для получения дополнительной информации.Возвращаемое значение
YES
true
если условиям отслеживания мыши удовлетворяют, иначеNO
false
.Обсуждение
Этот метод обычно не переопределяется, потому что реализация по умолчанию вызывает другой
NSCell
методы, которые могут быть переопределены для обработки определенных событий в сеансе перетаскивания. Возвращаемое значение этого метода зависит отuntilMouseUp
флаг. ЕслиuntilMouseUp
установлен вYES
true
, этот метод возвратыYES
true
в то время как курсор где угодно, если кнопка мыши восстанавливает работоспособность;NO
false
, иначе. ЕслиuntilMouseUp
установлен вNO
false
, этот метод возвратыYES
true
в то время как курсор в, если кнопка мыши восстанавливает работоспособностьcellFrame
;NO
false
, иначе.Этот метод сначала вызывает
startTrackingAt:inView:
. Если возвращается тот методYES
true
, тогда, поскольку перетащенные мышью события прерываются,continueTracking:at:inView:
вызывается до любого возвраты методаNO
false
или мышь выпущена. Наконец,stopTracking:at:inView:mouseIsUp:
если мышь выпущена, вызывается. ЕслиuntilMouseUp
YES
true
, это вызывается, когда кнопка мыши восстанавливает работоспособность, в то время как курсор где угодно. ЕслиuntilMouseUp
NO
false
, это вызывается, когда кнопка мыши восстанавливает работоспособность, в то время как курсор вcellFrame
. Вы обычно переопределяете один или больше этих методов для ответа на определенные события от нажатия мыши.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Начинает отслеживать события от нажатия мыши в получателе.
Объявление
Параметры
startPoint
Начальное расположение курсора.
controlView
NSControl
объект, управляющий получателем.Возвращаемое значение
YES
true
когда мышь перетаскивается, иначе, если получатель установлен отвечать постоянно или устанавливать для ответаNO
false
.Обсуждение
NSCell
реализацияtrackMouse:inRect:ofView:untilMouseUp:
когда отслеживание начинается, вызывает этот метод. Подклассы могут переопределить этот метод для реализации специального отслеживающего мышь поведения в начале отслеживания мыши — например, выведя на экран специальный курсор.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает булево значение, указывающее, должно ли отслеживание мыши продолжаться в ячейке получения.
Объявление
Параметры
lastPoint
Когда отслеживание началось или предыдущая текущая точка, содержит или начальное расположение курсора.
currentPoint
Текущее расположение курсора.
controlView
NSControl
объект, управляющий получателем.Возвращаемое значение
YES
true
если отслеживание мыши должно продолжаться, иначеNO
false
.Обсуждение
Этот метод вызывается в
trackMouse:inRect:ofView:untilMouseUp:
. Возвраты реализации по умолчаниюYES
true
если ячейка установлена постоянно отправить сообщения действия в свою цель, когда кнопка мыши снижается, или мышь перетаскивается. Подклассы могут переопределить этот метод для обеспечения более сложного поведения отслеживания.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Остановки, отслеживающие события от нажатия мыши в получателе.
Объявление
Параметры
lastPoint
Содержит предыдущую позицию курсора.
stopPoint
Текущее расположение курсора.
controlView
NSControl
объект, управляющий получателем.flag
Если
YES
true
, этот метод был вызван, потому что пользователь отпустил кнопку мыши; иначе, еслиNO
false
, курсор оставил определяемый прямоугольник отслеживания.Обсуждение
Значение по умолчанию
NSCell
реализацияtrackMouse:inRect:ofView:untilMouseUp:
вызывает этот метод, когда курсор оставил границы получателя, или кнопка мыши восстанавливает работоспособность. Значение по умолчаниюNSCell
реализация этого метода ничего не делает. Подклассы часто переопределяют этот метод для обеспечения настроенного поведения отслеживания. Когда кнопкой мыши щелкают, следующий пример постепенно увеличивает состояние ячейки с тремя состояниями:- (void)stopTracking:(NSPoint)lastPoint at:(NSPoint)stopPoint
inView:(NSView *)controlView mouseIsUp:(BOOL)flag
{
if (flag == YES) {
[self setTriState:([self triState]+1)];
}
}
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
mouseDownFlags mouseDownFlags
СвойствоМодификатор отмечает для последнего (левого) события mouseDown. (только для чтения)
Объявление
Swift
var mouseDownFlags: Int { get }
Objective C
@property(readonly) NSInteger mouseDownFlags
Обсуждение
Значение этого свойства является значением флагов модификатора от нового
NSEvent
объект, представляющий событие mouseDown. Если отслеживание еще не произошло, или событие не содержало модифицирующих клавиш, значение этого свойства0
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
modifierFlags
(NSEvent
) -
Возвращает булево значение, указывающее, ли отслеживание остановок, когда курсор оставляет ячейку.
Объявление
Swift
class func prefersTrackingUntilMouseUp() -> Bool
Objective C
+ (BOOL)prefersTrackingUntilMouseUp
Возвращаемое значение
YES
true
при отслеживании остановок, когда курсор оставляет ячейку, иначеNO
false
.Обсуждение
Возвраты реализации по умолчанию
NO
false
. Подклассы могут переопределить этот метод для возврата различного значения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает начальную задержку и повторные значения для непрерывной отправки сообщений действия к целевым объектам.
Объявление
Swift
func getPeriodicDelay(_
delay
: UnsafeMutablePointer<Float>, intervalinterval
: UnsafeMutablePointer<Float>)Objective C
- (void)getPeriodicDelay:(float *)
delay
interval:(float *)interval
Параметры
delay
На вводе, указателе на переменную с плавающей точкой. На выводе переменная содержит текущую задержку (измеренный в секундах), прежде чем будут отправлены сообщения. Этот параметр не должен быть
NULL
.interval
На вводе, указателе на переменную с плавающей точкой. На выводе переменная содержит интервал (измеренный в секундах), в котором отправляются сообщения. Этот параметр не должен быть
NULL
.Обсуждение
Реализация по умолчанию возвращает задержку
0.2
и интервал0.025
секунды. Подклассы могут переопределить этот метод для предоставления их собственной задержки и значений интервала.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Информация о тестировании хита возвратов для получателя.
Объявление
Swift
func hitTestForEvent(_
event
: NSEvent, inRectcellFrame
: NSRect, ofViewcontrolView
: NSView) -> NSCellHitResultObjective C
- (NSCellHitResult)hitTestForEvent:(NSEvent *)
event
inRect:(NSRect)cellFrame
ofView:(NSView *)controlView
Параметры
event
Текущее событие.
cellFrame
Кадр ячейки.
controlView
Объект управления, в котором расположена ячейка.
Возвращаемое значение
Константа, указывающая тип области, в которой событие имело место — видит
Hit Testing
для значений.Обсуждение
Когда вызов этого метода — видит, можно использовать поразрядную маску для поиска определенного значения
Hit Testing
для значений.Обычно этот метод должен быть переопределен пользовательским
NSCell
подклассы для возврата корректного результата. В настоящее время это вызывают некоторые представления мультиячейки, такой какNSTableView
.По умолчанию,
NSCell
взгляды на тип ячейки и делают следующее:NSImageCellType
: Если изображение существует, и точка события находится в возвратах изображенияNSCellHitContentArea
, иначеNSCellHitNone
.NSTextCellType
(также применяется кNSTextFieldCell
):Если существует текст: Если хиты точки события в тексте, возвратиться
NSCellHitContentArea
. Кроме того, если ячейке включают возвратNSCellHitContentArea
|
NSCellHitEditableTextArea
.Если нет текста: возвратиться
NSCellHitNone
.NSNullCellType
(это - значение по умолчанию, применяющееся к не тексту или ячейкам изображения, кто не переопределяетhitTestForEvent:inRect:ofView:
):Возвратиться
NSCellHitContentArea
по умолчанию;Если бы ячейка не отключила, и она отследила бы, возвратиться
NSCellHitContentArea
|
NSCellHitTrackableArea
.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Устанавливает получатель для показа курсора I-луча, в то время как это отслеживает мышь.
Объявление
Параметры
cellFrame
Прямоугольник, в котором можно вывести на экран курсор I-луча.
controlView
Управление, управляющее ячейкой.
Обсуждение
Получатель должен быть включенным и выбираемым (или доступный для редактирования) ячейка типа текста.
Этот метод вызывается
resetCursorRects
и в целом Вы не должны вызывать этот метод, если у Вас нет пользовательскогоNSView
это использует ячейку.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
keyEquivalent keyEquivalent
СвойствоКлючевой эквивалент связался с щелчком по ячейке. (только для чтения)
Объявление
Swift
var keyEquivalent: String { get }
Objective C
@property(readonly, copy) NSString *keyEquivalent
Обсуждение
Подклассы могут переопределить это свойство и возвратить строку с допустимым символом для ключевого эквивалента. Реализация по умолчанию этого свойства возвращает пустую строку.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Генерирует компоненты изображения перетаскивания с указанным кадром в представлении.
Объявление
Параметры
frame
Ограничительный прямоугольник получателя.
view
Представление, управляющее ячейкой.
Возвращаемое значение
Массив
NSDraggingImageComponent
объекты, представляющие ячейку.Обсуждение
Реализация по умолчанию генерирует изображение от ячейки, и возвратите два компонента: один для
NSDraggingImageComponentLabelKey
и другой дляNSDraggingImageComponentIconKey
. Это сделано путем получения части отtitleRectForBounds:
иimageRectForBounds:
методы соответственно.Этот метод может быть разделен на подклассы и переопределен для обеспечения пользовательского набора
NSDraggingImageComponent
создать изображение перетаскивания для ячейки. Этот метод обычно используется NSTableView/NSOutlineView.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.7 и позже.
-
Рисует фокусирующее кольцо для управления.
Объявление
Параметры
cellFrame
Ограничительный прямоугольник получателя или часть ограничительного прямоугольника.
controlView
Представление, управляющее ячейкой.
Обсуждение
Реализованный подклассами NSCell для рисования надлежащего фокусирующего кольца для управления реализация по умолчанию ничего не делает.
Набор Приложения автоматически вызывает этот метод в надлежащих случаях, для рендеринга фокусирующего кольца представления. Представление должно быть приемлемо становиться своим окном
firstResponder
, путем переопределенияacceptsFirstResponder
возвратYES
true
.Фокусирующее кольцо представляется с помощью стиля, указанного
focusRingType
свойство, которое не должно бытьNSFocusRingTypeNone
если Вы не хотите подавить получение фокусирующего кольца. РеализацияdrawFocusRingMaskWithFrame:inView:
может предположить, что это рисует в границах представления, и что цвета заливки и цвета обводки были установлены в произвольный полностью непрозрачный цвет. Это должно только нарисовать желаемую форму фокусирующего кольца или изображение или другой объект, схема которого определяет маску фокусирующего кольца.Этот новый OS X v10.7 фокусирующее кольцо API больше не должен вызывать
NSSetFocusRingStyle
(), и выполняют свое собственное получение.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.7 и позже.
-
Возвращает границы маски фокусирующего кольца.
Объявление
Параметры
cellFrame
Ограничительный прямоугольник получателя или часть ограничительного прямоугольника.
controlView
Представление, управляющее ячейкой.
Возвращаемое значение
Возвращает прямоугольник, охватывающий границы фокусирующего кольца в
controlView
координатное пространство.Обсуждение
Реализованный
NSCell
подклассы, чтобы позволить ячейке обеспечивать прямоугольные границы маски фокусирующего кольца для ячейки.Реализация по умолчанию возвращает пустое значение. Подклассы, как ожидают, реализуют этот метод, если они будут намереваться нарисовать фокусирующее кольцо.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.7 и позже.
-
Возвращает тип по умолчанию фокусирующего кольца для получателя.
Объявление
Swift
class func defaultFocusRingType() -> NSFocusRingType
Objective C
+ (NSFocusRingType)defaultFocusRingType
Возвращаемое значение
Тип по умолчанию фокусирующего кольца для получателя (одно из значений, перечисленных в
NSFocusRingType
).Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
focusRingType focusRingType
СвойствоТип фокусирующего кольца для использования со связанным представлением.
Объявление
Swift
var focusRingType: NSFocusRingType
Objective C
@property NSFocusRingType focusRingType
Обсуждение
Можно отключить получение фокусирующего кольца представления путем установки этого свойства в
NSFocusRingTypeNone
. Единственные времена необходимо отключить получение фокусирующего кольца, - когда Вы хотите нарисовать свое собственное фокусирующее кольцо или когда существует недостаточное пространство для отображения фокусирующего кольца в расположении по умолчанию.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Повторно вычисляет геометрию ячейки.
Параметры
aRect
Ссылочный прямоугольник для использования при вычислении информации о соте.
Обсуждение
Объекты (такие как средства управления), которые управляют
NSCell
объекты обычно поддерживают флаг, сообщающий им, если какая-либо из их ячеек была изменена таким способом, которым должны быть повторно вычислены расположение или размер ячейки. Если так,calcSize
методNSControl
автоматически вызывается до дисплея ячейки, и тот метод вызываетcalcDrawInfo:
метод ячейки.Реализация по умолчанию этого метода ничего не делает.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Минимальный размер должен был вывести на экран ячейку. (только для чтения)
Обсуждение
Это свойство содержит самый маленький размер ячейки (в точках) требуемый нарисовать его содержание. Если ячейка не является текстом или ячейкой изображения, размер ячейки установлен в (
10000
,10000
). Если ячейка изображения еще не имеет связанного изображения, размер ячейкиNSZeroSize
Метод.This принимает во внимание размера изображения или текста в ячейке вместе с любыми граничными областями, требуемыми границей ячейки, если таковые имеются.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращается минимальный размер должен был вывести на экран получатель, ограничив его к указанному прямоугольнику.
Объявление
Параметры
aRect
Размер ячейки или размер
aRect
параметр, если ячейка не является ячейкой изображения или текстом. Если ячейка является ячейкой изображения, но никакое изображение не было установлено, возвратыNSZeroSize
.Обсуждение
Этот метод принимает во внимание размера изображения или текста в определенном смещении, определенном типом границы ячейки. Если получатель имеет тип текста, текст изменен для адаптации в
aRect
(так же какaRect
в границах ячейки).Поддерживать расположение на основе ограничений, когда содержание пользовательские изменения ячеек таким способом, которым возвращаемое значение этого метода изменилось бы, ячейка, должно уведомить свое управление изменения путем вызова управления
invalidateIntrinsicContentSizeForCell:
метод.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает прямоугольник, в котором получатель рисует себя
Объявление
Параметры
theRect
Ограничительный прямоугольник получателя.
Возвращаемое значение
Прямоугольник, в котором получатель рисует себя. Этот прямоугольник немного вставляется от того в
theRect
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
calcSize
(NSControl
) -
Возвращает прямоугольник, в котором получатель рисует свое изображение.
Объявление
Параметры
theRect
Ограничительный прямоугольник получателя.
Возвращаемое значение
Прямоугольник, в котором получатель рисует свое изображение. Этот прямоугольник немного смещается от того в
theRect
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает прямоугольник, в котором получатель составляет свой текст заголовка.
Объявление
Параметры
theRect
Ограничительный прямоугольник получателя.
Возвращаемое значение
Прямоугольник, в котором получатель составляет свой текст заголовка.
Обсуждение
Если получатель является ячейкой типа текста, этот метод изменяет размеры прямоугольника получения для заголовка (
theRect
) внутрь маленьким смещением для размещения границы ячейки. Если получатель не является ячейкой типа текста, метод ничего не делает.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
controlSize controlSize
СвойствоРазмер ячейки.
Обсуждение
Используйте это свойство для изменения представленного размера ячейки и ее управления. Для списка возможных значений посмотрите
NSControlSize
.Изменение размера элемента управления ячейки не изменяет шрифт, используемый ячейкой. Используйте
systemFontSizeForControlSize:
метод классаNSFont
получить надлежащий шрифт на основе нового размера элемента управления.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Рисует границу получателя и затем рисует внутреннюю часть ячейки.
Объявление
Параметры
cellFrame
Ограничительный прямоугольник получателя.
controlView
Управление, управляющее ячейкой.
Обсуждение
Этот метод рисует ячейку в в настоящее время фокусируемом представлении, которое может отличаться от
controlView
переданный в. Использование в своих интересах этого поведения не рекомендуется, как бы то ни было.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает цвет использование получателя при рисовании подсветки выделения.
Объявление
Параметры
cellFrame
Ограничительный прямоугольник получателя.
controlView
Управление, управляющее ячейкой.
Возвращаемое значение
Цвет получатель использует при рисовании подсветки выделения.
Обсуждение
Вы не должны предполагать, что ячейка обязательно хотела бы нарисовать себя со значением, возвращенным из
selectedControlColor
. Ячейка может хотеть нарисовать с различным цвет подсветки выделения в зависимости от таких вещей как ключевое состояниеcontrolView
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.1 и позже.
-
Рисует внутреннюю часть получателя, включающего изображение, или текст делят на части, но не включает границу.
Объявление
Параметры
cellFrame
Ограничительный прямоугольник получателя или часть ограничительного прямоугольника.
controlView
Управление, управляющее ячейкой.
Обсуждение
Тип текста
NSCell
объекты выводят на экран свое содержание в прямоугольнике, немного вставленном отcellFrame
использование глобальной переменнойNSText
объект. Тип изображенияNSCell
объекты выводят на экран свое содержание, центрируемое вcellFrame
. Если надлежащие атрибуты установлены, этот метод также выводит на экран пунктирный прямоугольник, чтобы указать, является ли управление первым респондентом и выделяет ячейку. Этот метод вызывается отdrawCellInside:
методNSControl
визуально обновить то, что выводит на экран ячейка, когда изменяется ее содержание. Получение, сделанноеNSCell
реализация минимальна и становится более сложной в объектах такой какNSButtonCell
иNSSliderCell
.Этот метод рисует ячейку в в настоящее время фокусируемом представлении, которое может отличаться от
controlView
переданный в. Использование в своих интересах этого не рекомендуется.Подклассы часто переопределяют этот метод для обеспечения более сложного получения содержания ячейки. Поскольку
drawWithFrame:inView:
вызываетdrawInteriorWithFrame:inView:
после того, как это нарисует границу ячейки, не вызыватьdrawWithFrame:inView:
в Вашей реализации переопределения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
controlView controlView
СвойствоПредставление связалось с ячейкой.
Объявление
Swift
unowned(unsafe) var controlView: NSView?
Objective C
@property(assign) NSView *controlView
Обсуждение
Это свойство содержит представление, связанное с ячейкой. Это представление обычно
NSControl
объект. Значение по умолчанию этого свойстваnil
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Перерисовывает получатель с указанной установкой выделения.
Объявление
Параметры
flag
Если
YES
true
, ячейка перерисовывается с выделением; иначе, еслиNO
false
, выделение удалено.cellFrame
Ограничительный прямоугольник получателя.
controlView
Управление, управляющее ячейкой.
Обсуждение
Обратите внимание на то, что
NSCell
выделение не появляется, когда выделенные ячейки распечатаны (несмотря на то, что экземплярыNSTextFieldCell
,NSButtonCell
, и другие могут распечатать себя выделенный). Обычно Вы не можете зависеть от выделения быть распечатанными, потому что реализации этого метода могут выбрать (или не выбрать) использовать прозрачность.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
выделенный выделенный
СвойствоБулево значение, указывающее, имеет ли ячейка выделенное появление.
Объявление
Swift
var highlighted: Bool
Objective C
@property(getter=isHighlighted) BOOL highlighted
Обсуждение
Когда значение этого свойства
YES
true
, ячейка рисует себя с выделенным появлением. Значение по умолчанию этого свойстваNO
false
.Присвоение нового значения к этому свойству не имеет никакого эффекта по умолчанию. Подклассы могут переопределить свойство для обеспечения выделяющегося поведения. Например,
NSButtonCell
когда значение, класс переопределяет это свойство, так, чтобыYES
true
кнопка рисует кнопку с появлением выделения, указаннымNSCellLightsByBackground
,NSCellLightsByContents
, илиNSCellLightsByGray
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
-
Начинает редактировать текста получателя с помощью указанного полевого редактора.
Объявление
Параметры
aRect
Ограничительный прямоугольник ячейки.
controlView
Управление, управляющее ячейкой.
textObj
Полевой редактор для использования для редактирования ячейки.
anObject
Объект использовать в качестве делегата к полевому редактору (
textObj
параметр). Этот объект делегата получает различныйNSText
делегация и методы уведомления в течение редактирования содержания ячейки.theEvent
NSLeftMouseDown
событие, инициировавшее поведение редактирования.Обсуждение
Если получатель не является типом текста
NSCell
объект, никакое редактирование не выполняется. Иначе, полевой редактор (textObj
) измерен кaRect
и его суперпредставление установлено вcontrolView
, таким образом, это точно покрывает получатель. Полевой редактор тогда активируется, и редактирование начинается. Это - ответственность делегата закончить редактирование при ответе наtextShouldEndEditing:
. После окончания сеанса редактирования делегат должен удалить любые данные от полевого редактора.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
selectWithFrame (_: inView:editor:delegate:start:length:) - selectWithFrame:inView:editor:delegate:start:length:
Выбирает указанный текстовый диапазон в полевом редакторе ячейки.
Объявление
Параметры
aRect
Ограничительный прямоугольник ячейки.
controlView
Управление, управляющее ячейкой.
textObj
Полевой редактор для использования для редактирования ячейки.
anObject
Объект использовать в качестве делегата к полевому редактору (
textObj
параметр). Этот объект делегата получает различныйNSText
делегация и методы уведомления в течение редактирования содержания ячейки.selStart
Запуск текстового выбора.
selLength
Длина текстового диапазона.
Обсуждение
Этот метод подобен
editWithFrame:inView:editor:delegate:event:
, за исключением того, что это может быть вызвано в любой ситуации, не только на событии mouseDown. Этот метод возвращается, ничего не делая еслиcontrolView
,textObj
, или получательnil
, или если получатель не имеет никакого набора шрифтов для него.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Булево значение, указывающее, отправляет ли объект управления ячейки свое сообщение действия, когда пользователь заканчивает редактировать текст ячейки.
Объявление
Swift
var sendsActionOnEndEditing: Bool
Objective C
@property BOOL sendsActionOnEndEditing
Обсуждение
Когда значение этого свойства
YES
true
, когда редактирование завершено, управление отправляет свое сообщение действия. Когда пользователь выполняет одно из следующих действий: редактирование завершеноНажимает клавишу Return
Нажимает клавишу Tab для перемещения из поля
Щелчки другое текстовое поле
Когда значение
NO
false
, управление отправляет свое сообщение действия только, когда пользователь нажимает клавишу Return.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Заканчивает редактирование текста в получателе с помощью указанного полевого редактора.
Объявление
Swift
func endEditing(_
textObj
: NSText)Objective C
- (void)endEditing:(NSText *)
textObj
Параметры
textObj
Полевой редактор, в настоящее время обрабатывающий редактирование содержания ячейки.
Обсуждение
Концы любое редактирование текста, начавшегося с вызова к
editWithFrame:inView:editor:delegate:event:
илиselectWithFrame:inView:editor:delegate:start:length:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Булево значение, указывающее, должен ли полевой редактор ячейки отправить текстовые уведомления изменения. (только для чтения)
Объявление
Swift
var wantsNotificationForMarkedText: Bool { get }
Objective C
@property(readonly) BOOL wantsNotificationForMarkedText
Обсуждение
Когда значение этого свойства
YES
true
, в то время как редактирование отметило текст, полевой редактор должен отправить текстовые изменения уведомления. Когда значение нет, полевой редактор должен задержать уведомления, пока не подтвержден отмеченный текст.Значение по умолчанию этого свойства
NO
false
. Подклассы могут переопределить свойство и изменить значение как надлежащее.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает пользовательского полевого редактора для редактирования в представлении.
Объявление
Swift
func fieldEditorForView(_
aControlView
: NSView) -> NSTextView?Objective C
- (NSTextView *)fieldEditorForView:(NSView *)
aControlView
Параметры
aControlView
Представление, содержащее ячейки, требующие пользовательского полевого редактора.
Возвращаемое значение
Пользовательский полевой редактор. Полевой редактор должен иметь
isFieldEditor
набор кYES
true
.Обсуждение
Это - точка переопределения для
NSCell
подклассы, разработанные для использования их собственных полевых редакторов. Это сообщение отправляется в выбранную ячейкуaControlView
использованиеNSWindow
метод вfieldEditor:forObject:
.Возврат не -
nil
от этого метода указывает пропуск типичного полевого редактора, включая которого обрабатывают запросыwindowWillReturnFieldEditor:toObject:
делегация.Возвраты реализации по умолчанию
nil
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
usesSingleLineMode usesSingleLineMode
СвойствоБулево значение, указывающее, ограничивает ли ячейка расположение и рендеринг текста к одной строке.
Объявление
Swift
var usesSingleLineMode: Bool
Objective C
@property BOOL usesSingleLineMode
Обсуждение
Когда значение этого свойства
YES
true
, текстовое расположение и рендеринг ограничиваются одной строкой. Кроме того, ячейка игнорирует возвращаемое значение отwraps
, интерпретируетNSLineBreakByWordWrapping
иNSLineBreakByCharWrapping
возвращенныйlineBreakMode
какNSLineBreakByClipping
, и конфигурирует полевого редактора для игнорирования команд привязки клавиш, вставляющих разделители строки и абзац.Полевой редактор, связанный с однострочной ячейкой, отфильтровывает абзац и вставку разделителя строки от пользовательских действий. Ячейки в однострочном режиме используют фиксированное базовое расположение. Текстовая базовая позиция определяется исключительно размером элемента управления независимо от стиля шрифта содержания или размера.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает кадр ячейки расширения для получателя.
Объявление
Параметры
cellFrame
Кадр для получателя.
view
Представление, в котором будет нарисован получатель.
Возвращаемое значение
Ячейка расширения структурирует для получателя. Если кадр не является слишком маленьким, возвратите пустой rect (
NSZeroRect
), и никакое представление подсказки расширения не будет показано.Обсуждение
Этот метод позволяет ячейке возвращать кадр ячейки расширения если
cellFrame
является слишком маленьким для всего содержания в представлении. Когда мышь колеблется по ячейке в определенных средствах управления, полное содержание ячейки показано в специальном плавающем представлении подсказки. По умолчанию,NSCell
возвратыNSZeroRect
, в то время как некоторые подклассы (такой какNSTextFieldCell
) возвратит надлежащий кадр при необходимости.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Дает получателю команду рисовать в кадре расширения.
Объявление
Параметры
cellFrame
Кадр, в котором можно нарисовать.
view
Представление, в котором можно нарисовать. Это представление может отличаться от исходного представления, что ячейка появилась в.
Обсуждение
Этот метод позволяет ячейке выполнять пользовательское получение подсказки расширения. По умолчанию,
NSCell
просто вызовыdrawWithFrame:inView:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Направление макета пользовательского интерфейса.
Объявление
Swift
var userInterfaceLayoutDirection: NSUserInterfaceLayoutDirection
Objective C
@property NSUserInterfaceLayoutDirection userInterfaceLayoutDirection
Обсуждение
Это свойство указывает направления потока расположения интерфейса обычного пользователя. Для подклассов, имеющих многократные визуальные компоненты в экземпляре отдельной ячейки, это свойство должно указать направленность или поток компонентов.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
setEntryType: - setEntryType:
(OS X v10.0)Наборы, как числовые данные отформатированы в получателе и устанавливают ограничения для приемлемого ввода.
Оператор осуждения
Используйте средство форматирования вместо этого. Посмотрите
formatter
.Объявление
Objective C
- (void)setEntryType:(NSInteger)
aType
Параметры
aType
Один из типов, перечисленных для этого метода в
Data Entry Types
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.0.
-
entryType - entryType
(OS X v10.0)Возвращает тип данных, которые пользователь может ввести в получатель.
Оператор осуждения
Используйте средство форматирования вместо этого. Посмотрите
formatter
.Объявление
Objective C
- (NSInteger)entryType
Возвращаемое значение
Один из типов, перечисленных для этого метода в
Data Entry Types
. Если никакой тип не был установлен, если получатель не является ячейкой типа текста, илиNSAnyType
возвращается.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.0.
-
isEntryAcceptable: - isEntryAcceptable:
Осуждаемый в OS X v 10.0 и позжеВозвраты, отформатирована ли строка, представляющая числовое значение или значение даты, подходящим способом к типу записи ячейки.
Оператор осуждения
Использовать
NSFormatter
вместо этого.Объявление
Objective C
- (BOOL)isEntryAcceptable:(NSString *)
aString
Параметры
aString
Строка, содержащая числовое значение или значение даты.
Возвращаемое значение
YES
true
еслиaString
отформатирован соответственно для получателя, иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Доступность
Осуждаемый в OS X v 10.0 и позже.
-
Устанавливает авторасположение и формат числа с плавающей точкой ячейки получателя.
Оператор осуждения
Используйте средство форматирования вместо этого. Посмотрите
formatter
.Объявление
Objective C
- (void)setFloatingPointFormat:(BOOL)
autoRange
left:(NSUInteger)leftDigits
right:(NSUInteger)rightDigits
Параметры
autoRange
Если
YES
true
, авторасположение включено, иначе оно отключено.leftDigits
Число цифр для отображения налево от десятичной точки.
rightDigits
Число цифр для отображения направо от десятичной точки.
Обсуждение
Наборы, авторасположены ли числа с плавающей точкой в получателе и устанавливают размеры полей налево и права на десятичную точку. Если
autoRange
NO
false
,leftDigits
указывает максимальное количество цифр налево от десятичной точки, иrightDigits
указывает число цифр вправо (дробные места цифры будут дополнены нулями для заполнения этой ширины). Однако, если число является слишком большим для адаптации его целой части вleftDigits
цифры, столько мест, сколько необходимы слева, эффективно удалено изrightDigits
когда число выведено на экран.Если
autoRange
YES
true
,leftDigits
иrightDigits
просто добавляются для формирования максимальной общей ширины поля для получателя (плюс 1 для десятичной точки). Дробная часть будет дополнена нулями на праве заполнить эту ширину, или усеченный как можно больше (до удаления десятичной точки и отображения числа как целое число). Целочисленная часть числа никогда не является усеченной — т.е. она выведена на экран полностью независимо от того, каков предел ширины поля.Следующий пример устанавливает ячейку, используемую для отображения сумм в долларах до 99 999,99:
[[currencyDollarsField cell] setEntryType:NSFloatType];
[[currencyDollarsField cell] setFloatingPointFormat:NO left:5 right:2];
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.0.
-
setTitleWithMnemonic: - setTitleWithMnemonic:
(OS X v10.8)Устанавливает заголовок получателя с одним символом в строке, обозначенной как ключ доступа.
Оператор осуждения
Мнемоника не используется.
Объявление
Objective C
- (void)setTitleWithMnemonic:(NSString *)
aString
Параметры
aString
Новый заголовок ячейки. Одному символу в строке должен предшествовать амперсанд (
&
) символ. Следующий символ становится мнемоническим символом для заголовка.Обсуждение
Мнемоника не поддерживается в OS X.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
-
мнемосхема - мнемосхема
(OS X v10.8)Возвращает символ в заголовке получателя, кажущемся подчеркнутым для использования в качестве мнемосхемы.
Оператор осуждения
Мнемоника не используется.
Объявление
Objective C
- (NSString *)mnemonic
Возвращаемое значение
Строка, содержащая мнемонический символ или пустую строку, если не установлен никакой мнемонический символ.
Обсуждение
Мнемоника не поддерживается в OS X
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
-
setMnemonicLocation: - setMnemonicLocation:
(OS X v10.8)Устанавливает символ заголовка получателя, который будет использоваться в качестве мнемонического символа.
Оператор осуждения
Мнемоника не используется.
Объявление
Objective C
- (void)setMnemonicLocation:(NSUInteger)
location
Параметры
location
Основанный на нуле индекс в строку заголовка ячейки, указывающую расположение мнемонического символа. Когда заголовок составлен, указанный символ подчеркивается.
Обсуждение
Мнемоника не поддерживается в OS X.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
-
mnemonicLocation - mnemonicLocation
(OS X v10.8)Возвращает позицию подчеркнутого мнемонического символа в заголовке получателя.
Оператор осуждения
Мнемоника не используется.
Объявление
Objective C
- (NSUInteger)mnemonicLocation
Возвращаемое значение
Основанный на нуле индекс в строку заголовка получателя, указывающую позицию символа. Если нет никакого мнемонического символа, этот метод возвраты
NSNotFound
.Обсуждение
Мнемоника не поддерживается в OS X.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
-
Константы для указания, как ячейка представляет свои данные (как текст или как изображение).
Объявление
Swift
enum NSCellType : UInt { case NullCellType case TextCellType case ImageCellType }
Objective C
typedef enum NSCellType : NSUInteger { NSNullCellType = 0, NSTextCellType = 1, NSImageCellType = 2 } NSCellType;
Константы
-
NullCellType
NSNullCellType
Ячейка ничего не выводит на экран.
Доступный в OS X v10.0 и позже.
-
TextCellType
NSTextCellType
Ячейка выводит на экран текст.
Доступный в OS X v10.0 и позже.
-
ImageCellType
NSImageCellType
Ячейка выводит на экран изображения.
Доступный в OS X v10.0 и позже.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
-
Константы для указания, как кнопка ведет себя, когда нажато и как это выводит на экран свое состояние.
Объявление
Swift
enum NSCellAttribute : UInt { case CellDisabled case CellState case PushInCell case CellEditable case ChangeGrayCell case CellHighlighted case CellLightsByContents case CellLightsByGray case ChangeBackgroundCell case CellLightsByBackground case CellIsBordered case CellHasOverlappingImage case CellHasImageHorizontal case CellHasImageOnLeftOrBottom case CellChangesContents case CellIsInsetButton case CellAllowsMixedState }
Objective C
typedef enum NSCellAttribute : NSUInteger { NSCellDisabled = 0, NSCellState = 1, NSPushInCell = 2, NSCellEditable = 3, NSChangeGrayCell = 4, NSCellHighlighted = 5, NSCellLightsByContents = 6, NSCellLightsByGray = 7, NSChangeBackgroundCell = 8, NSCellLightsByBackground = 9, NSCellIsBordered = 10, NSCellHasOverlappingImage = 11, NSCellHasImageHorizontal = 12, NSCellHasImageOnLeftOrBottom = 13, NSCellChangesContents = 14, NSCellIsInsetButton = 15, NSCellAllowsMixedState = 16 } NSCellAttribute;
Константы
-
CellAllowsMixedState
NSCellAllowsMixedState
Позволяет состоянию ячейки быть
NSMixedState
, а такжеNSOffState
иNSOnState
.Доступный в OS X v10.0 и позже.
-
ChangeBackgroundCell
NSChangeBackgroundCell
Если состояние ячейки
NSMixedState
илиNSOnState
, изменяет цвет фона ячейки от серого до белого.Доступный в OS X v10.0 и позже.
-
CellChangesContents
NSCellChangesContents
Если состояние ячейки
NSMixedState
илиNSOnState
, выводит на экран дополнительное изображение ячейки.Доступный в OS X v10.0 и позже.
-
ChangeGrayCell
NSChangeGrayCell
Если состояние ячейки
NSMixedState
илиNSOnState
, выводит на экран изображение ячейки, как затемнено.Доступный в OS X v10.0 и позже.
-
CellDisabled
NSCellDisabled
Не позволяет пользователю управлять ячейкой.
Доступный в OS X v10.0 и позже.
-
CellEditable
NSCellEditable
Позволяет пользователю отредактировать содержание ячейки.
Доступный в OS X v10.0 и позже.
-
CellHasImageHorizontal
NSCellHasImageHorizontal
Управляет позицией изображения ячейки: помещает изображение справа от любого текста в ячейке.
Вместе,
NSCellHasImageOnLeftOrBottom
,NSCellHasImageHorizontal
, иNSCellHasOverlappingImage
управляйте позицией изображения и текста ячейки. Для размещения изображения выше не установите ни одного из них. Для размещения изображения ниже установитьNSCellHasImageOnLeftOrBottom
. Для размещения изображения вправо установитьNSCellHasImageHorizontal
. Для размещения изображения налево установитьNSCellHasImageHorizontal
иNSCellHasImageOnLeftOrBottom
. Для размещения изображения непосредственно установитьNSCellHasOverlappingImage
.Доступный в OS X v10.0 и позже.
-
CellHasImageOnLeftOrBottom
NSCellHasImageOnLeftOrBottom
Управляет позицией изображения ячейки: помещает изображение слева от или ниже любого текста в ячейке.
Посмотрите
NSCellHasImageHorizontal
для большего количества подробных данных.Доступный в OS X v10.0 и позже.
-
CellHasOverlappingImage
NSCellHasOverlappingImage
Управляет позицией изображения ячейки: помещает изображение по любому тексту в ячейке.
Посмотрите
NSCellHasImageHorizontal
для большего количества подробных данных.Доступный в OS X v10.0 и позже.
-
CellHighlighted
NSCellHighlighted
Доступный в OS X v10.0 и позже.
-
CellIsBordered
NSCellIsBordered
Рисует границу вокруг ячейки.
Доступный в OS X v10.0 и позже.
-
CellIsInsetButton
NSCellIsInsetButton
Вставляет содержание ячейки от границы.
По умолчанию содержание ячейки вставляется 2 точками. Если ячейка не имеет никакой границы, эта константа проигнорирована.
Доступный в OS X v10.0 и позже.
-
CellLightsByBackground
NSCellLightsByBackground
Если ячейка продвинута в, изменяет цвет фона ячейки от серого до белого.
Доступный в OS X v10.0 и позже.
-
CellLightsByContents
NSCellLightsByContents
Если ячейка продвинута в, выводит на экран дополнительное изображение ячейки.
Доступный в OS X v10.0 и позже.
-
CellLightsByGray
NSCellLightsByGray
Если ячейка продвинута в, выводит на экран изображение ячейки, как затемнено.
Доступный в OS X v10.0 и позже.
-
PushInCell
NSPushInCell
Определяет, кажется ли изображение и текст ячейки, смещаются вниз и вправо.
Доступный в OS X v10.0 и позже.
-
CellState
NSCellState
Состояние ячейки.
Состояние ячейки может быть
NSMixedState
,NSOffState
, илиNSOnState
.Доступный в OS X v10.0 и позже.
Обсуждение
Эти константы используются
NSButton
иNSButtonCell
классы.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
-
Константы для указания позиции изображения кнопки относительно его заголовка.
Объявление
Swift
enum NSCellImagePosition : UInt { case NoImage case ImageOnly case ImageLeft case ImageRight case ImageBelow case ImageAbove case ImageOverlaps }
Objective C
typedef enum NSCellImagePosition : NSUInteger { NSNoImage = 0, NSImageOnly = 1, NSImageLeft = 2, NSImageRight = 3, NSImageBelow = 4, NSImageAbove = 5, NSImageOverlaps = 6 } NSCellImagePosition;
Константы
-
NoImage
NSNoImage
Ячейка не выводит на экран изображение.
Доступный в OS X v10.0 и позже.
-
ImageOnly
NSImageOnly
Ячейка выводит на экран изображение, но не заголовок.
Доступный в OS X v10.0 и позже.
-
ImageLeft
NSImageLeft
Изображение налево от заголовка.
Доступный в OS X v10.0 и позже.
-
ImageRight
NSImageRight
Изображение направо от заголовка.
Доступный в OS X v10.0 и позже.
-
ImageBelow
NSImageBelow
Изображение ниже заголовка.
Доступный в OS X v10.0 и позже.
-
ImageAbove
NSImageAbove
Изображение выше заголовка.
Доступный в OS X v10.0 и позже.
-
ImageOverlaps
NSImageOverlaps
Изображение перекрывает заголовок.
Доступный в OS X v10.0 и позже.
Обсуждение
Эти константы используются
imagePosition
свойствоNSButton
иNSButtonCell
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
-
Константы для указания поведения масштабирования изображения ячейки.
Объявление
Swift
enum NSImageScaling : UInt { case ImageScaleProportionallyDown case ImageScaleAxesIndependently case ImageScaleNone case ImageScaleProportionallyUpOrDown }
Objective C
typedef enum NSImageScaling : NSUInteger { NSImageScaleProportionallyDown = 0, NSImageScaleAxesIndependently, NSImageScaleNone, NSImageScaleProportionallyUpOrDown } NSImageScaling;
Константы
-
ImageScaleProportionallyDown
NSImageScaleProportionallyDown
Если это является слишком большим для места назначения, уменьшите масштаб изображения при сохранении форматного соотношения.
Доступный в OS X v10.5 и позже.
-
ImageScaleAxesIndependently
NSImageScaleAxesIndependently
Масштабируйте каждую размерность для точной адаптации месту назначения.
Эта установка не сохраняет форматное соотношение изображения.
Доступный в OS X v10.5 и позже.
-
ImageScaleNone
NSImageScaleNone
Не масштабируйте изображение.
Доступный в OS X v10.5 и позже.
-
ImageScaleProportionallyUpOrDown
NSImageScaleProportionallyUpOrDown
Масштабируйте изображение к его максимальным возможным размерностям в то время как и остающийся в конечной области и сохраняющий его форматное соотношение.
Доступный в OS X v10.5 и позже.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
-
Константы для указания состояния ячейки и используются главным образом для кнопок.
Объявление
Swift
typealias NSCellStateValue = Int
Objective C
typedef enum NSCellStateValue : NSUInteger { NSMixedState = -1, NSOffState = 0, NSOnState = 1 } NSCellStateValue;
Константы
-
NSMixedState
NSMixedState
Соответствующая функция имеет силу где-нибудь.
Доступный в OS X v10.0 и позже.
-
NSOffState
NSOffState
Соответствующая функция не имеет силу нигде.
Доступный в OS X v10.0 и позже.
-
NSOnState
NSOnState
Соответствующая функция имеет силу везде.
Доступный в OS X v10.0 и позже.
Обсуждение
Эти константы описаны в состояниях Ячейки.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
-
Константы для указания, что происходит, когда кнопка нажимается или выводит на экран свое альтернативное состояние.
Объявление
Swift
struct NSCellStyleMask : RawOptionSetType { init(_
rawValue
: UInt) init(rawValuerawValue
: UInt) static var NoCellMask: NSCellStyleMask { get } static var ContentsCellMask: NSCellStyleMask { get } static var PushInCellMask: NSCellStyleMask { get } static var ChangeGrayCellMask: NSCellStyleMask { get } static var ChangeBackgroundCellMask: NSCellStyleMask { get } }Objective C
typedef enum NSCellStyleMask : NSUInteger { NSNoCellMask = 0, NSContentsCellMask = 1, NSPushInCellMask = 2, NSChangeGrayCellMask = 4, NSChangeBackgroundCellMask = 8 } NSCellStyleMask;
Константы
-
NoCellMask
NSNoCellMask
Ячейка кнопки не изменяется.
Доступный в OS X v10.0 и позже.
-
PushInCellMask
NSPushInCellMask
Ячейка кнопки “продвигает в”, если она имеет границу.
Доступный в OS X v10.0 и позже.
-
ContentsCellMask
NSContentsCellMask
Ячейка кнопки выводит на экран свой альтернативный значок и/или заголовок.
Доступный в OS X v10.0 и позже.
-
ChangeGrayCellMask
NSChangeGrayCellMask
Ячейка кнопки подкачивает “цвет управления” (
controlColor
методNSColor
) и белые пиксели на его фоне и значке.Доступный в OS X v10.0 и позже.
-
ChangeBackgroundCellMask
NSChangeBackgroundCellMask
То же как
NSChangeGrayCellMask
, но только фоновые пиксели изменяются.Доступный в OS X v10.0 и позже.
Обсуждение
Это содержание используется
highlightsBy
иshowsStateBy
методыNSButtonCell
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
-
-
Константы для указания оттенка ячейки.
Объявление
Swift
enum NSControlTint : UInt { case DefaultControlTint case BlueControlTint case GraphiteControlTint case ClearControlTint }
Objective C
typedef enum NSControlTint : NSUInteger { NSDefaultControlTint = 0, NSBlueControlTint = 1, NSGraphiteControlTint = 6, NSClearControlTint = 7 } NSControlTint;
Константы
-
DefaultControlTint
NSDefaultControlTint
Текущая установка оттенка по умолчанию
Доступный в OS X v10.0 и позже.
-
ClearControlTint
NSClearControlTint
Ясный оттенок управления
Доступный в OS X v10.0 и позже.
-
BlueControlTint
NSBlueControlTint
Оттенок управления водой
Доступный в OS X v10.3 и позже.
-
GraphiteControlTint
NSGraphiteControlTint
Графитовый оттенок управления
Доступный в OS X v10.3 и позже.
Обсуждение
Эти константы используются
controlTint
свойство.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
-
Константы для указания размера ячейки.
Объявление
Swift
enum NSControlSize : UInt { case RegularControlSize case SmallControlSize case MiniControlSize }
Objective C
typedef enum NSControlSize : NSUInteger { NSRegularControlSize, NSSmallControlSize, NSMiniControlSize } NSControlSize;
Константы
-
RegularControlSize
NSRegularControlSize
Управление измерено как регулярное.
Доступный в OS X v10.0 и позже.
-
SmallControlSize
NSSmallControlSize
Управление имеет меньший размер.
Эта константа для средств управления, которые не могут быть изменены в одном направлении, таком как кнопки, переключатели, флажки, ползунки, полосы прокрутки, кнопки всплывающего меню, вкладки и индикаторы хода выполнения. Необходимо использовать маленький системный шрифт с маленьким управлением.
Доступный в OS X v10.0 и позже.
-
MiniControlSize
NSMiniControlSize
Управление имеет меньший размер, чем
NSSmallControlSize
.Доступный в OS X v10.3 и позже.
Обсуждение
Эти константы используются
controlSize
свойство.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
-
Константы, используемые
hitTestForEvent:inRect:ofView:
метод для определения эффекта события.Объявление
Swift
struct NSCellHitResult : RawOptionSetType { init(_
rawValue
: UInt) init(rawValuerawValue
: UInt) static var None: NSCellHitResult { get } static var ContentArea: NSCellHitResult { get } static var EditableTextArea: NSCellHitResult { get } static var TrackableArea: NSCellHitResult { get } }Objective C
typedef enum NSCellHitResult : NSUInteger { NSCellHitNone = 0, NSCellHitContentArea = 1 << 0, NSCellHitEditableTextArea = 1 << 1, NSCellHitTrackableArea = 1 << 2, } NSCellHitResult;
Константы
-
None
NSCellHitNone
Пустая область, или не совершал нападки в ячейке.
Доступный в OS X v10.5 и позже.
-
ContentArea
NSCellHitContentArea
Предметная область в ячейке.
Доступный в OS X v10.5 и позже.
-
EditableTextArea
NSCellHitEditableTextArea
Доступная для редактирования текстовая область ячейки.
Доступный в OS X v10.5 и позже.
-
TrackableArea
NSCellHitTrackableArea
Допускающая отслеживание область в ячейке.
Доступный в OS X v10.5 и позже.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
-
-
Стили фона, используемые с
backgroundStyle
иinteriorBackgroundStyle
свойства.Объявление
Swift
enum NSBackgroundStyle : Int { case Light case Dark case Raised case Lowered }
Objective C
typedef enum NSBackgroundStyle : NSUInteger { NSBackgroundStyleLight = 0, NSBackgroundStyleDark, NSBackgroundStyleRaised, NSBackgroundStyleLowered } NSBackgroundStyle;
Константы
-
Light
NSBackgroundStyleLight
Фон является светлым цветом.
Темное содержание контрастирует хорошо с этим фоном.
Доступный в OS X v10.5 и позже.
-
Dark
NSBackgroundStyleDark
Фон является темным цветом.
Легкое содержание контрастирует хорошо с этим фоном.
Доступный в OS X v10.5 и позже.
-
Raised
NSBackgroundStyleRaised
Фон предназначается для появления выше, чем содержание, продвинутое это.
Содержание, возможно, должно было бы быть вставлено.
Доступный в OS X v10.5 и позже.
-
Lowered
NSBackgroundStyleLowered
Фон предназначается для появления ниже, чем содержание, продвинутое это.
Содержание, возможно, должно было бы быть рельефным.
Доступный в OS X v10.5 и позже.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
-
Они осуждаются, масштабируя константы.
Используйте константы NSImageScaling вместо этого.
Объявление
Objective C
enum { NSScaleProportionally = 0, NSScaleToFit, NSScaleNone };
Константы
-
NSScaleProportionally
NSScaleProportionally
Использовать
NSImageScaleProportionallyDown
.Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.
-
NSScaleToFit
NSScaleToFit
Использовать
NSImageScaleAxesIndependently
.Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.
-
NSScaleNone
NSScaleNone
Использовать
NSImageScaleNone
.Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.
-
-
Эти константы указывают как числовые данные форматов ячеек.
Объявление
Swift
var NSIntType: Int { get } var NSPositiveIntType: Int { get } var NSFloatType: Int { get } var NSPositiveFloatType: Int { get } var NSDoubleType: Int { get } var NSPositiveDoubleType: Int { get } var NSAnyType: Int { get }
Objective C
enum { NSAnyType = 0, NSIntType = 1, NSPositiveIntType = 2, NSFloatType = 3, NSPositiveFloatType = 4, NSDoubleType = 6, NSPositiveDoubleType = 7 };
Константы
-
NSIntType
NSIntType
Должен быть между
INT_MIN
иINT_MAX
.Осуждаемый в OS X v10.4 и позже.
-
NSPositiveIntType
NSPositiveIntType
Должен быть между 1 и
INT_MAX
.Осуждаемый в OS X v10.4 и позже.
-
NSFloatType
NSFloatType
Должен быть между
–FLT_MAX
иFLT_MAX
.Осуждаемый в OS X v10.4 и позже.
-
NSPositiveFloatType
NSPositiveFloatType
Должен быть между
FLT_MIN
иFLT_MAX
.Осуждаемый в OS X v10.4 и позже.
-
NSDoubleType
NSDoubleType
Должен быть между
–FLT_MAX
иFLT_MAX
.Осуждаемый в OS X v10.4 и позже.
-
NSPositiveDoubleType
NSPositiveDoubleType
Должен быть между
FLT_MIN
иFLT_MAX
.Осуждаемый в OS X v10.4 и позже.
-
NSAnyType
NSAnyType
Любое значение позволяется.
Осуждаемый в OS X v10.4 и позже.
Обсуждение
Эти константы используются
setEntryType:
иentryType
. -
-
Отправленный после того, как пользователь изменяет предпочтение оттенка управления. Объект уведомления
NSApp
. Это уведомление не содержит auserInfo
словарь.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.