QQuickMenuBar: add docs about using a native menu bar on macOS

Add a note explaining that a native menu bar will be used
on macOS from Qt 6.8, and that it can be disabled by
using AA_DontUseNativeMenuBar.

Change-Id: I4fff1d6e05bbd274a77d0fe145bde5089277f5bc
Reviewed-by: Shawn Rutledge <[email protected]>

1 files changed, 9 insertions, 0 deletions

diff --git a/src/quicktemplates/qquickmenubar.cpp b/src/quicktemplates/qquickmenubar.cpp
index 43c278e166..5bc6995670 100644
--- a/src/quicktemplates/qquickmenubar.cpp
+++ b/src/quicktemplates/qquickmenubar.cpp
@@ -42,6 +42,15 @@ QT_BEGIN_NAMESPACE
     \l {removeMenu}{remove}, and \l {takeMenu}{take} menus dynamically. The
     menus in a menu bar can be accessed using \l menuAt().
 
+    \note Since Qt 6.8, MenuBar is implemented as a native menu bar on \macos. As a
+    result, all Menus, MenuItems and MenuBarItems within a MenuBar will also be native.
+    While this has the advantage that everything will look native, it also comes with the
+    disadvantage that the delegates set on the mentioned controls will not be used
+    for rendering.
+    If a native MenuBar is not wanted, you can set
+    \l {Qt::AA_DontUseNativeMenuBar}{QGuiApplication::setAttribute(Qt::AA_DontUseNativeMenuBar)}
+    to disable it.
+
     \sa {Customizing MenuBar}, Menu, MenuBarItem, {Menu Controls},
         {Focus Management in Qt Quick Controls}
 */