NSCell

一个用于在一个View对象上显示文本或图片的结构，并且不需要一个完整的NSView子类的开销。

定义

class NSCell : NSObject

概述

大多数NSControl类都使用Cell来实现其内部工作。

指定的初始化方法

子类化NSCell时，必须实现所有指定的初始化方法。这些方法包括init，init(coder:)，init(textCell:)和init(imageCell:)。

主题

初始化一个Cell

• init(imageCell: NSImage?)

  返回使用指定图像初始化并设置为具有Cell默认菜单的NSCell对象。

• init(textCell: String)

  返回使用指定字符串初始化并设置为具有Cell默认菜单的NSCell对象。

管理Cell的值

• var objectValue: Any? The cell’s value as an Objective-C object.

• var hasValidObjectValue: Bool A Boolean value that indicates whether the cell has a valid object value.

• var intValue: Int32 The cell’s value as an integer.

• var integerValue: Int The cell’s value as an NSInteger type.

• var stringValue: String The cell’s value as a string.

• var doubleValue: Double The cell’s value as a double-precision floating-point number.

• var floatValue: Float The cell’s value as a single-precision floating-point number.

管理Cell属性

• func setCellAttribute(NSCell.Attribute, to: Int)

  设置指定Cell属性的值。

• func cellAttribute(NSCell.Attribute) -> Int Returns the value for the specified cell attribute.

• var type: NSCell.CellType

  Cell的类型。

• var isEnabled: Bool A Boolean value indicating whether the cell is currently enabled.

• var allowsUndo: Bool A Boolean value indicating whether the cell assumes responsibility for undo operations.

管理显示属性

• var isBezeled: Bool A Boolean value indicating whether the cell has a bezeled border.

• var isBordered: Bool A Boolean value indicating whether the cell draws itself outlined with a plain border.

• var isOpaque: Bool A Boolean value indicating whether the cell is completely opaque.

• var backgroundStyle: NSView.BackgroundStyle

  Cell的背景样式。

• var interiorBackgroundStyle: NSView.BackgroundStyle

  Cell的内部背景样式。

• enum NSView.BackgroundStyle

  与backgroundStyle和interiorBackgroundStyle属性一起使用的背景样式。

管理Cell状态

• var allowsMixedState: Bool A Boolean value indicating whether the cell supports three states instead of two.

• var nextState: Int

  Cell的下一个状态。

• func setNextState()

  将Cell的状态更改为序列中的下一个值。

• var state: NSControl.StateValue

  Cell的当前状态。

• struct NSControl.StateValue

管理字段属性

• var isEditable: Bool A Boolean value indicating whether the cell is editable.

• var isSelectable: Bool A Boolean value indicating whether the cell’s text can be selected.

• var isScrollable: Bool A Boolean value indicating whether excess text scrolls past the cell’s bounds.

• var alignment: NSTextAlignment The alignment of the cell’s text.

• var font: NSFont?

  Cell用于显示文本的字体。

• var lineBreakMode: NSLineBreakMode The line break mode to use when drawing text in the cell.

• var truncatesLastVisibleLine: Bool A Boolean value indicating whether the cell truncates text that does not fit within the cell’s bounds.

• var wraps: Bool A Boolean value indicating whether the cell wraps text whose length that exceeds the cell’s frame.

• var baseWritingDirection: NSWritingDirection The initial writing direction used to determine the actual writing direction for text.

• var attributedStringValue: NSAttributedString The cell’s value as an attributed string.

• var allowsEditingTextAttributes: Bool A Boolean value indicating whether the cell allows the editing of its content’s text attributes by the user.

• var importsGraphics: Bool A Boolean value indicating whether the cell supports the importation of images into its text.

• func setUpFieldEditorAttributes(NSText) -> NSText Configures the textual and background attributes of the receiver’s field editor.

• var title: String The cell’s title text.

管理Target和Action

• var action: Selector? The action performed by the cell.

