Platforms to show: All Mac Windows Linux Cross-Platform

NSTokenFieldMBS class

Super class: NSTextFieldMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
class Cocoa MBS MacControls Plugin 12.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
NSTokenField is a subclass of NSTextField that provides tokenized editing similar to the address field in the Mail application.

NSTokenField uses an NSTokenFieldCell to implement much of the control's functionality. NSTokenField provides cover methods for most methods of NSTokenFieldCell, which invoke the corresponding cell method.

In MBS Plugin the objects must be strings or numbers. With plugin version 12.5, you can also use normal Xojo objects.

In OS X v10.4, NSTokenField trims whitespace around tokens but it does not trim whitespace in OS X versions 10.5.0 and 10.5.1. In OS X v10.5.2, you get whitespace-trimming behavior by either linking against the v10.4 binary or linking against the v10.5 binary and not implementing the representedObjectForEditingString event. If you do not want the whitespace-trimming behavior, link against the v10.5 binary and implement this method, returning the editing string if you have no represented object.

Please note: Due to the way the plugin is implemented the Action, textShouldEndEditing and textShouldBeginEditing events do nothing, so please use tokenFieldAction, tokenFieldTextShouldEndEditing and tokenFieldTextShouldBeginEditing.
Subclass of the NSTextFieldMBS class.

Token Styles

Constant Value Description
NSDefaultTokenStyle 0 Style best used for keyword type tokens.
Available in OS X v10.4 and later.
NSPlainTextTokenStyle 1 Style to use for data you want represented as plain-text and without any token background.
Available in OS X v10.4 and later.
NSRoundedTokenStyle 2 Style best used for address type tokens.
Available in OS X v10.4 and later.

Super class NSTextFieldMBS

Constants

Constant Value Description
NSTextFieldRoundedBezel 1 One of the constants for the bezelStyle property. Corners are rounded.
NSTextFieldSquareBezel 0 One of the constants for the bezelStyle property. Corners are square.

Super class NSControlMBS

Constants

Constant Value Description
ControlSizeLarge 3 One of the constants to specify a cell’s size. A size larger than the default control size.
ControlSizeMini 2 One of the constants to specify a cell’s size. The smallest control size.
ControlSizeRegular 0 One of the constants to specify a cell’s size. The default control size.
ControlSizeSmall 1 One of the constants to specify a cell’s size. A size smaller than the default control size. more

Super class NSViewMBS

Constants

Constant Value Description
NSBezelBorder 2 One of the constants to specify the type of a view's border. A concave border that makes the view look sunken.
NSFocusRingTypeDefault 0 One of the constants for the focusringtype property. The default focus ring type for NSView or NSCell.
NSFocusRingTypeExterior 2 One of the constants for the focusringtype property. The standard Aqua focus ring.
NSFocusRingTypeNone 1 One of the constants for the focusringtype property. No focus ring. If you set the focus ring type to this value, NSView and NSCell will not draw any focus ring.
NSGrooveBorder 3 One of the constants to specify the type of a view's border. A thin border that looks etched around the image.
NSLineBorder 1 One of the constants to specify the type of a view's border. A black line border around the view.
NSNoBorder 0 One of the constants to specify the type of a view's border. No border.
NSViewHeightSizable 16 One of the constants for the autoresizingMask property. The receiver's height is flexible.
NSViewLayerContentsRedrawBeforeViewResize 3 One of the view layer content redraw policy constants.
NSViewLayerContentsRedrawDuringViewResize 2 One of the view layer content redraw policy constants.
NSViewLayerContentsRedrawNever 0 One of the view layer content redraw policy constants.
NSViewLayerContentsRedrawOnSetNeedsDisplay 1 One of the view layer content redraw policy constants.
NSViewMaxXMargin 4 One of the constants for the autoresizingMask property. The right margin between the receiver and its superview is flexible.
NSViewMaxYMargin 32 One of the constants for the autoresizingMask property. The top margin between the receiver and its superview is flexible.
NSViewMinXMargin 1 One of the constants for the autoresizingMask property. The left margin between the receiver and its superview is flexible.
NSViewMinYMargin 8 One of the constants for the autoresizingMask property. The bottom margin between the receiver and its superview is flexible.
NSViewNotSizable 0 One of the constants for the autoresizingMask property. The receiver cannot be resized.
NSViewWidthSizable 2 One of the constants for the autoresizingMask property. The receiver's width is flexible.

Window Order Constants

Constant Value Description
NSWindowAbove 1 Moves the window above the indicated window.
NSWindowBelow -1 Moves the window below the indicated window.
NSWindowOut 0 Moves the window off the screen.

Super class NSResponderMBS

Sub classes:

Some properties using for this class:

Some examples using this class:

Blog Entries


The items on this page are in the following plugins: MBS MacBase Plugin, MBS MacCocoa Plugin, MBS MacControls Plugin.


NSTimeZoneMBS   -   NSToolbarItemGroupMBS


The biggest plugin in space...