From Xojo Documentation

Class (inherits from DesktopMenuItem)

New in 2021r3

DesktopPreferencesMenuItem is designed to handle the Preferences menu item for macOS applications. A menu item derived from the DesktopPreferencesMenuItem class is automatically moved to the application menu under macOS. Under other operating systems, such a menu item stays where you put it in the Menu Editor.


Since this class is based on DesktopMenuItem, please refer to this class for information on its Properties, Methods, and Events.

This class is for creating the Preferences menu item for applications that will run on macOS. Create the menu item under the menu that you want to use for the Windows and Linux builds and then use the Inspector to change its super class to DesktopPreferencesMenuItem. Otherwise, set up the menu item normally. In your macOS build, it will automatically move to the application menu.

According to Apple user interface guidelines, Cmd+, (comma) is the recommended keyboard shortcut for an application's Preferences menu item.

See Also

DesktopApplicationMenuItem, DesktopMenuItem, DesktopQuitMenuItem classes.