• var target: AnyObject? The object that receives the cell’s action messages.

• var isContinuous: Bool A Boolean value indicating whether the cell sends its action message continuously during mouse tracking.

• func sendAction(on: NSEvent.EventTypeMask) -> Int Sets the conditions on which the receiver sends action messages to its target.

管理图片

• var image: NSImage?

  Cell中显示的图片（如果有的话）。

管理标签

• var tag: Int A tag for identifying the cell.

格式化和验证数据

• var formatter: Formatter? The cell’s formatter object.

管理菜单

• class var defaultMenu: NSMenu? Returns the default menu for instances of the cell.

• var menu: NSMenu? The cell’s contextual menu.

• func menu(for: NSEvent, in: NSRect, of: NSView) -> NSMenu? Returns the menu associated with the cell and related to the specified event and frame.

比较Cell

• func compare(Any) -> ComparisonResult Compares the string values of the receiver another cell, disregarding case.

响应键盘事件

• var acceptsFirstResponder: Bool A Boolean value indicating whether the cell accepts first responder status.

• var showsFirstResponder: Bool A Boolean value indicating whether the cell provides a visual indication that it is the first responder.

• var refusesFirstResponder: Bool A Boolean value indicating whether the cell refuses the first responder status.

• func performClick(Any?) Simulates a single mouse click on the receiver.

衍生值

• func takeObjectValueFrom(Any?) Sets the value of the receiver’s cell to the object value obtained from the specified object.

• func takeIntegerValueFrom(Any?) Sets the value of the receiver’s cell to an integer value obtained from the specified object.

• func takeIntValueFrom(Any?) Sets the value of the receiver’s cell to an integer value obtained from the specified object.

• func takeStringValueFrom(Any?) Sets the value of the receiver’s cell to the string value obtained from the specified object.

• func takeDoubleValueFrom(Any?) Sets the value of the receiver’s cell to a double-precision floating-point value obtained from the specified object.

• func takeFloatValueFrom(Any?) Sets the value of the receiver’s cell to a single-precision floating-point value obtained from the specified object.

表示一个对象

• var representedObject: Any? The object represented by the cell.

追踪鼠标

• func trackMouse(with: NSEvent, in: NSRect, of: NSView, untilMouseUp: Bool) -> Bool

  启动Cell中的鼠标跟踪行为。

• func startTracking(at: NSPoint, in: NSView) -> Bool

  开始跟踪接收者中的鼠标事件。

• func continueTracking(last: NSPoint, current: NSPoint, in: NSView) -> Bool

  返回一个布尔值，该值指示鼠标跟踪是否应在接收Cell中持续进行。

• func stopTracking(last: NSPoint, current: NSPoint, in: NSView, mouseIsUp: Bool)

  停止接收者中的鼠标跟踪事件。

• var mouseDownFlags: Int

  最后一个鼠标按下（左键）事件的修饰符标志。

• class var prefersTrackingUntilMouseUp: Bool

  返回一个布尔值，该值指示当光标离开Cell时跟踪是否停止。

• func getPeriodicDelay(UnsafeMutablePointer, interval: UnsafeMutablePointer)

  返回初始延迟和重复值，以将动作消息连续发送到Target对象。

命中测试

• func hitTest(for: NSEvent, in: NSRect, of: NSView) -> NSCell.HitResult Returns hit testing information for the receiver.

管理光标

• func resetCursorRect(NSRect, in: NSView) Sets the receiver to show the I-beam cursor while it tracks the mouse.

处理键盘替代

• var keyEquivalent: String The key equivalent associated with clicking the cell.

拖动Cell

• func draggingImageComponents(withFrame: NSRect, in: NSView) -> [NSDraggingImageComponent] Generates dragging image components with the specified frame in the view.

管理对焦环

• func drawFocusRingMask(withFrame: NSRect, in: NSView) Draws the focus ring for the control.

• func focusRingMaskBounds(forFrame: NSRect, in: NSView) -> NSRect Returns the bounds of the focus ring mask.

