macOS application windows have several different modern configurations which go beyond the standard "thin" titlebar look. However, using the NSWindow API to achive the desired configuration can be non-straightforward.
Above: the Slate application with a unified title and toolbar look.
NSWindow configuration options are platform specific and are typically not available through the cross-platform QWindow or QWidget API. Instead we'll create the native and configure the NSWindow separately, and then embed the QWindow in it.
nswindow.contentView = (__bridge NSView *)reinterpret_cast<void *>(qwindow->winId());
Sidebar: Top-level windows on macOS are NSWindow instances. NSWindow content is provided by the content view, which is a NSView. QWindows are NSViews on macOS and QWindow::WId is a NSView pointer.
This project provides an incomplete C++ API for NSWindow: MacWindow.
QWindow *applicationWindiow = ...
MacWindow macWindow;
macWindow.setContentView(applicationWindow)
macWindow.setFullSizeContentView(true);
macWindow.show()
And also a configurator panel for exploring the NSWindow configurations.
Okay, this is more like a tech shrubbery with intertwined options.
- NSWindow.Toolbar
- NSWindow.titleVisibility
- NSWindow.title
- NSFullSizeContentViewWindowMask
- NSWidnow.titlebarAppearsTransparent
- (with Toolbar) NSToolBar.showsBaselineSeparator
- [NSWindow addTitlebarAccessoryViewController]
Let's break out the checkerboard test QWindow to illustrate which parts of the NSWindow the Qt application QWindow is drawing to.
Standard - The standard window configration with a "thin" titlebar.
Set toolbar - Adding a Toolbar expands the titlebar. The Toolbar can be populated with native toolbar items, perhaps using QMacToolBar.
Clear titleVisibility - Disabling title visiblity vertically centers the traffic lights. Note that this option is distinct from merely setting an empty title string.
Add addTitlebarAccessoryViewController - Accessory NSViews/QWindows can be added to the title/toolbar area. The application controls view width, while the height is set automatically. The left accessory view (green) is anchored to the traffic lights, while the right view (red) is anchored to the window edge.
Set fullSizeContentView - Going back to the thin titlebar: Setting full size content view makes the content view/QWindow cover the entire NSWindow area. The title bar will be rendred with a nice blur effect.
Set titlebarAppearsTransparent - Make the titlebar transparent. We've set an empty title text string as well.
Set toolbar, clear titleVisibility - Adding a Toolbar without a window title lowers the traffic lights again. You also want to clear showsBaselineSeparator to prevent the toolbar from drawing a separator line which would, if present, make the application completely unusable.
