Native macOS Toolbar

Extras
1

For anyone looking for a native macOS toolbar, I made one available on the Xojo store recently. You can find more information and a demo link on my website.

ToolbarCustomization
ToolbarCustomization1796×1152 194 KB

10 Likes
2

This looks great! Any chance of extending this or creating a similar project for Windows?

3

?
(macos 13.4.1)

Capture d’écran 2023-08-28 à 20.41.11
Capture d’écran 2023-08-28 à 20.41.11744×916 132 KB

4

You’ll need to put the dylib into the copy files step again.

1 Like
5

I’ll do this to test, but App crash in Window1.Opening doing ‘RebuildToolbar’ when AddItem : nstoolbar1.AddItem(MakeItem(“Trash”, “trash”))

6

Interesting. You’re the second person to report that and I have no idea why yet.

Could you separate that line into two like this?

Dim item as SOSToolbar.NSToolbarItem = MakeItem(“Trash”, “trash”)
nstoolbar1.AddItem(item)

And tell me it item is Nil?

7

Well the good news is that I can reproduce it now
 working on a solution.


and Fixed.

2 Likes
8

Version 1.0.2 of my Native macOS Toolbar classes are now available. A special shout out to @Valdemar_De_SOUSA for pointing out a critical toolbar selection bug.

This version adds an NSToolbarItem.IsSelectable property which indicates whether or not the toolbar item stays highlighted when it is selected. Coupled with setting the Bordered property to False, you can now have a preferences toolbar that behaves like a Tab Bar where one item is always selected.

The new version can be downloaded from here.

7 Likes
9

Another test problem, how do you use ‘Tag’ in SOSToolbar.NSToolbarItem ?

It always return 0 when you add a tag at construction, and -1 when you don’t.

10

Fixed. tag will only take integers now since that’s what macOS supports under the hood.

11

I get this message when launching the Demo (what do I do?)

Window1.NSToolbar1.SelectableItemIdentifiers Declaration
NSToolbar1 on Window1 implements the event “SelectableItemIdentifiers,” but its superclass SOSToolbar.NSToolbar has already implemented the event.
Function SelectableItemIdentifiers() As String()

Thanks.

12

It works when I remove the NSToolbar1.SelectableItemIdentifiers event !!!

13

Right. I moved that feature to a property of the items themselves. Now you just set the “isSelectable” property and whenever the toolbar asks for that info, it asks the items.

14

I’ve had a recent query about how to move add this module into a text project.

The encrypted SOSToolbar module in the sample project contains not only methods and properties, but also other classes. Because of the encryption, these files must be kept together as a binary object.

The solution is pretty straightforward:

  1. In your project, create a folder called SOS_Toolbar
  2. Copy & Paste the SOSToolbarHelpers module from the sample project to the SOS_Toolbar folder in your project.
  3. Go to the sample project and select the SOSToolbar module.
  4. Right-click on the module and select Export.
  5. Save the file into the folder where your project files are.
  6. Bring your project to the foreground
  7. Drag the exported file to your project while holding down the CMD and OPT keys so it gets added to your project as an external item.
  8. Save your project
15

Hmm


Somehow the toolbar icons are always disabled
also in the demo project where the itemPressed event should trigger label1.Text = "Pressed: " + item.Label.

Something missing to get the itemPressed events?

16

Hey Everyone,

An update is available for my macOS Toolbar classes which includes declares for items that were added for macOS 15 and upcoming macOS 26.

This is a free update for anyone that has purchased these classes. Those users should get an email shortly with download instructions for the latest text format files.

Greg

Version 1.0.6 brings a few requested updates:

macOS 15+

NSToolbar.allowsDisplayModeCustomization as Boolean
Allows you to decide whether or not the user can right-click to change the toolbar mode

NSToolbarItem.TrackingSeparatorToolbarItem(Identifier as String, splitViewHandle as Ptr, dividerIndex as Integer) as NSToolbarItem
Returns an NSTrackingSeparatorToolbarItem for use with an NSSplitView to control the layout of the toolbar with respect to the Split View.

macOS 26+

NSToolbarItem.ClearBadge()
Removes the item’s badge

NSToolbarItem.SetBadge(value as Integer)
NSToolbarItem.SetBadge(value as String)
Sets the item’s badge using the supplied integer or string.

NSToolbarItem.BackgroundTintColor as Color
NSToolbarItem.BackgroundTintColor as String
Sets the items tint color using a Xojo Color or an NSColor named color.

IsHidden as Boolean
Sets the visibility of the toolbar item.

Style as Styles
Sets the prominence of the toolbar item.

Styles as Integer
Plain = 0
Prominent = 1

4 Likes