• class var defaultFocusRingType: NSFocusRingType Returns the default type of focus ring for the receiver.

• var focusRingType: NSFocusRingType The type of focus ring to use with the associated view.

确定Cell大小

• func calcDrawInfo(NSRect)

  重新计算Cell的几何形状。

• var cellSize: NSSize

  显示Cell所需的最小尺寸。

• func cellSize(forBounds: NSRect) -> NSSize

  返回显示接收器所需的最小尺寸，并将其限制为指定的矩形。

• func drawingRect(forBounds: NSRect) -> NSRect

  返回接收方绘制自身的矩形。

• func imageRect(forBounds: NSRect) -> NSRect

  返回接收方在其中绘制其图像的矩形。

• func titleRect(forBounds: NSRect) -> NSRect

  返回接收方在其中绘制其文本的矩形。

• var controlSize: NSControl.ControlSize

  Cell的大小。

绘图和高亮显示

• func draw(withFrame: NSRect, in: NSView)

  绘制接收者的边框，然后绘制Cell的内部。

• func highlightColor(withFrame: NSRect, in: NSView) -> NSColor? Returns the color the receiver uses when drawing the selection highlight.

• func drawInterior(withFrame: NSRect, in: NSView)

  绘制接收器的内部，其中包括图像或文本部分，但不包括边框。

• var controlView: NSView? The view associated with the cell.

• func highlight(Bool, withFrame: NSRect, in: NSView) Redraws the receiver with the specified highlight setting.

• var isHighlighted: Bool A Boolean value indicating whether the cell has a highlighted appearance.

编辑和选择文本

• func edit(withFrame: NSRect, in: NSView, editor: NSText, delegate: Any?, event: NSEvent?) Begins editing of the receiver’s text using the specified field editor.

• func select(withFrame: NSRect, in: NSView, editor: NSText, delegate: Any?, start: Int, length: Int) Selects the specified text range in the cell’s field editor.

• var sendsActionOnEndEditing: Bool A Boolean value indicating whether the cell’s control object sends its action message when the user finishes editing the cell’s text.

• func endEditing(NSText) Ends the editing of text in the receiver using the specified field editor.

• var wantsNotificationForMarkedText: Bool A Boolean value indicating whether the cell’s field editor should post text change notifications.

• func fieldEditor(for: NSView) -> NSTextView? Returns a custom field editor for editing in the view.

• var usesSingleLineMode: Bool A Boolean value indicating whether the cell restricts layout and rendering of text to a single line.

管理扩展框架

• func expansionFrame(withFrame: NSRect, in: NSView) -> NSRect

  返回接收器的扩展Cell框架。

• func draw(withExpansionFrame: NSRect, in: NSView)

  指示接收器在扩展框架中绘制。

用户界面布局方向

• var userInterfaceLayoutDirection: NSUserInterfaceLayoutDirection

  用户界面的布局方向。

常量

• enum NSCell.CellType

  用于指定Cell如何表示其数据（作为文本或图像）的常量。

• enum NSCell.Attribute

  用于指定Button在按下时的行为方式以及如何显示其状态的常量。

• enum NSControl.ImagePosition Constants for specifying the position of a button’s image relative to its title.

• enum NSImageScaling Constants that specify a cell’s image scaling behavior.

• struct NSCell.StyleMask Constants for specifying what happens when a button is pressed or is displaying its alternate state.

• enum NSControlTint Constants for specifying a cell’s tint color.

• enum NSControl.ControlSize

  用于指定Cell大小的常量。

• struct NSCell.HitResult Constants used by the hitTest(for:in:of:) method to determine the effect of an event.

• enum NSView.BackgroundStyle

  与backgroundStyle和interiorBackgroundStyle属性一起使用的背景样式。

• Deprecated Scaling Constants These are deprecated scaling constants.

• Data Entry Types These constants specify how a cell formats numeric data.

初始化

• init()
• init(coder: NSCoder)