Platforms to show: All Mac Windows Linux Cross-Platform
NSToolbarItemMBS class
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| class | Cocoa Toolbar | MBS MacControls Plugin | 11.3 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Each item in an NSToolbar is an instance of NSToolbarItem.
- 24 properties
- property allowsDuplicatesInToolbar as boolean
- property autovalidates as boolean
- property backgroundTintColor as NSColorMBS
- property Bordered as Boolean
- property ClassName as String
- property ClassPath as String
- property Enabled as boolean
- property Handle as Integer
- property Hidden as Boolean
- property image as NSImageMBS
- property itemIdentifier as string
- property label as string
- property MaxSize as NSSizeMBS
- property menuFormRepresentation as NSMenuItemMBS
- property MinSize as NSSizeMBS
- property Navigational as Boolean
- property paletteLabel as string
- property Style as integer
- property tag as Integer
- property Title as String
- property toolbar as NSToolbarMBS
- property toolTip as string
- property view as NSViewMBS
- property visibilityPriority as Integer
- 6 methods
- method Constructor(Handle as Integer)
- method Constructor(itemIdentifier as string)
- method copy as NSToolbarItemMBS
- method possibleLabels as String()
- method setPossibleLabels(Labels() as String)
- method validate
- 13 shared methods
- shared method NSToolbarCloudSharingItemIdentifier as string
- shared method NSToolbarCustomizeToolbarItemIdentifier as string
- shared method NSToolbarFlexibleSpaceItemIdentifier as string
- shared method NSToolbarInspectorTrackingSeparatorItemIdentifier as string
- shared method NSToolbarPrintItemIdentifier as string
- shared method NSToolbarSeparatorItemIdentifier as string
- shared method NSToolbarShowColorsItemIdentifier as string
- shared method NSToolbarShowFontsItemIdentifier as string
- shared method NSToolbarSidebarTrackingSeparatorItemIdentifier as string
- shared method NSToolbarSpaceItemIdentifier as string
- shared method NSToolbarToggleInspectorItemIdentifier as string
- shared method NSToolbarToggleSidebarItemIdentifier as string
- shared method NSToolbarWritingToolsItemIdentifier as string
- 6 constants
Constants
| Constant | Value | Description |
|---|---|---|
| NSToolbarItemVisibilityPriorityHigh | 1000 | One of the visibility priority constants. When a toolbar does not have enough space to fit all its items, it must push some items into the overflow menu. These values allow you to suggest a priority for a toolbar item. more |
| NSToolbarItemVisibilityPriorityLow | -1000 | One of the visibility priority constants. When a toolbar does not have enough space to fit all its items, it must push some items into the overflow menu. These values allow you to suggest a priority for a toolbar item. more |
| NSToolbarItemVisibilityPriorityStandard | 0 | One of the visibility priority constants. When a toolbar does not have enough space to fit all its items, it must push some items into the overflow menu. These values allow you to suggest a priority for a toolbar item. more |
| NSToolbarItemVisibilityPriorityUser | 2000 | One of the visibility priority constants. When a toolbar does not have enough space to fit all its items, it must push some items into the overflow menu. These values allow you to suggest a priority for a toolbar item. more |
Styles
| Constant | Value | Description |
|---|---|---|
| NSToolbarItemStylePlain | 0 |
A plain style maintains the item’s standard appearance. |
| NSToolbarItemStyleProminent | 1 |
For macOS 26 or newer. |
Sub classes:
- class CustomNSToolbarItemMBS
- class NSMenuToolbarItemMBS
- class NSSearchToolbarItemMBS
- class NSToolbarItemGroupMBS
- class NSTrackingSeparatorToolbarItemMBS
Blog Entries
- macOS 26 thoughts
- News from the MBS Xojo Plugins Version 25.3
- MonkeyBread Software Releases the MBS Xojo Plugins in version 25.3
- MBS Xojo Plugins, version 25.3pr3
- MBS Xojo Plugins, version 24.6pr5
- MBS Xojo Plugins, version 24.5pr7
- MBS Xojo Plugins, version 24.5pr3
- News from the MBS Xojo Plugins Version 21.2
- MBS Xojo Plugins, version 21.2pr1
- MBS Xojo Plugins, version 21.1pr4
Xojo Developer Magazine
Release notes
- Version 25.3
- Added backgroundTintColor and style properties to NSToolbarItemMBS class.
- Version 25.0
- Added NSToolbarWritingToolsItemIdentifier shared method to NSToolbarItemMBS class.
- Version 24.5
- Added Hidden property to NSToolbarItemMBS class.
- Added possibleLabels, copy, NSToolbarToggleInspectorItemIdentifier and NSToolbarInspectorTrackingSeparatorItemIdentifier methods to NSToolbarItemMBS class.
- Deprecated NSToolbarSeparatorItemIdentifier and NSToolbarCustomizeToolbarItemIdentifier in NSToolbarItemMBS class.
- Version 21.2
- Added more methods to NSToolbarItemMBS and NSToolbarMBS classes.
- Version 21.1
- Added Constructor for handle to UNNotificationMBS, UNNotificationContentMBS, NSToolbarItemMBS and NSToolbarMBS.
Some methods using this class:
- NSToolbarItemGroupMBS.SetSubItems(items() as NSToolbarItemMBS)
- NSToolbarItemGroupMBS.subitems as NSToolbarItemMBS()
- NSToolbarMBS.items as NSToolbarItemMBS()
- NSToolbarMBS.visibleItems as NSToolbarItemMBS()
Some events using this class:
- CustomNSToolbarMBS.itemForItemIdentifier(identifier as string, willBeInsertedIntoToolbar as boolean) as NSToolbarItemMBS
- CustomNSToolbarMBS.toolbarDidRemoveItem(item as NSToolbarItemMBS, notification as NSNotificationMBS)
- CustomNSToolbarMBS.toolbarItemAction(item as NSToolbarItemMBS)
- CustomNSToolbarMBS.toolbarItemAllowsDuplicatesInToolbar(item as NSToolbarItemMBS) as boolean
- CustomNSToolbarMBS.toolbarItemValidate(item as NSToolbarItemMBS) as boolean
- CustomNSToolbarMBS.toolbarWillAddItem(item as NSToolbarItemMBS, notification as NSNotificationMBS)
Some examples using this class:
- /MacControls/Toolbar/Toolbar add textfield
- /MacControls/Toolbar/Toolbar buttons/Toolbar buttons
- /MacControls/Toolbar/Toolbar customized
- /MacControls/Toolbar/Toolbar with retina Icons
Some related classes:
- class CustomNSToolbarItemMBS
- class CustomNSToolbarMBS
- class NSImageMBS
- class NSMenuToolbarItemMBS
- class NSNotificationMBS
- class NSSearchToolbarItemMBS
- class NSSizeMBS
- class NSToolbarItemGroupMBS
- class NSToolbarMBS
- class NSViewMBS
The items on this page are in the following plugins: MBS MacControls Plugin.
NSToolbarItemGroupMBS - NSToolbarMBS
